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

1С описывает обмен с интернет-магазином как отдельный блок протокола: сайт передаёт заказы, после чего синхронизируются их параметры и состояния; формат связан со стандартом CommerceML 2. Конкретная схема и поддерживаемые поля зависят от конфигурации 1С и модуля сайта, поэтому сначала выгрузите эталонный тестовый документ из вашей пары систем.

Сначала назначьте владельца каждому полю

ДанныеИсточник истиныНаправление
Номер и внешний ID сайтасайтсайт → 1С
Состав и цены на момент покупкисайт/checkoutсайт → 1С
Факт оплатыплатёжный контурчерез согласованный статус
Сборка и отгрузка1С/склад1С → сайт
Трек-номерслужба доставки/1С1С → сайт
Отменазависит от этапатаблица допустимых переходов

Отдельно определите, можно ли редактировать заказ после передачи. Часто безопаснее создать новую версию или операцию корректировки, чем молча менять уже проведённый документ. Это бизнес-решение должно быть записано в контракте.

Внешний ID переживает переименование и повтор

Название покупателя, номер телефона и номер заказа на экране не подходят как ключ: они могут измениться или совпасть. Передавайте неизменяемый `site_order_id`, храните его в отдельном реквизите документа 1С и закрепите уникальность в обработке импорта. Если несколько магазинов используют одну базу, ключ включает стабильный идентификатор источника.

integration_key = source_system + ':' + site_order_id

source_system: shop-main
site_order_id: 8f2d...
revision: 3
created_at: 2026-10-06T16:40:00Z
currency: RUB
items: [{external_sku, quantity, unit_amount_minor}]

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

Outbox не теряет подтверждённый заказ

  1. Сайт сохраняет заказ и outbox-событие в одной транзакции.
  2. Фоновая задача выбирает неотправленные события и формирует пакет.
  3. Приёмник в 1С ищет документ по integration key.
  4. Новый ключ создаёт документ, существующий — сравнивает revision и обновляет разрешённые поля.
  5. После подтверждения сайт отмечает доставку, сохраняя ответ и время.

Если соединение оборвалось после обработки, отправитель не знает, был ли принят пакет. Поэтому retry обязателен, а идемпотентность приёмника — не оптимизация, а часть корректности.

Статусы переводятся, а не копируются строкой

Сайт1СРазрешённый переходКомментарий
newК обеспечениюсозданиеещё не отгружен
paidОплаченпосле подтверждения оплатыне по нажатию кнопки
assemblingК сборкеиз 1Ссклад принял заказ
shippedОтгружениз 1Сс трек-номером при наличии
cancelledОтменёнпо матрице этаповне отменять отгруженный автоматически

Названия условные. Сопоставляйте их с реальными статусами своей конфигурации и храните версию mapping. Не используйте двустороннее правило «последняя дата победила»: часы могут расходиться, а переход назад — разрушить уже выполненную операцию.

Первая сверка проходит по одной контрольной сумме

  • Число строк и количества совпадают с checkout.
  • SKU сопоставлены однозначно и не заменены названием товара.
  • Сумма строк, скидка, доставка и итог объясняют друг друга.
  • Валюта не потеряна, налоги переданы по согласованной модели.
  • Повтор пакета не меняет итог и не создаёт новый документ.
  • Обратный статус относится к тому же внешнему ID.

Запуск делят на теневой обмен и переключение

Сначала отправляйте тестовые или копии реальных заказов в отдельный контур без проведения документов. Сравните выборку, исправьте mapping, затем включите ограниченный источник или временное окно. У старого обмена должна быть точка остановки: два активных экспортёра создают дубли даже при исправной логике каждого.

Приёмочный тест намеренно рвёт соединение

Создайте заказ, дождитесь документа в 1С и повторно отправьте тот же пакет. Затем оборвите соединение после приёма, но до ответа, и повторите ещё раз. Во всех случаях integration key должен привести к одному документу. После изменения разрешённого поля увеличьте revision и убедитесь, что запрещённые поля не перезаписались.

К запуску подготовьте версии конфигурации и модуля обмена, обезличенный пример заказа, mapping полей и статусов, расписание, журнал одного trace и план отката. Реальные телефоны, адреса и платёжные реквизиты в диагностический пакет не включайте.

Проверенные источники