Транспортные заявки: создание и работа

Транспортная заявка в 1С-Битрикс — это запрос на доставку, который магазин передаёт перевозчику из конкретной отгрузки заказа. Отгрузка хранит состав, вес и адрес, а служба доставки принимает эти данные, возвращает трек-номер и присылает статусы. Разберём весь путь: где в админке, как формируется заявка и что уходит перевозчику.

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

В модуле sale нет отдельной сущности «транспортная заявка» — она всегда привязана к отгрузке (shipment) внутри заказа. Отгрузка уже содержит всё, что нужно перевозчику: список товаров, их количество, суммарный вес, выбранную службу доставки и профиль (тариф), а также адрес получателя из свойств заказа. Заявка — это акт передачи этих данных во внешнюю систему перевозчика по его API.

Формирование заявки берёт на себя обработчик службы доставки (delivery handler). Базовые обработчики Битрикса (Почта России, СДЭК, Boxberry, PickPoint, DPD и другие из Маркетплейса) реализуют класс, наследующий \Bitrix\Sale\Delivery\Services\Base, и добавляют к отгрузке действие «передать в службу доставки». Без такого обработчика служба доставки остаётся «ручной» — она считает стоимость, но заявку в чужую систему не отправляет.

Где это в админке

Основная точка работы — карточка заказа: Магазин → Заказы → Заказы, открыть заказ, блок «Отгрузка». Именно здесь у отгрузки выбирается служба доставки и появляются кнопки взаимодействия с перевозчиком, если у службы есть обработчик с поддержкой заявок.

Есть и отдельный список отгрузок — Магазин → Отгрузки (файл sale_order_shipment.php), удобный для массовой работы: отфильтровать неотгруженные, увидеть трек-номера и статусы доставки в колонках. Настройка самих служб и их обработчиков — Магазин → Настройки → Службы доставки. Общие параметры трекинга задаются в настройках модуля магазина.

• Заказы — работа с конкретной заявкой в контексте одного заказа;
• Отгрузки — пакетная обработка и контроль статусов;
• Службы доставки — подключение обработчиков, тарифов и учётных данных API перевозчика.

Как сформировать заявку из отгрузки

Порядок действий типовой для большинства обработчиков:

1. В отгрузке заказа выбрать службу доставки и профиль — от этого зависит тариф и набор передаваемых полей.
2. Указать способ забора и параметры: пункт выдачи (ПВЗ) или курьер, тип посылки, при наложенном платеже — сумму к получению.
3. Убедиться, что заполнены вес и, при необходимости, габариты мест: часть перевозчиков откажет в приёме заявки без них.
4. Сохранить отгрузку и нажать действие обработчика — «Создать заявку» / «Передать в службу доставки». Кнопка появляется только у служб с соответствующим обработчиком.

После нажатия обработчик обращается к API перевозчика, тот регистрирует отправление и возвращает свой номер заказа и/или трек-номер. Битрикс записывает его в отгрузку. Дополнительно многие обработчики позволяют скачать печатную форму — накладную или наклейку со штрихкодом.

Какие данные уходят перевозчику

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

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

Трек-номер и статусы доставки

Полученный от перевозчика трек-номер сохраняется в поле отгрузки TRACKING_NUMBER. Через него работает подсистема отслеживания \Bitrix\Sale\Delivery\Tracking: по расписанию (агент/cron) она опрашивает API перевозчика и обновляет статус доставки, а покупателю может уходить письмо с трек-номером.

Не путайте два независимых набора статусов:

• Статус отгрузки в Битрикс — управляемый вручную флаг «Отгружено» (DEDUCTED) и пользовательские статусы отгрузки из Магазин → Настройки → Статусы; влияет на списание со склада.
• Статус трекинга — то, что вернул перевозчик (принято, в пути, доставлено). Он приходит извне и не отгружает товар автоматически.

Типичные проблемы и как их избежать

Большинство сбоев при формировании заявок повторяются от проекта к проекту:

• Нет кнопки создания заявки — у службы доставки не подключён обработчик с поддержкой заявок либо она настроена как ручная.
• Ошибка авторизации API — просрочен или неверен ключ/договор в настройках службы доставки.
• Перевозчик отклоняет заявку — не заполнены вес, габариты, телефон или адрес; проверяйте маппинг свойств заказа на поля обработчика.
• Статус не обновляется — не запущены агенты/cron или трек-номер записан не в то поле.
• Дубли отправлений — повторное нажатие «Создать заявку»; корректный обработчик должен обновлять, а не создавать новую заявку.

Отдельно проверяйте частичные отгрузки: если заказ делится на несколько посылок, у каждой должна быть своя заявка и свой трек, а суммарный вес и стоимость — распределены по местам корректно.

Итог

Транспортная заявка в 1С-Битрикс — это передача данных отгрузки в систему перевозчика через обработчик службы доставки: из карточки заказа или списка отгрузок формируется запрос, перевозчик возвращает трек-номер, а подсистема трекинга подтягивает статусы. Ключ к стабильной работе — корректный маппинг свойств заказа, заполненные вес и габариты, действующие ключи API и разведённая логика «отгружено» и «доставлено».

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