﻿---
title: "WooCommerce и МойСклад: товары, остатки и заказы"
description: "Каталог, цены и остатки из МойСклад в WooCommerce и заказы обратно: сценарии, соответствие полей, варианты реализации и лимиты JSON API."
---

**Кратко:** МойСклад остаётся источником товаров, цен и остатков, а WooCommerce — витриной и приёмом
заказов. Заказ уходит в учёт документом «Заказ покупателя», отгрузка и оплата возвращаются статусом.
Готовый продуктовый сценарий WPCraft — [WooMS](https://wpcraft.ru/labs/wooms): плагин синхронизации,
эта страница описывает связку в целом, а не заменяет его документацию. Уровень проверки `documented`.

## Кратко

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

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

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

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

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

## Сценарии

### Товар и модификации → карточка 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: каталог, цены, остатки и
  заказы. Подходит, когда нужен готовый сценарий и поддержка; см.
  [карточку решения](https://wpcraft.ru/integrations/solutions/wooms.md) и
  [страницу продукта](https://wpcraft.ru/labs/wooms).
- **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 и МойСклад](https://wpcraft.ru/integrations/solutions/wooms.md) — Открытый плагин, который
  переносит каталог, цены и остатки из МойСклад в WooCommerce и отправляет заказы обратно в учёт
  документами.

## Источники

- [МойСклад JSON API 1.2](https://dev.moysklad.ru/doc/api/remap/1.2/)
- [МойСклад: справочник товаров](https://dev.moysklad.ru/doc/api/remap/1.2/dictionaries/#suschnosti-towar)
- [МойСклад: заказ покупателя](https://dev.moysklad.ru/doc/api/remap/1.2/documents/#dokumenty-zakaz-pokupatela)
- [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)