Delivery Information Management

This service enables the webstore to add, update or delete order delivery information to Svea Payments. Delivery information consists of delivery method and tracking code(s) in case of traceable deliveries or some description in case untraceable deliveries. That is, tracking code is used in case of traceable deliveries, such as Posti or Matkahuolto etc.

Response (XML, common for add, update and delete requests)

Response is a XML document with root element <pmtq> (yes, it should be pkg, but it is pmtq) having following elements under it.

Element name

Value

Format

C/O

Description

Element name

Value

Format

C/O

Description

pkg_version

002

AN4

C

Version of interface content or message

pkg_sellerid

 

AN15

C

Technical seller id given to the webstore by Svea Payments.

pkg_id

 

AN20

C

Unique Payment Identifier given to the payment transaction by the webstore.

pkg_resultcode

 

AN2

C

Response code that indicates either success or failure. Values and explanations of all the codes can be found from section Response code values.

pkg_resulttext

 

AN300

C

OK or brief description of the failure reason.
For example which tracking codes did not pass the the formal validation.
Syntax is: error code: error description
For example: 30:JJFI00000012345123456,30:JJFI00000012345123457

Delivery Method codes

 

Delivery method code

Short description

Description

Delivery method code

Short description

Description

ITELL

Posti (formerly known as Itella) traceable delivery

The products are delivered as a postal parcel or registered letter (Posti). The delivery information can be confirmed as soon as the delivery has a tracking code. The tracking code is for example a JJFI code obtained from Posti and can be used to trace the package in Posti's tracking service.

MATHU

Matkahuolto traceable delivery

The products are delivered as a registered Matkahuolto shipment. The delivery data is processed similarly as Posti's.

KAUKO

Kaukokiito traceable delivery

The products are delivered as a registered Kaukokiito shipment. The delivery data is processed similarly as Posti's.

TRANS

Transpoint traceable delivery

The products are delivered as a registered Transpoint shipment. The delivery data is processed similarly as Posti's.

KIITO

Kiitolinja traceable delivery

The products are delivered as a registered Kiitolinja shipment. The delivery data is processed similarly as Posti's.

MYPAC

MyPack traceable delivery

The products are delivered as a registered MyPack shipment. The delivery data is processed similarly as Posti's.

DBSCH

DB Schenker traceable delivery

The products are delivered as a registered DB Schenker shipment. The delivery data is processed similarly as Posti's.

FEDEX

FedEx traceable delivery

The products are delivered as a registered FedEx shipment. The delivery data is processed similarly as Posti's.

DHLDP

DHL traceable delivery

The products are delivered as a registered DHL shipment. The delivery data is processed similarly as Posti's.

TNTNV

TNT traceable delivery

The products are delivered as a registered TNT shipment. The delivery data is processed similarly as Posti's.

UPSAM

UPS traceable delivery

The products are delivered as a registered UPS shipment. The delivery data is processed similarly as Posti's.

UNREG

Untraceable letter

The products are delivered in a regular letter. The delivery has no tracking code. The delivery information should not be given until the letter has been sent.

PICKU

Pick up

The buyer will pick up the products from the webstore’s outlet. The delivery has no tracking code. The delivery info should not be given until the buyer has picked up the products.

ODLVR

Own delivery

The webstore will deliver the products to the buyer by their own means. The delivery has no tracking code. The delivery info should not be given until the buyer received the products.

SERVI

Service

A service is performed for the buyer. No physical delivery is attached to the order. Service delivery information should not be given until the service has been performed.

ELECT

Electronic delivery

The order is delivered electronically (e.g. per email) and can be consider received immediately upon sending. The delivery has no tracking code. The delivery should not be given until the order has been delivered electronically.

UNREF

Foreign untraceable letter

The products are delivered in a regular letter abroad. The delivery has no tracking code. The delivery information should not be given until the letter has been sent. The delivery period is much longer than in case of domestic letters (UNREG).

UNRDL

Untraceable delivery

The products are delivered in a untraceable parcel. The delivery has no tracking code. The delivery information should not be given until the parcel has been sent.

Response code values

 

Response code

Short description

Description

Response code

Short description

Description

00

OK

The request was processed successfully.

10

Not found

Exception. Payment could not be found.

11

Processing failed

Exception. Processing of the request failed.

12

No service

Exception. The webstore does not have a valid service.

20

Invalid data

The delivery information is not formally correct. Detailed information available in the answer.

30

Already submitted

The delivery information has already been received.

31

Delivery info not found

Exception. The delivery information asked to be removed could not be found.

40

Incorrect delivery method

The delivery information does not match the information received earlier. A transaction can only have one delivery method.

41

Delivery method not allowed

The delivery information is not valid, the delivery method is not enabled for the webstore.

42

Force update required

The transaction has confirmed delivery information. An update requires the override option. That is, pkg_forceupdate should be Y.

99

Invalid request data

The request was somehow invalid. Detailed information available in the answer.

Svea Payments Oy
info.payments@svea.fi
+358 9 4241 7050 (weekdays 8:00 - 16:00)
Saavutettavuusseloste