Побудовано на офіційному 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.
Що ви отримуєте
- Bearer-токен (UUID) зберігається окремо від секрету адаптера
- Перевірка зʼєднання валідовує токен до першого запиту
- Запит на список штрихкодів повертає мапнуті статуси
- Клікабельне посилання на сторінку відстеження Укрпошти
Підключення
- 1
Отримайте Bearer-токен
Authorization bearer (UUID) видається в Додатку до договору з Укрпоштою.
- 2
Вставте токен і перевірте
Введіть токен у налаштуваннях адаптера й натисніть «Перевірити зʼєднання».
- 3
Опитуйте трекінг
Воркер шле список barcode на /tracking з X-Adapter-Secret і отримує статуси.
Часті запитання
Чи можна створювати накладні?
У v1 — трекінг статусів. Створення декларації через eCom API заплановано окремо як v2 (це багатокроковий процес).
Звідки беруться статуси?
З офіційного Status Tracking API Укрпошти; ми мапимо офіційні event-коди (10100, 20700, 41000 тощо) на статуси відправлення.
Чи безпечний токен?
Так — він зберігається на сервері, ніколи не передається у браузер, і використовується лише для запитів до Укрпошти.
Додайте трекінг Укрпошти
Статуси відправлень оновлюються автоматично за офіційним API.
Почати безкоштовно