# Meest + Krokul CRM

Так. Krokul CRM інтегрується з Meest ПОШТА через API Meest 3.0. Посилка створюється з картки угоди методом POST /parcel, штрихкод і стікер лишаються у відправленні, а події трекінгу Meest Krokul сам записує в угоду. Потік між сервісами збирають на API та підписаних вебхуках Krokul.

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

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

### Посилка Meest з виграної угоди

Менеджер натискає «Відправити Meest» в угоді. Krokul підставляє одержувача з контакту угоди, вагу й платника, а її номер передає в orderNumber. Посилка створюється методом POST /parcel, і Meest повертає parcelID та barCode, які Krokul зберігає у відправленні.

### Хто платить і чи можна післяплату

Поле receiverPay посилки вирішує, чи платить за доставку одержувач, чи відправник. Krokul бере його з налаштування компанії, а в угоді менеджер може змінити. Перед створенням посилки з післяплатою Krokul читає allowedCOD з /contractClientInfo/{contractID} і показує суму COD лише там, де договір її дозволяє.

### Стікер 100×100 з картки угоди

Після створення посилки менеджер друкує стікер Meest прямо з відправлення. Krokul отримує його методом /print/sticker100/{printValue}, тож складу не потрібен доступ до кабінету Meest.

### Події трекінгу Meest у стрічці угоди

Щодня й протягом дня Krokul читає /trackingByDate/{searchDate}, знаходить угоду за barCode посилки й додає в стрічку подію з eventDateTime та описом. Подія вручення переводить угоду на наступний етап за правилом компанії, а повернення ставить менеджеру задачу.

### Міста й відділення без помилок у назвах

У формі посилки місто й відділення вибираються зі списку, який Krokul бере з довідників Meest /citySearch і /branchSearch. Так у посилку не потрапляє відділення, якого немає.

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

| Meest | Krokul | Напрям | Коли |
|---|---|---|---|
| Довідники /citySearch і /branchSearch | Поля міста й відділення у формі посилки | Meest → Krokul | Під час заповнення форми |
| Посилка (POST /parcel): одержувач, weight, receiverPay, payType, orderNumber | Угода й контакт угоди | Krokul → Meest | Менеджер створює посилку |
| Післяплата COD і allowedCOD договору | Сума післяплати у відправленні | Krokul → Meest | Під час створення посилки |
| parcelID і barCode | Відправлення в картці угоди, стрічка угоди | Meest → Krokul | У відповідь на створення посилки |
| Стікер 100×100 (/print/sticker100) | Кнопка друку у відправленні | Meest → Krokul | На запит менеджера |
| Події трекінгу: eventDateTime, eventCode, опис | Статус відправлення, стрічка й етап угоди | Meest → Krokul | Krokul опитує /trackingByDate і /tracking/{trackNumber} |

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

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

1. Отримайте в Meest логін і пароль до API та номер договору contractID. Токен видає POST /auth, а продовжує /refreshToken.
2. У Krokul заведіть ключ API зі scope на угоди й контакти та підпишіть вебхук на `card.statusChanged` з фільтром за етапом відправки. Заголовок `x-crm-signature` кожної доставки звіряйте зі своїм секретом.
3. Обробник бере одержувача з угоди через `card/api-read`, створює посилку POST /parcel і прив’язує parcelID до угоди через `externalRef/api-upsert`.
4. За розкладом читайте /trackingByDate і додавайте кожну подію трекінгу в стрічку угоди через `activity/api-create`.

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

Посилки Meest доступні й через публічний API Krokul, а parcelID прив’язується до угоди зовнішнім ключем `externalRef`, тож склад зі своєю системою знаходить угоду за номером посилки. Подію про готовність до відправки дає підписаний вебхук `card.statusChanged` з фільтром за етапом. Пропущену доставку вебхука видно в журналі й можна повторити.

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

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

### Чи можна створити посилку Meest з угоди в Krokul?

Так. Krokul заповнює одержувача з контакту угоди, створює посилку через API Meest і зберігає штрихкод у відправленні угоди.

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

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

### Хто платить за доставку Meest?

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

### Чи підтримує інтеграція післяплату Meest?

Так, якщо її дозволяє договір. Krokul перевіряє allowedCOD договору й лише тоді передає суму COD у посилку.

## Обмеження

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

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

- [Нова пошта](https://krokul.com/uk/integrations/nova-poshta/index.md)
- [Укрпошта](https://krokul.com/uk/integrations/ukrposhta/index.md)
- [Rozetka](https://krokul.com/uk/integrations/rozetka/index.md)
- [Хорошоп](https://krokul.com/uk/integrations/horoshop/index.md)
- [Prom.ua](https://krokul.com/uk/integrations/prom-ua/index.md)

[Доставка (Україна)](https://krokul.com/uk/integrations/category/delivery-ua/index.md)

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

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

---

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