# ShipHero + Krokul CRM

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

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

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

### Виграні угоди потрапляють у чергу фулфілменту

Коли угоду виграно у воронці, що відвантажується зі складу ShipHero, Krokul викликає `order_create` з номером угоди як `partner_order_id`, адресою доставки контрагента й кожним рядком товару з його SKU і кількістю. Великі B2B-замовлення йдуть через `wholesale_order_create`, де живуть дані вантажного перевезення на зразок перевізника й коносамента. ShipHero повертає ідентифікатор замовлення, і Krokul зберігає його в угоді.

### Посилки повертаються з трекінгом

ShipHero надсилає вебхук Shipment Update, щойно посилка виїхала. Krokul знаходить угоду за `partner_order_id`, читає `tracking_number` і `shipping_carrier` з етикетки кожної посилки, записує відправлення й переводить угоду на етап доставки. Замовлення у двох коробках дає два номери відстеження в одній угоді.

### Залишки складу видно під час пропозиції

Кожен вебхук Inventory Update несе SKU, кількості inventory і on_hand та ідентифікатор складу. Krokul записує ці числа на склад, повʼязаний із цим складом ShipHero. Менеджер, що складає пропозицію, бачить, що ShipHero може відвантажити сьогодні, а резерви відкритих угод і далі рахуються від цього числа в Krokul.

### Дефіцит і скасування бачить менеджер

Вебхуки Order Backorder і Order Canceled стають задачею власнику угоди з номером замовлення й SKU, яких бракує. Менеджер дзвонить клієнту до того, як зсунеться дата доставки.

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

| ShipHero | Krokul | Напрям | Коли |
|---|---|---|---|
| Замовлення (`order_create`, partner_order_id, shipping_address, line_items) | Виграна угода з рядками й адресою контрагента | Krokul → ShipHero | Угоду виграно |
| Гуртове замовлення (`wholesale_order_create`) | Виграна B2B-угода з вантажним перевезенням | Krokul → ShipHero | Угоду виграно у вантажній воронці |
| Зміна чи скасування замовлення | Змінена або програна угода | Krokul → ShipHero | До відвантаження |
| Shipment Update (tracking_number, shipping_carrier) | Відправлення угоди, етап доставки | ShipHero → Krokul | Посилку відвантажено |
| Inventory Update (sku, inventory, on_hand, склад) | Залишки складу ShipHero у Krokul | ShipHero → Krokul | Залишок на складі змінився |
| Order Backorder, Order Canceled | Задача власнику угоди | ShipHero → Krokul | ShipHero не може відвантажити, як замовлено |

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

### Застосунок Krokul у Make

1. Підключіть застосунок Krokul ключем API Krokul, а застосунок ShipHero токеном оновлення користувача third-party developer з панелі ShipHero.
2. Почніть із тригера Krokul Deal Won і надішліть замовлення модулем ShipHero Execute a GraphQL Query з мутацією `order_create`.
3. Другий сценарій почніть із Watch Shipments і завершіть діями Krokul Change Deal Stage та Add Comment для номера відстеження.

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

1. Створіть у ShipHero користувача third-party developer і збережіть його токени доступу й оновлення. У Krokul видайте ключ API на угоди, товари, склад і активності.
2. Підпишіть вебхук Krokul на card.won з фільтром pipelineUuid, перевіряйте x-crm-signature, читайте угоду через card/api-read і викликайте `order_create` на public-api.shiphero.com/graphql.
3. Зареєструйте Shipment Update та Inventory Update мутацією `webhook_create` і збережіть `shared_signature_secret`, який вона повертає один раз.
4. Перевіряйте x-shiphero-hmac-sha256 на кожній доставці, знаходьте угоду через externalRef/api-resolve, переводьте її через card/api-updateStatus і пишіть залишки через stock/api-adjust.

**Тригери:** Watch Shipments; Watch Inventory Updates; Watch Order Cancellations; Watch Backorders; Watch Order Allocations; Watch Order Packouts; Watch PO Updates; Watch Returns; Watch Completed Totes; Watch Cleared Totes.

**Дії:** Execute a GraphQL Query; Update an Order; Update an Order Status; Get Orders; Get Products.

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

ShipHero підписує кожен вебхук значенням HMAC-SHA256 у base64 в заголовку `x-shiphero-hmac-sha256` і чекає відповіді 2xx 10 секунд. Після 5 невдалих повторів на тригер вебхук може перейти в стан UNHEALTHY і вимкнутись, а події цього часу губляться. Krokul відповідає до обробки. Нічне читання з `updated_at_min` тримає Krokul у відповідності. Krokul дає публічний REST API, підписані вебхуки з журналом доставок, зовнішні ключі для ідентифікаторів замовлень ShipHero і пісочницю.

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

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

### Чи інтегрується Krokul із ShipHero?

Так. Krokul інтегрується з ShipHero через застосунок Krokul у Make та через API і вебхуки Krokul разом із GraphQL API ShipHero.

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

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

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

Так. Угоди у вантажній воронці йдуть у ShipHero як гуртові замовлення з полями перевізника, способу доставки й коносамента.

### Що, коли ShipHero не може виконати замовлення?

Вебхук Order Backorder створює задачу власнику угоди з SKU, яких бракує, тож про затримку клієнт дізнається від менеджера.

## Обмеження

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

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

- [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)
- [Extensiv](https://krokul.com/uk/integrations/extensiv/index.md)

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

ShipHero є торговою маркою ShipHero, LLC. Krokul не афілійований з ShipHero.

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

---

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