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.
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
POSTRA XML schema can be found here. Last updated: 2.11.2018
Code list for POSTRA message can be found here. Last updated: 2.11.2018
|Use case||Use case purpose||Message implementation guide||XML-sample||Last updated|
|Pickup order||Issue pickup instructions||Doc||Zip||2.11.2018|
|Transport orders for parcels and letters||Issue instructions regarding parcel and letter services||Doc||Zip||2.11.2018|
|Transport orders for domestic freight (FI)||Issue instructions regarding forwarding/transport services||Doc||Zip||2.11.2018|