Получить статусы заказа

Запрос позволяет получить историю статусов заказа.

  1. Синтаксис запроса
  2. Пример запроса
  3. Структура ответа

Синтаксис запроса

POST /api/last/getSenderOrderStatuses
Host: delivery.yandex.ru 
Content-Type:application/x-www-form-urlencoded
... 

secret_key=<секретный ключ>
&client_id=<идентификатор аккаунта в Яндекс.Доставке>
&order_id=<идентификатор заказа>
&sender_id=<идентификатор магазина>

Параметры:

Параметр Тип Значение
Обязательные
secret_key Строка

Секретный ключ.

client_id Число

Идентификатор аккаунта в Яндекс.Доставке.

Значение можно получить в личном кабинете Яндекс.Доставки, в разделе Настройки, на вкладке Интеграция → API.

sender_id Число

Идентификатор магазина.

Значение можно получить в личном кабинете Яндекс.Доставки, в разделе Настройки, на вкладке Интеграция → API.

order_id Число

Идентификатор заказа.

Значение можно получить с помощью запроса Получить список заказов магазина.

Параметр Тип Значение
Обязательные
secret_key Строка

Секретный ключ.

client_id Число

Идентификатор аккаунта в Яндекс.Доставке.

Значение можно получить в личном кабинете Яндекс.Доставки, в разделе Настройки, на вкладке Интеграция → API.

sender_id Число

Идентификатор магазина.

Значение можно получить в личном кабинете Яндекс.Доставки, в разделе Настройки, на вкладке Интеграция → API.

order_id Число

Идентификатор заказа.

Значение можно получить с помощью запроса Получить список заказов магазина.

Пример запроса

POST /api/last/getSenderOrderStatuses HTTP/1.1
Host: delivery.yandex.ru
Content-Type:application/x-www-form-urlencoded
...

secret_key=6f08ebd49a996fcb6666fc130f491a2d&client_id=79&sender_id=3&order_id=215000001
cURL
curl  -d 'secret_key=6f08ebd49a996fcb6666fc130f491a2d&client_id=79&sender_id=3&order_id=215000001' 'https://delivery.yandex.ru/api/last/getSenderOrderStatuses'

Структура ответа

{
  "status":"ok",
  "data":
    { 
      "data":
        [ 
          { 
            "time":"2017-03-10 16:15:12",
            "description":"",
            "uniform_status":"DRAFT",
            "status":"Ждет обработки"
          },
          {
            "time":"2017-03-10 17:15:12",
            "description":"",
            "uniform_status":"CREATED",
            "status":"Обрабатывается"
          },
          {
            "time":"2017-03-13 16:15:12",
            "description":"",
            "uniform_status":"DELIVERY_LOADED",
            "status":"Обрабатывается"
          }
        ],
      "info":
        {
          "address":"шоссе Головинское 5",
          "search_address":"шоссе Головинское 5"
        }
    }
}
Ключ Тип значения Описание
status Строка

Статус выполнения запроса.

Возможные значения:
  • ok — запрос выполнен успешно.
  • error — запрос выполнен с ошибкой.
data Объект Данные ответа.
Ключи объекта data
data Массив Статусы заказа.
info Объект Адрес получателя.
Ключи объекта data/data
time Строка

Дата и время установки статуса.

Указана в формате «YYYY-MM-DD hh:mm:ss».

description Строка Дополнительное описание.
uniform_status Строка

Статус заказа (кодовое название).

Возможные значения:
  • DRAFT — заказ доступен для редактирования.
  • CREATED — заказ проверен и отправлен в службу доставки.
  • SENDER_SENT — заказ ожидает подтверждения от службы доставки.
  • DELIVERY_LOADED — заказ подтвержден службой доставки.
  • SENDER_WAIT_FULFILMENT — заказ ожидается на едином складе.
  • SENDER_WAIT_DELIVERY — заказ ожидается в службе доставки.
  • FULFILMENT_LOADED — заказ подтвержден единым складом.
  • FULFILMENT_ARRIVED — заказ находится на едином складе.
  • FULFILMENT_PREPARED — заказ готов к передаче в службу доставки.
  • FULFILMENT_TRANSMITTED — заказ передан в службу доставки.
  • DELIVERY_AT_START — заказ находится на складе службы доставки.
  • DELIVERY_TRANSPORTATION — заказ доставляется.
  • DELIVERY_ARRIVED — заказ находится в населенном пункте получателя.
  • DELIVERY_TRANSPORTATION_RECIPIENT — заказ доставляется по населенному пункту получателя.
  • DELIVERY_ARRIVED_PICKUP_POINT — заказ находится в пункте самовывоза.
  • DELIVERY_DELIVERED — заказ доставлен получателю.
  • RETURN_PREPARING — заказ готовится к возврату.
  • RETURN_ARRIVED_DELIVERY — заказ возвращен на склад службы доставки.
  • RETURN_ARRIVED_FULFILMENT — заказ возвращен на единый склад.
  • RETURN_PREPARING_SENDER — заказ возвращается в магазин.
  • RETURN_RETURNED — заказ возвращен в магазин.
  • LOST — заказ утерян в процессе доставки.
  • UNEXPECTED — статус заказа уточняется.
  • CANCELED — заказ отменен.
  • ERROR — произошла ошибка.
status Строка

Название статуса заказа.

Возможные значения:
  • «Черновик»;

  • «Ждет обработки»;

  • «Ждёт подтверждения службы доставки»;

  • «Готов к передаче в службу доставки»;

  • «Ожидается в службе доставки»;

  • «Ожидается на едином складе»;

  • «Обрабатывается»;

  • «На едином складе»;

  • «Передан в службу доставки»;

  • «Передан на единый склад»;

  • «Подтверждён службой доставки»;

  • «Подтверждён единым складом»;

  • «На складе службы доставки»;

  • «Доставляется»;

  • «В пункте самовывоза»;

  • «В городе покупателя»;

  • «Доставляется по городу»;

  • «Готовится к возврату»;

  • «Возвращается в магазин»;

  • «Возвращён на склад службы доставки»;

  • «Возвращён в магазин»;

  • «Доставлен»;

  • «Утерян»;

  • «Отменён»;

  • «Статус уточняется».

Ключи объекта data/info
address Строка Адрес получателя.
search_address Строка Служебное поле.
Ключ Тип значения Описание
status Строка

Статус выполнения запроса.

Возможные значения:
  • ok — запрос выполнен успешно.
  • error — запрос выполнен с ошибкой.
data Объект Данные ответа.
Ключи объекта data
data Массив Статусы заказа.
info Объект Адрес получателя.
Ключи объекта data/data
time Строка

Дата и время установки статуса.

Указана в формате «YYYY-MM-DD hh:mm:ss».

description Строка Дополнительное описание.
uniform_status Строка

Статус заказа (кодовое название).

Возможные значения:
  • DRAFT — заказ доступен для редактирования.
  • CREATED — заказ проверен и отправлен в службу доставки.
  • SENDER_SENT — заказ ожидает подтверждения от службы доставки.
  • DELIVERY_LOADED — заказ подтвержден службой доставки.
  • SENDER_WAIT_FULFILMENT — заказ ожидается на едином складе.
  • SENDER_WAIT_DELIVERY — заказ ожидается в службе доставки.
  • FULFILMENT_LOADED — заказ подтвержден единым складом.
  • FULFILMENT_ARRIVED — заказ находится на едином складе.
  • FULFILMENT_PREPARED — заказ готов к передаче в службу доставки.
  • FULFILMENT_TRANSMITTED — заказ передан в службу доставки.
  • DELIVERY_AT_START — заказ находится на складе службы доставки.
  • DELIVERY_TRANSPORTATION — заказ доставляется.
  • DELIVERY_ARRIVED — заказ находится в населенном пункте получателя.
  • DELIVERY_TRANSPORTATION_RECIPIENT — заказ доставляется по населенному пункту получателя.
  • DELIVERY_ARRIVED_PICKUP_POINT — заказ находится в пункте самовывоза.
  • DELIVERY_DELIVERED — заказ доставлен получателю.
  • RETURN_PREPARING — заказ готовится к возврату.
  • RETURN_ARRIVED_DELIVERY — заказ возвращен на склад службы доставки.
  • RETURN_ARRIVED_FULFILMENT — заказ возвращен на единый склад.
  • RETURN_PREPARING_SENDER — заказ возвращается в магазин.
  • RETURN_RETURNED — заказ возвращен в магазин.
  • LOST — заказ утерян в процессе доставки.
  • UNEXPECTED — статус заказа уточняется.
  • CANCELED — заказ отменен.
  • ERROR — произошла ошибка.
status Строка

Название статуса заказа.

Возможные значения:
  • «Черновик»;

  • «Ждет обработки»;

  • «Ждёт подтверждения службы доставки»;

  • «Готов к передаче в службу доставки»;

  • «Ожидается в службе доставки»;

  • «Ожидается на едином складе»;

  • «Обрабатывается»;

  • «На едином складе»;

  • «Передан в службу доставки»;

  • «Передан на единый склад»;

  • «Подтверждён службой доставки»;

  • «Подтверждён единым складом»;

  • «На складе службы доставки»;

  • «Доставляется»;

  • «В пункте самовывоза»;

  • «В городе покупателя»;

  • «Доставляется по городу»;

  • «Готовится к возврату»;

  • «Возвращается в магазин»;

  • «Возвращён на склад службы доставки»;

  • «Возвращён в магазин»;

  • «Доставлен»;

  • «Утерян»;

  • «Отменён»;

  • «Статус уточняется».

Ключи объекта data/info
address Строка Адрес получателя.
search_address Строка Служебное поле.