ServiceDefinition Structure

This structure is used to transmit information about a selected shipping service and special services.

The capability to combine individual products and additional services is limited - WebAPI will not permit the creation of a shipment with an invalid combination of services (returning a clear error message). More details are available in the DHL domestic services price list.

Structure Fields

Field Name	Type	Required?	Description
product	string	Yes	Dictionary value: AH - domestic shipment PR - Premium shipment 09 - Domestic 09 12 - Domestic 12 DW - evening delivery shipment EK - Connect shipment PI - International shipment CP - Connect Plus shipment CM - Connect Plus Pallet shipment
deliveryEvening	bool	No	Selection of the Evening Delivery service
deliveryOnSaturday	bool	No	Selection of the Saturday Delivery service
pickupOnSaturday	bool	No	Selection of the Saturday Shipment service
collectOnDelivery	bool	No	Selection of the cash on delivery service
collectOnDeliveryValue	float	Yes, if COD selected	Collection amount in country of delivery's currency
collectOnDeliveryForm	string	Yes, if COD selected	Form of the collection amount refund. Permitted values: BANK_TRANSFER - bank transfer
collectOnDeliveryReference	string	No	“COD reference” field on the consignment note
insurance	bool	No	Selection of the insurance service
insuranceValue	float	Yes, if Insurance selected	Value of the insured shipment
returnOnDelivery	bool	No	Return of documents service
returnOnDeliveryReference	string	No	Name of the return document
proofOfDelivery	bool	No	Selection of the proof of delivery service For a PI product- Selection of the disposal service
selfCollect	bool	No	Selection of the self-pickup service
deliveryToNeighbour	bool	No	Delivery to neighbour
predeliveryInformation	bool	No	Selection of the pre-delivery information service
pre-delivery notification	bool	No	Selection of the pre-delivery notification service - notifying the recipient of the shipment collection

Example:

<serviceDefinition>
    <product>AH</product>
    <deliveryEvening>Y</deliveryEvening>
    <insurance>Y</insurance>
    <insuranceValue>600</insuranceValue>
    <selfCollect>Y</selfCollect>
</serviceDefinition>

Go back to topic list