Posti transport orders API
POSTRA is used to issue transportation instruction regarding parcel, letter, freight and parcel pickup services. Guidelines for each service are in separate MIG documents that can be found later on this page. Schema is common for all use cases, but MIG document varies case by case. It's very important to follow MIG more closely than schema validations.
Posti offers a free, self-service validation portal for POSTRA message developers. To get the URL-link of the site, please send request to LogEDI@posti.com. Link is valid for 30 days from the first test.
Printing of address labels and waybills, including unique number ranges (ShipmentNumber, Package/TrackingNumber), must be built in and maintained by customer. All printouts must be sent for validation and acceptance to Posti.
Interface require authentication and authorization process that follows OAuth technology. This means that the client should first retrieve an access token from Posti's authentication service and use that token when sending messages to external interfaces.
The process is described here.
POSTRA is used to issue pickup instructions regarding parcel and letter pickup order services for a shipment under conditions agreed. POSTRA pickup order is used, if separate agreement of regular pickup does not exist. Only customers having contract with Posti parcel services can use pickup order message.
POSTRA is used to issue instructions regarding parcel and letter services for a shipment under conditions agreed. One shipment can consist of several goods items.
POSTRA is used to issue instructions regarding forwarding/transport services for a shipment under conditions agreed. One shipment can consist of several goods items.
Interface is RESTfull web service interface operating in POSTRA message format.
Principals can send inbound messages using HTTP POST method.
URL in UAT environment is https://connect.ja.posti.fi/kasipallo/transportation/v1/orders
URL in production environment is https://connect.posti.fi/transportation/v1/orders
All documentation is based on POSTRA XML schema version 1.2.
POSTRA XML schema can be found here. Last updated: 26.10.2021. (Previous update 5.11.2019).
Code list for POSTRA message can be found here.
|Use case||Use case purpose||Message implementation guide||XML-sample|
|Pickup order||Issue pickup instructions||Doc||Zip|
|Transport orders for parcels and letters||Issue instructions regarding parcel and letter services||Doc||Zip|
|Transport orders for domestic freight (FI)||Issue instructions regarding forwarding/transport services||Doc||Zip|