---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.kz/routing/doc/ru/oob/parameters/order-list.md
  - href: ru/oob/parameters/order-list.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: Яндекс Маршрутизация — экспресс-доставка — параметры заказов
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/ru/llms.txt


# Параметры заказов

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

Обязательным атрибутом заказа является уникальный идентификатор, который задается в поле `client_order_id`. Он не должен повторяться в течение дня и на протяжении всего периода планирования. Для соблюдения уникальности добавляйте к идентификатору текущую дату. Например, `Order1 2025-01-01`.

## Местоположение заказа

Корректность адреса или координат имеет большое значение для получения хороших результатов прогнозирования маршрута.

Для передачи адреса используется блок `address`. Уделите внимание тому, как в вашей системе появляются и хранятся адреса:

* Если клиенты указывают адреса в форме на сайте, рекомендуем подключить проверку ввода адресов (например, [проверку Яндекса](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/examples/)).

* Если адреса вводят сотрудники компании, рекомендуем упорядочить процесс ввода. Часто адрес набирают сплошной строкой, в том же поле сохраняют комментарий и информацию по окну доставки.

Для определения координат заказа используются поля `coordinates.latitude` и `coordinates.longitude`. Важно убедиться, что координаты не перепутаны местами и нет координат, которые по значениям сильно отличаются от остальных.

## Политика доставки

#|
||

**Параметр**

|

**Описание**

|

**Тип**

||
||

`type`

|

Тип политики доставки

|

Строка

||
||

`deadline`

|

Точное время

|

Дата и время в формате ISO 8601 и RFC 3339

||
||

`time_interval`

|

Временной интервал

|

Дата и время в формате ISO 8601 и RFC 3339

||
|#

## Содержимое заказа

Список товаров в заказе передается в блоке `content.verbose_item_list`. Для корректного распределения нагрузки на курьеров указывайте в блоке `content.dimensions` размеры заказа:

#|
||

**Параметр**

|

**Описание**

|

**Тип**

||
||

`weight_gross_g`

|

Вес заказа (в граммах)

|

Целое число

||
||

`units_count`

|

Количество единиц товара

|

Целое число

||
|#

## Совместимость заказа и курьеров {#order-tags}

При определении заказа в запросе к Маршрутизации возможно назначить [список требований к курьеру](https://yandex.kz/routing/doc/ru/oob/parameters/courier-list.md#courier-tags), который должен выполнить данный заказ.

Правила совместимости курьеров и заказов (теги заказа) задаются в параметре `order_list.required_tag_list`. Они должны совпадать со свойствами курьеров.

## Приоритет заказа

Приоритет заказа задается в поле `order_priority`. Возможны следующие значения:

* `standard`;
* `express`.

## Продолжительность этапов заказа

#|
||

**Параметр**

|

**Описание**

|

**Тип**

||
||

`order_preparing_duration_s`

|

Время подготовки заказа (в секундах)

|

Целое число

||
||

`source_order_exchange_service_duration_s`

|

Время передачи заказа курьеру на стартовой точке (в секундах)

|

Целое число

||
||

`destination_order_exchange_service_duration_s`

|

Время вручения заказа на точке назначения (в секундах)

|

Целое число

||
|#

## Информация о платеже

В поле `payment_method` передайте информацию о платеже — метод оплаты заказа без персональных или платежных данных.

## Информация о получателе заказа

В поле `recipient_id` передайте информацию о получателе — идентификатор без персональных данных.