This method is used to get information about orders included in one consignment by its reference. For this method, API uses Данный метод используется для получения информации о заказах, входящих в групповой заказ по его идентификатору. Для получения статусов API использует структуру application/x-www-form-urlencoded as its acceptable request representation (Media Type), and the standard и стандартный HTTP-method метод POST.Input for getConsignment request
Входные данные запроса getConsignment
...
# |
---|
Название атрибута |
---|
Тип |
---|
Обязательность |
---|
Описание | |
---|---|
1 | sessionID |
текст |
Да | Идентификатор сессии, полученный от сервера после запроса авторизации. |
1 |
consignmentReferences |
число |
Headers:
Да | Идентификационный номер группового заказа (пара связанных заказов Pickup & Delivery). |
Заголовки:
Метод: POST
URL: [account-name].maxoptra.com/rest/2/distribution-api/orders/getConsignment
Method: POST
Acceptable request representationsСтруктура: application/x-www-form-urlencoded
All attributes should be sent in request parameters for this request.
Request parametersДля этого запроса все атрибуты должны находиться в параметрах запроса.
Параметры запроса: sessionID=eca3b9f1afa24988834ceb5c6aafdcbf&consignmentReferenceconsignmentReferences=bo1*bo2*gsdfgExample of getConsignment response
Пример ответа 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="PickupAndDelivery" status="NEW"/> ="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="PickupAndDelivery"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