This service enabled 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 Satisfaction Guarantee payment services.
Delivery Information Response
| 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 |
|---|---|---|
| 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 |
|---|---|---|
| 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. |