Работа с транспортными заявками перевозчиков

Транспортная заявка связывает отгрузку в заказе с системой перевозчика и передаёт ей габариты, адрес и способ оплаты. В 1С-Битрикс эта связка работает через профили служб доставки и их API — от СДЭК и Boxberry до Почты России, а грамотная настройка убирает ручной перенос данных в личные кабинеты перевозчиков.

Что такое транспортная заявка и как она устроена

Транспортная заявка — это запись, которая привязана к отгрузке (Shipment) внутри заказа и хранит данные для передачи перевозчику: адрес получателя, вес и габариты мест, объявленную ценность, тип тарифа и режим оплаты. В коробочной версии «1С-Битрикс: Управление сайтом» базовая работа идёт через модуль sale и его службы доставки (Bitrix\Sale\Delivery\Services), а конкретные перевозчики подключаются отдельными модулями или обработчиками.

Важно различать три сущности: служба доставки (настроенный профиль перевозчика в магазине), отгрузка (что и куда едет по заказу) и транспортная заявка (запрос, отправленный в систему перевозчика и получивший от неё идентификатор). Одна отгрузка порождает одну заявку у одного перевозчика.

Подключение служб доставки: СДЭК, Почта России, Boxberry

Профили перевозчиков настраиваются в Магазин → Настройки → Службы доставки. Для каждого сервиса нужен обработчик и учётные данные из личного кабинета перевозчика — обычно это логин, пароль и/или пара «account + secret» для доступа к API.

• СДЭК — модуль подключается по договору, в настройках указываются идентификатор клиента и пароль API, тип отправления (склад-склад, склад-дверь и т.д.), а также город и код отправителя.
• Почта России — работа через API отправлений (Tariff API и Delivery API), нужен токен авторизации и ключ доступа; передаются разряд отправления, категория и вложение.
• Boxberry — интеграция по token из ЛК, поддерживает выбор пунктов выдачи (ПВЗ) и расчёт по зонам.

После сохранения профиля обработчик начинает рассчитывать стоимость и сроки прямо в оформлении заказа, а на стороне админки появляется возможность создать заявку по отгрузке. Проверьте ограничения по весу и габаритам — они задаются в профиле службы и влияют на её доступность в корзине.

Автосоздание заявок по статусу отгрузки

Ручное создание заявки по каждой отгрузке годится для малого потока, но при десятках заказов в день его автоматизируют. Стандартный приём — событийная логика на смене статуса отгрузки: когда менеджер переводит отгрузку в статус «Готова к отправке» (по умолчанию флаг DEDUCTED = Y или отдельный пользовательский статус), обработчик формирует заявку у перевозчика.

Технически это делается через события модуля sale, например OnSaleShipmentDeducted или OnSaleOrderSaved, где по данным отгрузки собирается запрос к API службы. Также используют:

1. агент 1С-Битрикс (Битрикс → Настройки → Агенты), который периодически выбирает отгрузки без заявки и создаёт их пакетно;
2. бизнес-процессы или роботы CRM (в редакции с CRM) на смене стадии сделки;
3. очередь на стороне обмена с 1С, если заявки формирует учётная система.

Статусы, трек-номера и трекинг

После успешного создания заявки перевозчик возвращает номер заявки и трек-номер — их сохраняют в свойствах отгрузки или в отдельном пользовательском поле, чтобы показать клиенту и использовать при печати. Дальше нужно синхронизировать состояние: заявка у перевозчика живёт своей жизнью (принята, в пути, прибыла в ПВЗ, вручена, возврат).

Синхронизацию статусов обычно вешают на агент или cron: скрипт периодически запрашивает статусы по списку активных трек-номеров через API перевозчика (или подписывается на его вебхуки, если сервис их поддерживает — например, статусные уведомления СДЭК). Полученный статус маппится на статус отгрузки/заказа в Битрикс.

Трек-номер удобно выводить в личном кабинете покупателя и в письме о статусе заказа через шаблоны почтовых событий (SALE_STATUS_CHANGED_*).

Массовая обработка и печать документов

При потоке отправлений ключевую роль играет групповая работа со списком заказов. В админке (Магазин → Заказы) через групповые действия можно менять статусы отгрузок пачкой, а модули перевозчиков добавляют собственные пункты — «Создать заявки», «Получить трек-номера», «Печать накладных».

• Пакетное создание заявок — по выбранным отгрузкам одним действием, с накоплением ошибок в лог, чтобы проблемные заказы не блокировали остальные.
• Печать — накладные и наклейки со штрихкодом обычно приходят от API в PDF; их выгружают одним файлом на партию отправлений.
• Формирование реестра (акта приёма-передачи) — перевозчик принимает партию по реестру; его тоже генерирует модуль на основе списка созданных заявок.

Личный кабинет перевозчика и сверка

Даже при полной автоматизации личный кабинет перевозчика остаётся источником истины: там видно фактический статус накладной, взаиморасчёты и спорные отправления. Практика — регулярно сверять заявки, созданные из Битрикс, с данными ЛК, чтобы ловить рассинхрон (заявка создалась в системе перевозчика, но идентификатор не сохранился в магазине, или наоборот).

Полезные приёмы сверки:

• хранить у отгрузки не только трек-номер, но и внутренний ID заявки перевозчика и дату создания — по ним быстро находить запись в ЛК;
• вести журнал обмена (лог запросов/ответов API) — при разборе спорных доставок это экономит часы;
• сверять наложенный платёж: сумму, переданную в заявке, и сумму, зачисленную перевозчиком в отчёте, чтобы корректно закрывать оплату заказа.

Для наложенного платежа особенно важно, чтобы сумма и признак предмета расчёта в заявке совпадали с составом отгрузки — иначе разъедутся деньги и фискализация.

Итог

Работа с транспортными заявками в 1С-Битрикс строится на связке «служба доставки → отгрузка → заявка у перевозчика». Настроив профили СДЭК, Почты России и Boxberry, автосоздание заявок по статусу отгрузки, синхронизацию трек-номеров и групповую обработку, вы убираете ручной перенос данных в личные кабинеты и снижаете число ошибок в накладных. Отдельного внимания требуют идемпотентность, лимиты API и сверка наложенного платежа.

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