﻿---
title: "WooCommerce и 1С: каталог по CommerceML и заказы"
description: "Файловый обмен каталогом, ценами и остатками по протоколу 1С и передача заказов WooCommerce в учётную базу: сценарии, поля и ограничения."
---

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

## Кратко

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

## Когда нужна интеграция

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

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

- **Нет серверной 1С и учёт небольшой** — облачный сервис дешевле, см.
  [WooCommerce и МойСклад](https://wpcraft.ru/integrations/woocommerce/moysklad.md).
- **Нужны только заказы в CRM** — это [WooCommerce и Битрикс24](https://wpcraft.ru/integrations/woocommerce/bitrix24.md).
- **Нужен только перенос каталога один раз** — это миграция, а не синхронизация.

## Сценарии

### Каталог и цены из 1С → витрина

- **Событие:** в 1С сформирован пакет обмена каталогом (`mode=file`, затем `mode=import`).
- **Направление:** 1С → WooCommerce.
- **Сущности:** товар, характеристика, тип цены, ставка налога, единица измерения.
- **Результат:** товары и вариации обновлены по GUID, цены пересчитаны, лишние позиции сняты с
  публикации без удаления истории заказов.

### Остатки → доступность на сайте

- **Событие:** регламентная выгрузка остатков из 1С или событие изменения остатка.
- **Направление:** 1С → WooCommerce.
- **Сущности:** остаток по складу, резерв, статус наличия.
- **Результат:** `stock_quantity` и `stock_status` отражают остаток; при нуле товар недоступен к
  заказу или помечен «под заказ» — правило фиксируется заранее.

### Заказ → документ в 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С, остаток по контрольному складу.

## Источники

- [1С: протокол обмена с сайтом](https://v8.1c.ru/tekhnologii/obmen-dannymi-i-integratsiya/standarty-i-formaty/protokol-obmena-s-saytom/)
- [1С: стандарты и форматы обмена данными](https://v8.1c.ru/tekhnologii/obmen-dannymi-i-integratsiya/standarty-i-formaty/)
- [WooCommerce REST API: Products](https://woocommerce.github.io/woocommerce-rest-api-docs/#products)
- [WooCommerce REST API: Orders](https://woocommerce.github.io/woocommerce-rest-api-docs/#orders)