Данный метод используется для получения информации о заказах, входящих в групповой заказ по его идентификатору. Для получения статусов API использует структуру application/x-www-form-urlencoded и стандартный HTTP-метод POST.
Входные данные запроса getConsignment
# | Название атрибута | Тип | Обязательность | Описание |
---|---|---|---|---|
1 | sessionID | текст | Да | Идентификатор сессии, полученный от сервера после запроса авторизации. |
1 | consignmentReferences | число | Да | Идентификационный номер группового заказа (пара связанных заказов Pickup & Delivery). |
Заголовки:
Метод: POST
URL: [account-name].maxoptra.com/rest/2/distribution-api/orders/getConsignment
Структура: application/x-www-form-urlencoded
Для этого запроса все атрибуты должны находиться в параметрах запроса.
Параметры запроса: sessionID=eca3b9f1afa24988834ceb5c6aafdcbf&consignmentReferences=bo1*bo2
Пример ответа getConsignment:
Code Block |
---|
<?xml version='1.0' encoding='UTF-8'
standalone='yes' ?>
<apiResponse version="1.0">
<consignmentResponse>
<consignments>
<consignment consignmentReference="bo2">
<orders>
<order referenceNumber="2311_3" linkType="PickupAndDelivery" status="NEW"/>
<order referenceNumber="2311_4" linkType="PickupAndDelivery" status="NEW"/>
</orders>
</consignment>
<consignment consignmentReference="bo1">
<orders>
<order referenceNumber="2311_1" linkType="PND" status="ALLOCATED">
<orderItem name="Пакет 1" barcode="12345678" status="NOT_CHECKED" costPerUnit="10" totalCost="10" quantity="1" />
<orderItem name="Пакет 2" barcode="987654321" status="NOT_CHECKED" costPerUnit="20" totalCost="60" quantity="3" />
<aggregatedItemsStatus actualDelivery="0" scheduledDelivery="2" completionStatus="NOT_DELIVERED" />
</order>
<order referenceNumber="2311_2" linkType="PND" status="ALLOCATED"></order>
</orders>
</consignment>
</consignments>
</consignmentResponse>
</apiResponse> |
Если один из связанных заказов содержит товары, информация о них также вернется в ответе getConsignment.
Code Block | ||
---|---|---|
| ||
<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
<apiResponse version="1.0">
<consignmentResponse>
<consignments>
<consignment consignmentReference="4366700843117298688">
<orders>
<order referenceNumber="mID5205913" linkType="PND" status="NEW">
<orderItem name="test1" barcode="1008105964500552" status="NOT_CHECKED" costPerUnit="0" totalCost="0" quantity="0" actualQuantity="0" />
<orderItem name="test2" barcode="2521250862053500" status="NOT_CHECKED" costPerUnit="0" totalCost="0" quantity="0" actualQuantity="0" />
</order>
<order referenceNumber="mID5205917" linkType="PND" status="NEW">
<orderItem name="test3" barcode="54654532583386658" status="NOT_CHECKED" costPerUnit="0" totalCost="0" quantity="0" actualQuantity="0" />
<orderItem name="test4" barcode="54561646465455" status="NOT_CHECKED" costPerUnit="0" totalCost="0" quantity="0" actualQuantity="0" />
<orderItem name="eqw" barcode="eqweqw" status="NOT_CHECKED" costPerUnit="0" quantity="0" />
</order>
</orders> </consignment> </consignments>
</consignmentResponse>
</apiResponse> |
...
См. также
Функциональность Pickup & Delivery