Errors and Solutions

This guide contains the most common errors when using the WPify Woo DPD plugin and steps to resolve them.

API Connection Errors

DPD API returns authentication error

Cause: The API Token or Customer ID is incorrect or the DPD account is not active.

Solution:

1. Go to WooCommerce → Wpify Modules → DPD and verify the API Token and Customer ID
2. Make sure there are no extra spaces in the credentials
3. Confirm with DPD that your business account is active and API access is enabled
4. Check the logs in WPify → WPify Logs for the exact error response from DPD

Connection timeout when submitting orders to DPD

Cause: The DPD API server is unreachable or the server’s outgoing connections are blocked.

Solution:

1. Try submitting the order again — the DPD API may be temporarily unavailable
2. Check if your server’s firewall allows outgoing HTTPS connections
3. Contact your hosting provider to verify that outgoing API calls are not blocked
4. Check the logs for timeout-related error messages

DPD Order Identification Errors

DPD metabox is not displayed for the order / order cannot be submitted to DPD

Cause: The order’s shipping method is not linked to a DPD service. The plugin identifies orders as DPD shipments only when the shipping method used is either DPD Parcel Shop or is mapped in the Other shipping methods setting.

Solution:

1. Go to WooCommerce → Wpify Modules → DPD
2. In the Other shipping methods section, map your shipping method (flat rate, free shipping, etc.) to a specific DPD service
3. Save the settings
4. New orders using this shipping method will have the DPD metabox and DPD column in the orders list

Note

Parcel Shop is linked automatically — there is no need to map it in “Other shipping methods”. Mapping is only needed for standard WooCommerce shipping methods (delivery to address).

Shipment Submission Errors

Order submission to DPD fails with validation error

Cause: The order data does not meet DPD API requirements (missing address, invalid phone number, etc.).

Solution:

1. Check the order’s shipping address — all required fields must be filled in
2. Verify the phone number format (DPD requires a valid phone number for delivery notifications)
3. Check that the sender address ID is valid in the DPD metabox
4. Review the error details in WPify → WPify Logs — the DPD API response usually contains specific validation errors

Label cannot be generated — order not submitted

Cause: The order has not been submitted to DPD yet.

Solution:

1. Open the order detail
2. In the DPD metabox, click Submit to DPD first
3. After successful submission, click Get Label

Bulk label printing returns empty file

Cause: None of the selected orders have been submitted to DPD, or all submissions failed.

Solution:

1. First use the DPD — Submit orders bulk action to submit orders
2. Then use DPD — Print labels to print labels
3. Check individual order notes for submission errors

Parcel Shop Errors

Parcel shop selection does not appear in checkout

Cause: The DPD Parcel Shop shipping method is not configured in the shipping zone, or the checkout does not support the widget.

Solution:

1. Go to WooCommerce → Settings → Shipping and verify that DPD Parcel Shop is added to the relevant shipping zone
2. Make sure the shipping zone matches the customer’s address
3. Check for JavaScript errors in the browser console that may prevent the widget from loading
4. If using block checkout, verify that the plugin version supports it

Customer selected a parcel shop but the address is not saved

Cause: The Replace shipping address option is not enabled.

Solution:

1. Go to WooCommerce → Wpify Modules → DPD
2. Enable Replace shipping address
3. This will replace the WooCommerce shipping address with the selected parcel shop address

Tracking Errors

Tracking link is not displayed in customer emails

Cause: The email tracking text is not configured or the order has not been submitted to DPD.

Solution:

1. Go to WooCommerce → Wpify Modules → DPD and check that Email tracking text is set
2. Make sure the text contains the {tracking} placeholder
3. Verify that the order was submitted to DPD before the email was sent
4. Check the Email tracking position setting

Frequently Asked Questions (FAQ)

Can I use multiple sender addresses?

Yes, configure multiple sender addresses in the plugin settings. Each address has a label and an ID. The default address is used automatically, and you can select a different address per order in the DPD metabox.

Can I send multi-package shipments?

Yes, change the Number of packages in the DPD metabox in the order detail before submitting to DPD. Each package gets its own tracking number and label.

What DPD services are available?

The plugin supports: DPD CLASSIC (001), DPD Private (013), DPD 10:00 (022), DPD 12:00 (023), DPD 18:00 / GUARANTEE (010), DPD EXPRESS (030), and DPD Shop2Home (610).

Can I map my existing shipping methods to DPD services?

Yes, use the Other shipping methods setting to map your WooCommerce shipping methods (flat rate, free shipping, etc.) to specific DPD services. This way, orders using these methods can be submitted to DPD with the correct service code.

Does the plugin support thermal printers?

Yes, set the Label format to ZPL and the Label size to A6 for thermal printer output.