3.1.5 Получение информации о курьерской службе

На этом этапе вы можете получить подробную информацию о курьерской службе, которая доставляет заказ покупателю. Данный запрос доступен только для заказов, находящихся в статусе DELIVERY — то есть когда товар уже передан курьеру и находится в процессе доставки.

GET-запрос:

curl --location 'https://halykmarket.kz/gw/merchant/public/order/v1
?orderNumber=1111111111-1' \
--header 'Authorization: Bearer ваш токен' \

Атрибуты запроса:

Наименование	Описание
orderNumber	Фильтр по номеру заказа

Для обращения на тестовый сервер, используйте URL: https://test2-api.halykmarket.com/api/merchant/v1/orders

Ответ сервера:

Шаблон ответа:

{ 
    "data": [ 
        { 
            "type": "orders", 
            "id": "11111111", 
            "attributes": { 
                "code": "1111111111-1", 
                "totalPrice": 21, 
                "deliveryMode": "PHYSICAL_PICKUP", 
                "deliveryType": "PICKUP", 
                "deliveryAddress": { 
                    "streetName": "Название улицы", 
                    "streetNumber": "163", 
                    "town": "Almaty", 
                    "district": null, 
                    "building": "1", 
                    "formattedAddress": "Almaty, Название улицы, 163, 1" 
                }, 
                "paymentMode": "EPAY", 
                "creditTerm": 0, 
                "state": "NEW", 
                "creationDate": 1732861447391, 
                "status": "DELIVERY", 
                "deliveryCost": 0.00, 
                "customer": { 
                    "firstName": "ФАМИЛИЯ", 
                    "lastName": "ИМЯ", 
                    "cellPhone": "77055555555", 
                    "iin": "111111111111" 
                }, 
                "providerType": "INTERNAL", 
                "subTotal": 1337.00, 
                "addressLetterPath": ссылка на накладную, 
                "trackNumber": 7232727967, 
                "deliveryServiceName": KAZPOST, 
                "trackUrl": https://qazpost.kz/ru/t/номер заказа, 
                "cancellationReason": null 
            }, 
            "relationships": { 
                "entries": { 
                    "links": { 
                        "self": "/api.halykmarket.com/api/merchant/v1/orders/11111111/relationships/entries", 
                        "related": "/api.halykmarket.com/api/merchant/v1/orders/11111111/entries" 
                    }, 
                    "data": [ 
                        { 
                            "type": "orderentries", 
                            "id": "11111111" 
                        } 
                    ] 
                } 
            }, 
            "links": { 
                "self": "/api.halykmarket.com/api/merchant/v1/orders/11111111" 
            } 
        } 
    ], 
    "pageCount": 1, 
    "totalCount": 1, 
    "size": 20, 
    "number": 0 
}

Атрибуты ответа:

Наименование	Описание
trackNumber	трек-номер заказа
deliveryServiceName	Курьерская служба:– CDEK: КС СДЭК– OWN_DELIVERY: КС Halyk Market– Яндекс.Доставка: КС Яндекс– KAZPOST: КС Казпочта
trackUrl	ссылка для отслеживания посылки

Вы получили информацию о курьерской службе и ссылку для отслеживания доставки по заказу в статусе DELIVERY.