Перейти к содержимому

WooCommerce и 1С: каталог по CommerceML и заказы

Кратко: каталог, цены и остатки приходят из 1С файлами по протоколу обмена с сайтом, а заказы WooCommerce уходят в учётную базу и возвращаются статусами. Это гибрид: файлы для объёмных данных, API или тот же протокол для событий. Связка привязана к конфигурации 1С, поэтому без её названия и версии обещаний быть не может. Уровень проверки documented.

  • Задача: продавать на WooCommerce, но вести номенклатуру, цены, остатки и документы в 1С.
  • Что проверено: формат CommerceML (import.xml, offers.xml, orders.xml) и режимы протокола обмена, REST API WooCommerce по товарам и заказам.
  • Уровень: documented; стенда с конкретной конфигурацией 1С не было.
  • Что не проверено: состав полей вашей конфигурации, настройки синхронизации и правила выгрузки.

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

Когда она не нужна:

  • Нет серверной 1С и учёт небольшой — облачный сервис дешевле, см. WooCommerce и МойСклад.
  • Нужны только заказы в CRM — это WooCommerce и Битрикс24.
  • Нужен только перенос каталога один раз — это миграция, а не синхронизация.
  • Событие: в 1С сформирован пакет обмена каталогом (mode=file, затем mode=import).
  • Направление: 1С → WooCommerce.
  • Сущности: товар, характеристика, тип цены, ставка налога, единица измерения.
  • Результат: товары и вариации обновлены по GUID, цены пересчитаны, лишние позиции сняты с публикации без удаления истории заказов.
  • Событие: регламентная выгрузка остатков из 1С или событие изменения остатка.
  • Направление: 1С → WooCommerce.
  • Сущности: остаток по складу, резерв, статус наличия.
  • Результат: stock_quantity и stock_status отражают остаток; при нуле товар недоступен к заказу или помечен «под заказ» — правило фиксируется заранее.
  • Событие: покупатель оформил заказ в WooCommerce.
  • Направление: WooCommerce → 1С → WooCommerce.
  • Сущности: заказ, контрагент, позиции, склад, реализация, оплата.
  • Результат: в 1С появляется заказ покупателя; после отгрузки магазин получает статус «Отгружен», после оплаты — «Оплачен». Повторная передача того же заказа не создаёт второй документ.
Событие в 1С Действие в WooCommerce Примечание
Выгрузка каталога (mode=file, mode=import) Обновление товаров и вариаций Импорт выполняется только после успешной загрузки файла
Выгрузка предложений (offers.xml) Цены и остатки Характеристики сопоставляются по GUID
Изменение цены типа «продажа» regular_price Тип цены фиксируется в настройке обмена
Создание реализации Статус completed Только по явной таблице соответствия
Событие в WooCommerce Действие в 1С Примечание
order.created Заказ покупателя Через mode=query/orders.xml или HTTP-сервис
Оплата заказа Поступление оплаты Требует сопоставления способов оплаты
Отмена заказа Отмена документа Отмена не удаляет документ
Возврат Документ возврата Сумма и причина передаются явно

Протокол различает шаги: проверка аутентификации, инициализация (mode=init), загрузка файла (mode=file), импорт (mode=import) и выгрузка заказов (mode=query). «Файл загружен» не значит «данные применены»: оба шага нужно логировать и подтверждать.

  • Протокол обмена с сайтом (CommerceML) — типовой путь для 1С: файлы каталога и заказов по HTTP. Подходит для больших каталогов; задержка от минут до часов, зато нет требования публиковать базу.
  • HTTP-сервисы 1С или OData — прямые запросы к справочникам и документам. Даёт реальное время, но требует публикации базы и доработки конфигурации, а доступ наружу согласуют службы безопасности.
  • Промежуточный сервис — обмен через базу-посредник или очередь. Оправдан при нескольких каналах продаж и сложных правилах сопоставления.
  • Custom-модуль обмена — обработка на стороне 1С и приёмник на стороне WooCommerce. Даёт контроль над полями и журналом, но требует разработчика 1С в контуре поддержки.

Ключевой критерий — не «есть ли модуль», а кто поддерживает обработку на стороне 1С и что происходит при сбое между загрузкой файла и импортом.

Объект 1С Объект WooCommerce Ключ соответствия Примечание
Номенклатура Товар GUID ↔ мета-поле GUID стабилен, артикул — нет
Характеристика Вариация GUID Создаётся после родителя
Тип цены regular_price / sale_price — Валюта и округление фиксируются
Склад и остаток stock_quantity — Учитывать ли резерв — правило обмена
Заказ покупателя Заказ Номер и дата Идемпотентность по номеру
Контрагент Покупатель ИНН, телефон, email Дедупликация до создания
Реализация Статус completed Таблица соответствия Не каждая отгрузка меняет статус

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

  • Зафиксировать конфигурацию и версию 1С, а также обработку обмена, которая используется.
  • Проверить, какие типы цен, склады и характеристики выгружаются.
  • Определить кодировку файлов и формат дат; проверить кириллицу в названиях на тестовой выгрузке.
  • Сопоставить GUID номенклатуры и существующих товаров магазина.
  • Прогнать на staging: полный каталог, изменение цены и остатка, заказ, отгрузка, повторный импорт того же файла, обрыв соединения посередине загрузки.
  • Настроить журнал обмена с указанием шага (init, file, import, query).
  • Зависимость от конфигурации. «УТ 11.5», «УНФ 3.1» и «ERP 2.5» отдают разный состав полей; страница описывает протокол, а не гарантию для вашей базы.
  • Двухшаговый импорт. Загруженный файл может быть не применён; при сбое между шагами остаётся «полуобмен», который нужно распознать и повторить.
  • Идентификаторы. Сопоставление по названию ломается на первом переименовании: ключ — GUID или внешний код.
  • Объём файла. Большой каталог упирается в лимиты времени выполнения и размер запроса; обмен делится на порции, а импорт выполняется в фоне.
  • Статусы. Обратная передача статусов должна идти по явной таблице соответствия, иначе заказ «прыгает» между состояниями.
  • Права доступа. HTTP-сервис 1С, открытый наружу, — это поверхность атаки: нужен отдельный пользователь, ограничение по IP и HTTPS.

Можно ли обойтись без публикации 1С в интернет? Да: файловый обмен по расписанию, где 1С выгружает пакет, а сайт забирает его по HTTP, либо промежуточный сервис между системами.

Почему каталог обновился, а цены нет? Каталог и предложения — разные файлы (import.xml и offers.xml). Часто импортируется только первый, и цены с остатками остаются старыми.

Кто должен создавать контрагента? Обычно 1С: магазин передаёт данные покупателя, а сопоставление и создание контрагента выполняет обработка. Если создаёт магазин, нужен доступ к справочнику контрагентов.

Как проверить, что обмен не врёт? Сверить три числа: количество товаров в выгрузке и на витрине, сумму заказов за период в магазине и в 1С, остаток по контрольному складу.