Запрос getOrderStatuses
...
# | Название аттрибута | Тип | Стиль | Обязательность | Описание |
1 | sessionID | Текст | Да | Идентификатор сессии, полученный от сервера после запроса авторизации. Срок жизни сессии – 5 минут.. Если в течении этого времени в рамках сессии были проведены запросы, то срок жизни сессии увеличивается еще на 5 минут | |
2 | orders | Текст | Query | Да | Список названий/идентификаторов заказов, разделенных «*» |
Пример запроса getOrderStatuseshttp://trial.maxoptra.com/rest/2/distribution-api/orders/ getOrderStatuses?sessionID=eca3b9f1afa24988834ceb5c6aafdcbf&orders=1071088*1070773*1070807*gsdfg
Заголовки:
URL: /rest/2/distribution-api/orders/getOrderStatuses
...
# | Название поля | Описание |
1 | orderStatusResponse | |
1.1 | orders | |
1.1.1 | order | |
| Атрибут “referenceNumber” | Название/Идентификатор заказа |
| Атрибут “status” | Статус заказа. Возможные значения представлены в разделе Статусы заказов. |
| Атрибут “fullNotes” | Причина недоставки, если таковая имеется, и комментарий, введенный водителем. Возможные причины:
| |
| Атрибут “<dynamic_attribute_name>” | Данный метод позволяет получить значения дополнительных полей для заказов. Данные поля добавляются отдельно для каждого конкретного аккаунта. <dynamic_attribute_name> - название дополнительно сконфигурированного для аккаунта поля заказа. | |
| Атрибут "deliveryRate" | Оценка доставки, проставленная клиентом. | |
| Атрибут "feedback" | Комментарий клиента о доставке. | |
| 1.1.1.1 | Атрибут "orderItem name" | Наименование товара (позиции) в заказе |
| Атрибут "name" | Название товара | |
| Атрибут "barcode" | Штрих-код товара в заказе | |
| Атрибут "status" | Статус товара в заказе | |
| Атрибут "externalId" | Внешний идентификатор товара | |
| Атрибут "costPerUnit" | Цена за единицу товара | |
| Атрибут "totalCost" | Общая стоимость товара | |
| Атрибут "quantity" | Количесвто единиц товара | |
| Атрибут "actualQuantity" | Фактическое количество единиц товара | |
| Атрибут "description" | Дополнительные сведения о товаре | |
| Атрибут "failReason" | Причина отказа от товара | |
| Атрибут "comment" | Комментаний водителя | |
| 1.1.1.2 | signature | Подпись клиента (подтверждение доставки заказа). По умолчанию опция экспорта подписи клиента (электронного подтверждения доставки заказа) выключена. Для подключения данной опции обращайтесь в службу технической поддержки Максоптры. |
| Атрибут "Content-Type" | Формат подтверждения подписи format of POD signature, e.g. "image/png" with picture name | |
| 1.1.1.3 | attachments | Если в заказе есть вложение, система возвращает информацию о вложении: дату и время, комментарии, ссылку на фотографиии. |
| 1.1.1.3.1 | attachment | |
| Атрибут "date" | Дата и время, когда было сделано вложение (если есть). Система также прикладывает ссылку на фотографии. | |
| Атрибут "comment" | Комментарий к вложению (если есть). | |
1.2 | unknownReferences | |
1.2.1 | reference | Название/Идентификатор ненайденных заказов |
...