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С → витрина
Заголовок раздела «Каталог и цены из 1С → витрина»- Событие: в 1С сформирован пакет обмена каталогом (
mode=file, затемmode=import). - Направление: 1С → WooCommerce.
- Сущности: товар, характеристика, тип цены, ставка налога, единица измерения.
- Результат: товары и вариации обновлены по GUID, цены пересчитаны, лишние позиции сняты с публикации без удаления истории заказов.
Остатки → доступность на сайте
Заголовок раздела «Остатки → доступность на сайте»- Событие: регламентная выгрузка остатков из 1С или событие изменения остатка.
- Направление: 1С → WooCommerce.
- Сущности: остаток по складу, резерв, статус наличия.
- Результат:
stock_quantityиstock_statusотражают остаток; при нуле товар недоступен к заказу или помечен «под заказ» — правило фиксируется заранее.
Заказ → документ в 1С и обратный статус
Заголовок раздела «Заказ → документ в 1С и обратный статус»- Событие: покупатель оформил заказ в 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С, остаток по контрольному складу.