--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/en/delivery/faq.md - https://yandex.kz/routing/doc/kk/delivery/faq.md - https://yandex.kz/routing/doc/ru/delivery/faq.md - href: ru/delivery/faq.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 # Часто задаваемые вопросы ## Общие вопросы {#common-problem} {% cut "Как подключиться к Мониторингу?" %} Для подключения к API Мониторинга напишите нам на почту [routing@yandex-team.ru](mailto:routing@yandex-team.ru). {% endcut %} {% cut "Я перенес заказ на следующий день, но он отмечен как отмененный. В чем дело?" %} При переносе заказа на другой день укажите ему статус `new`. {% endcut %} {% cut "При загрузке маршрутов в Мониторинг возникает предупреждение о том, что маршруты на дату уже есть. Что делать?" %} Предупреждение означает, что маршруты на этот день уже были добавлены ранее. Нужно выбрать подходящий вариант действий со старыми и новыми маршрутами. Подробнее см. в разделе [Загрузка данных](https://yandex.kz/routing/doc/ru/delivery/load-data.md#additional-load). {% endcut %} {% cut "При загрузке маршрутов в Мониторинг возникает предупреждение о повторяющихся заказах. Что делать?" %} Предупреждение означает, что в маршрутах есть дубликаты — заказы с повторяющимися номерами. Возможные действия с дубликатами описаны в разделе [Загрузка данных](https://yandex.kz/routing/doc/ru/delivery/load-data.md#duplicate-orders). {% endcut %} {% cut "Как изменить подключаемые опции?" %} Некоторые возможности по умолчанию недоступны в мобильном приложении для курьеров. Вы можете подключить или отключить их только через службу поддержки. Изменения вступят в силу после того, как курьер перезапустит приложение. {% endcut %} {% cut "Почему при загрузке маршрутов в Мониторинг возникает ошибка `429 (Too many requests)`?" %} Эта ошибка появляется при нарушении лимитов, заданных для Мониторинга. Например, если пользователь параллельно загружает в систему больше 5 маршрутов. Чтобы решить проблему, уменьшите количество параллельных запросов или обратитесь в службу поддержки. {% endcut %} ## Авторизация {#authorization} {% cut "Как правильно передать OAuth-токен в запросе?" %} OAuth-токен передается в заголовке Authorization. {% endcut %} {% cut "Я использую правильный OAuth-токен, но получаю ответ 401 Unauthorized. В чем дело?" %} Возможные причины: - Истек срок действия OAuth-токена. Если вы не использовали токен более 1 месяца он может быть отозван. - Был изменен пароль от аккаунта с [Яндекс ID](https://id.yandex.ru/). - Была включена или выключена [двухфакторная аутентификация](https://yandex.ru/support/id/authorization/twofa.html). - В аккаунте с Яндекс ID была нажата кнопка **Выйти на всех устройствах**. - В параметре `Authorization` указан токен без добавления OAuth. - Правильно: `Authorization: OAuth <ваш-OAuth-токен>`. - Неправильно: `Authorization: <ваш-OAuth-токен>`. Подробнее о причинах отзыва токена можно прочитать на странице [Отзыв токена](https://yandex.ru/dev/id/doc/ru/tokens/token-invalidate). Для продолжения работы необходимо получить новый токен. Последовательность действий описана на странице [Получение OAuth-токена](https://yandex.kz/routing/doc/ru/delivery/quickstart/register.md#oauth-token). {% endcut %} {% cut "Я потерял OAuth-токен. Как его восстановить?" %} Для восстановления OAuth-токена, получите его еще раз как указано в пункте 9 инструкции на странице [Получение OAuth-токена](https://yandex.kz/routing/doc/ru/delivery/quickstart/register.md). При повторном получении таким образом ключ не меняется. {% endcut %} {% cut "Почему я получаю ответ `403 (Company apikey is unknown or banned)` или `403 (Company apikey is invalid)?`" %} Для работы API нужно указать валидный API-ключ в разделе **Настройки** → **Компания** → **API Key** [Рабочего места логиста](https://yandex.ru/courier/companies). Проверить, что ваш ключ валиден, или получить новый ключ можно в [Кабинете разработчика](https://developer.tech.yandex.ru/) для сервиса **Маршрутизация: Планирование и Мониторинг**. {% endcut %} {% cut "Почему я получаю ошибку `403 Your role doesn't allow to make this request`?" %} Эта ошибка означает, что у используемой учетной записи недостаточно прав для выполнения запроса. Учетная запись определяется по используемому в запросе OAuth-токену. Чтобы решить проблему, назначьте учетной записи роль **Администратор** в разделе **Настройки** → **Менеджеры** [Рабочего места логиста](https://yandex.ru/courier/companies). {% endcut %} ## Отслеживание заказов {#tracking} {% cut "Почему в треках курьеров в Рабочем месте логиста машины перескакивают сразу на большие расстояния?" %} **Симптомы** : При просмотре истории перемещения курьера иногда его машина резко перемещается по маршруту, как будто часть трека не записалась. **Вероятная причина** : Во время выполнения маршрута курьер сворачивает приложение Яндекс Маршрутизация и устройство выгружает его из оперативной памяти телефона. **Как устранить** : Необходимо внести приложение Яндекс Маршрутизация в исключения в настройках оптимизации батареи телефона. {% cut "Пример настройки на телефонах Huawei" %} - Зайдите в меню **Настройки** → **Батарея** → **Запуск приложений**. - Найдите приложение Яндекс Маршрутизация и снимите с него флаг. - В появившемся окне **Управление вручную** убедитесь, что установлены все флаги. {% endcut %} На разных моделях телефонов, меню настроек может отличаться. Если вы не смогли найти соответствующие настройки, обратитесь в техническую поддержку, и мы постараемся вам помочь. {% endcut %} {% cut "Почему в треках курьеров в Рабочем месте логиста машины прыгают на большие расстояния в сторону от основного маршрута?" %} **Симптомы** : При просмотре истории перемещения курьера иногда его машина резко перемещается в сторону от маршрута. **Вероятная причина** : Приложению не удалось получить точные координаты. **Как устранить** : Телефон курьера должен использовать только источник GPS или источник «только с устройства (Device only)», вместо режима определения местоположения сразу с нескольких источников (Wi-Fi, сотовая связь, GPS). {% endcut %} {% cut "Можно ли включить «счетчик» времени простоя, если курьер находится по адресу доставки дольше, чем планировалось?" %} В Мониторинге нет счетчика времени простоя. Для оценки качества работы курьера: * определите время без движения, после которого начинается отсчет [простоя](https://yandex.kz/routing/doc/ru/delivery/functions/idle.md#idle-setting) — `idle_time_window_s`. По умолчанию `idle_time_window_s` = 1800 (30 минут). Значение параметра изменяется через службу поддержки и задается на всю компанию; * используйте отчет [Качество работы курьеров](https://yandex.kz/routing/doc/ru/delivery/interface/quality-report.md). Он включает поле [Простой на точке, мин](https://yandex.kz/routing/doc/ru/delivery/interface/quality-report.md#fields), значения которого можно использовать для анализа и дальнейших расчетов. {% endcut %} ## Сообщения по заказам {#messages} {% cut "Какие виды уведомлений по заказам доступны?" %} Есть 2 вида уведомлений о доставке заказа: - Уведомление `shift_start` появляется в системе когда курьер начинает движение по маршруту. - Уведомление `nearby` появляется в системе за некоторое время (по умолчанию — 30 минут) до расчетного времени прибытия на точку доставки. Расчетное время прибытия вычисляется автоматически при движении курьера по маршруту. [Подробнее о получении информации об уведомлениях](https://yandex.ru/routing/doc/ru/delivery/redoc/index.html#operation/getsOrderNotifications) {% endcut %} {% cut "Когда в системе появляется уведомление shift_start?" %} Уведомление `shift_start` как правило появляется во время, указанное в поле `route.route_start`, при условии что есть информация о позиции курьера, выполняющего доставку. Если у сервиса Мониторинга нет информации о координатах курьера (например, координаты стали поступать только после указанного в поле `route_start` времени), уведомление появится только при получении этих данных. Если параметр `route.route_start` не задан, то уведомление появится в системе в момент начала самого раннего временного окна из всех заказов. Также, если для склада (`depot`) задан параметр (`mark_route_started_radius`), то уведомление для привязанных к складу маршрутов не появится в системе до тех пор, пока курьер будет находится в радиусе склада. {% endcut %} {% cut "Почему уведомление не появилось в системе?" %} Потенциальные причины могут быть следующие: 1. Сервис уведомлений не подключен. Для подключения сервиса, обратитесь к менеджеру. 1. Курьер не зашел в приложение или не выбрал маршрут. 1. Курьер начал выполнение маршрута после завершения временного окна доставки. Например, если курьер начал маршрут в 10:30 при окне доставки с 8:00 до 10:00, то уведомление по заказу не появится в системе. 1. Данные о местоположении с GPS-трекера не отправлялись в сервис. В этом случае в [Рабочем месте логиста](https://yandex.ru/courier/companies) вы увидите, что данные о местоположении курьера отсутствуют. {% endcut %} Написать в службу поддержки [//]: # (Вариант без html\: \[Написать в службу поддержки\]\(../../../feedback.md\))