DHL Shipping
v1.0.0Overview
A carrier for the works. When a job is ready it asks what a collection would cost for the parcel the run actually makes — the weight comes from the sheets it consumed — offers the services that come back, books one, stores the label and follows the tracking events through to delivery. An address the carrier will not accept comes back as a refusal you can read and correct, not a silent failure. It is written against the delivery-carrier contract rather than against one company, which is what makes the next carrier a copy of this one; and in the demo it talks to a stand-in transport, so no real collection is ever booked.
What it attaches to
An add-on extends an app you already run, and is never deployed on its own. This one attaches to:
What connecting lets it do
It needs an API key and account number from your own account with the carrier. Both are encrypted at rest, redacted in every response and never sent to the browser. Connected, it may read a job that is ready, record shipments and their tracking events, and put a label in your file store. Its server half may call one address and nothing else.
Inside your own installation
- Read the job it is working on
- Create and update shipment records
- Write files into your file store
Addresses its server code may reach
- express.api.dhl.com
That list is the whole list: a call to any other address is refused and recorded.
What it needs to connect
An API key
What it adds
Where it appears 4
- The dispatch actions on a job ticket
- The delivery choice at checkout
- The dispatch panel on a customer’s order
- Its own panel under Add-ons in the dashboard settings
Tables it brings 2
- shipments
- shipment_events
Settings you configure 4
- API key
- Account number
- Use the stand-in carrier instead
- Collection cut-off
If you switch it off
Disconnecting removes an add-on’s surfaces. It never drops the tables it created, deletes the files it wrote, or removes the rows it added — everything it wrote stays in your database. The credentials it was given are revoked and deleted with it.
What stays
Shipments already booked, their labels and their whole tracking history stay exactly where they are.
What goes
The carrier disappears from checkout, from the customer’s order and from the job ticket, and the stored key is deleted. Handing a job over the counter works as it did before.
About the demo
No demo on this site makes a real call to anyone else’s service. Every add-on ships a stand-in transport that answers from built-in data, and it is on by default. Real credentials are a self-host choice, described in the add-on’s own README.
How to switch it on In the demo, switch to the Print shop side, open Add-ons and turn DHL Shipping on — then open a job that is ready.
Adminium is not affiliated with this company.