Подключить 1С к Яндекс Маршрутизации можно готовым модулем. Он выгружает заказы из 1С в Excel или отправляет их запросом в API планирования, забирает готовый порядок объезда и при желании передаёт маршруты в Мониторинг. Документация рассчитывает модули на 1С версии 8 и выше, но с оговоркой: они поставляются «как есть» для типовых конфигураций, обслуживание самого модуля Яндекс не ведёт. Поддержка отвечает по вопросам Планирования и Мониторинга, а правки под вашу базу делает разработчик 1С или интегратор.

Что нужно подготовить до установки

Модуль обращается к геокодеру (адрес в координаты), планированию и Мониторингу. Отсюда и список подготовки.

  • Доступ к конфигуратору 1С, чтобы установить расширение.
  • Регистрация компании в Яндекс Маршрутизации. Ключ API и ID компании нужны обязательно. ID виден в адресной строке после companies, ключ лежит в «Настройки», «Компания», «API Key».
  • Токен для Мониторинга, если планируете отслеживать доставку. Его получают через Яндекс OAuth с учётной записи, у которой роль «Администратор» в вашей компании. Это третий ключ, он не совпадает с API-ключом планирования.
  • Ключ геокодера, если в 1С только текстовые адреса. Он тоже отдельный и берётся в Кабинете разработчика. Бесплатный ключ из 1С не работает.
  • Заполненные справочники «Склады отгрузки» и «Машины»: нужен хотя бы один действующий склад и одна машина.

Архив выбирают по конфигурации. Для управляемых форм подходят Управление торговлей 11, ERP, Бухгалтерия предприятия 3, Комплексная автоматизация 2 и отраслевые решения на их основе. Для обычных форм есть отдельный комплект: Управление торговлей 10, Бухгалтерия 2, Комплексная автоматизация 1, Управление производственным предприятием. В версии от декабря 2025 есть пресеты, геозоны, отчёты «План / Факт» и «Качество работы курьеров», допланирование и промежуточные склады.

Порядок внедрения

В документации внедрение разбито на шесть шагов: знакомство с продуктом, тестирование, проезд по маршрутам, интеграция, опытная эксплуатация, промышленное использование. Порядок рекомендательный, и в простых случаях часть шагов можно пропустить. Но интеграция стоит четвёртой неслучайно: прежде чем подключать 1С, полезно один раз прогнать задачу через Excel-шаблон в веб-интерфейсе и убедиться, что результат вас устраивает. Тогда модуль автоматизирует уже понятный процесс, и при сбое ясно, где искать причину: в данных 1С или в настройках планирования.

Установка модуля по шагам

  1. В конфигураторе откройте «Конфигурация», «Расширения конфигурации», добавьте новое расширение с параметрами по умолчанию и загрузите в него файл расширения через «Загрузить конфигурацию из файла». Обновите конфигурацию базы данных. Контрольная точка: в режиме предприятия в панели разделов появился пункт «Яндекс Маршрутизация».
  2. Для автоматического обновления статусов добавьте обработку статусов через справочник «Дополнительные отчёты и обработки» и настройте расписание её запуска. Обработка обновляет запросы, которые ещё не в статусах «Завершен» и «Ошибка».
  3. Откройте обработку начального заполнения справочников и нажмите «Заполнить справочники по умолчанию». Контрольная точка: заполнились настройки штрафов, группы балансировки и общие настройки.
  4. В «Общих настройках» укажите ID компании, ключ API, при необходимости токен Мониторинга и ключ геокодера. Если настройки не подтянулись сами, отключите у расширения безопасный режим или загрузите их из файла настроек в архиве.
  5. Проверьте склад и машины. Склад: код, координаты, временное окно. Машина: логин курьера (он же номер машины), способ перемещения, вместимость, стоимость, смены.
  6. В рабочем месте логиста выберите склад и период, нажмите «Заполнить список» и получите заказы из документов. Какие документы берутся, зависит от конфигурации: заказ клиента, заказ покупателя или реализация.
  7. Нажмите «Геокодировать» и посмотрите на подсветку. Оранжевый означает, что нужный дом не найден и найден близкий номер или только улица. Красный: улица не найдена, вернулся центр города.
  8. В меню «Планирование» отправьте запрос. Результат смотрите на вкладке «Результат планирования» или кнопкой перехода в веб-интерфейс.
  9. Кнопка «Отправить в мониторинг» передаёт склады, курьеров, маршруты и заказы. Позже «Получить отчёт о доставке» вернёт статус и фактическое время по каждому заказу.

Что проверить после запуска

В первые дни сверяйте результат с привычным планом вручную. Расхождения чаще всего возникают здесь.

  • Случайные координаты. Параметр «Заполнять координаты случайными значениями» по умолчанию включён: он нужен для теста без геокодера. Если оставить его при реальной работе, заказы лягут в произвольные точки вокруг склада.
  • Значения по умолчанию для всех заказов: окно 7:00 до 23:00, жёсткое окно, 900 секунд сервисного времени на адрес и 120 на заказ, тип «delivery». Индивидуальные значения для отдельных заказов в модуле требуют доработки, поэтому сверьте общие значения с реальностью.
  • Журнал запросов. Статусы идут от «Отправлен» к «Запланирован» и «Завершен», при сбое будет «Ошибка» с текстом ответа сервиса.
  • Радиус на точке доставки по умолчанию 500 метров, статус заказа «new». Если клиентов не нужно предупреждать звонком, допустим статус «confirmed».
  • Типичные ошибки. «Query parameter apikey is missing» означает пустой ключ планирования в общих настройках. Ошибка о несоответствии схеме (additionalProperties) говорит, что запрос содержит лишний параметр. В документации разобран случай со штрафом за недоставку на смене машины: его задают только для заказов, из настроек штрафов смены его нужно убрать.
  • Тест на сопоставление. Выгрузите заказы кнопкой «Выгрузить заказы в Excel», загрузите файл в веб-интерфейс и сравните расчёт с тем, что вернул модуль.

Через неделю-две сравните план и факт в отчётах мониторинга и поправьте сервисное время, окна и вместимость там, где расхождения повторяются.

Ограничения модуля и когда лучше API

При обновлении модуля все индивидуальные доработки теряются, это прямо указано в документации. Лицензия MIT позволяет менять код свободно, но после обновления правки придётся накладывать заново. Автоматическое заполнение тегов совместимости, собственная таблица координат по адресам, индивидуальные окна и сервисное время на заказ, типы заказов кроме delivery и pickup: всё это в модуле из коробки не заложено.

Если такие вещи для вас обязательны, а конфигурация 1С нетиповая, разумнее заказать у интегратора прямую интеграцию через API. Разумный путь: модуль для опытной эксплуатации, затем решение, оставаться на нём или переходить на собственный обмен.

Отдельный вопрос для Беларуси: геокодирование белорусских адресов и качество карты проверьте на своём списке адресов, а подсветка точности в рабочем месте логиста покажет проблемные строки. Условия доступа для вашей компании уточняйте у менеджера Яндекса.

Частые вопросы

Какие версии 1С поддерживают готовые модули? По документации, готовые модули интеграции можно использовать с 1С версии 8 и выше.

Когда лучше подключать сервис через API? Когда готовых модулей недостаточно или нужно связать сервис с другой системой, не только с 1С.

Читайте также

Раздел: Автоматизация логистики, оптимизация доставки и работы курьерской службы

Похожие записи