# UPS + Krokul CRM

Так. Krokul CRM інтегрується з UPS. Менеджер порівнює сервіси й ціни UPS в угоді, створює відправлення з етикеткою та номером відстеження, а Krokul стежить за посилкою через події UPS Track Alert до самої доставки. Винятки й доставка потрапляють у стрічку угоди, і на сайт UPS ніхто не заходить.

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

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

### Сервіс вибирають, бачачи ціну

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

### Етикетка й номер відстеження з угоди

Krokul передає в UPS Shipping API отримувача з контакту угоди, адресу контрагента й вагу посилки. UPS повертає ідентифікатор відправлення, номер відстеження для кожної посилки й зображення етикетки. Етикетка відкривається для друку з відправлення в угоді, а номер відстеження потрапляє в стрічку угоди.

### Статус доставки без опитування

Одразу після створення етикетки Krokul підписує номер відстеження в UPS Track Alert. Далі UPS надсилає в Krokul TrackingEvent на кожне сканування. Тип activityStatus I означає, що посилка в дорозі, а тип D з actualDeliveryDate закриває відправлення як доставлене.

### Винятки стають задачами

activityStatus типу X повідомляє Krokul, що UPS зафіксувала виняток із посилкою. Krokul ставить задачу власнику угоди з описом статусу й місцем з події. Подія U з новою scheduledDeliveryDate оновлює очікувану дату у відправленні, і клієнт отримує правильну відповідь.

### Скасування відправлення, яке не має їхати

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

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

| UPS | Krokul | Напрям | Коли |
|---|---|---|---|
| Address Validation | Адреса контрагента | Krokul → UPS | Перед першою відправкою на нову адресу |
| Rating (Shop, Shoptimeintransit) | Вибір сервісу й ціни в угоді | UPS → Krokul | Менеджер готує відправлення |
| Відправлення (запит ship) | Отримувач, адреса, посилки з угоди | Krokul → UPS | Менеджер створює відправлення |
| ShipmentIdentificationNumber, номер відстеження, етикетка | Відправлення в угоді, стрічка угоди | UPS → Krokul | Одразу після створення відправлення |
| Підписка Track Alert | Номер відстеження відправлення | Krokul → UPS | Одразу після створення етикетки |
| TrackingEvent (activityStatus I, U, D) | Статус відправлення й очікувана дата | UPS → Krokul | Кожне сканування UPS |
| TrackingEvent (activityStatus X) | Задача власнику угоди | UPS → Krokul | UPS фіксує виняток |
| Скасування відправлення (void) | Скасоване відправлення | Krokul → UPS | Менеджер скасовує до забору |

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

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

1. Установіть перевірений вузол UPS у n8n і підключіть його своїми Client ID і Client Secret від UPS. Застосунок Krokul підключіть ключем API Krokul.
2. Почніть з тригера Krokul «Етап угоди змінено» з фільтром на ваш етап відправки.
3. Використайте операції вузла UPS Validate і Get Rates для адреси й ціни, потім Create, щоб створити відправлення.
4. Запишіть номер відстеження в угоду дією Krokul «Додати активність» і запускайте Track за розкладом для відкритих відправлень.

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

1. Випустіть у Krokul ключ API зі scope на угоди, контакти, активності й задачі. Створіть застосунок на порталі розробників UPS і отримайте токен OAuth за client credentials.
2. Підпишіть вебхук Krokul на card.statusChanged з фільтром statusUuid на ваш етап відправки й перевіряйте x-crm-signature.
3. Викличте UPS Shipping API, збережіть ідентифікатор відправлення в угоді через externalRef/api-set і запишіть номер відстеження через activity/api-create.
4. Підпишіть номер відстеження в UPS Track Alert і на кожен TrackingEvent оновлюйте угоду або відкривайте задачу через task/api-create.

**Дії:** Validate; Get Rates; Create; Track.

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

UPS публікує на GitHub файли OpenAPI для Shipping, Rating, Tracking, Track Alert, Address Validation і Paperless Documents, а для тестів є окреме середовище Customer Integration Environment. Доступ іде через OAuth. Для власного акаунта це client credentials, а для відправника, який підключає свій акаунт до вашого застосунку, authorization code. На боці Krokul номер відправлення UPS зберігається як externalRef в угоді, а підписані вебхуки Krokul несуть зміну етапу, з якої починається відправка.

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

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

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

Так. Krokul порівнює тарифи UPS, створює з угоди відправлення з етикетками й номерами відстеження та оновлює статус доставки з подій UPS Track Alert.

### Як Krokul дізнається, що посилку UPS доставлено?

Через вебхук UPS Track Alert. UPS надсилає TrackingEvent з activityStatus типу D і actualDeliveryDate, і Krokul позначає відправлення в угоді доставленим.

### Чи бачить менеджер ціни UPS до створення етикетки?

Так. UPS Rating API з опцією Shop або Shoptimeintransit повертає тарифи всіх сервісів UPS між двома адресами, а друга опція додає ще й строки доставки.

### Які облікові дані UPS потрібні Krokul?

Client ID і Client Secret застосунку з порталу розробників UPS, а також ваш шестизначний номер акаунта UPS, на який виставляється оплата відправлення.

## Обмеження

Забори посилок, рахунки й претензії лишаються в акаунті UPS. UPS Track Alert приймає до 100 номерів відстеження в одному запиті на підписку, і для нього UPS документує лише локаль en_US.

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

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

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

UPS є торговою маркою United Parcel Service of America, Inc. Krokul не афілійований з UPS.

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

---

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