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

WooCommerce

WooCommerce — платформа каталога: на ней живут товары, корзина, заказы и статусы. Внешние системы получают из неё коммерческие события и возвращают учётные данные.

Магазин отвечает за витрину и оформление заказа: карточки товаров, варианты, цены для покупателя, корзину, оплату, доставку и статус заказа. Учётные системы владеют себестоимостью, складом и документами, CRM — клиентом и сделкой. Эти роли не совпадают, и интеграция нужна именно для их разграничения.

Способ Что даёт Когда уместен Ограничения
REST API /wp-json/wc/v3/ Товары, варианты, заказы, клиенты, купоны, отчёты Чтение и запись по запросу, первичная загрузка каталога Ключи с правами read/write; пагинация по 100 записей; нагрузка на сервер
Вебхуки WooCommerce Событие order.created, order.updated, customer.created с подписью Реакция на заказ в секунды Доставка не гарантирована: нужна реконсиляция и повторные попытки
Хуки плагинов (woocommerce_*) События внутри WordPress с полным объектом заказа Точечная логика внутри сайта Код живёт в плагине/теме и требует сопровождения
Импорт/экспорт CSV Массовая правка каталога вручную Разовые работы и сверка Нет транзакций, легко получить частичную запись

Вебхук подписывается секретом: заголовок X-WC-Webhook-Signature содержит base64 от HMAC-SHA256 сырого тела запроса. Подпись нужно проверять до разбора JSON, иначе endpoint принимает подделку.

  • Статусы — это данные, а не только состояние. Набор статусов расширяется плагинами и кастомным кодом; внешняя система должна знать про pending, processing, on-hold, completed, cancelled, refunded, failed и про собственные wc-* статусы.
  • Заказ меняется несколько раз. Создание, оплата, изменение состава и отмена — разные события; обработчик должен быть идемпотентным по order_id.
  • Варианты товаров. Вариативный товар — родитель и набор вариаций; синхронизация только родителя теряет цены и остатки вариантов.
  • Остатки. При manage_stock WooCommerce хранит числовой остаток, иначе — статус наличия; это разные модели, и учётная система должна договориться, какая из них источник правды.
  • Производительность. REST API выполняет полный bootstrap WordPress: массовая выгрузка каталога через API заметно дороже файлового обмена.
  • WooMS: связка WooCommerce и МойСклад — Открытый плагин, который переносит каталог, цены и остатки из МойСклад в WooCommerce и отправляет заказы обратно в учёт документами.