Shipping · Ukrposhta
Ukrposhta — a waybill directly from the order
BetaBeta: available to connect today; the channel’s capabilities are still being refined.
Enter your own keys, test the connection and create branch or courier waybills. Start with the sandbox. Beta: you can connect today; channel capabilities are still being refined.
Status Tracking API · dev.ukrposhta.ua
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
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.
Official event-code mapping
What you can do in the CRM
- Waybills from orders — branch or courier delivery, Priority or Basic service
- Cash on delivery and a choice of delivery payer
- 100×100 labels and cancellation before handing over the parcel
- Connection tests for your eCom keys, production and sandbox environments
- Status lookup through an API for an external worker — automatic CRM refresh is not available yet
How to connect
- 01
Add Ukrposhta
Create a Ukrposhta adapter in the Integration Center and open its settings.
- 02
Enter and test your keys
Choose sandbox or production, then enter the matching eCom bearer, user token and sender phone. The connection test creates no addresses or shipments.
- 03
Save the sender
Fill in the sender details, save the sender through the API and test the saved connection. Then create a sandbox waybill on a test order. Enter the separate Status Tracking token for your external worker.
Frequently asked questions
- Can I create waybills?
- Yes — from an order via the eCom API, with branch or courier delivery, cash on delivery and labels. Use your Ukrposhta eCom keys; select the sandbox with its separate test key pair for testing.
- Where do statuses come from?
- From the official Status Tracking API through an external worker. CRM maps event codes, including returns and cancellations. Automatic Ukrposhta polling is not available yet.
- Is the token secure?
- Yes — both eCom keys and the tracking token are encrypted on the server. Stored secrets are not returned to the browser.