ShipmentService-Public_4_4 Web Service Reference

ShipmentService-Public_4_4

Web Service Reference

Version 4.4.0

07.04.2021

ShipmentService-Public_4_4

Web Service Reference

Table of contents

History ............................................................................................................................................................ 5

Methods ......................................................................................................................................................... 7

storeOrders ................................................................................................................................................ 8

Complex Types ........................................................................................................................................... 11

types ....................................................................................................................................................... 11

OutputType ......................................................................................................................................... 11

additionalInvoiceLine .......................................................................................................................... 12

address ............................................................................................................................................... 13

addressWithBusinessUnit ................................................................................................................... 15

addressWithType ................................................................................................................................ 18

delivery ............................................................................................................................................... 20

faultCodeType .................................................................................................................................... 21

generalShipmentData ......................................................................................................................... 23

hazardous ........................................................................................................................................... 25

higherInsurance .................................................................................................................................. 28

international ........................................................................................................................................ 28

notification ........................................................................................................................................... 31

parcel .................................................................................................................................................. 32

parcelInformationType ........................................................................................................................ 35

parcelShopDelivery ............................................................................................................................. 35

ShipmentService-Public_4_4

Web Service Reference

personalDelivery ................................................................................................................................. 36

pickup ................................................................................................................................................. 37

printOption .......................................................................................................................................... 39

printOptions ........................................................................................................................................ 40

printer .................................................................................................................................................. 40

proactiveNotification ............................................................................................................................ 41

productAndServiceData ...................................................................................................................... 42

shipmentResponse ............................................................................................................................. 44

shipmentServiceData .......................................................................................................................... 45

storeOrders ......................................................................................................................................... 45

storeOrdersResponse ......................................................................................................................... 46

storeOrdersResponseType ................................................................................................................. 46

types_authentication ............................................................................................................................. 47

anonymous ........................................................................................................................................ 47

authentication ................................................................................................................................ 47

authenticationFault ........................................................................................................................ 48

Simple Types .............................................................................................................................................. 49

types ....................................................................................................................................................... 49

OutputFormatType .............................................................................................................................. 49

startPosition ........................................................................................................................................ 49

Elements ...................................................................................................................................................... 50

ShipmentService-Public_4_4

Web Service Reference

types ....................................................................................................................................................... 50

storeOrders ......................................................................................................................................... 50

storeOrdersResponse ......................................................................................................................... 50

types_authentication ............................................................................................................................. 51

authentication ..................................................................................................................................... 51

authenticationFault ............................................................................................................................. 51

ShipmentService-Public_4_4

Web Service Reference

History

Version 4.4.0

- The new type addressWithBusinessUnit includes all fields of address plus business unit.

- The new type addressWithType includes all fields of addressWithBusinessUnit plus address type.

- Sender and recipient in generalShipmentData have been changed to addressWithType.

- The type invoiceConsigneAddress in International has been changed to addressWithBusinessUnit.

- The international block has been moved from parcel to productAndServiceData.

- New fields numberOfArticle and countryRegistrationNumber have been added to international block.

- The fields customsAmountParcel, customsContent and customsTarif have been removed from

international block and customsTerms can now also be 07 = "DAP enhanced, duty and taxes

were pre-paid by the receiver".

- New fields productFabricCompositon, productCode and productShortDescription have been added

to additionalInvoiceLine.

- New field parcelShopPudoId has been added to the parcelShopDelivery block.

a new field returnAddress has been added.

- The field addService has been expanded with additional values.

- The field function can now also be LOCKZBK = "Delivery to mail-/parcelbox (without signature)".

- The number of parcels has been changed from unbounded to 100.

- In parcel, the minimum value of volume has been changed to 1001001.

- The field cod in parcel has been removed. Therefore COD is no longer allowed.

- Email pattern has been changed for all addresses.

- The product DPD PARCELLetterPlus (PL+ in generalShipmentData) has been removed.

- The day has been removed from pickup block and quantity as well as date are optional now.

- New pattern for all time fields added.

Version 4.3.0

- New structure for parcel labels, now including ZPL labels and other types.

- New fields for ParcelLock in Pickup (boxId and boxTan).

- New field mobile in type address.

- New fields customsAmountExport, customsCurrencyExport, commercialInvoiceConsignor,

commercialInvoiceConsignorVatNumber, additionalInvoiceLines in type international.

- New type additionalInvoiceLine.

- Changed field extraPickup in type pickup from Boolean to Integer and invoicePosition in type

international from String to Integer.

- Changed field length of field email in type address, customsAmount, customsAmountParcel,

customsContent, customsTarif in type international, parcelClass in type parcel, phone in type

personalDelivery.

- New product DPD MAX (MAX in generalShipmentData).

- New product DPD Priority (PM4 in generalShipmentData).

- New feature DPD Food (DID).

ShipmentService-Public_4_4

Web Service Reference

Version 3.2.0

- New field extraPickup in pickup.

- New field startPosition in printOptions.

Version 3.1.0

- New field tyres in productAndServiceData.

- Field customerNumber in sender/recipient address and field invoicePosition in international must be

numeric.

- Parcelblock is optional, for only one parcel with no additional data.

- Return parcel label in format A7 support.

- Return parcel label receipt support.

- Variable sender address support.

- Parcel with 0kg weight handle as classic parcel.

Version 3.0.0

- New field countrySpecificService in productAndServiceData.

- Removed field paperFormat in storeOrders.

- Introduced new element printOptions in storeOrders with paperformat, printertype and printer options.

ShipmentService-Public_4_4

Web Service Reference

Methods

Following methods are available for the service ShipmentService-Public_4_4

Method name Description

storeOrders Stores up to 30 shipments and creates corresponding shipment

documents.

ShipmentService-Public_4_4

Web Service Reference

Method: storeOrders

Description

Stores up to 30 shipments and creates corresponding shipment documents.

Sample request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://

dpd.com/common/service/types/Authentication/2.0" xmlns:ns1="http://dpd.com/common/service/types/

ShipmentService/4.4">

<soapenv:Header>

<ns:authentication>

</ns:authentication>

</soapenv:Header>

<soapenv:Body>

<ns1:storeOrders>

</printOption>

</printOptions>

<order>

<name1>Abholer1</name1>

<street>Strasse 1</street>

</sender>

<name1>Test-Empfaenger</name1>

<street>Test-Strasse</street>

ShipmentService-Public_4_4

Web Service Reference

<city>Aschaffenburg</city>

</recipient>

</generalShipmentData>

</parcels>

<orderType>consignment</orderType>

</productAndServiceData>

</order>

</ns1:storeOrders>

</soapenv:Body>

</soapenv:Envelope>

Action

http://dpd.com/common/service/ShipmentService/4.4/storeOrders

Input

The input for method storeOrders is as follows:

Name Element

authentication * types_authentication:authentication

parameters types:storeOrders

* header parameter

Output

The output for method storeOrders is as follows:

Name Element

return types:storeOrdersResponse

ShipmentService-Public_4_4

Web Service Reference

Faults

The defined faults for method storeOrders are as follows:

Name Element

AuthenticationFault types_authentication:authenticationFault

ShipmentService-Public_4_4

Web Service Reference

Complex Types

Namespace: types

URL: http://dpd.com/common/service/types/ShipmentService/4.4

Namespace: types

Complex Type: OutputType

Description

Contains the output data, e.g. parcel labels.

Field name Data type /

Occurrence /

Range

Description

format types:OutputFormatType

1 .. 1 /

The type of the output data.

content xs:base64Binary /

1 .. 1 /

The output data

ShipmentService-Public_4_4

Web Service Reference

Namespace: types

Complex Type: additionalInvoiceLine

Description

Bundles information about an invoice position for international parcels.

Field name Data type /

Occurrence /

Range

Description

customsInvoicePosition xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 999999

Number of invoice position.

quantityItems xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 9999

Number of items.

customsContent xs:string /

0 .. 1 /

maxLength: 200

Content.

customsTarif xs:string /

0 .. 1 /

pattern: [0-9]*

minLength: 8

maxLength: 10

Customs tarif number.

customsAmountLine xs:long /

0 .. 1 /

minInclusive: 0

maxInclusive: 999999999

999999

Value of invoice position (in invoice currency) with

two decimal digits without separator.

customsOrigin xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 999

Country of invoice origin (ISO 3166).

ShipmentService-Public_4_4

Web Service Reference

customsNetWeight xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 99999999

Parcel net weight in gramm rounded in 10 gramm

units without decimal delimiter (e.g. 300 equals

3kg).

customsGrossWeight xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 99999999

Parcel gross weight in gramm rounded in 10 gramm

units without decimal delimiter (e.g. 300 equals

3kg).

productFabric

Composition

xs:string /

0 .. 1 /

maxLength: 200

Description of fabric composition (for DPD DIRECT

Servicecode 370).

productCode xs:string /

0 .. 1 /

maxLength: 255

Internal customer product code (for DPD DIRECT

Servicecode 370).

productShortDescription xs:string /

0 .. 1 /

maxLength: 40

Short description of the product (for DPD DIRECT

Servicecode 370).

Namespace: types

Complex Type: address

Description

Bundles address data.

Field name Data type /

Occurrence /

Range

Description

name1 xs:string /

1 .. 1 /

maxLength: 50

Name of address owner. For dangerous goods the

maximum length is 50, otherwise always 35.

name2 xs:string /

0 .. 1 /

maxLength: 35

Second name of address owner.

ShipmentService-Public_4_4

Web Service Reference

street xs:string /

1 .. 1 /

maxLength: 50

Street of address owner. For dangerous goods the

maximum length is 50, otherwise always 35.

houseNo xs:string /

0 .. 1 /

maxLength: 8

House number of address owner.

state xs:string /

0 .. 1 /

length: 2

State of address owner in ISO 3166-2 code (e.g. BY

= Bayern).

country xs:string /

1 .. 1 /

length: 2

Country of address owner in ISO 3166-1 alpha-2

format (e.g. 'DE').

zipCode xs:string /

1 .. 1 /

maxLength: 9

Zip code of address owner.

city xs:string /

1 .. 1 /

maxLength: 50

City/town of address owner. For dangerous goods

the maximum length is 50, otherwise always 35.

gln xs:long /

0 .. 1 /

minInclusive: 0

maxInclusive: 99999999

99999

International location number of address owner.

customerNumber xs:string /

0 .. 1 /

maxLength: 17

Customer number of address owner. Maximum

length is 17 for consignment and pickup information,

11 for collection request.

Mandatory for sender's address.

contact xs:string /

0 .. 1 /

maxLength: 35

Contact person of address owner.

phone xs:string /

0 .. 1 /

maxLength: 30

Phone number of address owner. Mandatory if

phone is the chosen notification channel.

If SMS notification is chosen, either mobile or phone

must be filled.

ShipmentService-Public_4_4

Web Service Reference

mobile xs:string /

0 .. 1 /

maxLength: 30

Mobile phone number of address owner. If SMS

notification is chosen, either mobile or phone must

be filled.

fax xs:string /

0 .. 1 /

maxLength: 30

Fax number of address owner. No required data

format.

email xs:string /

0 .. 1 /

pattern: [\w\p{L}!#$%&'*+

/=?^_`{|}~-]+(\.[\w\p{L}!#$

%&'*+/=?^_`{|}~-]+)*@[\w

][\w\p{L}\-]*(\.[\w\p{L}\-]+)*

(\.[a-zA-Z][\-a-zA-Z0-9]{0,

61}[a-zA-Z0-9])

minLength: 5

maxLength: 100

The email address including at minimum one "@"

character as a delimiter between addresser and

domain.

The domain must include at minimum one "." as

a delimiter between domain-name and domain-

country.

comment xs:string /

0 .. 1 /

maxLength: 70

Comment on address owner.

iaccount xs:string /

0 .. 1 /

maxLength: 50

Account allocation or cost center (for VTG) of invoice

data for consignments.

Namespace: types

Complex Type: addressWithBusinessUnit

Description

Bundles address data.

Field name Data type /

Occurrence /

Range

Description

businessUnit xs:int /

0 .. 1 /

minInclusive: 0

Business unit of address owner.

ShipmentService-Public_4_4

Web Service Reference

maxInclusive: 999

name1 xs:string /

1 .. 1 /

maxLength: 50

Name of address owner. For dangerous goods the

maximum length is 50, otherwise always 35.

name2 xs:string /

0 .. 1 /

maxLength: 35

Second name of address owner.

street xs:string /

1 .. 1 /

maxLength: 50

Street of address owner. For dangerous goods the

maximum length is 50, otherwise always 35.

houseNo xs:string /

0 .. 1 /

maxLength: 8

House number of address owner.

state xs:string /

0 .. 1 /

length: 2

State of address owner in ISO 3166-2 code (e.g. BY

= Bayern).

country xs:string /

1 .. 1 /

length: 2

Country of address owner in ISO 3166-1 alpha-2

format (e.g. 'DE').

zipCode xs:string /

1 .. 1 /

maxLength: 9

Zip code of address owner.

city xs:string /

1 .. 1 /

maxLength: 50

City/town of address owner. For dangerous goods

the maximum length is 50, otherwise always 35.

gln xs:long /

0 .. 1 /

minInclusive: 0

maxInclusive: 99999999

99999

International location number of address owner.

customerNumber xs:string /

0 .. 1 /

maxLength: 17

Customer number of address owner. Maximum

length is 17 for consignment and pickup information,

11 for collection request.

Mandatory for sender's address.

ShipmentService-Public_4_4

Web Service Reference

contact xs:string /

0 .. 1 /

maxLength: 35

Contact person of address owner.

phone xs:string /

0 .. 1 /

maxLength: 30

Phone number of address owner. Mandatory if

phone is the chosen notification channel.

If SMS notification is chosen, either mobile or phone

must be filled.

mobile xs:string /

0 .. 1 /

maxLength: 30

Mobile phone number of address owner. If SMS

notification is chosen, either mobile or phone must

be filled.

fax xs:string /

0 .. 1 /

maxLength: 30

Fax number of address owner. No required data

format.

email xs:string /

0 .. 1 /

pattern: [\w\p{L}!#$%&'*+

/=?^_`{|}~-]+(\.[\w\p{L}!#$

%&'*+/=?^_`{|}~-]+)*@[\w

][\w\p{L}\-]*(\.[\w\p{L}\-]+)*

(\.[a-zA-Z][\-a-zA-Z0-9]{0,

61}[a-zA-Z0-9])

minLength: 5

maxLength: 100

The email address including at minimum one "@"

character as a delimiter between addresser and

domain.

The domain must include at minimum one "." as

a delimiter between domain-name and domain-

country.

comment xs:string /

0 .. 1 /

maxLength: 70

Comment on address owner.

iaccount xs:string /

0 .. 1 /

maxLength: 50

Account allocation or cost center (for VTG) of invoice

data for consignments.

ShipmentService-Public_4_4

Web Service Reference

Namespace: types

Complex Type: addressWithType

Description

Bundles address data.

Field name Data type /

Occurrence /

Range

Description

addressType xs:string /

0 .. 1 /

PRV

COM

Address Type. Allowed values are:

PRV: Private customer

COM: Commercial customer

businessUnit xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 999

Business unit of address owner.

name1 xs:string /

1 .. 1 /

maxLength: 50

Name of address owner. For dangerous goods the

maximum length is 50, otherwise always 35.

name2 xs:string /

0 .. 1 /

maxLength: 35

Second name of address owner.

street xs:string /

1 .. 1 /

maxLength: 50

Street of address owner. For dangerous goods the

maximum length is 50, otherwise always 35.

houseNo xs:string /

0 .. 1 /

maxLength: 8

House number of address owner.

state xs:string /

0 .. 1 /

length: 2

State of address owner in ISO 3166-2 code (e.g. BY

= Bayern).

ShipmentService-Public_4_4

Web Service Reference

country xs:string /

1 .. 1 /

length: 2

Country of address owner in ISO 3166-1 alpha-2

format (e.g. 'DE').

zipCode xs:string /

1 .. 1 /

maxLength: 9

Zip code of address owner.

city xs:string /

1 .. 1 /

maxLength: 50

City/town of address owner. For dangerous goods

the maximum length is 50, otherwise always 35.

gln xs:long /

0 .. 1 /

minInclusive: 0

maxInclusive: 99999999

99999

International location number of address owner.

customerNumber xs:string /

0 .. 1 /

maxLength: 17

Customer number of address owner. Maximum

length is 17 for consignment and pickup information,

11 for collection request.

Mandatory for sender's address.

contact xs:string /

0 .. 1 /

maxLength: 35

Contact person of address owner.

phone xs:string /

0 .. 1 /

maxLength: 30

Phone number of address owner. Mandatory if

phone is the chosen notification channel.

If SMS notification is chosen, either mobile or phone

must be filled.

mobile xs:string /

0 .. 1 /

maxLength: 30

Mobile phone number of address owner. If SMS

notification is chosen, either mobile or phone must

be filled.

fax xs:string /

0 .. 1 /

maxLength: 30

Fax number of address owner. No required data

format.

email xs:string /

0 .. 1 /

pattern: [\w\p{L}!#$%&'*+

/=?^_`{|}~-]+(\.[\w\p{L}!#$

%&'*+/=?^_`{|}~-]+)*@[\w

The email address including at minimum one "@"

character as a delimiter between addresser and

domain.

ShipmentService-Public_4_4

Web Service Reference

][\w\p{L}\-]*(\.[\w\p{L}\-]+)*

(\.[a-zA-Z][\-a-zA-Z0-9]{0,

61}[a-zA-Z0-9])

minLength: 5

maxLength: 100

The domain must include at minimum one "." as

a delimiter between domain-name and domain-

country.

comment xs:string /

0 .. 1 /

maxLength: 70

Comment on address owner.

iaccount xs:string /

0 .. 1 /

maxLength: 50

Account allocation or cost center (for VTG) of invoice

data for consignments.

Namespace: types

Complex Type: delivery

Description

Bundles delivery data.

Field name Data type /

Occurrence /

Range

Description

day xs:string /

0 .. 1 /

maxLength: 20

Allowed delivery days in the week (0 = Sunday, 1 =

Monday etc.).

Comma separated list of possible delivery days (e.g.

"2,3,4,5").

dateFrom xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 99999999

Fixed delivery from date - format YYYYMMDD, e.g.

20080213.

dateTo xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 99999999

Fixed delivery to date - format YYYYMMDD, e.g.

20080213.

ShipmentService-Public_4_4

Web Service Reference

timeFrom xs:string /

0 .. 1 /

pattern: ([01]\d|2[0-3])([0

-5]\d)

length: 4

Time from which the consignee is available - format

HHMM (local time receipient country), e.g. 1400 or

0830.

timeTo xs:string /

0 .. 1 /

pattern: ([01]\d|2[0-3])([0

-5]\d)

length: 4

Time until the consignee is available - format HHMM

(local time receipient country), e.g. 1600 or 0930.

Namespace: types

Complex Type: faultCodeType

Description

Bundles fault code type data.

Field name Data type /

Occurrence /

Range

Description

faultCode xs:string /

1 .. 1 /

Possible error codes are:

SHIPPING_1 - Pickup address is unknown for

customer,

SHIPPING_2 - Parcel label print fails,

COMMON_1 - Unexpected runtime error,

COMMON_2 - Mandatory input field is empty,

COMMON_3 - Length of data for field does not fit,

COMMON_4 - Input data contains invalid special

character,

COMMON_5 - A swap parcel is ordered, but there is

more than one parcel,

COMMON_6 - Some input data field values result in

an invalid combination,

COMMON_7 - Input data contains invalid value,

COMMON_8 - A field is to be stored in database, but

there is not database field mapped for it,

DATABASE_6 - Transfer state of order is to be

changed but order is already committed,

ShipmentService-Public_4_4

Web Service Reference

DATABASE_7 - Update fails on database level

during order storing,

DATABASE_8 - Delete fails on database level

during rollback after some other error,

DATABASE_21 - Order is to be inserted in databse,

but has already a database id,

DATABASE_22 - Order is to be committed after

inserting, but there is no database id for update

given,

DATABASE_24 - Feletion is necessary because of

some other error, but no database id for record is

given,

MPSEXP_1 - Parcel label number is already in use,

ROUTING_1 - No route could be found for depot

and feature,

ROUTING_2 - Invalid input data,

ROUTING_3 - The connection to the database

failed,

ROUTING_4 - An internal failure occurs,

ROUTING_5 - No depot could be found,

ROUTING_6 - No pickup date was given,

ROUTING_7 - Internal extension rule error,

ROUTING_8 - Malformed zip code,

ROUTING_9 - Missing country code,

ROUTING_10 - Missing routing place,

ROUTING_11 - Missing service code,

ROUTING_12 - Routing place error,

ROUTING_13 - Sending date error,

ROUTING_14 - Service code error,

ROUTING_15 - Invalid relation of service codes,

ROUTING_16 - Unknown country code,

ROUTING_17 - Unknown destination depot,

ROUTING_18 - Unknown zip code,

ROUTING_19 - Unknown routing place,

ROUTING_20 - Unknown service code,

ROUTING_21 - Invalid service code,

ROUTING_21 - Parcel is labelled as return parcel

but returns is not possible,

ROUTING_22 - Missing allow,

ROUTING_23 - Missing routing place or destination

depot.

ShipmentService-Public_4_4

Web Service Reference

message xs:string /

1 .. 1 /

Message with detailed information for the fault (e.g.

incorrect field).

Namespace: types

Complex Type: generalShipmentData

Description

Bundles general shipment data.

Field name Data type /

Occurrence /

Range

Description

mpsId xs:string /

0 .. 1 /

maxLength: 25

The shipment number for consignment data.

The shipment number is only accepted if the parcel

label number is allocated by customer.

It starts with one of "MPS", "EXP" or "B2C", the last

eight ciphers are the date in format YYYYMMDD.

cUser xs:string /

0 .. 1 /

maxLength: 10

User ID of the person who made the entry.

mpsCustomerReference

Number1

xs:string /

0 .. 1 /

maxLength: 50

Consignment customer reference number 1

(maximal length 35),

also customer reference number for collection

request orders (maximal length 50).

mpsCustomerReference

Number2

xs:string /

0 .. 1 /

maxLength: 35

Consignment customer reference number 2.

mpsCustomerReference

Number3

xs:string /

0 .. 1 /

maxLength: 35

Consignment customer reference number 3.

mpsCustomerReference

Number4

xs:string /

0 .. 1 /

maxLength: 35

Consignment customer reference number 4.

ShipmentService-Public_4_4

Web Service Reference

identificationNumber xs:string /

0 .. 1 /

maxLength: 999

Serves as unique alphanumeric key of the shipment

used by customer.

sendingDepot xs:string /

1 .. 1 /

length: 4

Sending depot for consignment, ordering depot for

collection request,

customer's depot for pickup information or creating/

sending depot for dangerous goods.

Four alphanumeric positions, including leading

zeros, e.g. 0163.

product xs:string /

1 .. 1 /

E830

E10

E12

E18

IE2

MAIL

MAX

PM4

Selection of product, exactly one per shipment,

mandatory for consignment data. Possible values

are:

CL = DPD CLASSIC

E830 = DPD 8:30

E10 = DPD 10:00

E12 = DPD 12:00

E18 = DPD 18:00

IE2 = DPD EXPRESS

MAIL = DPD International Mail

MAX = DPD MAX

PL = DPD PARCELLetter

PM4 = DPD Priority

mpsCompleteDelivery xs:boolean /

0 .. 1 /

Specifies if this shipment should be sent as

complete delivery. Default value is false.

mpsCompleteDelivery

Label

xs:boolean /

0 .. 1 /

Specifies if the label for complete delivery is printed

for pickup. Default value is false.

mpsVolume xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 999999999

Volume per consignment in cm3 (without positions

after the decimal point).

mpsWeight xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 99999999

Shipment weight in grams rounded in 10 gram units

without decimal point (e.g. 300 equals 3kg).

ShipmentService-Public_4_4

Web Service Reference

mpsExpectedSending

Date

xs:string /

0 .. 1 /

pattern: [2][0-9]{3}([0][0-9

]|[1][0-2])(0[1-9]|[12][0-9]|

3[01])

Date when the shipment is expected to be

transferred to the system. Format is YYYYMMDD.

mpsExpectedSending

Time

xs:string /

0 .. 1 /

pattern: (([1][0-9]|[2][0-3]

|[0][0-9])([0-5][0-9])([0-5][

0-9]))|([0-9]([0-5][0-9])([0-

5][0-9]))

Time when the shipment is expected to be

transferred to the system. Format is HHMMSS.

sender types:addressWithType /

0 .. 1 /

Consignment sender's address, collection

request customer's address or pickup information

customer's address.

recipient types:addressWithType /

0 .. 1 /

Address of the recipient. For parcel shop delivery

address of the real recipient.

returnAddress types:addressWithType /

0 .. 1 /

Address of the return parcel. It is currently not used.

Namespace: types

Complex Type: hazardous

Description

Bundles hazardous materials data.

Field name Data type /

Occurrence /

Range

Description

identificationUnNo xs:string /

1 .. 1 /

length: 4

Defines UN number of hazardous substance. UN

numbers range between 0004 and 9004.

identificationClass xs:string /

1 .. 1 /

maxLength: 6

Declares class of hazardous substance. Possible

values range from 1 to 9. Subclasses are specified

as position after decimal point

ShipmentService-Public_4_4

Web Service Reference

(e.g. class 1 is "explosives", class 1.6 is "extremely

insensitive explosives").

classificationCode xs:string /

0 .. 1 /

maxLength: 5

Declares classification code of hazardous

substance.

packingGroup xs:string /

0 .. 1 /

maxLength: 5

Declares packing group of hazardous substance.

Valid values are "I", "II" and "III".

packingCode xs:string /

1 .. 1 /

0A1

0A2

1A1

1A2

1B1

1B2

1H1

1H2

3A1

3A2

3B1

3B2

3H1

3H2

4H1

4H2

Declares packing code.

Possible values are:

0A = Thin sheet packing,

0A1 = Thin sheet packing with non removable head,

0A2 = Thin sheet packing with removable head,

1A = Steel barrel,

1A1 = Steel barrel with non removable head,

1A2 = Steel barrel with removable head,

1B = Aluminium barrel,

1B1 = Aluminium barrel with non removable head,

1B2 = Aluminium barrel with removable head,

1H = Plastics barrel,

1H1 = Plastics barrel with non removable head,

1H2 = Plastics barrel with removable head,

3A = Steel canister,

3A1 = Steel canister with non removable head,

3A2 = Steel canister with removable head,

3B = Aluminium canister,

3B1 = Aluminium canister with non removable head,

3B2 = Aluminium canister with removable head,

3H = Plastics canister,

3H1 = Plastics canister with non removable head,

3H2 = Plastics canister with removable head,

4A = Steel crates,

4B = Aluminium crate,

4D = Plywood crate,

4G = Cardboard crate,

4H = Plastics crate,

4H1 = Plastics crate plastics expanded,

4H2 = Plastics crate plastics solid,

5H = Plastics bags,

5M = Paper bags,

6H = Combination packings.

ShipmentService-Public_4_4

Web Service Reference

description xs:string /

1 .. 1 /

maxLength: 160

Description of hazardous substance (redundant).

subsidiaryRisk xs:string /

0 .. 1 /

maxLength: 10

Subsidiary risk of hazardous substance (redundant).

tunnelRestrictionCode xs:string /

0 .. 1 /

Tunnel restriction code of hazardous substance.

Possible values are "A", "B", "C", "D" or "E".

hazardousWeight xs:decimal /

1 .. 1 /

totalDigits: 6

fractionDigits: 2

Weight of hazardous substance with up to 4 pre-

decimal point positions and 2 decimal digits with

separator.

netWeight xs:decimal /

0 .. 1 /

totalDigits: 6

fractionDigits: 2

Net weight of hazardous substance with up to 4

pre-decimal point positions and 2 decimal point

positions.

factor xs:int /

1 .. 1 /

minInclusive: 0

maxInclusive: 999

Factor of hazardous substance (redundant), 999

means unlimited.

notOtherwiseSpecified xs:string /

0 .. 1 /

maxLength: 150

A not otherwise specified text which is mandatory for

some substances.

ShipmentService-Public_4_4

Web Service Reference

Namespace: types

Complex Type: higherInsurance

Description

Bundles data for higher insurance.

Field name Data type /

Occurrence /

Range

Description

amount xs:long /

1 .. 1 /

minInclusive: 0

maxInclusive: 99999999

Increased insurance value with 2 decimal point

positions without separators.

currency xs:string /

1 .. 1 /

length: 3

Currency code for increased insurance in format ISO

4217 alpha 3.

Namespace: types

Complex Type: international

Description

Bundles express international data.

Field name Data type /

Occurrence /

Range

Description

parcelType xs:boolean /

1 .. 1 /

Specifies if the type of this parcel is

"Documents" (allowed for air based destination

only), not by default.

customsAmount xs:long /

1 .. 1 /

minInclusive: 0

Declared customs amount (in invoice currency) in

total with two decimal digits without separator (e.g.

14.00 = 1400),

ShipmentService-Public_4_4

Web Service Reference

maxInclusive: 999999999

999999

for "Documents" it is set to 0.

customsCurrency xs:string /

1 .. 1 /

length: 3

Invoice currency code in ISO 4217 alpha 3 format.

customsAmountExport xs:long /

0 .. 1 /

minInclusive: 0

maxInclusive: 999999999

999999

Converted customs amount (in export currency) in

total with two decimal digits without separator (14,

00 = 1400),

for "Documents" it is set to 0.

customsCurrencyExport xs:string /

0 .. 1 /

length: 3

Export currency code in ISO 4217 alpha 3 format.

customsTerms xs:string /

1 .. 1 /

Declares the customs terms.

Possible values are:

01 = DAP, cleared,

02 = DDP, delivered duty paid (incl. duties and excl.

taxes),

03 = DDP, delivered duty paid (incl. duties and

taxes),

05 = Ex works (EXW),

06 = DAP

07 = DAP enhanced, duty and taxes were pre-paid

by the receiver.

customsPaper xs:string /

0 .. 1 /

maxLength: 20

Declares accompanying documents without

separator (e.g. "ABG"), composed by following

values:

A = Commercial invoice,

B = Pro forma invoice,

C = Export declaration,

D = EUR1,

E = EUR2,

F = ATR,

G = Delivery note,

H = Third party billing,

I = T1 document.

customsEnclosure xs:boolean /

0 .. 1 /

Specifies if the accompanying documents are at the

parcel or not (not by default).

ShipmentService-Public_4_4

Web Service Reference

customsInvoice xs:string /

0 .. 1 /

maxLength: 20

Declares the invoice number.

customsInvoiceDate xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 99999999

Declares the invoice date in format YYYYMMDD.

customsOrigin xs:string /

0 .. 1 /

length: 2

Origin country in ISO 3166 alpha 2 format (e.g. DE,

EN).

customsOrder xs:string /

0 .. 1 /

maxLength: 25

Central customs order number for collective customs

clearance.

linehaul xs:string /

0 .. 1 /

Declares mode of line haul, possible values are "AI"

for Air or "RO" for Road.

shipMrn xs:string /

0 .. 1 /

maxLength: 20

Movement reference number of the electronical

export declaration.

collectiveCustoms

Clearance

xs:boolean /

0 .. 1 /

Flag for determining collective customs clearance.

Default value is false.

invoicePosition xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 999999

Declares the invoice position.

comment1 xs:string /

0 .. 1 /

maxLength: 70

Comment.

comment2 xs:string /

0 .. 1 /

maxLength: 70

Second comment.

numberOfArticle xs:int /

0 .. 1 /

minInclusive: 0

Real number of commodities. The number of

additionalInvoiceLines must be equal to this value.

ShipmentService-Public_4_4

Web Service Reference

maxInclusive: 99

countryRegistration

Number

xs:string /

0 .. 1 /

maxLength: 15

Destination country registration information:

Registration number or FDA.

commercialInvoice

ConsigneeVatNumber

xs:string /

0 .. 1 /

maxLength: 20

Declares the commercial invoice consignee VAT

number.

commercialInvoice

Consignee

types:addressWith

BusinessUnit /

0 .. 1 /

Contains address data of commercial invoice

consignee.

commercialInvoice

ConsignorVatNumber

xs:string /

0 .. 1 /

pattern: [A-Z]{2}\w{1,15}

maxLength: 17

Declares the commercial invoice consignor VAT/

EORI number.

commercialInvoice

Consignor

types:address /

0 .. 1 /

Contains address data of commercial invoice

consignor.

additionalInvoiceLines types:additionalInvoice

Line /

0 .. 99 /

Contains additional invoice lines.

Namespace: types

Complex Type: notification

Description

Bundles notification data.

Field name Data type /

Occurrence /

Range

Description

channel xs:int /

1 .. 1 /

Declares channel of notification.

Possible values are:

1 = Email,

2 = Telephone,

ShipmentService-Public_4_4

Web Service Reference

3 3 = SMS.

value xs:string /

1 .. 1 /

maxLength: 50

Value for the chosen channel, i.e. the phone number

or the e-mail address.

language xs:string /

0 .. 1 /

length: 2

Language of the notification in ISO 3166-1 alpha-2

format (e.g. 'DE').

Namespace: types

Complex Type: parcel

Description

Bundles parcel data.

Field name Data type /

Occurrence /

Range

Description

parcelLabelNumber xs:string /

0 .. 1 /

minLength: 11

maxLength: 14

Parcel label number. Number range and validity are

checked.

customerReference

Number1

xs:string /

0 .. 1 /

maxLength: 35

Parcel customer reference number 1.

customerReference

Number2

xs:string /

0 .. 1 /

maxLength: 35

Parcel customer reference number 2.

customerReference

Number3

xs:string /

0 .. 1 /

maxLength: 35

Parcel customer reference number 3.

customerReference

Number4

xs:string /

0 .. 1 /

maxLength: 35

Parcel customer reference number 4.

ShipmentService-Public_4_4

Web Service Reference

swap xs:boolean /

0 .. 1 /

Specifies if this parcel is a consignment swap parcel.

Default value is false.

volume xs:int /

0 .. 1 /

minInclusive: 1001001

maxInclusive: 999999999

Volume of the single parcel (length/width/height in

format LLLWWWHHH) in cm without separators.

weight xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 99999999

Parcel weight in grams rounded in 10 gram units

without decimal point (e.g. 300 equals 3kg).

Consignment allows 8-digit values, collection

requests 7-digit and dangerous goods 6-digit.

hazardousLimited

Quantities

xs:boolean /

0 .. 1 /

Specifies if this parcel is a limited quantities

hazardous goods parcel. Default value is false.

higherInsurance types:higherInsurance /

0 .. 1 /

Specifies if this parcel has increased insurance

value. Default value is false.

content xs:string /

0 .. 1 /

maxLength: 50

Content of this parcel, mandatory for increased

insurance.

For collection requests maximum length is 50, for

consignment it is 35.

addService xs:int /

0 .. 1 /

minInclusive: 1

maxInclusive: 8

Additional service.

Possible values are:

1 = Delivery information,

2 = Documents return,

3 = Written permission to deposit goods by sender,

4 = Department delivery,

5 = Online permission to deposit goods,

6 = Parcel box,

7 = Information at indoor scanning,

8 = Locking out-for-delivery.

messageNumber xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 99999

Message number for consignment shipper

information. Default value is 1.

function xs:string /

0 .. 1 /

LOCKDZB

LOCKASG

LOCKEVM

Blockable functions.

Possible values are:

LOCKDZB = Delivery to a third party with notification

of delivery,

LOCKASG = Written permission to deposit goods,

ShipmentService-Public_4_4

Web Service Reference

LOCKSHOP

LOCKTV

LOCKZBK

LOCKEVM = Delivery with non-recurring authority,

LOCKSHOP = Parcel shop,

LOCKTV = Appointment,

LOCKZBK = Delivery to mail-/parcelbox (without

signature).

parameter xs:string /

0 .. 1 /

maxLength: 300

Free text for blockable functions.

hazardous types:hazardous /

0 .. 4 /

Contains packing and substance data for dangerous

goods.

printInfo1OnParcelLabel xs:boolean /

0 .. 1 /

Flag for determining if content of parameter info1 will

be added on the label of a collection request parcel.

Default value is false.

info1 xs:string /

0 .. 1 /

maxLength: 29

Information text 1. This will be printed on the parcel

label if the flag printInfo1OnParcellabel is set to

true.

info2 xs:string /

0 .. 1 /

maxLength: 30

Information text 2. This will not be printed on the

parcel label.

returns xs:boolean /

0 .. 1 /

Specifies if parcel is a return parcel. Default value is

false.

parcelClass xs:string /

0 .. 1 /

maxLength: 50

Parcel class. See Parcelclass in MPSEXPDATA

specification for valid values.

ShipmentService-Public_4_4

Web Service Reference

Namespace: types

Complex Type: parcelInformationType

Description

Bundles parcel information type data.

Field name Data type /

Occurrence /

Range

Description

parcelLabelNumber xs:string /

0 .. 1 /

The parcel label number of the corresponding

parcel.

dpdReference xs:string /

0 .. 1 /

The DPD reference for this parcel.

output types:OutputType /

0 .. * /

The content for the parcel.

Namespace: types

Complex Type: parcelShopDelivery

Description

Bundles parcel shop delivery data.

Field name Data type /

Occurrence /

Range

Description

parcelShopId xs:long /

0 .. 1 /

minInclusive: 1

maxInclusive: 999999999

99999999

Parcel shop ID for parcel shop delivery. Can be

obtained from parcel shop finder.

Mandatory for parcel shop delivery.

ShipmentService-Public_4_4

Web Service Reference

parcelShopPudoId xs:string /

0 .. 1 /

maxLength: 20

ID of PUDO point. For a parcel shop delivery the

parcelShopId is also required.

parcelShopNotification types:notification /

1 .. 1 /

Contains data for personal notification for parcel

shop consignments.

Namespace: types

Complex Type: personalDelivery

Description

Bundles personal delivery data.

Field name Data type /

Occurrence /

Range

Description

type xs:int /

1 .. 1 /

minInclusive: 1

maxInclusive: 5

Declares type of personal delivery.

Possible values are:

1 = Department delivery (without personal

identification),

2 = Personal delivery with personal identification (ID-

Check),

3 = Personal delivery without personal identification

at drop point (e.g. parcel shop),

4 = Personal delivery with personal identification at

drop point (e.g. parcel shop),

5 = Personal delivery with personal identification at

drop point plus ID-Check (e.g. parcel shop).

For parcel shop delivery the parcel shop id must

be declared in productAndServiceData. It can be

obtained from parcel shop finder.

floor xs:string /

0 .. 1 /

maxLength: 30

Floor where the personal delivery shall take place.

This field is only used for department delivery.

ShipmentService-Public_4_4

Web Service Reference

building xs:string /

0 .. 1 /

maxLength: 30

Building where the personal delivery shall take

place. This field is only used for department delivery

(type 1).

department xs:string /

0 .. 1 /

maxLength: 30

Department where the personal delivery shall take

place. This field is only used for department delivery

(type 1).

name xs:string /

0 .. 1 /

maxLength: 35

Name of the person authorised to accept the

consignment. This field is only used for delivery with

ID-Check (types 2 and 5).

phone xs:string /

0 .. 1 /

maxLength: 30

Telephone number of the person authorised to

accept the consignment. This field is only used for

delivery with ID-Check (types 2 and 5).

personId xs:string /

0 .. 1 /

maxLength: 35

Personal identification number of the person

authorised to accept the consignment. This field is

only used for delivery with ID-Check (types 2 and

5).

Namespace: types

Complex Type: pickup

Description

Bundles pickup data.

Field name Data type /

Occurrence /

Range

Description

tour xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 999

Tour number (between 000 and 999).

quantity xs:int /

0 .. 1 /

minInclusive: 0

Quantity of pickup parcels. Mandatory for

consignment.

ShipmentService-Public_4_4

Web Service Reference

maxInclusive: 99999

date xs:int /

0 .. 1 /

minInclusive: 0

maxInclusive: 99999999

Pickup date in consignments and collection

requests. The collection day for advice customers.

The from date for pickup information. Format is

YYYYMMDD.

It can also be used as pickup date for collection

requests, then format is YYMMDD. Mandatory for

consignment.

fromTime1 xs:string /

0 .. 1 /

pattern: ([01]\d|2[0-3])([0

-5]\d)

length: 4

From time 1 for consignments and pickup

information. Format is HHMM.

toTime1 xs:string /

0 .. 1 /

pattern: ([01]\d|2[0-3])([0

-5]\d)

length: 4

Until time 1 for consignments and pickup

information. Format is HHMM.

fromTime2 xs:string /

0 .. 1 /

pattern: ([01]\d|2[0-3])([0

-5]\d)

length: 4

From time 2 for consignments and pickup

information. Format is HHMM.

toTime2 xs:string /

0 .. 1 /

pattern: ([01]\d|2[0-3])([0

-5]\d)

length: 4

Until time 2 for consignments and pickup

information. Format is HHMM.

extraPickup xs:int /

0 .. 1 /

minInclusive: 1

maxInclusive: 2

Detemines whether an extra pickup tour is created

for this shipment with express service.

Possible values are:

1: Extra pickup without express service,

2: Extra pickup with express service.

boxId xs:string /

0 .. 1 /

maxLength: 100

The ID of the parcel box.

ShipmentService-Public_4_4

Web Service Reference

boxTan xs:string /

0 .. 1 /

maxLength: 6

The TAN of the parcel box for this order.

collectionRequest

Address

types:address /

0 .. 1 /

Contains pickup address information for

consignments and collection requests. Mandatory

for consignment.

Namespace: types

Complex Type: printOption

Description

Options how to return the parcel labels

Field name Data type /

Occurrence /

Range

Description

outputFormat types:OutputFormatType

1 .. 1 /

The format in which the parcel labels should be

returned.

PDF, BARCODE_IMAGE, MULTIPAGE_IMAGE as

file output; DPL, PDL, ZPL for direct printing.

In any case the output is base64 encoded.

paperFormat xs:string /

0 .. 1 /

Declares the paper format for parcel label print,

either "A4", "A6" or "A7".

For direct printing must be set to "A6". "A7" only

prints return labels.

printer types:printer /

0 .. 1 /

Information about the printer, if direct printing is

enabled.

startPosition types:startPosition /

0 .. 1 /

The start position of the first parcellabel on the first

page, if page format A4 is chosen. Ignored on other

paperformats

ShipmentService-Public_4_4

Web Service Reference

Namespace: types

Complex Type: printOptions

Description

Options how to return the parcel labels

Field name Data type /

Occurrence /

Range

Description

printOption types:printOption /

1 .. * /

The formats in which the parcel labels should be

returned.

If more than one format is set, the option

splitByParcel is set implicitly.

splitByParcel xs:boolean /

0 .. 1 /

Determines whether a complete parcel label sheet

will be created or a single one for each parcel.

If format is BARCODE_IMAGE then this is set

implicitly.

Namespace: types

Complex Type: printer

Description

Information about the printer, if direct printing is used.

Field name Data type /

Occurrence /

Range

Description

manufacturer xs:string /

0 .. 1 /

The printer's manufacturer. At the moment only for

informational purposes.

model xs:string /

0 .. 1 /

The printer's model. At the moment only for

informational purposes.

ShipmentService-Public_4_4

Web Service Reference

revision xs:string /

0 .. 1 /

The printer's revision / version. At the moment only

for informational purposes.

offsetX xs:decimal /

1 .. 1 /

The horizontal offset in mm for the direct printer file

(Not used with normal PDF output).

offsetY xs:decimal /

1 .. 1 /

The vertical offset in mm for the direct printer file

(Not used with normal PDF output).

connectionType xs:string /

1 .. 1 /

SERIAL

PARALLEL

The connection type of the printer: serial or parallel

connection.

barcodeCapable2D xs:boolean /

1 .. 1 /

If the printer can print AZTEC barcodes, set this flag

to true.

Namespace: types

Complex Type: proactiveNotification

Description

Bundles proactive notification data.

Field name Data type /

Occurrence /

Range

Description

channel xs:int /

1 .. 1 /

Declares type of proactive notification.

Possible values are:

1 = Email,

2 = Telephone,

3 = SMS,

6 = FAX,

7 = Postcard.

value xs:string /

1 .. 1 /

maxLength: 50

Data for proactive notification, e.g. telephone

number, email address, etc.

The data format for the proactive message types

SMS, phone and FAX is as follows:

+international country number#phone number

ShipmentService-Public_4_4

Web Service Reference

Examples:

+49#1725673423

+49#01725673423

rule xs:int /

1 .. 1 /

maxInclusive: 31

Specifies for which events a notification is to be

issued.

Each event has a certain integer value. By

adding the different values, it is possible to build

combinations of events, e.g. notification for pick-up

and delivery is 5.

The different values are:

1 = Pick-up,

2 = Non-delivery,

4 = Delivery,

8 = Inbound,

16 = Out for delivery.

So maximum value can be 31.

language xs:string /

1 .. 1 /

length: 2

Language of the proactive notification in ISO-3166-1

alpha-2 format (e.g. 'DE').

Namespace: types

Complex Type: productAndServiceData

Description

Bundles product and service data for ShipmentService.

Field name Data type /

Occurrence /

Range

Description

orderType xs:string /

1 .. 1 /

consignment

collection request order

pickup information

Defines the shipment type.

Possible values are:

consignment,

collection request order,

pickup information.

saturdayDelivery xs:boolean /

0 .. 1 /

Specifies if saturday delivery is demanded. Only

selectable for product "E12". Default value is false.

ShipmentService-Public_4_4

Web Service Reference

exWorksDelivery xs:boolean /

0 .. 1 /

Specifies if the recipient has to pay the consignment.

Default value is false.

guarantee xs:boolean /

0 .. 1 /

Set to true if an international shipment should

use Guarantee, only for products CL and E18 for

international parcels.

tyres xs:boolean /

0 .. 1 /

Set to true if this consignment contains bulk tyres,

only for product CL.

food xs:boolean /

0 .. 1 /

Set to true if the parcel should deliver as product

'DPD Food'.

personalDelivery types:personalDelivery /

0 .. 1 /

Contains information for personal delivery.

pickup types:pickup /

0 .. 1 /

Contains information for pickup consignments,

pickup address for collection requests or details for

pickup information.

parcelShopDelivery types:parcelShopDelivery

0 .. 1 /

Contains the necessary information, if a parcel shop

delivery is intended.

predict types:notification /

0 .. 1 /

Contains data for interactive notification for

consignments. The notification type "phone" is

forbidden here.

personalDelivery

Notification

types:notification /

0 .. 1 /

Contains data for personal delivery notification for

consignments.

proactiveNotification types:proactive

Notification /

0 .. 5 /

Contains information of proactive notification for

consignments.

delivery types:delivery /

0 .. 1 /

Contains special delivery data for consignments.

invoiceAddress types:address /

0 .. 1 /

Contains data about invoice recipient if it differs for

consignment.

countrySpecificService xs:string /

0 .. 1 /

In some relations a specific service code can be set,

which overwrites the feature selection.

ShipmentService-Public_4_4

Web Service Reference

international types:international /

0 .. 1 /

Contains data for consignments across customs

borders.

Namespace: types

Complex Type: shipmentResponse

Description

Bundles shipment response data.

Field name Data type /

Occurrence /

Range

Description

identificationNumber xs:string /

0 .. 1 /

maxLength: 999

Serves as unique alphanumeric key of the shipment

used by customer.

mpsId xs:string /

0 .. 1 /

maxLength: 25

The shipment number for consignment data. If

ordertype is pickup information,

the shipment number is an internal database id,

which is necessary for technical support requests at

DPD.

parcelInformation types:parcelInformation

Type /

0 .. * /

Contains information about the single parcels.

faults types:faultCodeType /

0 .. 3 /

Contains information about errors during shipment

order processing.

ShipmentService-Public_4_4

Web Service Reference

Namespace: types

Complex Type: shipmentServiceData

Description

Bundles shipment service data.

Field name Data type /

Occurrence /

Range

Description

generalShipmentData types:generalShipment

Data /

1 .. 1 /

Contains general data for a shipment.

parcels types:parcel /

0 .. 100 /

Contains information for the parcels.

productAndServiceData types:productAndService

Data /

1 .. 1 /

Contains special data for a shipment.

Namespace: types

Complex Type: storeOrders

Description

Stores up to 30 shipments and creates corresponding shipment documents.

Field name Data type /

Occurrence /

Range

Description

printOptions types:printOptions /

0 .. 1 /

The Options which should be used for parcel

printing.

ShipmentService-Public_4_4

Web Service Reference

order types:shipmentService

Data /

1 .. 30 /

Contains the whole data for the shipments.

Namespace: types

Complex Type: storeOrdersResponse

Description

Contains return object.

Field name Data type /

Occurrence /

Range

Description

orderResult types:storeOrders

ResponseType /

1 .. 1 /

Contains return object.

Namespace: types

Complex Type: storeOrdersResponseType

Description

Bundles storeOrders response data.

Field name Data type /

Occurrence /

Range

Description

output types:OutputType /

0 .. 1 /

Contains parcel label data in bytes.

shipmentResponses types:shipmentResponse

0 .. * /

Contains response data for every shipment order.

ShipmentService-Public_4_4

Web Service Reference

Namespace: types_authentication

URL: http://dpd.com/common/service/types/Authentication/2.0

Namespace: types_authentication

Anonymous Complex Type of Element: authentication

Description

The data structure for authentication data.

Field name Data type /

Occurrence /

Range

Description

delisId xsd:string /

1 .. 1 /

minLength: 8

maxLength: 10

The delis user id for authentication.

authToken xsd:string /

1 .. 1 /

minLength: 0

maxLength: 64

The token for authentication. Field authToken of

Method "getAuth" of LoginService.

messageLanguage xsd:string /

1 .. 1 /

minLength: 5

maxLength: 5

The language (Java format) for messages.

"de_DE" for german messages.

"en_US" for english messages.

ShipmentService-Public_4_4

Web Service Reference

Namespace: types_authentication

Anonymous Complex Type of Element: authenticationFault

Description

The data structure for authentication errors.

Field name Data type /

Occurrence /

Range

Description

errorCode xsd:string /

1 .. 1 /

The error code. Valid codes:

NoAccessAuthenticationFault=-1

NoRightsAuthenticationFault=-2

errorMessage xsd:string /

1 .. 1 /

minLength: 1

maxLength: 255

The error message text.

ShipmentService-Public_4_4

Web Service Reference

Simple Types

Namespace: types

URL: http://dpd.com/common/service/types/ShipmentService/4.4

Namespace: types

Simple Type: OutputFormatType

Field name Data type /

Occurrence /

Range

Description

OutputFormatType xs:string /

PDF

ZPL

DPL

PDL

BARCODE_IMAGE

MULTIPAGE_IMAGE

Content of output format.

Supported types are:

PDF,

ZPL,

DPL,

PDL,

BARCODE_IMAGE,

MULTIPAGE_IMAGE.

Namespace: types

Simple Type: startPosition

Field name Data type /

Occurrence /

Range

Description

startPosition xs:string /

UPPER_LEFT

UPPER_RIGHT

LOWER_LEFT

LOWER_RIGHT

Start positions

ShipmentService-Public_4_4

Web Service Reference

Elements

Namespace: types

URL: http://dpd.com/common/service/types/ShipmentService/4.4

Namespace: types

Element: storeOrders

Field name Data type /

Occurrence /

Range

Description

storeOrders types:storeOrders /

1 .. 1 /

See types:storeOrders

Namespace: types

Element: storeOrdersResponse

Field name Data type /

Occurrence /

Range

Description

storeOrdersResponse types:storeOrders

Response /

1 .. 1 /

See types:storeOrdersResponse

ShipmentService-Public_4_4

Web Service Reference

Namespace: types_authentication

URL: http://dpd.com/common/service/types/Authentication/2.0

Namespace: types_authentication

Element: authentication

Anonymous Complex Type types_authentication:authentication

Namespace: types_authentication

Element: authenticationFault

Anonymous Complex Type types_authentication:authenticationFault