Built on the official Status Tracking API
The adapter is built from Ukrposhta's official documentation (dev.ukrposhta.ua), not copied from another carrier: real endpoints, Bearer authorization, and the official status event codes.
Technical details
- Base
- https://www.ukrposhta.ua/status-tracking/0.0.1
- Authorization
- Authorization: Bearer {UUID}
- Endpoint
- GET /statuses/last?barcode=&lang=en
- CRM endpoint
- POST /api/v1/adapters/ukrposhta/{id}/tracking
Official event-code mapping
Ukrposhta numeric codes map to CRM shipment statuses.
What you'll get once connecting opens
- A waybill from the order — to a branch or by courier to the door
- Cash on delivery and a choice of who pays for delivery
- A 100×100 label and cancelling the waybill before the parcel is handed in
- Shipment statuses from the official tracking, returns to sender included
Connection readiness
- 1
What's already built
Waybill creation via the eCom API: branch or courier, cash on delivery, the delivery payer, label printing and cancelling before handover. Tracking via the Status Tracking API, with the official event codes translated into CRM statuses.
- 2
What's still needed
Creating waybills needs your own eCom keys — Ukrposhta issues them under a merchant contract, together with test keys for its sandbox. Connecting in the CRM is still in development.
- 3
How you'll know
Leave a request with the "Leave a request" button — we'll tell you when connecting Ukrposhta opens in your workspace.
Frequently asked questions
Can I create waybills?
Once connecting opens — yes. You'll create the waybill from the order via Ukrposhta's eCom API: to a branch or by courier, with cash on delivery, the delivery payer and label printing. It needs your eCom keys from your Ukrposhta contract.
Where do statuses come from?
From the official Ukrposhta Status Tracking API: we translate the official event codes (10100, 21700, 41000, etc.) into shipment statuses — returns to sender and cancelled receptions included.
Is the token secure?
Yes — once connecting opens, the token will be stored server-side, never exposed to the browser, and used only for requests to Ukrposhta.
Follow the Ukrposhta launch
Leave a request — we'll tell you when connecting Ukrposhta opens. Try Obriym CRM for free right now.
Start for free