WooCommerce и МойСклад: товары, остатки и заказы
Кратко: МойСклад остаётся источником товаров, цен и остатков, а WooCommerce — витриной и приёмом
заказов. Заказ уходит в учёт документом «Заказ покупателя», отгрузка и оплата возвращаются статусом.
Готовый продуктовый сценарий WPCraft — WooMS: плагин синхронизации,
эта страница описывает связку в целом, а не заменяет его документацию. Уровень проверки documented.
- Задача: не вести каталог дважды и не продавать товар, которого нет на складе.
- Что проверено: JSON API 1.2 по товарам, модификациям, ценам, остаткам и заказам; лимит частоты;
пагинация; инкрементальная выборка по
updated; REST API WooCommerce по товарам и заказам. - Уровень: documented; воспроизводимого стенда с реальным аккаунтом МойСклад не было.
- Что не проверено: набор типов цен, складов и правил округления в вашем аккаунте.
Когда нужна интеграция
Заголовок раздела «Когда нужна интеграция»Связка нужна, когда учёт уже ведётся в МойСклад (или компания готова туда перейти), а магазин работает на WooCommerce: номенклатура большая, цены меняются, остатки общие для нескольких каналов продаж.
Когда она не нужна:
- Магазин — единственный канал и учёт не нужен — синхронизация добавляет сложность без пользы.
- Учёт ведётся в 1С — это отдельная связка, см. WooCommerce и 1С.
- Нужны только заказы в CRM — см. WooCommerce и Битрикс24.
Сценарии
Заголовок раздела «Сценарии»Товар и модификации → карточка WooCommerce
Заголовок раздела «Товар и модификации → карточка WooCommerce»- Событие: в МойСклад создан товар с модификациями или изменены его атрибуты; планировщик находит
запись по
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 и отправляет заказы обратно в учёт документами.