# DHL Express + Krokul CRM

Так. Krokul CRM інтегрується з DHL Express через MyDHL API. З виграної угоди Krokul отримує тариф DHL, створює відправлення з етикеткою, а для експорту ще й митний інвойс із рядків угоди, і замовляє забір курʼєром. Далі Krokul перевіряє трекінг DHL для кожної відкритої накладної й тримає статус в угоді.

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

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

### Експортне замовлення їде з виграної угоди

Менеджер відкриває відправлення виграної угоди, вказує кількість місць і вагу, а Krokul запитує в MyDHL API тариф і дату доставки. Після підтвердження Krokul створює Shipment, зберігає номер накладної й етикетку в угоді та додає митний інвойс із назвами товарів, кількістю й вартістю кожного рядка.

### Забір курʼєром замовляється тим самим кроком

MyDHL API приймає запити Pickup поруч зі створенням відправлення. Krokul замовляє забір на дату, яку вибрав склад, і записує підтвердження у відправлення угоди.

### Статус трекінгу в угоді

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

### Перевірка адреси до накладної

Перед створенням відправлення Krokul перевіряє адресу контрагента сервісом адрес MyDHL API. Хибний поштовий індекс менеджер виправляє в Krokul, поки посилка ще на складі.

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

| DHL Express | Krokul | Напрям | Коли |
|---|---|---|---|
| Тариф і дата доставки | Відправлення угоди | DHL Express → Krokul | Менеджер готує відвантаження |
| Shipment з етикеткою й митним інвойсом | Виграна угода, рядки, адреса контрагента | Krokul → DHL Express | Менеджер підтверджує відправлення |
| Номер накладної й етикетка | Відправлення угоди, зовнішній ключ | DHL Express → Krokul | Одразу після створення відправлення |
| Запит на забір і підтвердження | Дата забору у відправленні | Krokul ↔ DHL Express | Разом із відправленням |
| Події трекінгу | Статус відправлення; етап угоди після доставки | DHL Express → Krokul | Перевірка відкритих накладних за розкладом |
| Перевірка адреси | Адреса контрагента | DHL Express → Krokul | Перед накладною |

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

### Застосунок Krokul у Make чи n8n

1. Підключіть застосунок Krokul із ключем API.
2. Почніть із тригера Krokul Deal Status Changed і для накладної з угоди запустіть Track a Shipment (Unified) чи Get a Shipment Status у Make або Get Tracking Details у n8n.
3. Тригерів DHL на цих платформах не дає, тому кожен результат повертайте в Krokul дією Add Comment.

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

1. На developer.dhl.com запросіть доступ до MyDHL API з номером рахунку DHL Express і отримайте ключ трекінгу від застосунку з Shipment Tracking - Unified.
2. У Krokul випустіть ключ API для угод і документів і підпишіть свій сервіс на card.won через webhook/api-upsert. Перевіряйте заголовок x-crm-signature, перш ніж щось відвантажувати.
3. Прочитайте угоду та її рядки через card/api-read, створіть відправлення DHL з етикеткою й митним інвойсом і збережіть номер накладної в угоді через externalRef/api-upsert.
4. За розкладом перевіряйте трекінг відкритих накладних, додавайте кожну подію через activity/api-create і переводьте угоду через card/api-updateStatus, коли DHL повідомить про доставку.

**Дії:** Track a Shipment (Unified); Get a Shipment Status; Get Tracking Details.

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

MyDHL API працює з базовою автентифікацією за обліковими даними від DHL, а тестове середовище дозволяє 500 запитів на добу. Shipment Tracking - Unified API починається з 250 запитів на добу й одного запиту на пʼять секунд. Для власних збірок Krokul дає REST API, підписані вебхуки на кшталт card.won, зовнішні ключі для номерів накладних і тестову компанію (пісочницю).

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

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

### Що потрібно від DHL для підключення?

Рахунок клієнта DHL Express з його номером, доступ до MyDHL API через портал розробників DHL і ключ API трекінгу від схваленого застосунку.

### Чи складає Krokul митний інвойс?

Так. Krokul заповнює його з рядків угоди: назви товарів, кількість, ціна за одиницю й валюта. Менеджер перевіряє інвойс до створення накладної.

### Як часто оновлюється статус трекінгу?

Krokul перевіряє відкриті накладні за розкладом, який вкладається в денний ліміт запитів DHL, і припиняє перевірку, коли DHL повідомляє про доставку.

## Обмеження

Потрібні рахунок клієнта DHL Express і облікові дані MyDHL API, які видає DHL. DHL обмежує кількість запитів трекінгу на добу, тому Krokul перевіряє лише відкриті накладні й зупиняється, щойно відправлення доставлено.

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

- [ShipStation](https://krokul.com/uk/integrations/shipstation/index.md)
- [Shopify](https://krokul.com/uk/integrations/shopify/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)

DHL і DHL Express є торговими марками Deutsche Post AG. Krokul не афілійований з DHL.

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

---

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