КСЭ (Курьер Сервис Экспресс) — федеральный логистический оператор с курьерской доставкой и сетью ПВЗ. Интеграция с RetailCRM избавляет операторов от ручного заведения накладных в личном кабинете КСЭ: заявка, трек-номер и статус приезжают прямо в заказ.
Что даёт интеграция КСЭ с RetailCRM
КСЭ закрывает курьерскую доставку по России и выдачу в пунктах, а также забор груза от отправителя. Когда служба подключена к RetailCRM, менеджеру не нужно дублировать данные заказа в кабинете перевозчика — всё делается из карточки заказа.
Практическая польза интеграции:
- Расчёт стоимости и срока прямо в заказе по адресу или выбранному ПВЗ;
- Создание отправления одним действием — RetailCRM передаёт габариты, вес, вложенное описание и сумму наложенного платежа;
- Печать накладной и этикетки без входа в личный кабинет КСЭ;
- Автообновление статусов и трек-номера, чтобы оператор и клиент видели актуальное положение груза.
Договор и доступы к API
Перед технической настройкой нужен действующий договор с КСЭ и учётные данные для API. Их выдаёт менеджер перевозчика после заключения договора.
- Заключите договор с КСЭ и получите номер клиента (код договора);
- Запросите доступ к API — обычно это пара
login/passwordили API-ключ для сервисной учётной записи; - Уточните адрес забора (склад отправителя) и город отправления — они подставляются в отправления по умолчанию;
- Согласуйте разрешённые тарифы и режимы (курьер, до ПВЗ, забор груза).
| Параметр | Где взять | Зачем нужен |
|---|---|---|
| Код договора | Менеджер КСЭ | Тарификация и учёт отправлений |
| Логин/пароль API | Служба поддержки КСЭ | Авторизация запросов |
| Город и адрес отправителя | Ваш склад | Расчёт плеча и забор |
Настройка модуля доставки в RetailCRM
Настройка выполняется в разделе Администрирование → Интеграция → Доставки. Если используется модуль КСЭ из Маркетплейса, его сначала устанавливают, затем открывают страницу настроек.
- Установите модуль КСЭ и активируйте его;
- Введите учётные данные API (логин, пароль или ключ) и код договора;
- Укажите склад отправления и город забора;
- Сопоставьте типы доставки КСЭ (курьер, ПВЗ, забор) с типами доставки в RetailCRM;
- Настройте маппинг статусов КСЭ на группы статусов заказа RetailCRM.
Ключевой момент — сопоставление типов доставки. В RetailCRM тип доставки хранится в заказе (поле delivery.code), и именно он определяет, каким способом уйдёт отправление.
Создание отправлений и накладных
Когда заказ переходит в статус готовности к отгрузке, оператор нажимает в блоке доставки «Создать отправление». RetailCRM собирает данные и передаёт их в КСЭ.
В отправление уходят:
- ФИО и телефон получателя, адрес или код ПВЗ;
- вес и габариты мест (Д×Ш×В);
- опись вложения и объявленная ценность;
- сумма наложенного платежа, если оплата при получении;
- тип услуги (курьер / до пункта / забор).
В ответ приходит трек-номер, который сохраняется в поле delivery.data.trackNumber. Печать накладной и этикетки доступна из того же блока — файл открывается в PDF.
Тарифы, зоны и расчёт стоимости
Расчёт стоимости выполняется по API КСЭ на основе города отправления, города/ПВЗ назначения и веса. Результат подставляется в поле стоимости доставки заказа, и его можно показывать клиенту.
| Режим | Что учитывается | Типичное применение |
|---|---|---|
| Курьер до двери | Адрес, вес, зона | B2C-заказы по городу и межгород |
| До ПВЗ | Код пункта, вес | Экономная доставка, самовывоз |
| Забор груза | Адрес отправителя | Регулярная отгрузка со склада |
Если у вас договорные (индивидуальные) тарифы, они применяются автоматически при передаче кода договора. Розничные тарифы используются только при отсутствии договорных.
Администрирование → Доставки → Стоимость) — тогда клиент видит фиксированную цену, а фактическую тарификацию контролирует бухгалтерия по актам КСЭ.Трек-номера и статусы доставки
После создания отправления RetailCRM периодически опрашивает КСЭ и обновляет статус в заказе. Маппинг статусов настраивается один раз и определяет, в какую группу статусов RetailCRM попадёт заказ.
Типовая цепочка событий:
создано— заявка принята, присвоен трек;принято на склад— груз у перевозчика;в пути / прибыло в город— транзит;выдано— доставлено получателю;возврат— отказ или невыдача.
На смену статуса удобно повесить триггеры: например, при статусе «выдано» отправлять клиенту запрос отзыва, а при «возврате» — ставить задачу менеджеру. Трек-номер можно транслировать покупателю в SMS или письме через шаблоны RetailCRM.
Типичные ошибки и как их избежать
- Ошибка авторизации API — неверный логин/пароль или не активирован доступ. Проверьте данные у менеджера КСЭ и статус сервисной учётки.
- Город не распознан — расхождение в справочнике населённых пунктов. Используйте выбор города из подсказок, а не свободный ввод.
- Не приходит трек-номер — не заполнены обязательные поля (вес, телефон, адрес). RetailCRM вернёт текст ошибки от API в блоке доставки.
- Статусы «замерли» — проверьте, что задача синхронизации активна и модуль не отключён.
Итог
Подключение КСЭ к RetailCRM сводится к трём шагам: получить договор и доступы к API, настроить модуль доставки с маппингом типов и статусов, проверить создание отправления на тестовом заказе. После этого операторы работают в одном окне — заявки, накладные и трек-номера формируются без входа в кабинет перевозчика.
Мы настраиваем интеграции RetailCRM со службами доставки под ключ: подключаем КСЭ и другие ТК, выстраиваем маппинг статусов, зоны и триггеры, тестируем на реальных заказах. Если КСЭ нет в готовых модулях, реализуем обмен по API и берём сопровождение на себя.
Частые вопросы
Есть ли готовый модуль КСЭ для RetailCRM?
КСЭ обычно подключается через модуль из Маркетплейса RetailCRM или собственную интеграцию по API. В отличие от СДЭК и Boxberry это не «встроенная из коробки» доставка, поэтому подключение планируют отдельно.
Что нужно получить у КСЭ перед настройкой?
Действующий договор, код клиента (договора) и доступ к API — логин с паролем или ключ для сервисной учётной записи. Также уточните город и адрес забора.
Передаётся ли наложенный платёж?
Да, сумма наложенного платежа передаётся в отправление, если в заказе указана оплата при получении. Проверьте, что реквизиты для перечисления настроены в договоре с КСЭ.
Как считается стоимость доставки?
По API КСЭ на основе города отправления, назначения и веса. При наличии договорных тарифов применяются они; иначе — розничные.
Обновляются ли статусы автоматически?
Да, RetailCRM опрашивает КСЭ по трек-номеру и обновляет статус заказа согласно настроенному маппингу. На смену статуса можно повесить триггеры.
Почему не создаётся отправление?
Чаще всего не заполнены обязательные поля (вес, телефон, адрес) или не распознан город. Текст ошибки от API виден в блоке доставки заказа и в логах модуля.
Можно ли печатать накладные из RetailCRM?
Да, после создания отправления накладная и этикетка доступны в PDF прямо из блока доставки, без входа в личный кабинет КСЭ.
Поможем с настройкой и поддержкой RetailCRM
Поможем с настройкой, доработкой и поддержкой RetailCRM.