# WooCommerce + Krokul CRM

Так. У Krokul CRM є нативний конектор WooCommerce. Кожне нове замовлення у вашому магазині на WordPress стає угодою Krokul з рядками, зіставленими з каталогом за артикулом (SKU). Krokul записує залишки й ціни назад у товари WooCommerce, а коли угоду відвантажено, статус замовлення стає completed з приміткою про трекінг. Покупці магазину стають контактами Krokul.

**Статус:** Нативна, Через API і вебхуки. **Платформи автоматизації:** Zapier, Make, n8n, Albato.

## Що отримує команда

### Замовлення WooCommerce відкриває угоду й резервує склад

Вебхук order.created приносить платіжні дані, валюту й кожен рядок замовлення з його SKU. Krokul зіставляє покупця з контактом, відкриває угоду з номером замовлення WooCommerce у назві й привʼязує кожен рядок до товару Krokul з тим самим SKU. Зарезервована кількість одразу виходить із вільного залишку. Менеджер, який продає телефоном, бачить, скільки справді лишилось.

### Залишки й ціни Krokul оновлюють товар у магазині

Коли в Krokul рухається склад або змінюється прайс, конектор записує stock_quantity і regular_price у товар чи варіацію WooCommerce з тим самим SKU. Гуртовий покупець, що замовляє онлайн, бачить ту саму наявність, що й ваша команда продажу.

### Відвантажена угода завершує замовлення WooCommerce

Коли угода доходить до етапу відвантаження і її відправлення має номер для відстеження, Krokul ставить замовленню WooCommerce статус completed і додає Order Note з перевізником і кодом відстеження. WooCommerce надсилає покупцю свій звичайний лист про виконане замовлення.

### Зміни статусу в магазині доходять до угоди

Вебхук order.updated повідомляє Krokul, коли працівники магазину скасовують Order або повертають за ним гроші. Krokul переводить угоду на відповідний етап, знімає резерв і записує повернення на оплаті угоди.

## Що передається між системами

| WooCommerce | Krokul | Напрям | Коли |
|---|---|---|---|
| Замовлення (order.created) | Угода з рядками за SKU, валютою й сумою | WooCommerce → Krokul | Покупець оформлює замовлення |
| Статус замовлення, повернення (order.updated) | Етап угоди, резерв, оплата | WooCommerce → Krokul | Магазин змінює замовлення чи повертає гроші |
| Статус замовлення completed і Order Note | Відвантажена угода з номером для відстеження | Krokul → WooCommerce | Угоду відвантажено |
| stock_quantity товару | Залишок товару на складі | Krokul → WooCommerce | Залишок змінюється в Krokul |
| regular_price товару | Ціна в прайсі | Krokul → WooCommerce | Ціна змінюється в Krokul |
| Покупець (customer.created, customer.updated) | Контакт | WooCommerce ↔ Krokul | Акаунт чи контакт створено або змінено |

## Як підключити сьогодні

### Нативний конектор у «Маркетплейсі»

1. У WordPress відкрийте WooCommerce → Settings (Налаштування) → Advanced (Додатково) → REST API і створіть ключ із правами Read/Write.
2. У «Маркетплейсі» Krokul виберіть WooCommerce, введіть адресу магазину й вставте consumer key і secret. Krokul сам реєструє свої вебхуки в магазині.
3. Задайте воронку, джерело й відповідального для замовлень, потім виберіть, що синхронізувати: замовлення, покупців, залишки, ціни, статус назад у магазин.
4. Запустіть тест. Журнал синхронізації показує кожне замовлення з його ID у WooCommerce, угоду, яку воно відкрило, SKU без відповідного товару й кнопку повтору для невдалих записів.

### Застосунок Krokul у Zapier, Make, n8n чи Albato

1. Підключіть застосунок Krokul ключем API.
2. Поєднайте тригер WooCommerce, наприклад Subscription чи Order Note, з дією Krokul, наприклад Create Task чи Add Comment.
3. Спрямуйте тригер Krokul Invoice Paid у дію WooCommerce Update Order, щоб позначати B2B-замовлення, оплачені банківським переказом, як оплачені.

**Тригери:** Order; Customer; Product; Order Note; Subscription.

**Дії:** Update Order; Create Order Note; Update Product Stock Quantity; Create Customer; Update Customer.

### Для інтеграторів

Krokul перевіряє X-WC-Webhook-Signature, тобто base64 HMAC-SHA256 від сирого тіла, і читає подію з X-WC-Webhook-Topic. WooCommerce вимикає вебхук, коли поспіль не вдалося більше пʼяти доставок, тому журнал Krokul показує вимкнений вебхук як помилку. Для власних доробок є REST API Krokul, підписані вихідні вебхуки, зовнішні ключі для ID замовлень і товарів і тестова компанія.

[Документація API](https://app.krokul.com/api/v1/docs)

## Питання й відповіді

### Чи потрібен плагін WordPress для конектора WooCommerce?

Ні. Конектор використовує ключ REST API і вебхуки, які є в самому WooCommerce.

### Як Krokul зіставляє товари WooCommerce?

За SKU. Прості товари й варіації з тим самим SKU, що й товар Krokul, отримують оновлення залишків і цін. Позиції без збігу потрапляють у журнал синхронізації.

### Чи зберігається компанія з платіжних даних як компанія-клієнт?

Так, коли поле компанії в платіжних даних заповнене. Krokul привʼязує контакт до цієї компанії-клієнта, і наступне замовлення того самого покупця йде до тієї самої компанії.

### Що буде, якщо за замовленням повернули гроші у WooCommerce?

Повернення приходить через order.updated. Krokul записує його на оплаті угоди, знімає резерв і переводить угоду на етап, який ви призначили для повернень.

## Обмеження

Купони, податки, сторінка оформлення замовлення й плагіни вашого сайту на WordPress лишаються у WooCommerce. Krokul веде бік продажу, тобто покупця, угоду, склад і відвантаження.

## Пов’язані сервіси

- [Shopify](https://krokul.com/uk/integrations/shopify/index.md)
- [BigCommerce](https://krokul.com/uk/integrations/bigcommerce/index.md)
- [Adobe Commerce](https://krokul.com/uk/integrations/adobe-commerce/index.md)
- [Форми WordPress](https://krokul.com/uk/integrations/wordpress-forms/index.md)
- [ShipStation](https://krokul.com/uk/integrations/shipstation/index.md)

[Платформи електронної торгівлі](https://krokul.com/uk/integrations/category/ecommerce/index.md)

WooCommerce є торговою маркою Automattic Inc. Krokul не афілійований із WooCommerce.

Оновлено: 2026-10-15

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs
