Побудовано на офіційному 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.
Що з’явиться, коли підключення відкриється
- Накладна із замовлення — у відділення або кур’єром до дверей
- Накладений платіж і вибір, хто платить за доставку
- Друк наліпки 100×100 і скасування накладної до здачі посилки
- Статуси відправлень з офіційного трекінгу, включно з поверненням відправнику
Готовність підключення
- 1
Що вже збудовано
Створення накладної через eCom API: відділення або кур’єр, накладений платіж, вибір платника доставки, друк наліпки й скасування до здачі посилки. Трекінг за Status Tracking API з перекладом офіційних кодів подій у статуси CRM.
- 2
Що ще потрібно
Для створення накладних потрібні ваші власні ключі eCom — Укрпошта видає їх за договором з магазином, разом із тестовими ключами для пісочниці. Підключення в CRM ще в розробці.
- 3
Як ви дізнаєтесь
Залиште заявку кнопкою «Залишити заявку» — ми повідомимо, коли підключення Укрпошти відкриється у вашому робочому просторі.
Часті запитання
Чи можна створювати накладні?
Коли підключення відкриється — так. Накладну створюватимете із замовлення через eCom API Укрпошти: у відділення або кур’єром, з накладеним платежем, вибором платника доставки й друком наліпки. Для цього потрібні ваші ключі eCom з договору з Укрпоштою.
Звідки беруться статуси?
З офіційного Status Tracking API Укрпошти: ми переводимо офіційні коди подій (10100, 21700, 41000 тощо) у статуси відправлення — зокрема повернення відправнику й скасування прийому.
Чи безпечний токен?
Так — коли підключення відкриється, токен зберігатиметься на сервері, ніколи не передаватиметься в браузер і використовуватиметься лише для запитів до Укрпошти.
Слідкуйте за запуском Укрпошти
Залиште заявку — ми повідомимо, коли підключення Укрпошти відкриється. Спробуйте Obriym CRM безкоштовно вже зараз.
Почати безкоштовно