# ShipStation + Krokul CRM

Так. Krokul CRM інтегрується з ShipStation. Виграна угода стає замовленням ShipStation з адресою доставки й позиціями, склад купує етикетку в ShipStation як завжди, а відправлення з перевізником і номером відстеження повертається в угоду. Угода сама переходить на ваш етап доставки. Зв’язка працює через застосунок Krokul у Zapier, Make чи Albato або через API і вебхуки Krokul.

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

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

### Виграна угода потрапляє в чергу складу

Коли менеджер виграє угоду у воронці з відвантаженням товару, Krokul створює Order у ShipStation: номер угоди стає номером замовлення, адреса доставки береться з компанії-клієнта, а кожен рядок товару йде з артикулом (SKU) і кількістю. ID замовлення в ShipStation лишається в угоді, тож пізніша правка оновлює той самий Order.

### Номер відстеження повертається в угоду

Коли етикетку створено, ShipStation надсилає SHIP_NOTIFY. Krokul читає відправлення за resource URL із вебхука, записує перевізника й номер відстеження у відправлення угоди та переводить угоду на етап доставки. Відділ продажів бачить трек-номер, не питаючи склад.

### Зміни до відвантаження доходять до замовлення

Якщо клієнт змінив адресу чи кількість, поки замовлення ще чекає в ShipStation, менеджер править угоду, і Krokul оновлює Order у ShipStation. Угода, закрита як програна, ставить Order на утримання (hold), щоб ніхто не відвантажив скасований продаж.

### Замовлення, що приходять у ShipStation з магазину

Замовлення може потрапити в ShipStation і прямо з каналу магазину. ORDER_NOTIFY дає Krokul додати їх угодами для відомих оптових клієнтів із ключем за ID замовлення в ShipStation, тож менеджер клієнта бачить кожну його покупку.

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

| ShipStation | Krokul | Напрям | Коли |
|---|---|---|---|
| Order з адресою доставки й позиціями | Виграна угода з рядками й адресою компанії-клієнта | Krokul → ShipStation | Угоду виграно |
| Оновлення замовлення чи утримання (hold) | Змінена чи програна угода | Krokul → ShipStation | До відвантаження замовлення |
| Відправлення: перевізник, номер відстеження (SHIP_NOTIFY) | Відправлення угоди й етап доставки | ShipStation → Krokul | Етикетку створено |
| Замовлення з каналу магазину (ORDER_NOTIFY) | Угода для відомого клієнта, ID замовлення як ключ | ShipStation → Krokul | У ShipStation з’явилось нове замовлення |

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

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

1. Підключіть застосунок Krokul ключем API.
2. Почніть із тригера Krokul Deal Won і завершіть дією ShipStation Create Order.
3. Для трекінгу почніть із тригера ShipStation Order Shipped і візьміть дію Krokul Change Deal Stage, або Item Shipped з Add Comment для приміток по кожній позиції.

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

1. У ShipStation відкрийте Settings → Account → API Settings і скопіюйте ключ API та секрет. У Krokul створіть ключ API зі scope на угоди й активності.
2. Підпишіть вебхук Krokul на `card.won` з фільтром `pipelineUuid`, перевірте `x-crm-signature`, прочитайте угоду через `card/api-read` і створіть Order у ShipStation.
3. Закріпіть ID замовлення ShipStation за угодою через `externalRef/api-upsert`.
4. На SHIP_NOTIFY прочитайте resource URL, запишіть перевізника й номер відстеження через `activity/api-create` і перемістіть угоду через `card/api-updateStatus`.

**Тригери:** New Order; Order Shipped; Item Ordered; Item Shipped.

**Дії:** Create Order.

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

Вебхуки ShipStation ORDER_NOTIFY, ITEM_ORDER_NOTIFY, SHIP_NOTIFY і ITEM_SHIP_NOTIFY несуть resource URL, який приймач читає, щоб отримати записи. Krokul робить це читання й зберігає ID замовлення ShipStation зовнішнім ключем в угоді. Для власної логіки є REST API Krokul, підписані вебхуки з журналом доставок і тестова компанія.

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

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

### Де купуються етикетки?

У ShipStation. Krokul надсилає замовлення й отримує результат, а склад зберігає свої акаунти перевізників, тарифи й правила пакування.

### Як відправлення ShipStation знаходить свою угоду?

За ID замовлення в ShipStation, який Krokul зберіг в угоді, коли створював замовлення.

### Чи несе замовлення в ShipStation артикули Krokul?

Так. Кожен рядок угоди йде в ShipStation з артикулом (SKU), назвою й кількістю товару Krokul, тож працюють складські правила для товарів.

### Який тариф ShipStation потрібен?

ShipStation зазначає, що її V1 API доступний на певних тарифах. Перед підключенням перевірте, чи у ваш тариф входить доступ до API.

## Обмеження

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

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

- [DHL Express](https://krokul.com/uk/integrations/dhl-express/index.md)
- [Shopify](https://krokul.com/uk/integrations/shopify/index.md)
- [WooCommerce](https://krokul.com/uk/integrations/woocommerce/index.md)
- [Amazon](https://krokul.com/uk/integrations/amazon/index.md)
- [Нова пошта](https://krokul.com/uk/integrations/nova-poshta/index.md)

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

ShipStation є торговельною маркою Auctane LLC. Krokul не пов’язаний з ShipStation.

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

---

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