КСЭ: подключение

КСЭ (Курьер Сервис Экспресс) — федеральная курьерская служба с сетью ПВЗ и курьерской доставкой. К 1С-Битрикс она подключается через API: расчёт тарифов, справочник точек, создание накладных и трекинг.

Что даёт подключение КСЭ

КСЭ работает и как курьерская доставка до двери, и через сеть пунктов выдачи. Для магазина на 1С-Битрикс подключение закрывает полный цикл: показать цену и срок, дать выбрать ПВЗ, создать накладную и отдать клиенту трек.

• Курьерская доставка и выдача в ПВЗ.
• Расчёт по весу, габаритам и направлению.
• Печать накладных и трекинг отправлений.

Готового коробочного обработчика КСЭ в Битриксе нет — подключают через модуль Маркетплейса или собственную интеграцию с API КСЭ.

Договор и доступ к API

Начинают с договора и получения доступа к API в личном кабинете КСЭ. Обычно выдаются ключ/токен авторизации и идентификатор клиента (номер договора).

1. Заключить договор, получить реквизиты доступа.
2. Прописать ключи в настройках модуля службы доставки.
3. Указать город/склад отправителя по умолчанию.
4. Отладить на тестовом контуре, если он предоставлен.

Расчёт тарифов на витрине

КСЭ подключается как профиль службы доставки. При оформлении Битрикс вызывает calculate(), который передаёт в API вес, габариты, города отправителя и получателя и тип доставки (курьер / ПВЗ).

Ответ кэшируют на несколько минут и предусматривают fallback-тариф на случай недоступности API.

Справочник ПВЗ

Пункты выдачи КСЭ отдаются через API. На витрине их показывают на карте с фильтром по городу; выбранная точка сохраняется в свойстве заказа и потом передаётся в накладную.

• Онлайн-загрузка точек под выбранный город — всегда актуально.
• Импорт в Highload-блок по расписанию — быстрее и автономнее.

Для стабильной работы карты чаще выбирают импорт справочника через агент или cron, обновляя его, например, раз в сутки.

Накладные и трек-номера

После оформления заказ передаётся в КСЭ вызовом создания отправления. В ответ приходят номер накладной и трек-номер, которые сохраняются в свойствах заказа Битрикса. API отдаёт печатную форму накладной.

• Создание отправления автоматически по статусу или по кнопке менеджера.
• Печать накладной/этикетки из PDF.
• Трек-номер показывается клиенту в письмах и личном кабинете.

Наложенный платёж и страхование

КСЭ поддерживает наложенный платёж — оплату получателем при выдаче, а также объявленную ценность со страхованием. Это важно для B2C-заказов и дорогих товаров.

• Сумма наложенного платежа передаётся в заявку и влияет на комиссию сервиса.
• Объявленная ценность закладывает страховой сбор в тариф.
• Деньги за наложенный платёж возвращаются на счёт по договору с перевозчиком.

Статусы и связка с CRM

Статусы отправлений КСЭ забираются из API по расписанию (агент/cron) или через вебхуки и маппятся на статусы заказа Битрикса. Так менеджер видит движение посылки без входа в кабинет перевозчика.

• Автообновление статуса заказа и уведомление клиента.
• Передача заказов и статусов в CRM Битрикс24 или 1С.
• Создание накладной там, где менеджер обрабатывает заказ.

Если продажи ведутся в учётной системе, накладную КСЭ логично формировать оттуда, а трек возвращать на сайт для информирования покупателя.

Итог

Подключение КСЭ к 1С-Битрикс — это расчёт тарифов на витрине, справочник ПВЗ на карте, автосоздание накладных с трек-номерами и обмен статусами с CRM или 1С. Важные детали — кэш и fallback расчёта, идемпотентность создания отправлений и безопасное хранение ключей API.

Мы в B2Bsite подключаем КСЭ под конкретную схему магазина: где считается тариф, где выбирается ПВЗ и где создаётся накладная. Настраиваем обмен статусами и связку с учётной системой, чтобы отправления не терялись и не задваивались.