# Adobe Commerce (Magento) + Krokul CRM

Так. Krokul CRM інтегрується з Adobe Commerce (Magento). Оформлене замовлення (sales order) стає угодою Krokul з рядками, зіставленими за SKU. Krokul записує кількість source item назад у магазин, а відвантажена угода створює shipment у Magento з трек-номером. Інвойси й credit memo з Commerce видно в угоді. Зв’язка працює через застосунок Krokul у Zapier, Make, n8n чи Albato або через API і вебхуки Krokul разом із REST API Commerce.

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

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

### Замовлення Magento стає угодою

Коли покупець оформлює замовлення, Adobe I/O Events сповіщає конектор Krokul, і той читає sales order через REST API. Krokul знаходить покупця серед контактів, прив’язує компанію з платіжної адреси (billing company) до контрагента й відкриває угоду, позиції якої вказують на товари Krokul з тим самим SKU. Increment ID замовлення стає зовнішнім ключем угоди.

### Залишки джерел ідуть за складом Krokul

Кожен склад Krokul відповідає джерелу запасів (inventory source) у Commerce. Коли залишок у Krokul змінюється, конектор оновлює кількість source item для цього SKU. Вітрина й відділ продажів бачать однаковий залишок.

### Відвантаження з угоди створює shipment у Commerce

Коли угоду відвантажено з трек-номером, Krokul викликає дію ship для sales order з відвантаженими позиціями й трекінгом перевізника. Commerce змінює стан замовлення, і менеджеру не треба писати коментар вручну.

### Інвойси й credit memo замовлення в угоді

Інвойс, створений у Commerce, записує суму в оплату угоди. Credit memo записує повернення коштів і переводить угоду на етап, який ви вказали, тож фінанси й продажі читають одну історію.

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

| Adobe Commerce | Krokul | Напрям | Коли |
|---|---|---|---|
| Sales order (подія оформлення, потім читання через REST) | Угода з рядками за SKU, increment ID як ключ | Adobe Commerce → Krokul | Оформлено замовлення |
| Інвойс замовлення | Оплата в угоді | Adobe Commerce → Krokul | На замовлення виставлено інвойс |
| Credit memo | Повернення в угоді, зміна етапу | Adobe Commerce → Krokul | Створено credit memo |
| Shipment із трекінгом | Відправлення угоди | Krokul → Adobe Commerce | Угоду відвантажено |
| Кількість source item | Залишок за складом | Krokul → Adobe Commerce | Залишок змінився в Krokul |
| Customer | Контакт і контрагент | Adobe Commerce ↔ Krokul | Створено покупця або контрагента |

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

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

1. Підключіть застосунок Krokul ключем API.
2. З’єднайте тригер Magento New Order з дією Krokul Create Deal, а New Customer з Create Contact.
3. Від тригера Magento New Sales Order Credit Memo запускайте дію Krokul Create Task для менеджера клієнта.
4. Тригер Krokul Deal Stage Changed поєднайте з Create Sales Order Comment, щоб працівники магазину бачили погодження B2B.

### Власний потік через API і вебхуки Krokul

1. В адмінці Commerce відкрийте System → Extensions → Integrations і активуйте інтеграцію з доступом до продажів, каталогу, запасів і покупців. У Krokul випустіть ключ API зі scope на угоди, контакти, контрагентів і оплати.
2. Для кожного нового sales order знайдіть покупця через contact/api-find, додайте нову компанію з платіжної адреси через clientCompany/api-create і відкрийте угоду через card/api-create.
3. Збережіть increment ID на угоді через externalRef/api-upsert, а кожен інвойс Commerce проводьте через payment/api-create з cardUuid цієї угоди.
4. Підпишіть вебхук на card.statusChanged і перевіряйте заголовок x-crm-signature своїм секретом. На етапі відвантаження викликайте дію ship для sales order з трек-номером.

**Тригери:** New Order; New Customer; New Sales Order Invoice; New Sales Order Shipment; New Sales Order Credit Memo.

**Дії:** Create Customer; Create Sales Order Comment.

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

Webhooks в Adobe Commerce виконують синхронні перевірки, під час яких Commerce чекає відповіді. Тому конектор бере сповіщення про замовлення з Adobe I/O Events, а читає й записує через REST API. Krokul дає публічний REST API, підписані вебхуки з журналом доставок, зовнішні ключі для increment ID і SKU та тестову компанію для пробних прогонів.

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

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

### Чи працює інтеграція з Magento Open Source?

Так. Потік спирається на REST API, спільний для Magento Open Source і Adobe Commerce. Сповіщення про замовлення через Adobe I/O Events потребують Adobe Commerce, тому на Magento Open Source потік читає нові замовлення за розкладом.

### Як обробляються кілька джерел запасів Commerce?

Кожен склад Krokul ви зіставляєте з одним джерелом. Krokul записує кількість для кожного source item, а Commerce рахує доступну для продажу кількість (salable quantity) як завжди.

### Чи зіставляються B2B-акаунти компаній Adobe Commerce?

Компанія з платіжної адреси замовлення стає контрагентом Krokul. Спільні каталоги, погоджувані пропозиції й погодження замовлень на закупівлю лишаються в Adobe Commerce.

### Де видно, чому замовлення не синхронізувалось?

В історії запусків вашого потоку. Там названо sales order і крок, що впав, наприклад невідомий SKU. На боці Krokul журнал доставок вебхуків показує кожну надіслану подію й дає повторити її після виправлення.

## Обмеження

B2B-можливості Adobe Commerce, як-от спільні каталоги, погоджувані пропозиції (negotiable quotes), списки закупівель і погодження замовлень на закупівлю, лишаються в Commerce. Krokul веде покупця, угоду, склад і доставку.

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

- [Shopify](https://krokul.com/uk/integrations/shopify/index.md)
- [WooCommerce](https://krokul.com/uk/integrations/woocommerce/index.md)
- [BigCommerce](https://krokul.com/uk/integrations/bigcommerce/index.md)
- [Amazon](https://krokul.com/uk/integrations/amazon/index.md)
- [ShipStation](https://krokul.com/uk/integrations/shipstation/index.md)

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

Adobe Commerce і Magento є торговими марками Adobe Inc. Krokul не афілійований з Adobe.

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

---

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