Запрос getOrdersLog
Для получения данных по изменению статусов заказов в приложении API использует структуру application/xml и HTTP метод POST.
Входные данные запроса getOrdersLog
# | Field name | Data type | Length | Mandatory | Description |
1 | sessionID | Текст |
| Да | Идентификатор сессии, полученный от сервера после запроса авторизации. Срок жизни сессии – 5 минут.. Если в течении этого времени в рамках сессии были проведены запросы, то срок жизни сессии увеличивается еще на 5 минут |
2 | filter |
|
|
|
|
2.1 | limit | Целое число |
| Нет | Максимальное количество статусов, которое должна вернуть система |
2.2 | date |
|
|
|
|
2.2.1 | begin |
|
| Нет | Начало временного интервала для выбора изменений. Формат – “ГГГГ-ММ-ДДTЧЧ:ММ:СС.00Z” |
2.2.2 | end |
|
| Нет | Окончания временного интервала для выбора изменений. Формат – “ГГГГ-ММ-ДДTЧЧ:ММ:СС.00Z” |
Пример запроса getOrdersLog
Заголовки:
URL: /rest/2/distribution-api/orders/getOrdersLog
Метод: POST
Структура: application/xml
XML:
<?xml version=”1.0” encoding=”UTF-8” standalone=”yes”?>
<apiRequest>
<sessionID>38a0e5953a744ff8be3a928453d735a6</sessionID>
<filter>
<limit>5000</limit>
<date>
<begin>2014-12-26T00:00:10.00Z</begin>
<end>2014-12-26T23:54:10.00Z</end>
</date>
</filter>
</apiRequest>
Ответ getOrdersLog
Для получения данных по изменению статусов заказов API использует структуру application/xml в качестве структуры ответа.
Output for getOrdersLog response
# | Field name | Description |
1 | Orders |
|
1.1 | Order |
|
| Атрибут “referenceNumber” | Название/Идентификатор заказа |
| Атрибут “status” | Статус заказа. Возможные значения представлены в Приложении 3. |
| Атрибут “type” | Тип заказа. DO – Доставка PU – Сбор |
| Атрибут “date” | Дата и время изменения статуса |
| Атрибут “author” | Имя пользователя, от имени которого совершено действие |
| Атрибут “shortNotes” | Название действия |
| Атрибут “fullNotes” | Расшифровка действия |
| Атрибут “fullNotes” | Причина недоставки если таковая имеется и комментарий введенный водителем. Возможные причины:
|
Пример ответа getOrdersLog
<apiResponse version="1.0">
<apiResponse>
<orders>
<order referenceNumber="TEST-00088570301214" status="FAILED" type="DO" date="2014-12-29T16:50:06.000Z" author="Alexander" shortNotes="created_from_import" fullNotes="Обстоятельства непреодолимой силы: Комментарий водителя "/>
</orders>
</apiResponse>
</apiResponse>