Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


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

...

#
Attribute name
Название атрибута
Type
Тип
Mandatory
Обязательность
Description
Описание
1sessionID
string
текст
YesA session identifier that has been fetched from the server using authentication request
ДаИдентификатор сессии, полученный от сервера после запроса авторизации.
1
consignmentReference
consignmentReferences
number
число
YesReference number of a consignment (a pair of linked P&D orders) in question.

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
titleExample of Order Items in getConsignment response
<?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>


...

См. также

Методы API. Заказы

save

deleteConsignment

Функциональность Pickup & Delivery