# Extensiv 3PL Warehouse Manager + Krokul CRM

Так. Krokul CRM інтегрується з Extensiv 3PL Warehouse Manager. Коли ваш товар лежить на складі 3PL-оператора, що працює в Extensiv, кожна виграна угода стає замовленням у 3PL Warehouse Manager з вашими ідентифікаторами клієнта й складу та рядками за SKU. Підтвердження відвантаження, приходи від постачальників і зведені залишки повертаються в Krokul, тож відділ продажу знає, що поїхало зі складу і що лишилось для продажу.

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

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

### Виграні угоди стають замовленнями 3PL

Менеджер виграє угоду на товар, що зберігається в 3PL. Krokul створює замовлення в 3PL Warehouse Manager з вашим ідентифікатором клієнта, ідентифікатором складу, номером угоди як номером-референсом, адресою доставки контрагента й кожним рядком за SKU. Ідентифікатор замовлення Extensiv лишається в угоді, а команда складу бачить замовлення у звичній черзі.

### Підтвердження замовлення закриває крок доставки

Склад підтверджує замовлення після відвантаження, і 3PL Warehouse Manager надсилає подію OrderConfirm із посиланням на ресурс замовлення. Krokul читає замовлення за цим посиланням, записує відправлення в угоді з даними перевізника, які вніс склад, і переводить угоду на етап «доставлено». Подія OrderCancel стає задачею власнику угоди.

### Зведені залишки для пропозицій

На кожну подію Inventory Summary Update Krokul читає зведені залишки вашого клієнта на цьому складі й записує кількості в наявності та доступні до продажу на відповідний склад Krokul. Резерви відкритих угод і далі рахуються в Krokul. Менеджери перестають обіцяти товар, який склад уже розподілив.

### Приходи від постачальників

Коли склад підтверджує приймання, подія Receipt Confirm приходить у Krokul з транзакцією приходу. Krokul позначає прихід у замовленні постачальнику й додає коментар до угод, які чекають на ці SKU.

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

| 3PL Warehouse Manager | Krokul | Напрям | Коли |
|---|---|---|---|
| Замовлення (клієнт, склад, номер-референс, рядки за SKU) | Виграна угода з адресою контрагента | Krokul → Extensiv | Угоду виграно |
| Зміна чи скасування замовлення | Змінена або програна угода | Krokul → Extensiv | До підтвердження замовлення складом |
| Подія OrderConfirm, ресурс замовлення | Відправлення угоди, етап «доставлено» | Extensiv → Krokul | Склад відвантажив і підтвердив |
| Подія OrderCancel | Задача власнику угоди | Extensiv → Krokul | Склад скасовує замовлення |
| Inventory Summary Update, зведені залишки | Залишки складу 3PL у Krokul | Extensiv → Krokul | Кількості на складі змінились |
| Подія Receipt Confirm, прихід | Прихід у замовленні постачальнику | Extensiv → Krokul | Товар прийнято на склад |

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

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

1. Попросіть свій 3PL видати REST API Client ID, Client Secret і user login, потім отримайте токен на secure-wms.com/AuthServer/api/Token з grant client_credentials. У Krokul видайте ключ API на угоди, товари й склад.
2. Підпишіть вебхук Krokul на card.won з фільтром pipelineUuid, перевіряйте x-crm-signature, читайте угоду через card/api-read і створюйте замовлення 3PL з номером угоди як референсом. Зберігайте ідентифікатор замовлення через externalRef/api-upsert.
3. Попросіть склад додати вебхук у Customers > Event Notifications для OrderConfirm, OrderCancel, Receipt Confirm та Inventory Summary Update з обсягом на вашого клієнта й вашою https-адресою.
4. Перевіряйте заголовок Signature публічним ключем із secure-wms.com/events/webhook/key, відповідайте одразу, потім ідіть за resource.href і пишіть у Krokul через card/api-updateStatus, task/api-create і stock/api-adjust.

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

Extensiv підписує повідомлення вебхуків алгоритмом RSA SHA-256 і публікує публічний ключ PEM за сталою адресою. Приймач має три секунди на відповідь. Невдалі доставки повторюються близько шести годин, а потім лежать у черзі недоставлених приблизно три дні. Події можуть приходити не по черзі, тому Krokul упорядковує їх за eventDateTimeUtc. З боку Krokul є публічний REST API, підписані вебхуки з журналом доставок, зовнішні ключі для ідентифікаторів замовлень Extensiv і пісочниця.

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

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

### Чи інтегрується Krokul з Extensiv 3PL Warehouse Manager?

Так. Krokul інтегрується з Extensiv 3PL Warehouse Manager через API і вебхуки Krokul разом із REST API Extensiv та сповіщеннями про події.

### Чий залишок на складі 3PL?

Складу 3PL. 3PL Warehouse Manager веде облік запасів, а Krokul віддзеркалює зведені залишки на окремому складі, який оновлюють лише події Extensiv.

### Чи можна підключитися без свого складу?

Ні. 3PL видає облікові дані API і логін користувача, а вебхуки налаштовуються в його акаунті 3PL Warehouse Manager для вашого клієнта.

### Навіщо Krokul читає замовлення після кожної події?

Подія Extensiv несе тип події, кілька полів і посилання на ресурс. Krokul іде за цим посиланням по повне замовлення чи прихід, якщо склад не ввімкнув повні ресурси в тілі повідомлення.

## Обмеження

Облік запасів у 3PL Warehouse Manager веде склад 3PL, а Krokul показує ці кількості на окремому складі й не змінює їх. Облікові дані API і логін користувача видає ваш склад, і він же вирішує, якими подіями ділитися. Розрахунки між вами і 3PL лишаються в Extensiv.

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

- [ShipHero](https://krokul.com/uk/integrations/shiphero/index.md)
- [ShipStation](https://krokul.com/uk/integrations/shipstation/index.md)
- [Shippo](https://krokul.com/uk/integrations/shippo/index.md)
- [Shopify](https://krokul.com/uk/integrations/shopify/index.md)
- [Amazon](https://krokul.com/uk/integrations/amazon/index.md)
- [FedEx](https://krokul.com/uk/integrations/fedex/index.md)

[Доставка й логістика](https://krokul.com/uk/integrations/category/shipping/index.md)

Extensiv і 3PL Warehouse Manager є торговими марками Extensiv, Inc. Krokul не афілійований з Extensiv.

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

---

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