Troubleshooting - Call Debugging

 

Frequent issues/questions

 

  • ZIP codes for NL are composed of 6 digits: 4 numbers and 2 letters. Please enter them in the response without spaces.
  • ZIP codes for UK are composed of letters and numbers. Please enter them in the response without spaces or any form of underscores, brackets etc. 
  • Do pay attention you keep to the 35-character limit for fields as 'Street' and 'Name'. If you are using some sort of auto cut-off, then valid info such as house numbers or departments/floors indication may disappear from the data and the label. Please use prior validation before feeding these values to the API.
  • Try to add phone and e-mailaddress whenever you can. For some services (DPD Home, Express, ...) these are mandatory, but even for other shipments it is valuable to enter.
  • Phone numbers are preferably added in the following syntax: +32475% or +316588% . Do not use spaces, underscores nor brackets etc.
  • Weight is a preferred field and uses decagrams and will become mandatory for shipments in time. Please do fill it out. 1 Kilo translates to the value '100'
  • Parcel measurements are optional; when filled out, please use the correct syntax being >HHHWWWDDD< in cm.
  • Do not use the namespace <state> in address fields for any destination other than USA or Canada
  • Express shipments require a mandatory mobile phone number ,capable of receiving an SMS, in the recipient segment.
  • Use the exact same e-mail address/phone number for DPD Home and DPD Parcelshop shipments in the recipient segment as in the predict segment.
  • References 1 & 2 will be printed on the label and will be on sight visible in Shipping Reports (www.shippingreports.be), references 3 & 4 will only appear in the data.

 

 

 

Error Codes

The following error return codes can occur when working with the API.

Please check them first before contacting DPD Customer IT.

 

 

 

Error code Customer DPD Service Description
address_name_length_too_long   Shipment Address name too long. Maximum length is 35 characters
address_street_length_too_long   Shipment Street name too long. Maximum length is 35 characters
Collecting_address_for_CR_not_specified   Shipment Please rovide correct collecting or pickup address for Collection Request.
DELICOM_ERR_AUTHENTICATION   Shipment Invalid Authentication data provided. Check DelisID and AuthToken
DELICOM_ERR_BAD_PRODUCT Shipment Bad product code specified. Contact DPD if you the product code is allowed for you, but not working
DELICOM_ERR_INVALID_AVAILABILITY_DATE   Parcelshop Invalid date for checking parcel shop availability in search parameters.
DELICOM_ERR_MISSING_PARCELSHOPID   Shipment Parcel shop ID missing. Error occurs when PSD product is specified or parcel shop delivery attributes are provided but are not complete.
DELICOM_ERR_NOT_SUPPORTED_PAPER_FORMAT   Shipment Invalid paper format defined for printing. A4 and A6 is allowed
DELICOM_ERR_TOKEN_NOT_PRESENT   All except Login Authentication token missing from request.
DELICOM_ERR_TOO_LONG_CITY   Shipment Recipient's cirty name too long. Maximum length is 35 characters
DELICOM_ERR_TOO_LONG_CUSTOMER_REF_NUMBER1 (or 2,3,4)   Shipment Shipment reference 1 (or 2,3,4) too long. Maximum length is 35 characters
DELICOM_ERR_TOO_LONG_NAME1   Shipment Recipient's name too long. Maximum length is 35 characters
DELICOM_ERR_TOO_LONG_NAME2   Shipment Recipient's name (second line) too long. Maximum length is 35 characters
DELICOM_ERR_TOO_LONG_SENDER_CITY   Shipment Sender's cirty name too long. Maximum length is 35 characters
DELICOM_ERR_TOO_LONG_SENDER_NAME1   Shipment Sender's name too long. Maximum length is 35 characters
DELICOM_ERR_TOO_LONG_SENDER_NAME2   Shipment Sender's name (second line) too long. Maximum length is 35 characters
DELICOM_ERR_TYRES_NOT_SUPPORTED Shipment Bad product option 'Tyres'. Contact DPD if you the product code is allowed for you, but not working
DELICOM_ERR_UNEXPECTED   All except Login Something unexpected happened, please contact DPD.
Empty_email_address   Shipment Contact/notification email is required, please provide it.
Empty_phone_number   Shipment Contact/notification phone number is required, please provide it.
Empty_phone_number_and_email   Shipment Contact/notification email or phone number is required, please provide it.
ERR_DELICOM_AUTH_DATA_MISSING   All except Login Authentication data haven't been provided as required.
ERR_DELICOM_AUTH_HEADER_MISSING   All Authentication data haven't been provided as required (XML SOAP header missing).
ERR_DELICOM_CUST_NO_CONFIG   All Customer doesn't have an active configuration for given login. Contact DPD
ERR_DELICOM_TOKEN_EXPIRED   All except Login Request a valid token using the LoginService. Tokens are valid for 24h
ERR_DELICOM_TOKEN_INCORRECT   All except Login Request a valid token using the LoginService.
err_parcel_number_taken_meanwhile   Shipment Retry the shipment call. The parcelnumber was already taken by another of your calls. This can occur with high load/frequency subsequent calls. 
ERR_RETURN_NOT_FOUND   All System configuration error,contact DPD.
gross_weight_and_declared_weight_are_not_equal   Shipment Check if customs clearance data are provided equally.
Incorrect_email_address   Shipment Email address is in wrong format.
Incorrect_phone_number   Shipment Phone number is in incorrect format. Use stardadized tel. number format (for example +134564784454).
invalid_city_name   Shipment Invalid recipient ZIP code. Also in case of providing custom pickup address, it can mean error there.
invalid_dest_city   Shipment City name can not be validated with country/zip
invalid_dest_zip   Shipment Invalid recipient ZIP code. Also in case of providing custom pickup address.
invalid_zip   Shipment Invalid recipient ZIP code. Also in case of providing custom pickup address.
My_pudo_deserialize_error   Parcelshop There has been an error querying pickup points data. Contact DPD
My_pudo_error   Parcelshop There has been an error querying pickup points data. Contact DPD
Parcel_exceeds_maximum_allowed_weight   Shipment Maximum parcel weight exceeded for recipients destination and product.
Parcel_number_already_exists   Shipment A parcel number that was already used has been provided.
Parcel_number_invalid_length   Shipment Use correct length of the parcel number when providing own parcel number in request.
Parcel_number_not_available_within_ranges   Shipment Contact DPD, your labelrange has been depleted. We will renew it asap.
Parcel_number_not_numeric   Shipment Parcel number can contain only numbers, not letters.
Parcel_number_not_within_customer_ranges   Shipment A parcel number that doesn't belong to the customer making the request has been provided.
Product_not_allowed_in_destination   Shipment A specific rule set by the business unit in Shipper Admin forbids the delivery of the product to the recipient's country.
Products_combination_not_allowed   Shipment A specific rule set by the business unit in Shipper Admin forbids combining products and additional services specified in the request.
program_logic_fault   All Unexpected error. Customer should contact DPD.
protocol_error_no_shipment_to_print   End-of-Day If no shipments fit into the filter specified by EOD service request, customer gets this error.
Return_address_must_be_specified_for_return_service   Shipment Missing return address if the return is used as additional service (if there is a normal product + a return parcel specified).
Routing_impossible   Shipment The selected product and services combination isn't routable (deliverable) to given destination according to the GeoRouting data.
Routing_impossible_service_codes_not_found   Shipment If CountrySpecificService code is provided, it's an invalid one.
Sending_depot_unknown Shipment Wrong sending depot set for pickup address.
SHP_VALID_ERR_API_ENDPOINT_NOT_ALLOWED   All Endpoint not allowed, contact DPD if you should be able to use it.
SHP_VALID_ERR_TOO_LONG_COLLECTION_REQUEST_ADDRESS_NAME1   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_COLLECTION_REQUEST_ADDRESS_NAME2   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_COLLECTION_REQUEST_ADDRESS_STREET   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_COLLECTION_REQUEST_ADDRESS_STREET2   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_COMMERCIAL_INVOICE_CONSIGNEE_NAME1   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_COMMERCIAL_INVOICE_CONSIGNEE_NAME2   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_COMMERCIAL_INVOICE_CONSIGNEE_STREET   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_COMMERCIAL_INVOICE_CONSIGNEE_STREET2   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_COMMERCIAL_INVOICE_CONSIGNOR_NAME1   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_COMMERCIAL_INVOICE_CONSIGNOR_NAME2   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_COMMERCIAL_INVOICE_CONSIGNOR_STREET   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_COMMERCIAL_INVOICE_CONSIGNOR_STREET2   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_INVOICE_ADDRESS_NAME1   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_INVOICE_ADDRESS_NAME2   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_INVOICE_ADDRESS_STREET   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_INVOICE_ADDRESS_STREET2   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_SENDER_STREET   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_SENDER_STREET2   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_STREET   Shipment Maximum length is 35 characters
SHP_VALID_ERR_TOO_LONG_STREET2   Shipment Maximum length is 35 characters
SCHEMA_VALIDATION   All The WS request was malformed, check the xml structure
Unknown_return_service_code   Shipment This is a system configuration error. If it occurs, contact DPD.
Unknown_sms_notification_allowance_type_code   Shipment This is a system configuration error. If it occurs, contact DPD.
Zero_cod_amount_not_allowed   Shipment Customer should provide a non-sero and non-negative COD amount.
SYSTEM_ERROR_TRANSIENT   All Retry the call after a minute. If the error repeats, The system might be overloaded. Contact DPD
SYSTEM_DOWN_UNEXPECTED   All Webservice is down. Contact DPD
SYSTEM_DOWN_MAINTANANCE   All Webservice is down for maintanance. Retry in a few minutes.
Submitted by CustomerIT on Wed, 05/20/2020 - 09:41