This documentation is deprecated and only available for supporting old/legacy integrations using for example hashes.

New documentation can be found here: Home



Delivery Information Management

This service enables the webstore to add, change or delete order delivery information to Svea Payments. Delivery information consists of delivery method and possible tracking code(s). Tracking code is used in case of trackable deliveries, such as Posti or Matkahuolto etc.

Tracking codes or information of untraceable deliveries of the order can be submitted after the payment has been registered to Svea Payments.

 

Please Notice. This service is only applicable to Escrow payment services.

Delivery Information Response

Field

Input name

Value

Format

C/O

Description

Field

Input name

Value

Format

C/O

Description

Message version

pkg_version

002

AN4

C

Version of the API request and response contents.

Seller ID

pkg_sellerid

 

AN15

C

Seller ID given to the webstore by Svea Payments. Technical interface user id.

Payment ID

pkg_id

 

AN20

C

 

Response code

pkg_resultcode

 

AN2

C

Indicates success or failure. Values and explanations of all the codes can be found from section Return code values.

Response text

pkg_resulttext

 

AN300

C

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

Response hash

pkg_hash

 

AN128

C

Hash calculated from predefined message fields and the webstore's secret key. Uses the same version, key generation etc values that were in the request. The following fields are used to calculate the hash:

  • pkg_sellerid

  • pkg_id

  • pkg_resultcode

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 message was processed ok.

10

Not found

Exception. The transaction could not be found.

11

Processing failed

Exception. Processing the message failed.

12

No service

Exception. The webstore does not have a valid service

20

Invalid data

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

30

Already submitted

The delivery information has already been received.

31

Delivery info not found

Exception. The delivery information 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 forbidden

The delivery information is not valid, the delivery method is not connected to the service.

42

Force update required

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

99

Muita virheitä

The delivery information contains errors. More information available in the answer.

This documentation is deprecated and only available for supporting old/legacy integrations using for example hashes.

New documentation can be found here: Home