# FedEx + Krokul CRM

Так. Krokul CRM інтегрується з FedEx через API FedEx. Менеджер порівнює тарифи й строки доставки FedEx в угоді, Krokul створює відправлення FedEx з етикеткою й номером відстеження та замовляє забір курʼєром. Далі вебхуки трекінгу FedEx передають кожне сканування в Krokul, тож угода показує, де посилка, і рухається далі після доставки.

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

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

### Клієнт чує справжню ціну й дату

Поки угода відкрита, менеджер вводить вагу пакунка, і Krokul надсилає адресу контрагента в FedEx Rates and Transit Times API. Krokul показує кожен сервіс FedEx з тарифом вашого рахунку й очікуваним строком доставки. Вибраний сервіс зберігається у відправленні угоди.

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

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

### Курʼєра замовляють у Krokul

Склад вибирає час готовності, і Krokul надсилає Pickup Request для цього рахунку FedEx і адреси. Підтвердження забору зберігається поруч із відправленням. FedEx відхиляє час готовності в минулому, тому Krokul пропонує лише майбутні проміжки.

### Події трекінгу оновлюють угоду

Krokul підписує кожен новий номер відстеження на FedEx Advanced Integrated Visibility. Кожне сканування приходить вебхуком і зʼявляється у відправленні з часом і місцем. Подія доставки переводить угоду на наступний етап, а виняток відкриває задачу менеджеру клієнта.

### Адресу перевіряють до відправки

Krokul надсилає адресу контрагента у FedEx Address Validation API ще до створення етикетки. Для США й Канади відповідь також каже, чи адреса ділова чи житлова, а від цього залежить тариф.

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

| FedEx | Krokul | Напрям | Коли |
|---|---|---|---|
| Тарифи й строки доставки | Відправлення угоди (сервіс і ціна) | FedEx → Krokul | Менеджер готує пропозицію |
| Відправлення з номером відстеження й етикеткою | Виграна угода й адреса контрагента | Krokul → FedEx | Менеджер підтверджує відправку |
| Запит на забір і підтвердження | Час забору у відправленні | Krokul ↔ FedEx | Склад задає час готовності |
| Подія вебхука трекінгу | Статус відправлення, етап угоди після доставки | FedEx → Krokul | Кожне сканування посилки |
| Подія винятку | Задача менеджеру клієнта | FedEx → Krokul | FedEx повідомляє про затримку чи проблему |
| Результат перевірки адреси | Адреса контрагента | FedEx → Krokul | До створення етикетки |

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

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

1. Створіть проєкт на FedEx Developer Portal, привʼяжіть 9-значний номер рахунку FedEx і візьміть ключ і секрет API для пісочниці й продакшну.
2. Створіть ключ API Krokul для угод, документів і активностей та підпишіть свій сервіс на card.won через webhook/api-upsert. Перевіряйте x-crm-signature на кожній доставці.
3. Прочитайте угоду через card/api-read, створіть відправлення FedEx і збережіть номер відстеження в угоді через externalRef/api-upsert.
4. Підпишіть номер відстеження на вебхук FedEx, перевіряйте fdx-signature своїм security token, записуйте кожну подію через activity/api-create і переводьте угоду через card/api-updateStatus після доставки.

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

API FedEx працюють із токеном доступу OAuth, який клієнт кешує, доки не отримає 401. Кожен проєкт FedEx обмежений 1 400 транзакціями за 10 секунд. Понад це Krokul ставить виклики в чергу. Пакетний трекінг приймає до 30 номерів за виклик, а Address Validation до 100 адрес. Krokul дає власним інтеграціям підписані вебхуки, зовнішні ключі для номерів відстеження й REST API.

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

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

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

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

### Що потрібно від FedEx, щоб підключитись?

Номер рахунку FedEx і проєкт на FedEx Developer Portal з привʼязаним рахунком. Проєкт дає ключ і секрет API, якими користується Krokul.

### Чи опитує Krokul FedEx щодо трекінгу?

Ні. Krokul підписує кожен номер відстеження на вебхуки трекінгу FedEx і отримує сканування, щойно вони стаються. Для рахунків без вебхуків Krokul може перевіряти відкриті відправлення пакетами до 30 номерів.

### Що, як події FedEx приходять не по черзі?

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

## Обмеження

Для відправок через API FedEx потрібен номер рахунку FedEx, привʼязаний до проєкту на FedEx Developer Portal. FedEx виставляє плату за вебхуки трекінгу щомісяця за кожен підписаний номер відстеження і не гарантує, що події прийдуть у тому порядку, в якому стались.

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

- [DHL Express](https://krokul.com/uk/integrations/dhl-express/index.md)
- [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)
- [WooCommerce](https://krokul.com/uk/integrations/woocommerce/index.md)

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

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

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

---

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