До разработки возьмите один заказ с доставкой, скидкой и несколькими товарами. Выпишите, какие значения окончательно определяет сайт, а какие — 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 не теряет подтверждённый заказ
- Сайт сохраняет заказ и outbox-событие в одной транзакции.
- Фоновая задача выбирает неотправленные события и формирует пакет.
- Приёмник в 1С ищет документ по integration key.
- Новый ключ создаёт документ, существующий — сравнивает revision и обновляет разрешённые поля.
- После подтверждения сайт отмечает доставку, сохраняя ответ и время.
Если соединение оборвалось после обработки, отправитель не знает, был ли принят пакет. Поэтому retry обязателен, а идемпотентность приёмника — не оптимизация, а часть корректности.
Статусы переводятся, а не копируются строкой
| Сайт | 1С | Разрешённый переход | Комментарий |
|---|---|---|---|
| new | К обеспечению | создание | ещё не отгружен |
| paid | Оплачен | после подтверждения оплаты | не по нажатию кнопки |
| assembling | К сборке | из 1С | склад принял заказ |
| shipped | Отгружен | из 1С | с трек-номером при наличии |
| cancelled | Отменён | по матрице этапов | не отменять отгруженный автоматически |
Названия условные. Сопоставляйте их с реальными статусами своей конфигурации и храните версию mapping. Не используйте двустороннее правило «последняя дата победила»: часы могут расходиться, а переход назад — разрушить уже выполненную операцию.
Первая сверка проходит по одной контрольной сумме
- Число строк и количества совпадают с checkout.
- SKU сопоставлены однозначно и не заменены названием товара.
- Сумма строк, скидка, доставка и итог объясняют друг друга.
- Валюта не потеряна, налоги переданы по согласованной модели.
- Повтор пакета не меняет итог и не создаёт новый документ.
- Обратный статус относится к тому же внешнему ID.
Запуск делят на теневой обмен и переключение
Сначала отправляйте тестовые или копии реальных заказов в отдельный контур без проведения документов. Сравните выборку, исправьте mapping, затем включите ограниченный источник или временное окно. У старого обмена должна быть точка остановки: два активных экспортёра создают дубли даже при исправной логике каждого.
Приёмочный тест намеренно рвёт соединение
Создайте заказ, дождитесь документа в 1С и повторно отправьте тот же пакет. Затем оборвите соединение после приёма, но до ответа, и повторите ещё раз. Во всех случаях integration key должен привести к одному документу. После изменения разрешённого поля увеличьте revision и убедитесь, что запрещённые поля не перезаписались.
К запуску подготовьте версии конфигурации и модуля обмена, обезличенный пример заказа, mapping полей и статусов, расписание, журнал одного trace и план отката. Реальные телефоны, адреса и платёжные реквизиты в диагностический пакет не включайте.