Skip to content

Settings

Open Add-ons > Manage add-ons > DPD Shipping Labels & Pickup Points > Settings.

Setting Default Description
Enable On When off, no new work is started. Jobs of work that is already under way are still processed.
Marketplace owner mode On On: every order is processed with the marketplace owner’s DPD account and vendors have no connection page. Off: each vendor connects their own account.
Debug log Off Also stores every call with a masked summary. The label request (personal data) is logged as its field names only; tokens and passwords are never stored.
Log retention (days) 90 Older log entries are removed by the cron run.
Create the label when the order status becomes empty Empty = create labels by hand on the order page.
Also create a CS-Cart shipment On Records the parcel label number as a regular shipment so the customer’s notifications show it.
Label format PDF outputFormat: PDF, ZPL (203 dpi) or ZPL300 (300 dpi) for thermal printers.
Paper format A6 paperFormat: A6 (one label per page) or A4 (up to four labels per sheet, PDF only). ZPL always uses A6.
Cash on delivery payment method empty ShipmentService 4.5 has no cash on delivery field. Orders paid with this method are refused with a clear message so that you create them in the DPD portal. Empty = no check.
Default parcel weight (kg) 1 Used when no product of the order has a weight.
Package length / width / height (cm) empty Optional. Sent as the parcel volume (LLLWWWHHH) when all three are set.
Ship date: days from today 0 The expected sending date sent to DPD: today in Germany plus these days (0 to 10).
Country of origin of the goods DE Used on the customs invoice lines of shipments outside the EU.
Send e-mail and phone number to DPD Off Data protection. Off: the customer’s e-mail address and phone number are not sent for home deliveries. On: they are added to the address and the e-mail is used for the DPD Predict notification (predict, channel e-mail). You need the customer’s consent (Art. 6 / 7 GDPR). DPD Pickup always needs the e-mail address (parcelShopNotification is mandatory in the schema); the checkout tells the customer.

Credentials are not ordinary settings: they are entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). The password is never shown again; leave the field empty to keep the saved value.

Field Description
Mode Test uses the DPD stage system (public-ws-stage.dpd.com), Live the production system (public-ws.dpd.com).
DelisID The DELIS user, 8 to 10 letters and digits.
Password The password of that user. It is sent only to DPD’s LoginService.
Customer number The sender customer number of your contract (customerNumber, up to 17 characters). Mandatory in the schema. Separate for test and live.
Sender address Name, street, postal code, city, country, e-mail, contact: printed on the label. Empty = company data of the store (of the vendor in Multi-Vendor).
Sending depot (optional) Four digits. The depot comes from the DPD login; fill this only to override it.

DPD has no price operation in its web services: the customer’s price is yours.

Field Description
Price Flat price per parcel.
Weight table 2=4.49, 5=5.49, 31.5=9.99: price up to that many kg; wins over the flat price.
Free from Cart subtotal from which shipping is free.
Countries ISO codes this method serves (zone): DE,AT,NL. Default DE.
Max weight Hide the method for heavier carts. Weight limits per DPD product are checked by DPD.
Delivery text Shown next to the price, for example “1-2 working days”.

The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:

  • php /path/to/store/admin.php --dispatch=kv_dpd.cron
  • https://your-store.example/index.php?dispatch=kv_dpd.cron&key=<secret>
  • Log lists every call and job with filters (level, action, text, dates) and a CSV export.
  • Jobs lists the queue. A job that fails is retried after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours, then marked “Gave up”; use Retry to queue it again.

In the vendor panel a vendor sees only their own records. With the marketplace owner mode off the vendor also gets the Connection tab for their own account.