Интеграция 1С с сайтом ломается не из-за «неправильной кнопки обмена», а из-за неоговорённых правил. Две системы одновременно меняют названия, цены и остатки, идентификаторы теряются, а ошибки обнаруживаются по звонку покупателя. Устойчивый обмен начинается с модели данных и ответственности, а уже потом — с формата CommerceML, REST API или собственного коннектора.
Определите источник истины
Для каждого типа данных назначьте систему, где его создают и исправляют. Обычно номенклатура, цены и складские остатки приходят из 1С, а сайт хранит описание для витрины, SEO-поля, фотографии и пользовательский контент. Заказы создаются на сайте и передаются в 1С, после чего статусы и оплаты могут двигаться в обе стороны.
Запишите правила в таблицу: сущность, владелец данных, направление, частота, идентификатор и поведение при конфликте. Без этой таблицы любое изменение превращается в спор между контент-менеджером и оператором 1С.
Сопоставьте сущности до первой выгрузки
- товар, торговое предложение, характеристика и единица измерения;
- тип цены, валюта, НДС, скидка и сегмент покупателя;
- склад, резерв, доступный остаток и срок поставки;
- покупатель, юридическое лицо, контакт и адрес;
- заказ, отгрузка, оплата, возврат и отмена.
Главное правило идентификации — постоянный внешний ID. Артикул и название могут измениться или повториться, поэтому использовать их как единственный ключ рискованно.
Разделите обмен на независимые потоки
Полная выгрузка каталога, обновление остатков и загрузка заказов имеют разный приоритет. Если объединить их в один длинный процесс, тяжёлый импорт картинок задержит остатки, а ошибка в одном заказе остановит остальные.
- Структура и товары — реже, пакетами, с протоколом изменений.
- Цены и остатки — чаще, только дельта, с контролем давности данных.
- Заказы — отдельная очередь, идемпотентная обработка и повторные попытки.
- Статусы — события или короткие интервалы синхронизации.
Не публикуйте импорт напрямую
Безопасная схема сначала принимает файл или пакет, проверяет структуру и обязательные поля, а затем применяет изменения транзакционно или небольшими порциями. Для критичных показателей полезны ограничения: отрицательный остаток, цена в сотни раз выше обычной или исчезновение половины каталога должны остановить публикацию и вызвать уведомление.
Большие изображения обрабатывайте отдельно. Их загрузка и ресайз не должны блокировать обновление цены или остатка.
Сделайте обработку заказов идемпотентной
Повторная отправка одного и того же заказа не должна создавать дубль. Сайт передаёт неизменяемый идентификатор, 1С хранит связь и возвращает результат обработки. Сетевой тайм-аут не означает, что запрос не был выполнен: перед повтором нужно проверить, появился ли объект на принимающей стороне.
Отдельно согласуйте, что происходит при изменении заказа после передачи: какие поля можно редактировать, где оформляется отмена и кто создаёт возврат.
Наблюдаемость важнее сообщения «обмен завершён»
У интеграции должен быть журнал с номером запуска, длительностью, количеством созданных и обновлённых объектов, предупреждениями и ошибками. Для каждой ошибки нужны понятный объект и причина — не просто «что-то пошло не так на шаге 4».
- уведомляйте об остановке и росте очереди;
- контролируйте давность последнего успешного обновления остатков;
- храните необработанные входящие пакеты ограниченное время;
- добавьте повторный запуск отдельного объекта, а не всего каталога.
Как тестировать интеграцию
Нужны не только «идеальные» данные. Проверьте товар без фото, нулевой остаток, удалённую характеристику, одинаковый артикул, новую ставку НДС, отменённый заказ, возврат и обрыв связи в середине пакета. Затем измерьте время прохождения полного цикла: от изменения в 1С до витрины и от заказа до учётной системы.
Минимальный результат проектирования
До разработки должны появиться схема потоков, таблица соответствий, правила конфликтов, формат журналирования, SLA обновления и сценарий восстановления после сбоя. Именно эти документы делают интеграцию обслуживаемой.
Мы проектируем и дорабатываем такие решения в рамках разработки на Битрикс. Примеры комплексных внедрений собраны в разделе наших работ; задачу можно обсудить через контакты.