Получает несколько заказов
Возвращает информацию о заказах, принадлежащих указанной компании. Заказы могут быть отфильтрованы по номеру заказа или по ID маршрута.
Request
GET
https://courier.yandex.ru/api/v1/companies/{company_id}/orders
Path parameters
Name |
Description |
company_id* |
Type: integer<int64> ID компании, используемый в запросах к API Мониторинга. |
Query parameters
Name |
Description |
number |
Type: string Уникальный номер заказа, совпадающий с номером в базе данных компании, выполняющей доставку. |
page |
Type: integer Номер страницы в базе данных. Каждая страница содержит 1000 заказов, упорядоченных по возрастанию ID маршрута и требуемому порядку доставки. Default: Min value: |
route_id |
Type: integer<int64> ID маршрута, используемый в запросах к API Мониторинга. Min value: |
types |
Type: string<list_of_types> Список типов точек через запятую. Доступные типы — |
Responses
200 OK
Список заказов получен.
Body
application/json
[
{
"address": "string",
"description": "string",
"id": 0,
"lat": 0,
"lon": 0,
"name": "string",
"number": "string",
"time_interval": "string",
"time_zone": "string",
"route_id": 0,
"type": "string"
}
]
(OrdersNodeDepot or OrdersNodeGarage or OrdersNodeOrder)[]
OrdersNodeDepot
Name |
Description |
address |
Type: string Адрес склада в текстовом формате. Max length: |
description |
Type: string Описание склада. Max length: |
id |
Type: integer ID склада, используемый в запросах к API Мониторинга. |
lat |
Type: number<float> Широта точки расположения склада. |
lon |
Type: number<float> Долгота точки расположения склада. |
name |
Type: string Название склада. |
number |
Type: string Номер склада. Используется для синхронизации с учетной системой компании, выполняющей доставку. |
route_id |
Type: integer<int64> ID маршрута. |
time_interval |
Type: string Часы работы склада в формате "T - T" или "T-T", где T - время в формате HH, HH:MM, HH:MM:SS или [d.]HH:MM:SS. |
time_zone |
Type: string Часовой пояс склада в формате базы данных tz, например Europe/Moscow, Europe/Berlin, Asia/Irkutsk, Asia/Istanbul. Дополнительные примеры доступны по адресу https://en.wikipedia.org/wiki/List_of_tz_database_time_zones. По умолчанию часовой пояс склада рассчитывается на основе его координат. |
type |
Type: string Тип узла. Всегда равен |
OrdersNodeGarage
Name |
Description |
address |
Type: string Адрес гаража в текстовом формате. |
id |
Type: string Идентификатор гаража. |
lat |
Type: number<float> Широта точки расположения гаража. |
lon |
Type: number<float> Долгота точки расположения гаража. |
number |
Type: string Номер гаража. |
route_id |
Type: integer<int64> ID маршрута. |
type |
Type: string Тип узла. Всегда равен |
OrdersNodeOrder
Name |
Description |
address |
Type: string Адрес доставки в текстовом формате. |
amount |
Type: number<float> Стоимость заказа в рублях. Min value: |
comments |
Type: string Комментарии к заказу. |
company_id |
Type: integer<int64> ID компании, используемый в запросах к API Мониторинга. |
confirmed_at |
Type: string<datetime> Время, когда заказ был согласован. |
customer_name |
Type: string Имя заказчика. Max length: |
customer_number |
Type: string Номер клиента в базе данных компании, выполняющей доставку. Max length: |
delivered_at |
Type: string<datetime> Время, когда информация о выполнении заказа была зафиксирована в системе Яндекс.Курьер. |
description |
Type: string Описание заказа. Max length: |
eta_type |
Type: string Тип ETA. Влияет на время оповещения и автоматического определения доставки. Default: |
history |
Type: OrderHistoryItem[] История событий, изменяющих статус заказа. |
id |
Type: integer ID заказа, используемый в запросах к API Мониторинга. |
lat |
Type: number<float> Широта точки доставки. |
lon |
Type: number<float> Долгота точки доставки. |
mark_delivered_radius |
Type: number<float> Радиус в метрах. Если Default: Min value: Max value: |
number |
Type: string Номер заказа. Используется для синхронизации с учетной системой компании, выполняющей доставку. Max length: |
order_status_comments |
Type: OrderStatusUpdateComment[] |
payment_status |
Type: string Состояние оплаты. Возможные значения:
Enum: |
payment_type |
Type: string Тип оплаты. Возможные значения:
Enum: |
phone |
Type: string Телефон получателя. |
refined_lat |
Type: number<float> Широта реальной (уточнённой курьером) точки доставки. |
refined_lon |
Type: number<float> Долгота реальной (уточнённой курьером) точки доставки. |
route_id |
Type: integer<int64> ID маршрута, используемый в запросах к API Мониторинга. |
service_duration_s |
Type: integer Ожидаемое время, потраченное курьером на отгрузку товара получателю, в том числе чтобы подняться на этаж и получить оплату. Значение по умолчанию: 600 секунд. |
shared_service_duration_s |
Type: integer Продолжительность обслуживания в точке доставки, которая может быть разделена с другими заказами в том же месте. Общая продолжительность обслуживания может включать такие операции, как парковка, доставка документов и другие. Значение по умолчанию: 0 секунд. |
shared_with_companies |
Type: CompanyNumber[] |
shared_with_company_ids |
Type: number[] ID компаний, которые могут получить доступ к информации о заказе. Предоставляется следующая информация:
|
sms_delivery_confirmation |
Type: boolean Нужно ли курьеру подтверждать доставку кодом из СМС Default: |
status |
Type: string Текущий статус заказа. Возможные значения:
|
status_log |
Type: StatusLog[] |
time_interval |
Type: string Желаемое окно доставки заказа. Поддерживаются следующие форматы:
|
time_interval_secs |
Type: number[] Значение |
time_window |
Type: OrderGetWithNotificatons_time_window Допустимое окно доставки заказа в формате ISO 8601. |
type |
Type: string Тип узла. Всегда равен |
volume |
Type: number<float> Объем заказа. |
weight |
Type: number<float> Вес заказа. |
OrderHistoryItem
Name |
Description |
event |
Type: string Название случившегося события. Возможные значения: ORDER_CREATED, START, ORDER_BECAME_NEXT, STATUS_UPDATE, INTERVAL_UPDATE, ARRIVAL, ORDER_VISIT, DEPARTURE. |
position |
Type: OrderHistoryPosition Позиция курьера. Появляется только в событиях ARRIVAL, ORDER_VISIT, DEPARTURE. |
source |
Type: OrderStatusUpdateSource Источник события. Отображается только в событии STATUS_UPDATE. |
time |
Type: string<datetime> Время события в формате ISO 8601. Example: |
timestamp |
Type: number<float> Время события (UNIX-формат). |
used_mark_delivered_radius |
Type: number<float> Значение order.mark_delivered_radius или depot.mark_delivered_radius или company.mark_delivered_radius, которое использовалось для пометки заказа как посещенного. Только для событий ARRIVAL, ORDER_VISIT, DEPARTURE. Min value: Max value: |
OrderStatusUpdateComment
Name |
Description |
comment |
Type: string Комментарий к событию обновления статуса заказа. |
id |
Type: integer ID события обновления статуса заказа. |
status |
Type: string Текущий статус заказа. Возможные значения:
|
CompanyNumber
Name |
Description |
number* |
Type: string Номер компании. |
id |
Type: integer ID компании, используемый в запросах к API Мониторинга. |
name |
Type: string Название компании. Max length: |
StatusLog
Name |
Description |
point |
Type: StatusLogLocation |
status |
Type: string Текущий статус заказа. Возможные значения:
|
timestamp |
Type: number<float> UNIX timestamp времени внесения изменений. |
OrderGetWithNotificatons_time_window
Допустимое окно доставки заказа в формате ISO 8601.
Name |
Description |
end |
Type: string<datetime> Example: |
start |
Type: string<datetime> Example: |
OrderHistoryPosition
Позиция курьера. Появляется только в событиях ARRIVAL, ORDER_VISIT, DEPARTURE.
Name |
Description |
lat |
Type: number<float> Широта позиции курьера. |
lon |
Type: number<float> Долгота позиции курьера. |
time |
Type: string<datetime> Время события на клиенте в формате ISO 8601. |
OrderStatusUpdateSource
Источник события. Отображается только в событии STATUS_UPDATE.
Name |
Description |
initiator |
Type: string Инициатор события, возможные значения: yandex, app, user_api. |
StatusLogLocation
Name |
Description |
lat |
Type: number<float> Широта точки внесения изменений. |
lon |
Type: number<float> Долгота точки внесения изменений. |
401 Unauthorized
Ошибка авторизации. Убедитесь, что заголовок запроса содержит правильный OAuth-токен.
403 Forbidden
У вас нет доступа к этому объекту.
404 Not Found
Указанного route_id не существует.
422 Unprocessable Entity
Неверный ввод. Операция не может быть выполнена.
504 Gateway Timeout
Ошибка при работе с API. Повторите запрос.
No longer supported, please use an alternative and newer version.