Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This service enables the webstore to add, change update or delete order delivery information to Svea Payments. Delivery information consists of delivery method and possible tracking code(s) . Tracking in case of traceable deliveries or some description in case untraceable deliveries. That is, tracking code is used in case of trackable traceable 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.

Note

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

Delivery Information Response

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

Table of Contents

Field

Input Element name

Value

Format

C/O

Description

Message version

pkg_version

002

AN4

C

Version of the API request and response contents.Seller IDinterface content or message

pkg_sellerid

AN15

C

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

pkg_id

AN20

CResponse code

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

pkg_resultcode

AN2

C

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

Response text

pkg_resulttext

AN300

C

Brief 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

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

    OkOK

    The message request was processed oksuccessfully.

    10

    Not found

    Exception. The transaction Payment could not be found.

    11

    Processing failed

    Exception. Processing of the message request failed.

    12

    No service

    Exception. The webstore does not have a valid service.

    20

    Invalid data

    The delivery information is not formally correct. More 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 forbiddennot allowed

    The delivery information is not valid, the delivery method is not connected to enabled for the servicewebstore.

    42

    Force update required

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

    99Muita virheitä

    Invalid request data

    The delivery information contains errors. More request was somehow invalid. Detailed information available in the answer.