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
Element name | Value | Format | C/O | Description |
---|---|---|---|---|
| 002 | AN4 | C | Version of interface content or message |
| Â | AN15 | C | Technical seller id given to the webstore by Svea Payments. |
| Â | AN20 | C | Unique Payment Identifier given to the payment transaction by the webstore. |
| Â | 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. |
| Â | AN300 | C | OK or brief description of the failure reason. |
Delivery Method codes
Â
Delivery method code | Short description | Description |
---|---|---|
| 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. |
| Matkahuolto traceable delivery | The products are delivered as a registered Matkahuolto shipment. The delivery data is processed similarly as Posti's. |
| Kaukokiito traceable delivery | The products are delivered as a registered Kaukokiito shipment. The delivery data is processed similarly as Posti's. |
| Transpoint traceable delivery | The products are delivered as a registered Transpoint shipment. The delivery data is processed similarly as Posti's. |
| Kiitolinja traceable delivery | The products are delivered as a registered Kiitolinja shipment. The delivery data is processed similarly as Posti's. |
| MyPack traceable delivery | The products are delivered as a registered MyPack shipment. The delivery data is processed similarly as Posti's. |
| DB Schenker traceable delivery | The products are delivered as a registered DB Schenker shipment. The delivery data is processed similarly as Posti's. |
| FedEx traceable delivery | The products are delivered as a registered FedEx shipment. The delivery data is processed similarly as Posti's. |
| DHL traceable delivery | The products are delivered as a registered DHL shipment. The delivery data is processed similarly as Posti's. |
| TNT traceable delivery | The products are delivered as a registered TNT shipment. The delivery data is processed similarly as Posti's. |
| UPS traceable delivery | The products are delivered as a registered UPS shipment. The delivery data is processed similarly as Posti's. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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). |
| 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 |
---|---|---|
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, |
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