A DHL label problem can mean the request was definitively rejected, the booking result is uncertain, the label exists but cannot be downloaded, or Shopify has not accepted the shipment. Those states require different actions.
Read the result first
| State | What it means | Safe next step |
|---|---|---|
| Definitive validation failure | DHL rejected the request before a paid shipment was accepted. | Correct the named sender, recipient, parcel, product, or service data and start a fresh deliberate confirmation. |
| Uncertain outcome | The network or provider response does not prove whether the paid booking was accepted. | Do not retry with a new key. Use the original booking context and live reconciliation path. |
| Label evidence exists | The booking has evidence, but download or printing failed separately. | Use the retained label or print/recovery flow; printing must not book DHL again. |
| Shopify pending | The local shipment exists but Shopify acceptance is not confirmed. | Use shipment sync recovery rather than creating another shipment. |
Safe resolution
- Record the order, shipment, DHL result, diagnostic identifier, and whether label evidence exists.
- For a definitive failure, correct the source data and re-run the full preflight before a new confirmation.
- For an uncertain outcome, keep the original booking reference and ask an Admin to reconcile before any new booking.
- For a print or download problem, use the original label evidence and never treat printing as a booking action.
- Confirm the final carrier and Shopify states before returning the order to completed history.
What this is and when to use it
Use this Admin troubleshooting guide when DHL validation, label download, printing, or Shopify acceptance does not finish normally.
Identify the result
- Read whether DHL rejected the request, accepted it with a missing response, returned a label that will not print, or awaits Shopify.
- For a definitive rejection, correct the named parcel, sender, recipient, service, or account value.
- For an uncertain result, keep the original shipment and use paid-label recovery.
- For printing, retrieve or print the existing label; never book to solve a print problem.
Questions and hand-off
If The PDF is missing after a paid booking
Treat the booking as potentially paid and reconcile it before any retry.
If Shopify is pending
Use shipment sync recovery on the original shipment.
What happens next
The final DHL state is known, one label is verified when applicable, and the Shopify result has its own clear state.