# Епіцентр + Krokul CRM

Так. Krokul CRM інтегрується з маркетплейсом Епіцентр через Merchant API продавця. Замовлення з кабінету Епіцентру стає угодою з товарами вашого каталогу, а покупець стає контактом. Назад в Епіцентр ідуть статус замовлення, номер ТТН і коментарі менеджера, а ціни й наявність оферів оновлюються зі складу Krokul.

**Статус:** Через API і вебхуки.

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

### Замовлення Епіцентру у воронці продажу

Krokul запитує /v4/oms/orders з фільтром filter[updatedAt][from] і проходить сторінки курсором. Кожне нове замовлення стає угодою «Епіцентр № …» у воронці підключення, а номер замовлення стає її зовнішнім ключем. Позиції замовлення зіставляються з товарами каталогу Krokul за артикулом продавця, тому резерв на складі ставиться одразу. Повторне читання дубля не створює.

### Етап угоди змінює статус замовлення

Менеджер підтверджує замовлення в Krokul, і угода переходить на етап «Підтверджено». Krokul читає дозволені переходи з /v2/oms/orders/{orderId}/allowed-statuses і викликає change-status з кодом confirmed_by_merchant. Для скасування Krokul передає причину з довідника Епіцентру, наприклад product_not_available, і закриває угоду як програну з тією самою причиною.

### ТТН з картки угоди в кабінет

Відправлення Новою поштою чи Укрпоштою менеджер створює в угоді. Номер ТТН Krokul записує в замовлення методом PATCH /v1/oms/orders/{orderId}/shipment-number. За документацією Епіцентру цей номер вмикає трекінг і завершує замовлення, коли посилку забрано, а статус completed закриває угоду як виграну.

### Ціни й наявність оферів зі складу Krokul

Коли змінюється залишок чи ціна товару, Krokul надсилає пакет у POST /v1/offers з полями availability і prices.price за артикулом. Епіцентр приймає до 1000 позицій в одному запиті й повертає requestId. За ним Krokul читає результат кожної позиції, а позиції зі статусом skipped чи forbidden показує в журналі з кодом помилки.

### Коментарі до замовлення в стрічці угоди

Коментарі до замовлення з /v2/oms/orders/{orderId}/comments з’являються в стрічці угоди поруч із листуванням. Нотатку для Епіцентру менеджер пише в угоді, і Krokul додає її до коментарів замовлення в кабінеті продавця.

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

| Епіцентр | Krokul | Напрям | Коли |
|---|---|---|---|
| Замовлення (/v4/oms/orders) | Угода «Епіцентр № …» із зовнішнім ключем | Епіцентр → Krokul | Опитування за часом останньої зміни |
| Позиції замовлення | Рядки угоди з товарами каталогу | Епіцентр → Krokul | Разом з угодою |
| Дані клієнта (ПІБ, телефон) | Контакт угоди | Епіцентр ↔ Krokul | Нове замовлення або правка контакту |
| Статус замовлення (change-status) | Етап угоди | Епіцентр ↔ Krokul | Зміна етапу в Krokul чи статусу в кабінеті |
| Причина скасування | Причина втрати угоди | Епіцентр ↔ Krokul | Скасування замовлення |
| Номер ТТН (shipment-number) | Відправлення угоди | Krokul → Епіцентр | Після створення ТТН |
| Коментарі замовлення | Записи в стрічці угоди | Епіцентр ↔ Krokul | Новий коментар з будь-якого боку |
| Офер: ціна й наявність (/v1/offers) | Товар і залишок на складі | Krokul → Епіцентр | Зміна ціни чи залишку |

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

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

1. Попросіть категорійного менеджера Епіцентру відкрити вкладку API в налаштуваннях компанії й згенеруйте там токен продавця з префіксом mp_.
2. У Krokul створіть ключ API зі scope на угоди, контакти й товари. За розкладом читайте /v4/oms/orders, для кожного нового замовлення викликайте `card/api-create` і зберігайте номер замовлення через `externalRef/api-upsert`.
3. Підпишіть вебхук Krokul на `card.statusChanged` з фільтром за воронкою, перевіряйте заголовок `x-crm-signature` і переводьте замовлення в Епіцентрі методом change-status.
4. Номер ТТН з угоди передавайте в PATCH /v1/oms/orders/{orderId}/shipment-number, а відповідь кожного виклику записуйте в стрічку угоди через `activity/api-create`.

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

Merchant API Епіцентру приймає токен продавця в заголовку Authorization і віддає всі дати в UTC. З боку Krokul зв’язку тримають публічний API, вебхуки з підписом HMAC-SHA256, журнал доставок із повтором і зовнішні ключі `externalRef` для замовлень і товарів. Потік можна прогнати на демо-компанії в пісочниці Krokul.

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

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

### Чи є в Krokul інтеграція з маркетплейсом Епіцентр?

Так. Замовлення Епіцентру стають угодами з товарами каталогу, а статус, ТТН, коментарі, ціни й наявність повертаються в кабінет продавця.

### Де взяти токен Merchant API Епіцентру?

У кабінеті продавця, на вкладці API в налаштуваннях компанії. Вкладку відкриває категорійний менеджер, бо API працює в закритому бета-тесті для частини компаній.

### Як швидко замовлення з Епіцентру з’являється в Krokul?

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

### Чи можна скасувати замовлення Епіцентру з картки угоди?

Так. Менеджер закриває угоду як програну й вибирає причину, а Krokul передає скасування з відповідною причиною з довідника Епіцентру.

## Обмеження

Епіцентр не надсилає подій про нові замовлення, тому Krokul читає список замовлень за розкладом і бере ті, що змінились після попереднього проходу. Merchant API працює в закритому бета-тесті для частини компаній, і вкладку API в налаштуваннях компанії відкриває ваш категорійний менеджер.

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

- [Rozetka](https://krokul.com/uk/integrations/rozetka/index.md)
- [Prom.ua](https://krokul.com/uk/integrations/prom-ua/index.md)
- [Хорошоп](https://krokul.com/uk/integrations/horoshop/index.md)
- [Нова пошта](https://krokul.com/uk/integrations/nova-poshta/index.md)
- [Meest](https://krokul.com/uk/integrations/meest/index.md)
- [Checkbox](https://krokul.com/uk/integrations/checkbox/index.md)

[Маркетплейси й магазини (Україна)](https://krokul.com/uk/integrations/category/marketplaces-ua/index.md)

Епіцентр є торговою маркою її власника. Krokul не афілійований з Епіцентром.

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

---

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