Connecter DHL Express : tarifs en direct, étiquettes, suivi

Récupérez la clé API et le secret API de votre app MyDHL API approuvée dans DHL Developer Portal, collez-les avec votre numéro de compte DHL Express dans Integration, testez, puis cotez et expédiez.

Le connecteur DHL Express obtient des tarifs en direct, achète des étiquettes et suit les envois via la MyDHL API. Tarifs et envois sont facturés sur votre compte DHL Express. Il s’agit de DHL Express uniquement — pas de DHL eCommerce, qui utilise une autre API et d’autres identifiants.

Prérequis#

• Un compte DHL Express et son numéro de compte DHL Express — sur une facture DHL ou dans mydhl+, sous My Profile.
• Accès à DHL Developer Portal (developer.dhl.com) avec une app MyDHL API approuvée.
• Commencez en bac à sable pour vous exercer : mettez true dans le champ sandbox. L’environnement de test a une limite d’appels quotidienne.

Obtenir les identifiants#

1. Allez dans DHL Developer Portal (developer.dhl.com) → Apps → votre app MyDHL API approuvée.
2. Dans la section Credential, cliquez sur Show key à côté de API Key et copiez-la. Cette clé API est la valeur à saisir comme API Username — ce n’est pas votre identifiant du site mydhl+.
3. Dans la même section Credential, cliquez sur Show key à côté de API Secret et copiez-le. Ce secret API est la valeur à saisir comme API Password.
4. Trouvez votre numéro de compte DHL Express sur une facture DHL ou dans mydhl+ → My Profile. Gardez-le avec la clé et le secret : il faut les trois pour remplir la connexion.

Remplir dans Integration#

1. Ouvrez Integration → Marketplace → DHL Express → Nouvelle connexion.
2. API Username : collez la clé API de la section Credential de votre app MyDHL API. Malgré le nom du champ, c’est bien la clé API qu’il faut mettre ici, pas un identifiant mydhl+.
3. API Password : collez le secret API de la même section Credential. Malgré le nom du champ, c’est bien le secret API qu’il faut mettre ici, pas votre mot de passe du site mydhl+.
4. DHL Express Account Number : saisissez votre numéro de compte DHL Express, depuis une facture DHL ou mydhl+ → My Profile. Tarifs et étiquettes sont facturés sur ce compte : un numéro erroné ne se voit que plus tard, à la cotation ou à l’étiquette.
5. Use sandbox (facultatif) : mettez true pour utiliser l’environnement de test pendant vos essais ; laissez vide pour la production.

Tester la connexion#

MyDHL n’a pas d’endpoint de token, donc le test fonctionne autrement que chez les autres transporteurs : il envoie votre clé API et votre secret API à l’endpoint de suivi et cherche un numéro d’envoi qui n’existe pas. Si DHL répond 404 — envoi introuvable — c’est une bonne nouvelle : vos identifiants ont été acceptés, seul l’envoi inventé est absent. Le test réussit sur ce 404. Une réponse 401 ou 403 est le vrai échec : les identifiants ont été refusés. Le test est en lecture seule, ne crée aucun envoi et ne vérifie pas votre numéro de compte : un numéro de compte erroné peut passer le test et n’échouer que plus tard, à la cotation ou à l’étiquette.

Mapping / choisir un modèle#

DHL Express n’a pas besoin de mapping de commandes : elle traite des colis, pas des commandes. Ce que vous réglez ici, c’est le mapping des services du transporteur : dans les paramètres de la connexion, associez chaque service DHL Express que vous proposez réellement au nom de service utilisé à l’expédition, et laissez non mappés les services que vous ne proposez pas. La comparaison de tarifs ne cotera alors que les services mappés, pour qu’un colis ne soit jamais coté ni étiqueté sur un service que votre compte n’expédie pas.

Activer#

Après activation, la connexion sert à comparer les tarifs et acheter des étiquettes à l’expédition, facturés sur le numéro de compte DHL Express de la connexion. Les mises à jour de suivi reviennent automatiquement et s’enregistrent sur l’envoi. Surveillez les premiers envois dans Runs / Logs avant de laisser tourner sans surveillance — surtout la première cotation, car le test ne vérifie pas le numéro de compte.

FAQ#

Le test mentionne 404 ou envoi introuvable — a-t-il échoué ?

Non — pour DHL Express, ce 404 est le signal de réussite. Le test cherche volontairement un numéro d’envoi qui n’existe pas. Recevoir une réponse introuvable signifie que DHL a accepté votre clé API et votre secret API et n’a rejeté que l’envoi inventé.

Considérez le test comme réussi et passez au mapping et à l’activation. Seule une réponse 401 ou 403 signifie un vrai échec du test.

Le test échoue avec 401 ou 403

DHL a refusé les identifiants. Les causes habituelles : la clé API ou le secret API a été mal copié, les deux ont été inversés, ou un mot de passe du site mydhl+ — ou des identifiants DHL eCommerce — a été saisi à la place du secret API MyDHL.

Retournez dans DHL Developer Portal → Apps → votre app MyDHL API approuvée → section Credential, cliquez à nouveau sur Show key et recopiez soigneusement : clé API dans API Username, secret API dans API Password. Puis testez à nouveau.

Le test réussit, mais la cotation ou l’étiquette échoue

Le test de connexion ne vérifie pas du tout votre numéro de compte : il peut donc réussir avec un numéro erroné. L’erreur n’apparaît que lorsqu’une cotation ou une étiquette réelle essaie de facturer ce compte.

Vérifiez le numéro de compte DHL Express sur une facture DHL ou dans mydhl+ → My Profile, corrigez-le dans la connexion, puis relancez la cotation.

J’ai utilisé mon accès mydhl+ ou mes identifiants DHL eCommerce et cela ne fonctionne pas

Ce sont trois jeux d’identifiants différents, non interchangeables : l’accès au site mydhl+ sert au site web, les identifiants DHL eCommerce relèvent d’une autre API, et cette connexion n’accepte que la clé API et le secret API d’une app MyDHL API.

N’utilisez que les identifiants MyDHL API pour cette connexion : DHL Developer Portal → Apps → votre app MyDHL API approuvée → section Credential → Show key pour la clé API et le secret API. Gardez les identifiants eCommerce pour le connecteur eCommerce.