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.

Skip to contents in this page

1 Response (XML, common for add, update and delete requests)
2 Delivery Method codes
3 Response code values

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.