Побудовано на офіційному Status Tracking API
Адаптер реалізовано за офіційною документацією Укрпошти (dev.ukrposhta.ua), а не за аналогією з іншим перевізником: реальні ендпоінти, авторизація Bearer і офіційні event-коди статусів.
Технічні деталі
- База
- https://www.ukrposhta.ua/status-tracking/0.0.1
- Авторизація
- Authorization: Bearer {UUID}
- Ендпоінт
- GET /statuses/last?barcode=&lang=en
- CRM endpoint
- POST /api/v1/adapters/ukrposhta/{id}/tracking
Маппінг офіційних event-кодів
Числові коди Укрпошти переводяться у статус відправлення CRM.
Що можна робити в CRM
- Накладна із замовлення — у відділення або кур’єром, пріоритетний чи базовий тариф
- Накладений платіж і вибір, хто платить за доставку
- Друк наліпки 100×100 і скасування накладної до здачі посилки
- Перевірка власних eCom-ключів, робоче й тестове середовища
- Читання статусів через API для зовнішнього воркера — автоматичного оновлення в CRM поки немає
Як підключити
- 1
Додайте Укрпошту
У центрі інтеграцій створіть адаптер Укрпошти й відкрийте його налаштування.
- 2
Введіть ключі й перевірте
Оберіть тестове або робоче середовище. Введіть відповідні eCom Bearer, токен користувача та телефон відправника. Перевірка з’єднання не створює адрес чи відправлень.
- 3
Збережіть відправника
Заповніть реквізити, збережіть відправника через API і перевірте збережене підключення. Тоді створіть тестову накладну із тестового замовлення. Токен Status Tracking вводиться окремо для зовнішнього воркера.
Часті запитання
Чи можна створювати накладні?
Так — із замовлення через eCom API: у відділення чи кур’єром, з накладеним платежем і друком наліпки. Потрібні власні eCom-ключі Укрпошти; для тесту оберіть пісочницю з тестовою парою ключів.
Звідки беруться статуси?
З офіційного Status Tracking API через зовнішній воркер. CRM читає коди подій, включно з поверненнями й скасуваннями. Власного автоматичного опитування Укрпошти поки немає.
Чи безпечний токен?
Так — обидва eCom-ключі й токен трекінгу зберігаються зашифрованими на сервері. Збережені секрети не повертаються у браузер.
Підключіть власні ключі Укрпошти
Почніть із перевірки з’єднання та тестової накладної у пісочниці.
Почати безкоштовно