Модуль «Экран логиста» для RetailCRM

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

1. CRM — доступы к RetailCRM

Раздел отвечает за техническую связь между модулем и вашей базой RetailCRM.

• RetailCRM URL (заполняется автоматически) — адрес вашей CRM-системы (например, https://yourcompany.retailcrm.ru). Связывается автоматически при установке модуля из маркетплейса.
• API-ключ (заполняется автоматически) — уникальный токен безопасности для передачи данных. Настраивается при установке.
• Кнопка «Сгенерировать 20 заказов» — сервисная функция для быстрого старта: создаёт в RetailCRM тестовые заказы с адресами, чтобы сразу протестировать карту, автораспределение и мобильную панель курьера.

Какие права нужны API-ключу. При установке из маркетплейса ключ создаётся автоматически с нужными правами. При ручном создании ключа (Администрирование → Интеграция → Ключи доступа к API) включите только эти группы:

• Заказы — Получение (order_read) и Редактирование (order_write): чтение заказов, назначение курьера, смена статусов и состава заказа.
• Справочники — Получение (reference_read): магазины, статусы заказов и товаров, типы доставки, курьеры, склады.
• Пользователи — Получение (user_read): список пользователей CRM.
• Пользовательские поля — Получение (custom_fields_read): пользовательские поля заказа для логиста и курьера.
• Интеграция — Редактирование (integration_write): регистрация интеграционного модуля.

2. Забор заказов

Определяет, какие именно заказы из RetailCRM попадают на экран логиста.

• Магазины — список ваших торговых точек или интернет-магазинов из CRM. Отметьте галочками те, чьи заказы нужно доставлять.
• Статусы для выгрузки — на каких этапах заказы импортируются в логистику (например: «Согласован», «Скомплектован», «Готов к отправке»).
• Типы доставки — фильтр заказов с курьерской доставкой (включить «Доставка курьером», «Срочная доставка», отключить «Самовывоз»).
• Поля заказа для логиста (в списке) — отображение дополнительных пользовательских полей CRM в боковой панели логиста (комментарии по сборке, предпочтения по упаковке и т. п.).

3. Курьеры

Настройки взаимодействия курьера с заказами в мобильной панели и правила синхронизации статусов обратно в RetailCRM.

• Поля заказа для курьера (в деталях) — пользовательские поля, которые курьер видит в смартфоне при открытии заказа (код домофона, признак бесконтактной доставки, потребность в сдаче).

Статусы автоматического перевода в CRM:

• Курьер взял заказ — статус при нажатии «Принять в работу» (например, «Передан курьеру»).
• Отказ курьера — статус, если курьер не смог выполнить заказ на этапе приёмки.
• Статус заказа при доставке — при успешном завершении (например, «Выполнен» / «Доставлен»).
• Статус заказа при отказе — если клиент отказался от получения на пороге (например, «Не доплачено / Отказ»).
• Статус заказа при переносе — если курьер согласовал с клиентом перенос даты получения.

Статус отменённого товара — поведение при отказе клиента от позиции в заказе:

• Полное удаление из заказа — товар вычёркивается из состава в CRM;
• Смена статуса позиции — перевод на выбранный статус отмены (для сохранения истории).

️ 4. Маршрутизация

Настройки склада отправки, параметров автоматического планирования маршрутов и геокодирования адресов.

• Адрес склада (стартовая точка) — адрес распределительного центра или магазина, откуда курьеры начинают путь.
• Координаты склада (широта и долгота) — можно ввести вручную или просто кликнуть по карте, маркер установится автоматически.
• Сервис геокодирования — перевод текстовых адресов покупателей в координаты:
  • OpenStreetMap (OSM) — бесплатный стандартный вариант, не требует ключей, подходит для небольших объёмов;
  • Яндекс.Геокодер — самый точный вариант для России, требует API-ключ (раздел «HTTP Геокодер» в кабинете разработчика Яндекса);
  • DaData подсказки — нормализация адресов и точное позиционирование, требует API-ключ DaData.
• Максимальное количество заказов на одного курьера — лимит для алгоритма автораспределения (сколько посылок физически возьмёт курьер за поездку).
• Время на обслуживание одного заказа (минут) — буферное время на парковку, подъём на этаж, передачу и расчёт; используется для точного прогноза ETA.
• Шаг окна планирования времени доставки (1–12 часов) — интервал группировки заказов по времени на панели логиста (например, при шаге 2 часа: 10:00–12:00, 12:00–14:00 и т. д.).