POSTRA

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.

Testing

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.

Printouts, number ranges

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.


Authentication

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.


Pickup order, MessageAction = PICKUP_ORDER

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.

Transport orders for parcels and letters, MessageAction = PARCEL_ORDER

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.

Transport orders for domestic freight (FI), MessageAction = FREIGHT_ORDER

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 and use cases

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.1.

POSTRA XML schema can be found here. Last updated: 05.11.2019. (Previous update 2.11.2018).

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