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

WooCommerce и МойСклад: товары, остатки и заказы

Кратко: МойСклад остаётся источником товаров, цен и остатков, а WooCommerce — витриной и приёмом заказов. Заказ уходит в учёт документом «Заказ покупателя», отгрузка и оплата возвращаются статусом. Готовый продуктовый сценарий WPCraft — WooMS: плагин синхронизации, эта страница описывает связку в целом, а не заменяет его документацию. Уровень проверки documented.

  • Задача: не вести каталог дважды и не продавать товар, которого нет на складе.
  • Что проверено: JSON API 1.2 по товарам, модификациям, ценам, остаткам и заказам; лимит частоты; пагинация; инкрементальная выборка по updated; REST API WooCommerce по товарам и заказам.
  • Уровень: documented; воспроизводимого стенда с реальным аккаунтом МойСклад не было.
  • Что не проверено: набор типов цен, складов и правил округления в вашем аккаунте.

Связка нужна, когда учёт уже ведётся в МойСклад (или компания готова туда перейти), а магазин работает на WooCommerce: номенклатура большая, цены меняются, остатки общие для нескольких каналов продаж.

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

  • Магазин — единственный канал и учёт не нужен — синхронизация добавляет сложность без пользы.
  • Учёт ведётся в 1С — это отдельная связка, см. WooCommerce и 1С.
  • Нужны только заказы в CRM — см. WooCommerce и Битрикс24.
  • Событие: в МойСклад создан товар с модификациями или изменены его атрибуты; планировщик находит запись по updated.
  • Направление: МойСклад → WooCommerce.
  • Сущности: товар, модификация, единица измерения, вес и габариты, категория.
  • Результат: в WooCommerce появляется простой или вариативный товар, модификации становятся вариациями, внешний код связывает записи и повторный импорт обновляет карточку, а не создаёт дубль.
  • Событие: отгрузка или поступление изменили остаток; в МойСклад обновлена цена типа «Цена продажи».
  • Направление: МойСклад → WooCommerce.
  • Сущности: остаток по складу, цена, статус наличия.
  • Результат: stock_quantity и regular_price обновляются; при нулевом остатке товар получает outofstock, если магазин не принимает заказы под заказ.

Заказ → «Заказ покупателя» и обратный статус

Заголовок раздела «Заказ → «Заказ покупателя» и обратный статус»
  • Событие: покупатель оформляет заказ в WooCommerce.
  • Направление: WooCommerce → МойСклад → WooCommerce.
  • Сущности: заказ, контрагент, позиции, склад, организация, отгрузка.
  • Результат: в учёте появляется заказ покупателя с позициями и контрагентом; после отгрузки магазин получает статус «Отгружен» и, при оплате, «Оплачен».
Событие в МойСклад Действие в WooCommerce Примечание
Изменение товара (updated) Создание или обновление товара Модификации — отдельные вариации
Изменение цены regular_price и sale_price Тип цены фиксируется в настройке
Изменение остатка stock_quantity / stock_status Нужно решить, учитывать ли резервы
Новая отгрузка по заказу Статус completed Только при явном сопоставлении
Оплата Статус processing Если оплата приходит в учёт
Событие в WooCommerce Действие в МойСклад Примечание
order.created Создание «Заказа покупателя» Контрагент создаётся или находится
order.updated (состав) Обновление позиций документа Позиции пересобираются целиком
Отмена заказа Отмена документа Отмена ≠ удаление
Возврат Отдельный документ возврата Сумма и причина передаются явно

Инкрементальная синхронизация строится на выборке с фильтром updated>=<метка> и сортировкой по времени изменения. Метка сохраняется после успешной обработки страницы, иначе обмен повторяет одни и те же записи или пропускает изменения.

  • WooMS — открытый плагин синхронизации МойСклад и WooCommerce от WPCraft: каталог, цены, остатки и заказы. Подходит, когда нужен готовый сценарий и поддержка; см. карточку решения и страницу продукта.
  • Custom-интеграция — свой плагин и воркер: полный контроль над маппингом цен, складов и правил округления. Дороже в разработке, дешевле в эксплуатации при нестандартных правилах.
  • iPaaS — сценарий без кода для небольших каталогов; ограничение — объём и лимит операций.
  • Файловый обмен — выгрузка из МойСклад и импорт CSV. Уместен для разовой загрузки, не для остатков.

Если каталог большой и меняется постоянно, ключевой критерий выбора — не «есть ли коннектор», а кто владеет ценой и остатком и как обрабатывается расхождение.

Объект МойСклад Объект WooCommerce Ключ соответствия Примечание
Товар Товар externalCode ↔ sku или мета-поле Внешний код создаётся интеграцией
Модификация Вариация externalCode Родитель и вариация создаются по порядку
Цена типа продажи regular_price — Валюта должна совпадать
Остаток по складу stock_quantity — Склад фиксируется в настройке
Заказ покупателя Заказ order_id во внешнем коде Ключ идемпотентности
Контрагент Покупатель Телефон, email Дедупликация обязательна
Отгрузка, оплата Статус заказа Таблица соответствия Не каждая отгрузка меняет статус

Владелец данных: МойСклад владеет номенклатурой, ценами, остатками и документами; WooCommerce — витриной, корзиной и заказом покупателя. Названия и описания товаров удобнее вести на стороне магазина, а учётные атрибуты — в МойСклад; это правило нужно зафиксировать до запуска, иначе системы будут перетирать друг друга.

  • Создать отдельного пользователя МойСклад с минимальными правами и токеном доступа.
  • Зафиксировать тип цены, склад и организацию для заказов.
  • Определить, что считается остатком: физический остаток или доступно с учётом резервов.
  • Проверить сопоставление единиц измерения, веса и габаритов с полями WooCommerce.
  • Прогнать на staging: импорт 10 товаров с модификациями, изменение цены, нулевой остаток, заказ, отгрузка, повторная выгрузка той же страницы.
  • Настроить журнал: сущность, идентификатор, действие, код ответа, длительность.
  • Лимит частоты. Документация ограничивает число запросов за интервал (порядка 45 запросов за 3 секунды) и размер страницы; при распродаже или первичной загрузке нужен троттлинг и очередь.
  • Модификации. Цены и остатки живут на уровне модификаций; синхронизация только родительского товара оставляет вариации с нулевыми данными.
  • Позиции документа. Заказ и отгрузка собираются из позиций отдельным вызовом; частичная запись оставляет документ без состава — нужен повтор и сверка суммы.
  • Удаление товара. Удаление в учёте не равно удалению на витрине: товар лучше снимать с публикации, сохраняя историю заказов.
  • Резервы и oversell. Между выгрузкой остатка и оформлением заказа остаток может измениться; для распродаж нужен резерв на стороне учёта или контрольный запас.
  • Расхождения. Ежедневная сверка «заказы магазина ↔ заказы покупателей» и «остаток в учёте ↔ остаток на витрине» — часть интеграции, а не отдельная задача.

Нужен ли WooMS, если у нас нестандартный маппинг цен? WooMS закрывает типовой сценарий; при нестандартных правилах его настройки могут не хватить, и тогда часть логики пишется поверх или вместо него.

Кто создаёт контрагента? Интеграция: при заказе ищет контрагента по телефону и email, создаёт при отсутствии и сохраняет соответствие, иначе в учёте появятся дубли.

Можно ли синхронизировать только остатки? Да, это самостоятельный сценарий: каталог и цены ведутся в магазине, а остаток приходит из учёта. Он проще, но требует договорённости, кто владеет карточкой товара.

Что делать с товарами, которых нет в учёте? Не удалять автоматически: снять с публикации и показать менеджеру список расхождений.

  • WooMS: связка WooCommerce и МойСклад — Открытый плагин, который переносит каталог, цены и остатки из МойСклад в WooCommerce и отправляет заказы обратно в учёт документами.