Marketplace
Add-on v1.0.31

DHL Shipping

Overview

One delivery company, for the shops that post what they make. At checkout the customer sees DHL’s services with their prices and delivery dates, and the one they pick is kept on the order. When the parcel is ready, the dispatch flow opens on that service: it asks DHL what the collection costs for the parcel’s weight, books it, stores the label in your file store and follows the tracking events through to delivery, and the customer’s order shows where the parcel is. An address DHL refuses comes back in DHL’s own words for you to correct and try again, not as a silent failure. Where an app marks a record as a return, it can also make a prepaid return label to your returns address. It works with Maker Shop, Print Shop, Factory Ops, Ecommerce Storefront and Support Desk, each showing the parts its screens have. A demo carrier is on until you switch it off: it prices, books and tracks without ever booking a real collection, and says so on screen. It is written against the delivery-carrier contract rather than against DHL alone, so another carrier is a copy of this one.

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 DHL account, given once when it is connected. Both are encrypted at rest, redacted in every response and never sent to the browser; only its server half reads them. Connected, it may record shipments and their tracking events in its own tables and put labels in your file store. Its server half may call one address, express.api.dhl.com, and nothing else.

Inside your own installation

  • 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 5
  • The dispatch actions on an order or 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
  • The actions on one record’s own page
Tables it brings 2
  • shipments
  • shipment_events
Settings you configure 9
  • API key
  • Account number
  • Use the demo carrier instead
  • Collection cut-off
  • Returns address — name on the label
  • Returns address — street
  • Returns address — town or city
  • Returns address — postcode
  • Returns address — country

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

DHL leaves checkout, the customer’s order and the dispatch screen, and the stored key is deleted. The app’s own words come back: handing a parcel over the counter or sending it your own way 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 Maker Shop and Print Shop demos on this site, switch DHL Shipping on among the demo’s add-ons, then choose a delivery service at checkout or open an order that is ready to post. In your own Adminium, both apps offer it when they are installed.

Adminium is not affiliated with this company.