Загрузка данных

В интерфейсе Рабочего места логиста доступно два способа загрузки маршрутов в Мониторинг:

• экспорт результатов задачи планирования, если вы создаете маршруты с помощью сервиса Планирования;
• импорт из Excel-файла, если вы самостоятельно задаете последовательность выполнения заказов.

Подготовка данных

Чтобы успешно загружать маршруты в Мониторинг, вы должны знать ответы на эти вопросы:

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

Мобильные приложения или GPS-трекеры

Для получения информации о маршруте и передачи геопозиций курьер может использовать GPS-трекер или мобильное приложение Яндекс Курьер.

Мобильные телефоны клиентов

Перед выездом на заказ курьеру может потребоваться уточнить, на месте ли клиент, или предупредить, что курьер задерживается, и согласовать новое время доставки.

Если нужно, чтобы курьер мог позвонить клиенту, укажите мобильные телефоны клиентов. Это можно сделать двумя способами:

• На листе Orders укажите мобильные телефоны клиентов. Тогда в приложении Яндекс Курьер появится кнопка Позвонить.

• На листе Orders в комментарии к заказу укажите телефон клиента в формате: <a href="tel:+79123456789">Позвонить</a>. Чтобы указать добавочный номер, используйте разделители ,, ;, * или #: <a href="tel:+79123456789,12">Позвонить</a>. В приложении в поле Комментарий логиста появится ссылка Позвонить, и курьер сможет связаться с клиентом.

Ссылка в комментарии к заказу

Если курьеру понадобится дополнительная информация о заказе, например, правила парковки по адресу клиента, вы можете добавить ссылку в комментарии к заказу.

Для этого на листе Orders в комментарии к заказу укажите ссылку в формате <a href="https://krasnaya-roza.com">Правила парковки</a>. В приложении в поле Комментарий логиста появится ссылка Правила парковки, по которой курьер сможет перейти и ознакомиться с необходимой информацией.

Склад

1. Укажите номер склада:
   • в файле Планирования на листе Depot в столбце Номер склада;
   • в задаче Планирования на вкладке Склады.
2. Загрузите файл планирования или заполните данные в интерфейсе и запустите планирование.

Ручная настройка маршрутов

Если вы самостоятельно определяете последовательность выполнения заказов, то в файл планирования нужно внести еще несколько настроек:

1. Перейдите в лист Routes и заполните следующие столбцы:
   • ID машины;
   • Смена;
   • Номер заказа.
2. Сопоставьте номер заказа с ID машины и Сменой, в которую курьер повезет заказ.
3. Определите последовательность доставки заказов.

Экспорт в Мониторинг

После того, как вы спланировали и отредактировали полученные маршруты, отправьте их в Мониторинг для отслеживания.

Экспорт через Рабочее место логиста

При экспорте результатов планирования в Мониторинг к номеру заказа может автоматически добавляться дата. Это происходит, если номер нового заказа совпадает с уже существующим в Мониторинге.

Например, если в Мониторинге уже есть заказ с номером Заказ 1, то в карточке нового заказа будет отображаться Заказ 1 ГГГГ-ММ-ДД.

Экспорт через API

Чтобы экспортировать решение из Планирования в Мониторинг через API, отправьте запрос к ресурсу routes-import.

Запрос:

curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X POST https://courier.yandex.ru/api/v2/companies/<id-вашей-компании>/routes:vrp-task-import/?vrp_task_id=<vrp_task_id>

curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-OAuth-токен>" -X POST https://courier.yandex.ru/api/v2/companies/<id-вашей-компании>/routes:vrp-task-import/?vrp_task_id=<vrp_task_id>

где <vrp_task_id> — идентификатор решения из Планирования.

Результат:

{
  "id": "<vrp_task_import_id>",
  "status": "IN_PROGRESS",
  "create_time": "<время-создания>",
  "update_time": "<время-обновления>"
}

где <vrp_task_import_id> — идентификатор экспортированного решения в Мониторинге.

Чтобы получить результат экспорта, отправьте GET-запрос:

Запрос:

curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-токен>" -X GET http://courier.yandex.ru/api/v2/companies/<id-вашей-компании>/routes:vrp-task-import/<vrp_task_import_id>

curl -H "Content-Type: application/json" -H "Authorization: OAuth <ваш-OAuth-токен>" -X GET http://courier.yandex.ru/api/v2/companies/<id-вашей-компании>/routes:vrp-task-import/<vrp_task_import_id>

где <vrp_task_import_id> — идентификатор экспортированного решения в Мониторинге.

В зависимости от статуса запроса вы получите один из результатов:

• запрос в процессе выполнения:

  {
    "id": "<vrp_task_import_id>",
    "status": "IN_PROGRESS",
    "create_time": "<время-создания>",
    "update_time": "<время-обновления>"
  }
  

• запрос успешно завершен:

  {
    "id": "<vrp_task_import_id>",
    "status": "SUCCESS",
    "create_time": "<время-создания>",
    "update_time": "<время-обновления>",
    "result": {
      "routes": [...]
      }
  }
  

  где массив routes содержит созданные маршруты.

• при выполнении запроса произошла ошибка:

  {
    "id": "<vrp_task_import_id>",
    "status": "ERROR",
    "create_time": "<время-создания>",
    "update_time": "<время-обновления>",
    "error": {
      "message": "<описание-ошибки>"
      }
  }
  

Особенности экспорта через API:

• Запросы от одной компании выполняются последовательно в порядке их поступления.
• Если во время выполнения запроса возникнет ошибка (например, указанный в запросе склад не существует), в результате вернется сообщение об ошибке. Экспорт решения не произойдет.

Импорт из Excel

Импортируйте самостоятельно подготовленные маршруты в Мониторинг:

1. В левом меню в Рабочем Месте Логиста выберите Мониторинг → Дашборд.

2. В правом верхнем углу нажмите Импорт из Excel. Откроется интерфейс импорта.

3. В левом верхнем углу нажмите Загрузить файл и загрузите нужный файл с компьютера.

4. Проверьте уведомления системы на всех вкладках и исправьте данные, если необходимо.

   Если номера заказов повторяются, система предложит варианты решения. В случае выбора варианта Оставить дубликаты и переименовать номера в новом маршруте повторяющиеся заказы будут переименованы. К их названию добавится дата планирования в формате ГГГГ-ММ-ДД.

5. Перейдите на вкладку Настройки:

   • выберите дату, когда эти маршруты должны выполняться;
   • выберите нужный статус заказов.

6. В левом нижнем углу нажмите кнопку Импорт.

7. В разделе Дашборд вы увидите спланированные маршруты.

Заполнение файла Excel

Работа с дубликатами

Дубликаты — это заказы с повторяющимися номерами.

Если в маршруте, который вы импортируете из Excel, встречаются дубликаты, Мониторинг предупредит об этом. Уведомление и возможные действия будут показаны в окне Импорт маршрутов на вкладке Заказы.

Чтобы импортировать данные, выберите одно из следующих действий:

Оставить дубликаты и переименовать номера в новом маршруте

Повторяющиеся заказы будут переименованы так, что к номеру дубликата добавится дата маршрута.

Оставить дубликаты только в новом маршруте

Дубликат будет перенесен из старого маршрута в новый.

Оставить как есть

Такой выбор означает, что система не будет совершать никаких действий с дубликатами.

При попытке сразу импортировать маршрут после выбора этой опции Мониторинг выдаст ошибку «Не удалось отправить импортированные данные. Сначала замените дубликаты повторяющихся заказов на вкладке "Заказы"».

Чтобы избежать ошибки, перед импортом удалите дубликат из Мониторинга вручную:

1. Нажмите правой клавишей мыши строку с дубликатом.

2. Нажмите Удалить строку.

   

3. Перейдите на вкладку Маршруты.

4. В таблице маршрутов удалите строку с дубликатом.

5. Нажмите Импорт.

Если вы сделали выбор, но он показался неверным — нажмите кнопку Отменить. Так вы снова вернетесь к выбору действия с дубликатами.

Статус заказов при загрузке

При загрузке маршрутов в Мониторинг нужно определить, с каким статусом должны быть созданы заказы.

Дозагрузка маршрутов

Вы можете загружать маршруты на дату, для которой уже есть заказы (например, при допланировании).

При добавлении новых маршрутов на день, для которого они уже есть, система выдаст предупреждение:

• при экспорте из Планирования: в окне загрузки в Мониторинг;
• в интерфейсе импорта: на вкладке Маршруты.

Далее нужно выбрать подходящий вариант действий.

Решение проблем

Чаще всего при экспорте или импорте система предупреждает о проблемах, связанных с id заказа или номером склада. Решить такие проблемы можно как в файле Планирования, так и в интерфейсе.

Ниже приведена таблица с возможными причинами и способами решения.