Отгрузки в заказе: как работают

В 1С-Битрикс заказ — это не плоская запись, а объектная модель D7: у заказа есть коллекция отгрузок и коллекция оплат. Отгрузка (Shipment) отвечает за то, какие товары, когда и какой службой доставки уезжают покупателю, а также за списание со склада. Разберём, как эта модель устроена и какие флаги реально управляют движением товара.

Заказ, отгрузки и оплаты: как связаны сущности

С переходом на ядро D7 заказ описывается объектом \Bitrix\Sale\Order. Внутри него живут независимые коллекции: корзина (Basket), оплаты (PaymentCollection) и отгрузки (ShipmentCollection). Деньги и товар в Битрикс разведены сознательно: за приём средств отвечает оплата, за движение товара — отгрузка.

• Order — контейнер: хранит покупателя, свойства, статус и итоговые суммы.
• Payment — факт оплаты через конкретную платёжную систему (PAY_SYSTEM_ID).
• Shipment — факт отгрузки: набор товаров, служба доставки (DELIVERY_ID), стоимость доставки и признак списания.
• ShipmentItem — строка отгрузки: сколько единиц конкретной позиции корзины уезжает в этой отгрузке.

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

Системная отгрузка: куда попадают товары сразу

Когда заказ только создан, в нём уже есть одна отгрузка — системная (Shipment::isSystem() === true). Это техническая сущность: в ней лежат все позиции корзины, ещё не распределённые по реальным отгрузкам. Служба доставки у системной отгрузки не выбрана.

Как только вы создаёте настоящую отгрузку и указываете службу доставки, товары «перетекают» из системной отгрузки в реальную: количество в ShipmentItem уменьшается в системной и появляется в новой. Пока часть товара осталась в системной отгрузке — заказ отгружен не полностью.

Ключевые флаги: DEDUCTED, ALLOW_DELIVERY, RESERVED

Состоянием реальной отгрузки управляют три флага «Да/Нет». Их путают чаще всего, поэтому разложим по смыслу.

Главный из них — DEDUCTED. Именно установка DEDUCTED = 'Y' означает физическую отгрузку: Битрикс списывает товар со склада каталога и снимает резерв. Флаг ALLOW_DELIVERY — это разрешение к доставке, а не сам факт списания; они независимы.

Резерв и связь с остатками склада

Резервирование работает на уровне строки отгрузки: у ShipmentItem есть RESERVED_QUANTITY. Зарезервированное количество удерживается на складе — доступный остаток для других покупателей уменьшается, но физически товар ещё на складе.

Момент резерва задаётся в настройках модуля sale (Магазин → Настройки → Настройки резервирования): резервировать при оформлении заказа, при оплате или при переходе отгрузки в определённый статус. Логика движения количеств такая:

1. Товар зарезервирован — вычитается из доступного остатка, но не из фактического.
2. Отгрузка помечена DEDUCTED = 'Y' — резерв снимается, фактический остаток уменьшается.
3. Отгрузка отменена (CANCELED = 'Y') — резерв возвращается, при уже списанном товаре остаток восстанавливается.

Привязка к доставке и статусы отгрузки

Каждая реальная отгрузка привязана к службе доставки через DELIVERY_ID и хранит стоимость доставки (PRICE_DELIVERY, BASE_PRICE_DELIVERY) и трек-номер (TRACKING_NUMBER). У отгрузки собственный статус STATUS_ID из справочника статусов доставки (тип DELIVERY_STATUS), не путайте его со статусом заказа.

Типичный жизненный цикл реальной отгрузки:

• создана, товар распределён из системной отгрузки;
• зарезервирована (если по настройке резерв на этом шаге);
• ALLOW_DELIVERY = 'Y' — разрешена доставка, меняется статус;
• DEDUCTED = 'Y' — отгружена, склад списан.

Статус самого заказа агрегируется из отгрузок: поле заказа DEDUCTED становится 'Y', только когда отгружены все его непустые отгрузки.

События и точки автоматизации

Модель отгрузок насыщена событиями ядра, за которые удобно цеплять интеграции — уведомления, обмен с 1С, печать документов. Работать с ними правильно через объектную модель, а не прямыми UPDATE в таблицы b_sale_order_delivery.

• OnSaleShipmentEntitySaved / OnShipmentDeducted — реакция на отгрузку и списание;
• OnSaleDeliveryAllowDeliveryChange — смена разрешения доставки;
• OnSaleShipmentEntitySaveError — контроль ошибок сохранения.

Программно отгрузку меняют через коллекцию: получают $order->getShipmentCollection(), вызывают setField('DEDUCTED', 'Y') у нужной отгрузки и сохраняют заказ $order->save(). Тогда Битрикс сам пересчитает резервы, остатки и статус заказа — это и есть корректный путь.

Итог

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

Мы в B2Bsite проектируем и сопровождаем магазины на Битрикс так, чтобы отгрузки, резервы и обмен с 1С работали предсказуемо: без двойных списаний, рассинхрона остатков и ручных правок в БД. Если нужно навести порядок в схеме заказ→отгрузки→оплаты или связать её с учётной системой — поможем на этапе разработки и на поддержке.