--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/en/delivery/specifics.md - https://yandex.kz/routing/doc/kk/delivery/specifics.md - https://yandex.kz/routing/doc/ru/delivery/specifics.md - href: kk/delivery/specifics.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/kk/llms.txt # Особенности работы и ограничения ## Политика опроса API {#queries} - Таймаут ответа API составляет 60 секунд. - Один batch-запрос не должен содержать больше тысячи объектов. Если требуется передать больше данных, разделите их на несколько запросов. - В редких случаях (менее одного процента запросов) API возвращает ошибку 504 Gateway Timeout. При получении такой ошибки отправляйте повторные запросы с растущей задержкой. Подробнее см. в разделе [Ошибки сервиса](https://yandex.kz/routing/doc/kk/vrp/error-handling.md#service-unavailable). - Чтобы получить результат выполнения задачи на русском или английском языке, добавьте параметр `lang` со значением `ru` или `en` соответственно в конец запроса на [добавление задачи](https://yandex.kz/routing/doc/kk/vrp/add-task.md). ## Ограничения API {#limitations} - Точность геокодирования адресов заказов не проверяется. Адрес в текстовом виде (задается параметром [address](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsAnOrder)) и координаты заказа (задаются параметрами [lat](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsAnOrder) и [lon](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/addsAnOrder)) должны соответствовать друг другу. Для построения маршрута используются геокоординаты. При недостаточной точности геолокации приложение может привести курьера не в ту точку, которая указана в приложении текстом. Распространенная ошибка в данных: адрес указан до дома, а геокоординаты указывают на середину улицы. - Каскадное удаление сущностей не поддерживается. Лишние сущности с зависимостями от других сущностей можно не удалять, они не мешают работе. ## Изменения в заказах {#changes} - При переносе отмененного заказа на другой день нужно присвоить ему статус `new`. В противном случае заказ добавится в маршрут на новый день в статусе `cancelled`. - При изменении заказа необходимо обновлять только измененные атрибуты. В противном случае данные, полученные от курьера, будут перезаписаны. Например, курьер уже доставил заказ, а учетная система вернула заказу статус `new` при обновлении другого поля. - После загрузки заказов нужно проверить их с помощью ресурса [verification](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsOrderInformation). Это позволяет убедиться в отсутствии ошибок. В противном случае курьер может не получить часть заказов. Такая проверка должна производиться ежедневно и в автономном режиме до выезда первого курьера. - Значение `route_number` должно быть уникальным в рамках всего периода использования API. - Поля с типом `number` и `integer` отправляются без кавычек, поля с типом `string` отправляются в кавычках. Поля с типом `string` должны передаваться в кодировке UTF-8. ## Сервисное время склада {#service-duration} При экспорте решений из Планирования в Мониторинг значение сервисного времени склада (`depot.service_duration_s`) по умолчанию равно 0, даже если оно было [задано при планировании](https://yandex.kz/routing/doc/kk/vrp/properties-of-depot.md#depot-service-duration). Чтобы задать сервисное время для склада в Мониторинге, отправьте PATCH-запрос к ресурсу [depots](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsDepot): ``` curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X PATCH -d @<Путь_до_файла_в_кодировке_UTF-8> https://courier.yandex.ru/api/v1/companies//depots/ ``` Файл: ```json { "service_duration_s": <значение> } ``` ## Формат номера телефона {#phone} При добавлении телефона убедитесь, что: * Формат номера поддерживается терминалом мобильного сотрудника. * Номер телефона указан полностью. * Формат зарубежного номера соответствует правилам нумерации, принятым в этой стране или Международной системе телефонных номеров. ## Порядок загрузки данных {#section_dq2_fqv_vgb} Рекомендуется следующий порядок загрузки данных: 1. Склады. 1. Курьеры. 1. Маршруты. 1. Заказы. Другой порядок загрузки может привести к ошибкам при обращении к объектам, которые еще не загружены. ## Рекомендованный способ загрузки данных {#section_eq2_fqv_vgb} Для загрузки и обновления данных рекомендуется использовать `batch`-запросы, загружающие массив данных: [depots-batch](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsMultipleDepots), [couriers-batch](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsMultipleMobileEmployees), [routes-batch](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsMultipleRoutes), [orders-batch](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/editsMultipleOrders). Каждому загружаемому объекту присваивается: - Уникальный номер, используемый в запросах к API Мониторинга. Записывается в полях с постфиксом `_id`, например `depot_id`. - Уникальный номер, совпадающий с номером в базе данных компании, выполняющей доставку. Записывается в полях с постфиксом `_number`, например `depot_number`. Существующие данные при batch-загрузке обновляются. {% note info %} Каждый вызов является ACID-транзакцией. Ошибка в вызове batch-ресурса приводит к отмене всех изменений, вносимых в этом вызове. Потери можно минимизировать, разбив данные на несколько пакетов. В этом случае будут потеряны только изменения в пакете с ошибкой. {% endnote %} ## Срок хранения данных {#data-retention-period} Данные хранятся на серверах Яндекса ограниченное время: - Треки движения курьеров: 1 месяц от даты маршрута. - Фотографии, присланные курьерами для подтверждения доставки: 3 месяца от даты добавления фотографии. - Данные мониторинга (заказы, маршруты): 1 год. - Данные для построения [отчетов План / Факт](https://yandex.kz/routing/doc/kk/delivery/functions/working-with-plan-fact.md): 18 месяцев. - Ссылка на отслеживание заказа в [клиентском виджете](https://yandex.kz/routing/doc/kk/delivery/functions/client-widget.md): 15 дней. - Трек движения курьера в [клиентском виджете](https://yandex.kz/routing/doc/kk/delivery/functions/client-widget.md): 1 сутки. - Координаты курьеров хранятся в приложении Яндекс Маршрутизация 1 день. Если нет доступа к интернету, данные сохранятся локально и передадутся, когда интернет появится. После окончания срока хранения данные могут быть безвозвратно удалены, однако сервис оставляет за собой право сохранить их. [//]: # (Вариант без html\: \[Написать в службу поддержки\]\(../../../feedback.md\))