Работа c 1С-обработкой для сервиса Яндекс Маршрутизация

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

В зависимости от конфигурации данные выбираются из соответствующих документов:

• Заказ клиента (УТ, КА);
• Заказ покупателя (УПП);
• Реализация товаров и услуг (БУХ).

Модуль представляет собой обработку, находящуюся в подсистеме Яндекс Маршрутизация. В зависимости от конфигурации и ее версии внешний вид диалога открытия файла может отличаться от представленного на изображении.

Шаг 1: Запуск модуля

1. Для установки расширения нужно запустить 1С в режиме конфигуратора и открыть список расширений. Для этого нужно запустить пункт меню Конфигурация и выбрать там подпункт Расширения конфигурации.

   

2. Откроется список, в котором нужно добавить новое расширение с помощью кнопки Добавить. Все параметры нового расширения нужно оставить заполненными по умолчанию и нажать ОК.

   

3. После добавления нового расширения конфигурации нужно выделить его в списке, и в пункте меню Конфигурация → Загрузить конфигурацию из файла выбрать файл расширения на диске компьютера.

   

4. При появлении диалогового окна с информацией о загрузке конфигурации нажать ОК.

   

5. После окончания загрузки расширения нужно обновить конфигурацию базы данных, нажав Да и подтвердить список изменений в следующем окне.

   

6. После этого расширение будет загружено в конфигурацию. В режиме предприятия на Панели разделов появится новый пункт Яндекс Маршрутизация.

   

7. Автоматическая обработка происходит с помощью обработки ЯМ_АвтоматическиеОбработки, которую необходимо добавить в учетную систему 1С, если есть необходимость в автоматическом обновлении статусов запросов.

   Обработка с заданной периодичностью запрашивает у сервиса обновление статусов для запросов на маршрутизацию в статусах, отличных от Завершен и Ошибка. Сделать это можно открыв справочник Дополнительные отчеты и обработки, нажав на его форме кнопку Добавить из файла и выбрав файл обработки на диске:

   

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

   

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

   

Шаг 2: Заполнение настроек по умолчанию

Для заполнения настроек по умолчанию воспользуйтесь автоматической обработкой Начальное заполнение справочников. Эту обработку можно открыть через меню Файл → Открыть и далее нажать на кнопку Заполнить справочники по умолчанию.

Данная обработка заполняет справочники:

• Настройки штрафов для алгоритма

• Группы балансировки

• Общие настройки

Шаг 3: Заполнение справочников и настроек

Для формирования запроса в сервис Яндекс Маршрутизация требуется ввести необходимые настройки модуля и заполнить справочники Склады отгрузки и Машины.

1. Справочник Общие настройки содержит основные настройки работы модуля, такие как ключ API, токен для сервиса Мониторинга, адрес подключения. Открыть форму настроек можно из общего меню, пункт Общие настройки.

   

2. Значения основных настроек заполняются значениями по умолчанию после шага 2. Если по какой-то причине настройки не заполнились, попробуйте убрать у расширения пункт Безопасный режим или выберите пункт меню Заполнить настройки из файла и загрузите файл с настройками.

   Скачать

3. Значения основных настроек заполняются значениями по умолчанию после шага 2. Заполните ключи для работы с сервисами Яндекс Маршрутизации и при необходимости скорректируйте общие настройки. Для работы с сервисом планирования необходимо заполнить:

   • ID Компании в Яндекс Маршрутизация;

   • КлючAPI для Яндекс Маршрутизация;

   • Для работы с сервисом Мониторинга дополнительно заполните Токен для Яндекс Мониторинг. Получение токена описано в разделе Получение OAuth-токена.;

   • Для работы с сервисом геокодирования дополнительно заполните Ключ API для Яндекс Геокодирование.

4. Справочник Склады отгрузки должен иметь один непомеченный на удаление элемент с заполненными параметрами.

   

   Пример настроек склада:

   

5. Справочник Машины должен иметь хотя бы один непомеченный на удаление элемент с заполненными параметрами. Для настройки также можно использовать пресеты. Пример заполнения показан на изображении ниже:

   

Шаг 4: Загрузка заказов

1. Для начала работы откройте Рабочее место логиста. Для отбора данных по документам (заказам) выберите склад и период, за который необходимо собрать данные по документам.

   

2. После выбора периода нажмите кнопку Заполнить список. Таблица на вкладке Запросы будет заполнена данными по документам за выбранный период. Выбор документов зависит от конфигурации. Таблица доступна для редактирования на форме модуля после завершения проверки и редактирования собранных данных.

   

3. Координаты для заказов можно заполнить в списке вручную. Если нужно геокодировать адреса, нажмите кнопку Геокодировать. Для этого в настройках должен быть указан API-ключ сервиса Яндекс Геокодирование.

   

   Для целей тестирования в настройках есть параметр Заполнять координаты случайными значениями. Если установить его в значение Да, то координаты будут заполняться случайными значениями в зависимости от координат склада — это позволит протестировать модуль без использования ключа геокодирования.

Шаг 5: Отправка запроса на планирование

1. Для отправки запроса на планирование в сервисе Яндекс Маршрутизация нажмите Планирование → Отправить запрос на планирование. Результат отправки отобразится в окне сообщений.

   

2. Для просмотра результатов перейдите на вкладку Результат планирования. По умолчанию отображается последний оправленный запрос. Чтобы найти запрос, в поле id планирования укажите id задачи планирования и нажмите кнопку обновления.

   

Шаг 6: Просмотр результатов и отправка данных в мониторинг

1. Результаты отображаются в виде двух блоков: сверху — список спланированных рейсов, снизу — распределение заказов по рейсам. По нажатию кнопки Перейти вы перейдете в интерфейс Яндекс Маршрутизации.

   

2. Для отправки данных в сервис Мониторинга нажмите кнопку Отправить в мониторинг.

3. По нажатию кнопки Получить отчет о доставке в нижней форме обновятся значения полей Статус доставки и Фактическое время (данные будут получены из сервиса мониторинга, если эти заказы уже будут фактически доставлены).