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.


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

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