PassengersParcelsCorporate customersService points
Search
Log in
Front page
Corporate customers
Interfaces

Interfaces

All online store applications can be directly linked to Matkahuolto’s data system via the XML interface.

The XML interface is implemented as an simple XML request to which the reply is given in XML format. The request is submitted to the contact address using the (POST) https protocol. In the request is successful, the sender receives an XML file containing not only the reply but also the address card in pdf format. The pdf is printed and appended to the consignment.

While the XML request is of standard format, there is a number of non-compulsory fields. The https protocol is the only permitted option because the server does not accept any non-encrypted http requests.

Technical description of the interface for label request

Load technical description of the interface

Load example response file

Load example label (pdf)

Technical description of the pickup point search

Load technical description of the pickup point search

Sample files

To facilitate deployment, Matkahuolto offers sample codes in some of the most common web programming languages. The sample codes may be used freely for both private and commercial purposes. The codes may be used as they are or modified at the user’s risk. Please note that the reliability of the sample codes has not been tested under all conditions.

Php: matkahuolto_php.zip

C#: matkahuolto_cs.zip

Java: matkahuolto_java.zip

Ruby: matkahuolto_ruby.zip

Testing and deployment

To test the interface, Matkahuolto’s servers offer a testing environment which returns a reply of correct format to the requests submitted. No consignments submitted using the testing environment are actually processed. Deployment is easy by changing the contact address.

Customer IDs and technical support

For testing and deployment, you will need a free customer ID. You can order it by e-mail from Matkahuolto at verkkokauppapalvelut@matkahuolto.fi.

Additional information on the user or XML interface is provided by the help desk The e-mail address to the help desk is verkkokauppapalvelut@matkahuolto.fi.

Parcel services

Fluent logistics increase your company's sales.
Become a contract customer

Travel services

Travel services for cities, communities and companies.

Contact our sales persons

Contact information on our sales persons in parcel and travel services.