Так. Krokul CRM інтегрується з Укрпоштою через eCom API. Менеджер створює відправлення прямо з картки угоди, а Krokul заводить в Укрпошті адресу й одержувача, повертає штрихкод і сам оновлює статус посилки в угоді.
Менеджер відкриває угоду й натискає «Відправити Укрпоштою». Krokul бере ім’я, телефон і адресу з її контакту, створює в Укрпошті адресу (/addresses), клієнта-одержувача (/clients) і відправлення (/shipments) саме в тому порядку, якого вимагає документація. Штрихкод з’являється у відправленні угоди й у її стрічці.
Для оплати при отриманні менеджер вказує суму, і Krokul передає її в поле postPay відправлення. Укрпошта приймає postPay не більше за declaredPrice, тому Krokul сам ставить оголошену цінність не нижче за цю суму. Стан переказу післяплати Krokul читає з /transfers/shipment-postpays/{barcode}/with-recipient і закриває оплату в угоді, коли гроші переказано.
За розкладом Krokul читає /shipments/{barcodeOrUuid}/lifecycle для кожного активного штрихкоду. Статуси на зразок IN_DEPARTMENT чи DELIVERED з’являються в стрічці угоди, а за правилом компанії угода переходить на потрібний етап. Менеджер бачить, де посилка, і не відкриває трекінг окремо.
Коли відправлення отримує статус RETURNING, Krokul ставить відповідальному задачу з угодою й штрихкодом. Менеджер устигає зателефонувати клієнту, поки посилка їде назад, а статус RETURNED фіксує в угоді, що товар повернувся.
Адресний ярлик відправлення менеджер друкує з картки угоди. Для передачі кількох посилок на відділення Krokul збирає вибрані відправлення й отримує від сервісу форм Укрпошти супровідну форму 103а, яку склад друкує одним файлом.
| Укрпошта | Напрям | Krokul | Коли |
|---|---|---|---|
Адреса (/addresses) і клієнт-одержувач (/clients) | Krokul → Укрпошта | Контакт угоди: ім’я, телефон, адреса | Менеджер створює відправлення |
Відправлення (/shipments): вага, declaredPrice, postPay, deliveryType | Krokul → Укрпошта | Відправлення угоди й сума післяплати | Одразу після створення одержувача |
| Штрихкод відправлення | Укрпошта → Krokul | Відправлення в картці угоди, стрічка угоди | У відповідь на створення відправлення |
Життєвий цикл (/lifecycle): IN_DEPARTMENT, DELIVERED, RETURNING, RETURNED | Укрпошта → Krokul | Статус відправлення, запис у стрічці, етап угоди | Krokul опитує за розкладом, доки відправлення активне |
| Статус RETURNING | Укрпошта → Krokul | Задача відповідальному | Відправлення їде назад до відправника |
| Переказ післяплати | Укрпошта → Krokul | Оплата-факт угоди | Коли Укрпошта переказала гроші |
| Адресний ярлик і форма 103а | Укрпошта → Krokul | Кнопки друку у відправленні та в реєстрі відправлень | На запит менеджера чи складу |
card.won або card.statusChanged з фільтром за етапом. Кожна доставка несе заголовок x-crm-signature, який ви перевіряєте своїм секретом.card/api-read.externalRef/api-upsert, а статуси з /lifecycle записуйте в стрічку угоди через activity/api-create.Так. Krokul бере одержувача з контакту угоди, створює адресу, клієнта й відправлення в Укрпошті й показує штрихкод у відправленні угоди.
Krokul сам перепитує життєвий цикл відправлення за штрихкодом, бо Укрпошта не надсилає подій. Статус DELIVERED записується в угоду, і опитування цього відправлення припиняється.
Договір з Укрпоштою. За ним менеджер видає bearer для eCom і для StatusTracking, токен контрагента та окремі значення для тестового середовища, які використовує ваш потік або підключення Krokul до Укрпошти.
Так. Сума післяплати йде в поле postPay, а коли Укрпошта переказала гроші, Krokul проводить оплату в угоді фактом.
Укрпошта не надсилає подій про зміну статусу, тому Krokul читає життєвий цикл відправлення за розкладом. Доступ до API Укрпошта видає за договором, і ключі для бойового й тестового середовищ різні.
Напишіть, яким сервісом ви користуєтесь і що має ходити між ним і Krokul. Ми відповімо способом і строком.
Запит отримано. Відповімо на вашу пошту.
Укрпошта є торговою маркою її власника. Krokul не афілійований з Укрпоштою.