--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.kz/routing/doc/kk/vrp/1c-guide-uf.md - https://yandex.kz/routing/doc/ru/vrp/1c-guide-uf.md - href: ru/vrp/1c-guide-uf.md type: text/markdown title: Markdown version - href: llms.txt type: text/markdown title: llms.txt title: Яндекс Маршрутизация — модули интеграции с 1С — работа с обработкой 1С --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/ru/llms.txt # Работа c 1С-обработкой для сервиса Яндекс Маршрутизация {% note warning %} Модуль предоставляется «как есть» для интеграции с типовыми конфигурациями 1С. Корректная работа модуля в уникальной конфигурации не гарантируется. Обслуживание модуля не осуществляется. За помощью по доработкам модуля обращайтесь к вашему разработчику 1С или интегратору. Поддержка доступна по вопросам Планирования и Мониторинга. {% endnote %} Ниже представлены две типовые реализации. В некоторых случаях они могут потребовать доработок. {% list tabs %} - Версия для управляемых форм Поддерживаемые версии 1С: - Управление торговлей 11.* и отраслевые конфигурации на их основе. - ERP и отраслевые конфигурации на их основе. - Бухгалтерия предприятия версий 3.* и отраслевые конфигурации на их основе. - Комплексная автоматизация версий 2.*. {% note alert %} При обновлении модуля 1С все индивидуальные доработки будут потеряны. {% endnote %} Перед началом работы скачайте файл внешней обработки. Скачать {% cut "Предыдущая версия" %} Скачать {% endcut %} В архиве четыре файла: - модуль интеграции; - обработка для работы с запросами на маршрутизацию (автоматический запрос статусов); - обработка для начального заполнения справочников; - настройки. - Версия для обычных форм Поддерживаемые версии 1С: - Управление торговлей 10.* и отраслевые на их основе. - Бухгалтерия предприятия версий 2.* и отраслевые на их основе. - Комплексная автоматизация версий 1.*. - Управление производственным предприятием и отраслевые на их основе. {% note alert %} При обновлении модуля 1С все индивидуальные доработки будут потеряны. {% endnote %} Перед началом работы скачайте файл внешней обработки. Скачать В архиве три файла: - модуль интеграции; - обработка для начального заполнения справочников; - настройки. {% endlist %} {% cut "Подробнее о версии от декабря 2025" %} В новой версии файла внешней обработки исправлены ошибки, а также добавлены возможности: - [авторизации по токену](https://yandex.kz/routing/doc/ru/delivery/quickstart/register.md) для использования: - [геозон из справочника](https://yandex.kz/routing/doc/ru/vrp/interface-geozones.md); - [пресетов](https://yandex.kz/routing/doc/ru/vrp/presets.md), позволяющих настраивать параметры складов, заказов, курьеров или автомобилей, глобальных опций; - [использования пресетов](https://yandex.kz/routing/doc/ru/vrp/interface-presets.md) для настройки склада, заказа, курьера или автомобиля, глобальных опций; - [использования геозон из справочника](https://yandex.kz/routing/doc/ru/vrp/interface-geozones.md); - [сохранения истории планирований](https://yandex.kz/routing/doc/ru/vrp/interface-history.md), в том числе логирования сотрудников в 1С; - экспорта в Мониторинг [маршрутов с плановыми показателями](https://yandex.kz/routing/doc/ru/delivery/functions/working-with-plan-fact.md#add-plan); - получения отчета [План / Факт](https://yandex.kz/routing/doc/ru/delivery/interface/plan-fact.md); - получения отчета [Качество работы курьеров](https://yandex.kz/routing/doc/ru/delivery/interface/quality-report.md); - [периодического допланирования](https://yandex.kz/routing/doc/ru/vrp/additional-planning.md) с `initial_routes`; - [получения списка дочерних задач](https://yandex.kz/routing/doc/ru/vrp/interaction-with-api.md#child-tasks) по идентификатору родительской задачи; - [использования промежуточных складов](https://yandex.kz/routing/doc/ru/vrp/properties-of-vehicles-depot.md#visit-additional-depot) при планировании. {% endcut %} В зависимости от конфигурации данные выбираются из соответствующих документов: - Заказ клиента (УТ, КА); - Заказ покупателя (УПП); - Реализация товаров и услуг (БУХ). Модуль представляет собой обработку, находящуюся в подсистеме Яндекс Маршрутизация. В зависимости от конфигурации и ее версии внешний вид диалога открытия файла может отличаться от представленного на изображении. ![](_images/1c-uf-guide-1.png){style="border: solid 1px #cccccc; max-width: 800px;"} ## Шаг 1: Запуск модуля {#step1} 1. Для установки расширения нужно запустить 1С в режиме конфигуратора и открыть список расширений. Для этого нужно запустить пункт меню **Конфигурация** и выбрать там подпункт **Расширения конфигурации**. ![](_images/1c-uf-guide-2.png){style="border: solid 1px #cccccc; max-width: 800px;"} 1. Откроется список, в котором нужно добавить новое расширение с помощью кнопки **Добавить**. Все параметры нового расширения нужно оставить заполненными по умолчанию и нажать **ОК**. ![](_images/1c-uf-guide-3.png){style="border: solid 1px #cccccc; max-width: 800px;"} 1. После добавления нового расширения конфигурации нужно выделить его в списке, и в пункте меню **Конфигурация** → **Загрузить конфигурацию из файла** выбрать файл расширения на диске компьютера. ![](_images/1c-uf-guide-4.png){style="border: solid 1px #cccccc; max-width: 800px;"} 1. При появлении диалогового окна с информацией о загрузке конфигурации нажать **ОК**. ![](_images/1c-uf-guide-5.png) 1. После окончания загрузки расширения нужно обновить конфигурацию базы данных, нажав **Да** и подтвердить список изменений в следующем окне. ![](_images/1c-uf-guide-6.png) 1. После этого расширение будет загружено в конфигурацию. В режиме предприятия на Панели разделов появится новый пункт Яндекс Маршрутизация. ![](_images/1c-uf-guide-7.png){style="border: solid 1px #cccccc; max-width: 800px;"} 1. Автоматическая обработка происходит с помощью обработки **ЯМ_АвтоматическиеОбработки**, которую необходимо добавить в учетную систему 1С, если есть необходимость в автоматическом обновлении статусов запросов. Обработка с заданной периодичностью запрашивает у сервиса обновление статусов для запросов на маршрутизацию в статусах, отличных от **Завершен** и **Ошибка**. Сделать это можно открыв справочник **Дополнительные отчеты и обработки**, нажав на его форме кнопку **Добавить из файла** и выбрав файл обработки на диске: ![](_images/1c-uf-guide-8.png){style="border: solid 1px #cccccc; max-width: 800px;"} 1. Для добавленной обработки можно будет настроить расписание запуска, выбрав его в строке таблицы на форме. ![](_images/1c-uf-guide-9.png){style="border: solid 1px #cccccc; max-width: 800px;"} 1. Окно настройки расписания является типовым и дает возможность гибко настроить интервалы запуска обработки в зависимости от особенностей использования сервиса. ![](_images/1c-uf-guide-10.png){style="border: solid 1px #cccccc; max-width: 800px;"} ## Шаг 2: Заполнение настроек по умолчанию {#step2} Для заполнения настроек по умолчанию воспользуйтесь автоматической обработкой **Начальное заполнение справочников**. Эту обработку можно открыть через меню **Файл** → **Открыть** и далее нажать на кнопку **Заполнить справочники по умолчанию**. ![](_images/1c-uf-guide-11.png){style="border: solid 1px #cccccc; max-width: 800px;"} Данная обработка заполняет справочники: - Настройки штрафов для алгоритма - Группы балансировки - Общие настройки ## Шаг 3: Заполнение справочников и настроек {#step3} Для формирования запроса в сервис Яндекс Маршрутизация требуется ввести необходимые настройки модуля и заполнить справочники **Склады отгрузки** и **Машины**. 1. Справочник **Общие настройки** содержит [основные настройки](https://yandex.kz/routing/doc/ru/vrp/1c-settings.md) работы модуля, такие как ключ API, токен для сервиса Мониторинга, адрес подключения. Открыть форму настроек можно из общего меню, пункт **Общие настройки**. ![](_images/1c-uf-guide-12.png){style="border: solid 1px #cccccc; max-width: 800px;"} 1. Значения основных настроек заполняются значениями по умолчанию после шага 2. Если по какой-то причине настройки не заполнились, попробуйте убрать у расширения пункт **Безопасный режим** или выберите пункт меню **Заполнить настройки из файла** и загрузите файл с настройками. Скачать 1. Значения основных настроек заполняются значениями по умолчанию после шага 2. Заполните ключи для работы с сервисами Яндекс Маршрутизации и при необходимости скорректируйте общие настройки. Для работы с сервисом планирования необходимо заполнить: - ID Компании в Яндекс Маршрутизация; - КлючAPI для Яндекс Маршрутизация; - Для работы с сервисом Мониторинга дополнительно заполните **Токен для Яндекс Мониторинг**. Получение токена описано в разделе [Получение OAuth-токена](https://yandex.kz/routing/doc/ru/delivery/quickstart/register.md).; - Для работы с [сервисом геокодирования](https://tech.yandex.ru/maps/geocoder/) дополнительно заполните **Ключ API для Яндекс Геокодирование**. 1. Справочник **Склады отгрузки** должен иметь один непомеченный на удаление элемент с заполненными параметрами. ![](_images/1c-uf-guide-13.png){style="border: solid 1px #cccccc; max-width: 800px;"} Пример настроек склада: ![](_images/1c-uf-guide-13a.png){style="border: solid 1px #cccccc; max-width: 800px;"} 1. Справочник **Машины** должен иметь хотя бы один непомеченный на удаление элемент с заполненными параметрами. Для настройки также можно использовать пресеты. Пример заполнения показан на изображении ниже: ![](_images/1c-uf-guide-14.png){style="border: solid 1px #cccccc; max-width: 800px;"} ## Шаг 4: Загрузка заказов {#step4} 1. Для начала работы откройте Рабочее место логиста. Для отбора данных по документам (заказам) выберите склад и период, за который необходимо собрать данные по документам. ![](_images/1c-uf-guide-15.png){style="border: solid 1px #cccccc; max-width: 800px;"} 1. После выбора периода нажмите кнопку **Заполнить список**. Таблица на вкладке **Запросы** будет заполнена данными по документам за выбранный период. Выбор документов зависит от конфигурации. Таблица доступна для редактирования на форме модуля после завершения проверки и редактирования собранных данных. ![](_images/1c-uf-guide-15a.png){style="border: solid 1px #cccccc; max-width: 800px;"} 1. Координаты для заказов можно заполнить в списке вручную. Если нужно геокодировать адреса, нажмите кнопку **Геокодировать**. Для этого в настройках должен быть указан API-ключ сервиса [Яндекс Геокодирование](https://yandex.ru/dev/maps/commercial/doc/jsapi-geocoder.html). ![](_images/1c-uf-guide-16.png){style="border: solid 1px #cccccc; max-width: 800px;"} Для целей тестирования в настройках есть параметр **Заполнять координаты случайными значениями**. Если установить его в значение **Да**, то координаты будут заполняться случайными значениями в зависимости от координат склада — это позволит протестировать модуль без использования ключа геокодирования. ## Шаг 5: Отправка запроса на планирование {#step5} 1. Для отправки запроса на планирование в сервисе Яндекс Маршрутизация нажмите **Планирование** → **Отправить запрос на планирование**. Результат отправки отобразится в окне сообщений. ![](_images/1c-uf-guide-17.png){style="border: solid 1px #cccccc; max-width: 800px;"} 1. Для просмотра результатов перейдите на вкладку **Результат планирования**. По умолчанию отображается последний оправленный запрос. Чтобы найти запрос, в поле **id планирования** укажите `id` задачи планирования и нажмите кнопку обновления. ![](_images/1c-uf-guide-18.png){style="border: solid 1px #cccccc; max-width: 800px;"} ## Шаг 6: Просмотр результатов и отправка данных в мониторинг {#step6} 1. Результаты отображаются в виде двух блоков: сверху — список спланированных рейсов, снизу — распределение заказов по рейсам. По нажатию кнопки **Перейти** вы перейдете в интерфейс Яндекс Маршрутизации. ![](_images/1c-uf-guide-19.png){style="border: solid 1px #cccccc; max-width: 800px;"} 1. Для отправки данных в сервис Мониторинга нажмите кнопку **Отправить в мониторинг**. 1. По нажатию кнопки **Получить отчет о доставке** в нижней форме обновятся значения полей Статус доставки и Фактическое время (данные будут получены из сервиса мониторинга, если эти заказы уже будут фактически доставлены). Написать в службу поддержки