--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/en/vrp/faq.md - https://yandex.kz/routing/doc/kk/vrp/faq.md - https://yandex.kz/routing/doc/ru/vrp/faq.md - href: ru/vrp/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 # Часто задаваемые вопросы ## Задача планирования {#planning-task} {% cut "Как получить исходные данные задачи?" %} Чтобы посмотреть исходные данные задачи, используйте ссылку `https://courier.yandex.ru/api/integration/v1/solver-task//fetch-request/`, где: * `` — тип задачи: `mvrp` или `svrp`; * `` — идентификатор решенной задачи. {% endcut %} {% cut "Как геокодировать адреса для задачи планирования?" %} Геокодирование адресов зависит от способа запуска задачи. Если вы запускаете планирование: - через API — предварительно обработайте адреса в сервисе [Геокодер](https://yandex.ru/dev/maps/geocoder/); - в интерфейсе — адреса автоматически обработает встроенный геокодер (см. подробнее в подразделе [Карта](https://yandex.kz/routing/doc/ru/vrp/interface-import.md#map) раздела **Окно импорта**). {% endcut %} {% cut "Есть ли ограничения на одновременное количество запусков задач в Планировании?" %} Да, есть. По умолчанию с одного [ключа доступа](https://yandex.kz/routing/doc/ru/vrp/authorization.md#api-key) запускается не более десяти параллельных планирований. {% endcut %} {% cut "Можно ли задать вручную время расчета планирования?" %} В разделе [Время обработки запроса](https://yandex.kz/routing/doc/ru/vrp/request-processing-time.md) приведено стандартное время планирования для настройки `Оптимально`. Если нужно дополнительно ограничить время планирования, [напишите в службу поддержки](https://yandex.kz/routing/doc/ru/vrp/feedback.md). {% endcut %} {% cut "Мы запустили задачу — спустя минуту пропал интернет, и появилась ошибка «failed to fetch». Нужно ли заново запускать задачу?" %} Нет, заново запускать задачу не нужно. Она сохранится под уникальным номером, который вы найдете в строке браузера: `https://yandex.ru/courier/companies//depots/all/mvrp/`, где `task_id` — идентификатор решенной задачи, `company_id` — идентификатор компании. Чтобы получить решение, обновите страницу, на которой вы запускали задачу. {% endcut %} {% cut "Почему при запуске задач планирования появляются ошибки, связанные с превышением лимитов «limit exceeded»?" %} В сервисе Планирования есть два типа лимитов: - по количеству запросов в сутки. При превышении этого лимита вы получите ошибку «Counter tasks_total_solved limit exceeded». - по количеству одновременно выполняемых запросов (например, планирование для разных городов или складов). При превышении этого лимита вы получите ошибку «Quota limit exceeded». Чтобы увеличить эти квоты, обратитесь к менеджеру или в [службу поддержки](https://yandex.kz/routing/doc/ru/vrp/feedback.md). Если из-за особенностей вашего бизнеса необходимо запускать одновременно большое количество задач, организуйте очередь так, чтобы отправлять новый запрос планирования только после того, как будет получен ответ на предыдущий, см. [Получение результата](https://yandex.kz/routing/doc/ru/vrp/get-result.md). Оценивайте [время выполнения запроса](https://yandex.kz/routing/doc/ru/vrp/request-processing-time.md). {% endcut %} ## Файл планирования {#planning-file} {% cut "Почему параметры, указанные в документации, не принимаются системой при загрузке через Excel?" %} Файл Excel поддерживает пока не все доступные параметры. Подробную информацию вы найдете по ссылкам: - [параметры, доступные через Excel](https://yandex.kz/routing/doc/ru/vrp/excel-fill-guide.md) - [параметры, доступные через API](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#operation/addMVRPTask) {% endcut %} {% cut "Почему в документации названия параметров планирования указываются через точку (например, `locations.id`)?" %} Параметры планирования могут задаваться: - в [файле Excel](https://yandex.kz/routing/doc/ru/vrp/excel-fill-guide.md) и в [API](https://yandex.ru/routing/doc/ru/vrp/redoc/index.html#operation/addsATask); - только в API. Если параметр задается в Excel, то в документации его название может указываться двумя способами: - в виде текста — например, `На листе Orders в поле id ...`; - `название_листа_Excel.название_параметра` — `orders.id`. Если параметр задается в API, его название включает название блока JSON (объекта или массива) и название самого параметра. Например, `locations.id`. Названия листов в Excel и соответствующих блоков в JSON могут не совпадать. Например, данные о заказах размещаются на листе **Orders**, а в JSON передаются в блоке `locations`. {% endcut %} ## Маршруты {#routes} {% cut "Как сделать маршруты более «кучными»?" %} Используйте опцию [Кучные маршруты](https://yandex.kz/routing/doc/ru/vrp/grouping-routes.md). {% endcut %} {% cut "Как минимизировать суммарный пробег всех машин?" %} Повысьте стоимость `cost.km` (см. раздел [Стоимость автомобиля или курьера](https://yandex.kz/routing/doc/ru/vrp/properties-of-vehicles-cost.md#cost)). Если вы используете жесткие окна для заказов или смен, попробуйте сделать их мягкими. {% endcut %} {% cut "Ошибка при просмотре маршрута по дорогам" %} Если возникает ошибка «Не хватает прав для просмотра результатов», используйте [инструкцию](https://yandex.kz/routing/doc/ru/vrp/interface-result.md#view-street-routes). {% endcut %} {% cut "Почему маршрут построен именно так?" %} Общее описание логики работы алгоритма планирования и причин выбора конкретного маршрута приведено в презентации [Почему так построился маршрут](https://doc-static.yandex.net/src/dev/routing/vrp/why-route-built-this-way.pdf). {% endcut %} ## Заказы {#orders} {% cut "Почему появляются нераспределенные заказы?" %} Есть ряд причин, по которым заказы попадают в нераспределенные. Чаще всего это происходит из-за жестких ограничений, которые алгоритм не может нарушить: - [жесткое окно](https://yandex.kz/routing/doc/ru/vrp/properties-of-time-window.md#hard-and-soft-windows) смены, склада или  заказа; - [совместимость заказов и автомобилей](https://yandex.kz/routing/doc/ru/vrp/properties-of-orders.md#order-vehicle-compatibility). В некоторых сценариях такое поведение ожидается заранее (см. [Планирование заказов, которые можно перенести / Планирование части заказов](https://yandex.kz/routing/doc/ru/vrp/examples-of-settings.md#part-of-orders)). Чтобы найти причины, исследуйте условия задачи: 1. Проверьте значение `penalty.drop` для заказа — оно не должно быть слишком маленьким или нулевым. 2. Сделайте все окна заказов [мягкими](https://yandex.kz/routing/doc/ru/vrp/properties-of-time-window.md#hard-and-soft-windows). 3. Уберите [теги на заказах](https://yandex.kz/routing/doc/ru/vrp/properties-of-orders.md#order-vehicle-compatibility). 4. Уберите [load_types](https://yandex.kz/routing/doc/ru/vrp/properties-of-orders.md#order-incompatibility) на заказах. Подробнее см. в разделе [Возможные причины нераспределенных заказов](https://yandex.kz/routing/doc/ru/vrp/undelivered-orders.md). {% endcut %} {% cut "Как в планировании учесть несколько окон у заказа?" %} Описание настроек такого сценария см. в разделе [Несколько временных окон в заказе](https://yandex.kz/routing/doc/ru/vrp/properties-of-orders.md#order-multiple-time-windows). {% endcut %} {% cut "Почему между заказами появляются большие ожидания?" %} Причины больших ожиданий и описание способов их уменьшения см. в разделе [Минимизация времени ожидания у курьеров](https://yandex.kz/routing/doc/ru/vrp/examples-of-settings.md#minimizing-waiting-time-for-couriers). {% endcut %} {% cut "Зачем нужно отдельно указывать время на парковку и время на вручение заказа?" %} Чтобы при объединении заказов в [мультизаказы](https://yandex.kz/routing/doc/ru/vrp/properties-of-orders.md#multi-orders) время на парковку учитывалось только один раз, а время на вручение считалось по количеству заказов. {% endcut %} {% cut "Если заказ могут выполнить не все курьеры, как настроить ограничения?" %} Используйте функциональность [Теги автомобиля](https://yandex.kz/routing/doc/ru/vrp/properties-of-vehicles.md#tags). {% endcut %} {% cut "Как учесть, что некоторые заказы не должны находиться вместе в одном автомобиле?" %} Используйте функциональность [Несовместимость заказов](https://yandex.kz/routing/doc/ru/vrp/properties-of-orders.md#order-incompatibility). {% endcut %} ## Курьеры {#couriers} {% cut "Как задействовать всех указанных курьеров и сделать их загрузку равномерной?" %} Настройки для управления загрузкой курьеров описаны в бизнес-кейсе [Планирование загрузки собственных курьеров](https://yandex.kz/routing/doc/ru/vrp/examples-of-settings.md#own-couriers). {% endcut %} {% cut "Как минимизировать количество курьеров?" %} Настройки для управления загрузкой курьеров описаны в бизнес-кейсе [Минимизация количества курьеров](https://yandex.kz/routing/doc/ru/vrp/examples-of-settings.md#minimizing-the-number-of-couriers). {% endcut %} {% cut "Можно ли «пересадить» одного курьера с автомобиля на общественный транспорт? Или реализовать сценарий, когда курьер доезжает на автомобиле до парковки, а потом обходит точки доставки пешком?" %} Нет, в рамках одного планирования можно выбрать только один вид транспорта для одного курьера. Отдельный случай — планирование с режимом [transit](https://yandex.kz/routing/doc/ru/vrp/routing-mode.md), когда курьер выполняет доставку на общественном транспорте, и от остановки до точки доставки передвигается пешком. {% endcut %} {% cut "Как учесть график работы курьеров?" %} В рамках каждого планирования учитывайте график работы курьеров в конкретный день. Если графики меняются по дням, то учтите это при формировании запроса API или при подготовке данных в Excel. Если заказы на будущие даты и график курьеров известны заранее, воспользуйтесь описанием бизнес-кейса [Планирование заказов на несколько дней](https://yandex.kz/routing/doc/ru/vrp/examples-of-settings.md#planning-several-days). {% endcut %} {% cut "Как настроить старт курьеров в разное время?" %} Включите опцию [Гибкое время старта](https://yandex.kz/routing/doc/ru/vrp/properties-of-depot.md#depot-flexible-start-time). {% endcut %} {% cut "Как сделать так, чтобы выполнение маршрута заканчивалось ближе к домашнему адресу/парковке курьера?" %} Добавьте точку с типом `garage` и укажите в поле `vehicle.finish_at` ее идентификатор. Маршрут будет завершен в указанной точке. Если включена опция возврата на склад в конце смены (параметр `vehicle.return_to_depot = TRUE`), то курьер сначала вернется на склад, а потом отправится в точку `finish_at`. Подробнее см. в разделе [Возврат на склад в конце рабочего дня](https://yandex.kz/routing/doc/ru/vrp/properties-of-vehicles-depot.md#return-to-depot) и [Старт или окончание маршрута в произвольной точке](https://yandex.kz/routing/doc/ru/vrp/supported-use-cases.md#route-start-or-end-at-arbitrary-point). {% endcut %} {% cut "Как уместить в смену большее количество заказов?" %} Увеличьте сервисное время, скорее всего, оно задано слишком «оптимистично». Также можете использовать опцию [Ограничение количества остановок в смене](https://yandex.kz/routing/doc/ru/vrp/properties-of-vehicles-routes.md#shift-stops). {% endcut %} {% cut "Как повысить приоритет собственных курьеров перед наемными?" %} Снизьте стоимость за факт использования собственных автомобилей. Подробнее см. сценарий [Собственный и наемный транспорт одновременно](https://yandex.kz/routing/doc/ru/vrp/examples-of-settings.md#own-and-hired-transport). {% endcut %} ## Штрафы {#penalties} {% cut "Как работают штрафы? Мы указываем штрафы, которые используем для оценки работы курьеров/транспорта, но планирование получается плохим." %} Штрафы предназначены только для настройки работы алгоритма, они не привязаны к оценкам стоимости логистики. См. подробнее в разделе [Как работает алгоритм планирования](https://yandex.kz/routing/doc/ru/vrp/routing-algorithm_index-page.md). Рекомендации по использованию штрафов вы найдете в описаниях [логистических сценариев](https://yandex.kz/routing/doc/ru/vrp/use-cases_index-page.md). {% endcut %} {% cut "Почему на странице с решением стоимость маршрутов в столбце **Стоимость с учетом штрафов, единицы** не совпадает с общей стоимостью решения с учетом штрафов?"%} Общая стоимость решения складывается из суммарной стоимости маршрутов с учетом штрафов, а также штрафов за нарушение опций маршрутизации. Подробнее см. в разделе [Стоимость с учетом штрафов](https://yandex.kz/routing/doc/ru/vrp/interface-result.md#cost-with-penalty). {% endcut %} ## Интеграция с API {#api-integration} {% cut "Мы настроили интеграцию по API, но хотим редактировать маршруты в интерфейсе Планирования. Как получить маршруты в свою систему после редактирования?" %} Такой способ взаимодействия подробно описан в разделе [Работа через API с редактированием решения через интерфейс](https://yandex.kz/routing/doc/ru/vrp/interaction-with-api.md). {% endcut %} {% cut "Как посмотреть на результаты полученного решения, если задачу отправляли через API?" %} Доступно два варианта: - Через интерфейс [Рабочего места логиста](https://yandex.ru/courier/companies). Этот вариант поддерживает редактирование маршрутов и сохранение результатов редактирования. Дополнительную информацию см. в разделе [Редактирование решения](https://yandex.kz/routing/doc/ru/vrp/interface-result.md#editing-a-solution). - По адресу `https://courier.yandex.ru/mvrp-map#`, где `task_id` — идентификатор полученного решения. Этот вариант поддерживает только визуализацию, без возможности редактировать решение. {% endcut %} Написать в службу поддержки