Clarity Connect integration
DHL Salesforce Integration
Give Salesforce users the DHL status of every open order, and open a Service Cloud case when a delivery goes wrong.
What a DHL and Salesforce link is for
Salesforce rarely books shipments. Labels and DHL bookings come from the store, ERP or warehouse system that packs the order, and that system should hold the DHL shipping connection.
What Salesforce needs is the outcome: where the parcel is, when it should arrive, and whether something has gone wrong. Clarity Connect reads that from DHL by tracking number and records it against the Salesforce order and the customer's contact.
DHL
Shipment Tracking - Unified API
- Shipment status
- Milestone timestamps
- Estimated delivery time
- Proof of delivery where offered
Salesforce
Sales Cloud and Service Cloud
- Orders
- Accounts and contacts
- Cases
- Activity history
DHL to Salesforce record mapping
A typical first map. Discovery confirms your DHL services and the Salesforce objects your teams use.
| DHL / shipping system | Salesforce | Direction |
|---|---|---|
| Tracking number | Field on the Order | Shipping system to Salesforce |
| Current status and estimated delivery | Fields on the Order | DHL to Salesforce |
| Milestone events | Activity on the Order or Contact | DHL to Salesforce |
| Delivery exception | Case | DHL to Salesforce |
| Proof of delivery (Express, Freight) | File on the Case | DHL to Salesforce |
What Salesforce gets from DHL
Tracking numbers in, status out
Once the shipping system has a DHL tracking number for an order, Connect stores it on the Salesforce Order. A scheduled task then asks DHL for the latest status of every undelivered shipment and updates the order, so reps and agents see the same answer the customer would get from DHL.
Problem deliveries become cases
When DHL reports an exception, or the estimated delivery moves past the date you promised, Connect creates a Service Cloud case on the contact with the tracking number and the last milestone, and routes it to the queue you name.
A delivery history on the account
Delivered shipments stay on the order as a short history: dispatch, key milestones and the delivery time. For DHL Express and DHL Freight, proof of delivery can be fetched after postal-code validation and added to the case if a customer says a parcel never arrived.
See Clarity Connect move an order
Watch an online order travel into the ERP and its status come back in our Clarity Connect demo, or book a live walkthrough on your own systems.
What each API asks for
DHL's tracking API needs a subscription key from the DHL developer portal, sent in a request header. The first access level is capped at 250 calls a day for development; production use needs an upgrade requested through the portal, so the call volume for your open shipments is worked out in discovery.
In Salesforce, a new integration should authenticate through an external client app, since new connected apps can't be created by default from Spring '26. Single updates use the REST API; a backlog of historic shipments can be loaded with Bulk API 2.0.
How Clarity Connect runs it
Clarity Connect is Clarity's integration platform. It runs the DHL checks as a scheduled task, writes the results to Salesforce, and keeps any job whose target is unavailable in a retry queue until it can be delivered. Clarity's own carrier work ties tracking numbers to orders, invoices and customer records. Demos of Connect are in Clarity's video playlist.
Discovery
A Clarity business analyst documents the data fields and workflows each system can share and which ones you need.
Tasks and mapping
Each flow becomes a Connect task, such as orders to the ERP or stock to the store, set to run in real time or on a schedule.
Testing
Orders and updates are run end to end, including the return trip of statuses back to the customer-facing system.
Live, with a dashboard
Queues and scheduled tasks show in Connect's Hangfire dashboard. A job whose target is offline is retried 10 times, every 30 minutes, and can be re-queued once the cause is fixed.
Clarity Connect is sold as a SaaS subscription at $599 a month or as a one-time license at $15,000 with no ongoing fees, and larger projects are priced to scope. See pricing.
Questions
Should DHL connect to Salesforce or to our ERP?
Shipments should be booked from the ERP, store or warehouse system that packs the order. Salesforce gets the tracking results, which is what this page covers.
Does it cover DHL Express and DHL eCommerce?
Yes. DHL's unified tracking API covers Express, eCommerce, Freight, Global Forwarding, Supply Chain and Parcel Germany shipments, but not services that require a DHL login.
Can we get DHL rates and labels in our online store?
Yes, that is a separate integration on the store side. See Clarity's DHL shipping integration.
How much does Clarity Connect cost?
$599 a month as SaaS, or $15,000 as a one-time license with no ongoing fees; larger projects are scoped and priced individually. See pricing.
Related resources
Put DHL status in Salesforce
Tell us which system books your DHL shipments and which Salesforce objects your teams use. A Clarity business analyst will map the tracking data with you, and only then is the task built.
Book a demo