# Shippo + Krokul CRM

Так. Krokul CRM інтегрується з Shippo. Krokul передає в Shippo адресу клієнта й посилки угоди, показує в угоді тарифи перевізників і купує вибрану етикетку як Shippo Transaction, щойно угоду виграно. Далі оновлення трекінгу Shippo повертають статус посилки в угоду. Звʼязка працює через застосунок Krokul у Zapier, Make чи Albato або через API і вебхуки Krokul.

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

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

### Тарифи перевізників у відкритій угоді

Клієнт питає ціну доставки ще до підпису. Менеджер вносить в угоду вагу й розміри посилки, і Krokul створює Shippo Shipment від адреси вашого складу до адреси контрагента. Shippo відповідає переліком Rates від перевізників вашого рахунку, кожен із ціною й орієнтовним строком. Менеджер вибирає один, і тариф лишається в угоді разом із пропозицією.

### Виграна угода отримує етикетку

Коли угоду виграно, Krokul надсилає Transaction для збереженого тарифу. Shippo купує етикетку й повертає номер відстеження та посилання на етикетку. Krokul зберігає обидва у відправленні угоди, а файл етикетки кладе посиланням, готовим для пакувального столу.

### Статуси трекінгу рухають угоду

Кожен номер відстеження з відправлення Krokul реєструється в Shippo, і кожен вебхук track_updated приходить в угоду зі статусом і місцем сканування. DELIVERED переводить угоду на етап доставленого. Статус FAILURE чи RETURNED відкриває задачу менеджеру клієнта, і той дзвонить клієнту того ж дня.

### Склад, що купує етикетки в Shippo

Деякі склади пакують у застосунку Shippo. Тоді Krokul створює з виграної угоди Shippo Order з номером угоди як номером замовлення й рядком на кожен товар. Коли склад купує етикетку в Shippo, вебхук transaction_created повертає номер відстеження в ту саму угоду.

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

| Shippo | Krokul | Напрям | Коли |
|---|---|---|---|
| Shipment із Rates | Угода, адреса контрагента, розміри посилки | Krokul ↔ Shippo | Менеджер готує пропозицію |
| Transaction (посилання на етикетку, номер відстеження) | Відправлення виграної угоди, файл етикетки посиланням | Krokul → Shippo | Угоду виграно |
| Order з номером замовлення й рядками | Виграна угода з товарними рядками | Krokul → Shippo | Склад купує етикетки в Shippo |
| Етикетка, куплена в Shippo (transaction_created) | Номер відстеження в угоді | Shippo → Krokul | Для замовлення створено етикетку |
| Track (track_updated) | Статус відправлення й етап угоди | Shippo → Krokul | Приходить сканування перевізника |
| Статус Track FAILURE чи RETURNED | Задача менеджеру клієнта | Shippo → Krokul | Доставка не вдалась або посилка повертається |

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

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

1. Підключіть застосунок Krokul ключем API Krokul.
2. Почніть із тригера Krokul Deal Won. У Zapier додайте дію Shippo Create Order, у Make використайте Create a Shipment і потім Create Label by Rate.
3. Для зворотного шляху почніть із New Shipping Label у Zapier чи Watch Shipping Labels у Make і завершіть діями Krokul Add Comment і Change Deal Stage.

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

1. У порталі Shippo скопіюйте тестовий токен (починається з shippo_test_), пізніше живий. У Krokul створіть ключ API з правами на угоди й активності.
2. Підпишіть вебхук Krokul на card.won через webhook/api-upsert і перевіряйте x-crm-signature на кожній доставці. Угоду читайте через card/api-read.
3. Створіть Shippo Shipment, купіть вибраний тариф через /transactions, зареєструйте номер відстеження в /tracks і збережіть його в угоді через externalRef/api-upsert.
4. Спрямуйте вебхук Shippo track_updated на свій приймач із секретним токеном в URL. Кожне сканування записуйте через activity/api-create, а на DELIVERED переводьте угоду через card/api-updateStatus.

**Тригери:** New Shipping Label; New Order; Watch Shipments; Watch Shipping Labels; Watch Parcels.

**Дії:** Create Order; Create a Shipment; Create Label by Rate; Find a Shipping Label; Find an Order.

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

Shippo автентифікує виклики заголовком авторизації ShippoToken, а тестові токени справжніх етикеток не купують. Приймач вебхука мусить повернути 2XX протягом трьох секунд. Krokul ставить роботу в чергу вже після відповіді. Shippo захищає доставки токеном в URL, списком дозволених IP або підписом HMAC, який Shippo вмикає на запит. Krokul додає REST API, підписані вебхуки з журналом доставок, зовнішні ключі для номерів відстеження й пісочницю.

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

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

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

Так. Krokul інтегрується з Shippo для тарифів, етикеток, замовлень і трекінгу через застосунок Krokul у Zapier, Make і Albato, а також через API і вебхуки Krokul.

### Якими перевізниками може їхати угода?

Будь-яким перевізником, підключеним до вашого рахунку Shippo. Krokul показує Rates, які Shippo повертає для відправлення, і зберігає той, що вибрав менеджер.

### Чи можна перевірити потік, не платячи за етикетки?

Так. Тестові токени Shippo повертають тестові етикетки й номери відстеження, а пісочниця Krokul тримає тестові угоди окремо від вашої справжньої воронки.

### Що, як Shippo надішле те саме оновлення трекінгу двічі?

Shippo попереджає, що вебхуки трекінгу не ідемпотентні, і повторна реєстрація може дублювати сповіщення. Krokul реєструє кожен номер відстеження один раз і пропускає сканування, яке вже записав.

## Обмеження

Рахунки перевізників, оплата етикеток і повернення коштів за невикористані етикетки лишаються в Shippo. Shippo повторює невдалу доставку вебхука двічі, тому приймач, що лежав довше, наздоганяє стан з обʼєкта Track.

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

- [ShipStation](https://krokul.com/uk/integrations/shipstation/index.md)
- [UPS](https://krokul.com/uk/integrations/ups/index.md)
- [FedEx](https://krokul.com/uk/integrations/fedex/index.md)
- [DHL Express](https://krokul.com/uk/integrations/dhl-express/index.md)
- [Shopify](https://krokul.com/uk/integrations/shopify/index.md)

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

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

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

---

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