Comment connecter MyDHL

MyDHL est un service web de DHL, l'un des principaux fournisseurs de services logistiques au monde.

Dans cet article, vous apprendrez comment connecter MyDHL à ShippyPro et ajouter des options supplémentaires telles qu'une étiquette de retour dans la boîte ou le commerce sans papier à votre connexion existante.

 

 

Sommaire:

1. Avant de commencer
2. Configuration du transporteur
3. Caractéristiques supplémentaires
4. Erreurs et dépannage

---

1. Avant de commencer

S'inscrire sur le portail des développeurs DHL

Pour procéder à la connexion, vous devez disposer d'une clé API, d' un secret API et d'un numéro de compte.numéro de compte que vous pouvez obtenir en vous enregistrant sur le portail des développeurs DHL si vous n'en avez pas encore.

Remplissez le formulaire d'intégration de DHL

• Aller dans APIs > Parcourir tous les services

• Cliquez sur DHL Express - MyDHL API

  

• Cliquez ensuite sur Obtenir l'accès

  

• Complétez les données relatives à votre entreprise.

• A la rubrique "Comment souhaitez-vous utiliser l'API ?" de la page d'enregistrement de DHL, vous devez sélectionner l'option "J'ai besoin d'informations d'identification pour DHL Express - MyDHL API pour un plugin existant/une plateforme de commerce électronique/une solution tierce" et ajouter simplement ShippyPro.

• En ce qui concerne la section intitulée"Services demandés", veuillez cocher tous les services disponibles. Le champ intitulé "Volume de transactions par mois" n'est utile à DHL qu'à des fins statistiques, il ne vous influencera donc pas dans l'utilisation de l'API.

• Après quelques heures, vous pouvez consulter votre profil de développeur DHL où vous devriez voir que le statut de votre application est approuvé.

• Ensuite, cliquez sur DHL EXPRESS – MYDHL API dans le nom de l'application, où vous trouverez un bouton rouge pour demander l'accès à la production. Une fois que vous avez cliqué dessus, vous recevrez une confirmation que votre demande a été envoyée dans les minutes qui suivent, et l'équipe locale de DHL devra l'approuver selon son propre calendrier.

  Si votre demande reste en attente, nous vous recommandons de contacter directement DHL pour accélérer le processus.

En cas de questions ou de doutes, veuillez également vous référer au guide DHL étape par étape  

---

2. Carrier's Configuration

Une fois que tout est correctement configuré dans le portail MyDHL, vous êtes prêt à le connecter à ShippyPro.

Accédez à Carriers et cliquez sur le logo MyDHL (il suffit de taper « MyDHL » dans la barre de recherche pour le trouver rapidement).

Une fois identifié, cliquez pour connecter le transporteur et renseignez les champs requis :

---

3. Fonctionnalités supplémentaires

 

Destinations

• National: Disponible
• International: Disponible

Features:

• Label PDF: Disponible

• Label PDF (dimensions): A4 & A6

• Label ZPL: Disponible

• Label EPL: Non disponible

• Track & Trace: Disponible

• Paperless: Disponible

• PickUp/DropOff (PUDO): Disponible

• Cash On Delivery: Disponible

• Live Rates: Disponible

• Return Labels: Disponible

• Return Labels (in the box): Disponible

• Book/Schedule Pickup: Disponible

• Address Check: Non disponible

• Carrier Options: Disponible

• Proof Of Delivery (POD): Disponible

• Insurance: Disponible

• Multiparcel: Disponible

• Delete Shipment (Void): Non disponible

• CloseOut: Non disponible

• CN22: Non disponible

• CN23: Non disponible

• Credentials Validation: Non disponible

• IOSS: Disponible

• Dynamic sender: Disponible

• After Ship ETD: Disponible

Services

Service Name	Service Code
All Services	ALL
ECONOMY SELECT NONDOC (ESI)	H
EXPRESS 9:00 DOC (TDK)	K
EXPRESS 9:00 NONDOC (TDE)	E
EXPRESS 10:30 DOC (TDL)	L
EXPRESS 10:30 NONDOC (TDM)	M
EXPRESS 12:00 DOC (TDT)	T
EXPRESS 12:00 NONDOC (TDY)	Y
EXPRESS DOMESTIC (DOM)	N
EXPRESS DOMESTIC 9:00 (DOK)	I
EXPRESS DOMESTIC 10:30 (DOL)	O
EXPRESS DOMESTIC 12:00 (DOT)	1
ECONOMY SELECT DOMESTIC (DES)	G
EXPRESS WORLDWIDE DOC (DOX)	D
EXPRESS WORLDWIDE NONDOC (WPX)	P
EXPRESS WORLDWIDE EU (ECX)	U
FREIGHT WORLDWIDE (FRT)	F
ECONOMY SELECT EU (ESU)	W
EXPRESS ENVELOPE DOC (XPD)	X
MEDICAL EXPRESS DOC (CMX)	C
MEDICAL EXPRESS NONDOC (WMX)	Q
EXPRESS JUMBO (WPX)	J
SAME DAY (SDX)	S

 

Carrier options

Name	Slug	Type	Description
Saturday Delivery	saturday_delivery	checkbox
Duties and Taxes Paid	duties_taxes_paid	checkbox
Importer Of Record	importer_of_record	checkbox
Dangerous Goods	dangerous_goods_contentid	select	Permet de spécifier le type de marchandises dangereuses expédiées. Les valeurs prises en charge sont listées dans le tableau ci-dessous.
Dangerous Goods 4-digit UN Code (Mandatory for Excepted Quantities)	dangerous_goods_uncode	text	À utiliser avec Dangerous Goods lorsque la sélection est « Excepted Quantities in accordance with IATA ».
Dangerous Goods Weight in Kg (Mandatory for Dry Ice UN1845)	dangerous_goods_dry_ice_weight	text	À utiliser avec Dangerous Goods lorsque la sélection est « Dry Ice UN1845 ».
Dangerous Goods Custom Description (Max 200 chars)	dangerous_goods_custom_description	text	À utiliser avec Dangerous Goods. Cette description (max. 200 caractères) remplacera le texte par défaut de l’étiquette pour les marchandises dangereuses sélectionnées.
Extended Liability	extended_liability	checkbox
Shipment Insurance	shipment_insurance	checkbox	À utiliser avec le montant d’assurance.
Neutral Delivery	neutral_delivery	checkbox
Delivery Signature	delivery_signature	checkbox
Go Green	go_green	checkbox	Ajoute le code service FE et le logo.
EXW Only Duties and Taxes	exw_only_duties_taxes	checkbox	À utiliser avec l’Incoterm EXW
Service Point ID	service_point_id	drop_off_point
Receiver Registration Number Type	receiver_registration_number_type	select	À utiliser avec receiver_registration_number_value. Valeurs prises en charge : VAT, EIN, CNP, EOR, FED, SDT.
Receiver Registration Number Value	receiver_registration_number_value	text	À utiliser avec receiver_registration_number_type.
Signature Options	signature_options	select	Signature. Remplace l’option delivery_signature.
Declaration Notes	declaration_notes	text	Déclaration de la facture commerciale.

• PDF 10 x 20 - disponible pour code-barres et texte

• ZPL - disponible pour code-barres et texte (Remarque : non disponible pour ZPL 10x15)

  Pour plus d’informations, cliquez ici.

Service Point

Si vous souhaitez utiliser un Service Point myDHL, vous devrez contacter votre personne de référence afin de vérifier l’activation du service ODD (nécessaire pour utiliser cette fonctionnalité). Une fois le service ODD activé, vous devrez envoyer au service technique du transporteur une capture d’écran de l’option Transporteur où le Service Point est sélectionné et demander l’activation du service pour l’identifiant souhaité.

Le Service Point n’apparaîtra jamais sur l’étiquette, celle-ci étant transmise électroniquement au transporteur chargé de la livraison.

 

Dangerous Goods

Pour chaque expédition contenant des marchandises dangereuses, vous devez saisir le contentId des marchandises dangereuses expédiées.

Si l’expédition contient de la glace carbonique UN1845, vous devez saisir le poids de la glace carbonique transportée.

Si les marchandises sont en quantités exceptées conformément à l’IATA, vous devez également saisir le UNCode des marchandises dangereuses, disponible ici.

Marchandises dangereuses prises en charge par l’intégration MyDHL :

 

Name	Content id	Special service code
Biological substances UN3373	650	HY
Class 2 Division 2.1 Flammable gas	910	HE
Class 2 Division 2.2 Non-flammable, non toxic gas	910	HE
Class 2 Division 2.2 Non-flammable, non toxic gas	910	HE
Class 3 Flammable Liquids	910	HE
Class 4 Division 4.1 Flammable solids	910	HE
Class 4 Division 4.2 Substances liable to spontaneous combustion	910	HE
Class 4 Division 4.3 Substances (Dangerous when wet)	910	HE
Class 5 Division 5.1 Oxidizer	910	HE
Class 5 Division 5.2 Organic Peroxides	910	HE
Class 6 Division 6.1 Toxic Substances	910	HE
Class 8 Corrosives	910	HE
Class 9 Miscellaneous Dangerous Goods	910	HE
Consumer Goods ID8000	700	HK
Dry Ice UN1845	901	HC
Excepted quantities in accordance with IATA	E01	HH
Ion PI965 Section IA (LiBa)	911	HE
Ion PI965 Section IB (LiBa)	911	HE
Ion PI965 Section II (LiBa)	965	HB
Ion PI966 Section I (LiBa with equipment)	910	HE
Ion PI966 Section II (LiBa with equipment)	966	HD
Ion PI967 Section I (LiBa in equipment)	910	HE
Ion PI967 Section II (LiBa in equipment)	967	HV
Limited quantities to the limits of ADR	A01	HL
Metal PI968 Section IA (LiBa)	911	HE
Metal PI968 Section IB (LiBa)	911	HE
Metal PI969 Section I (LiBa with equipment)	910	HE
Metal PI969 Section II (LiBa with equipment)	969	HM
Metal PI970 Section I (LiBa in equipment)	910	HE
Metal PI970 Section II (LiBa in equipment)	970	HW
Perishable Cargo	P01	HG

 

Imprimer les étiquettes de retour

Si vous souhaitez imprimer ensemble les étiquettes d’expédition et de retour lors de l’expédition de vos commandes (étiquette de retour dans le colis), ajoutez votre numéro de compte dans le champ « Account Number » et votre numéro de compte retour dans le champ « Return Account Number ». Cochez ensuite l’option Enable Return Label in the box en bas et confirmez. Veuillez noter que le format de l’étiquette sera celui choisi pour les expéditions sortantes, car il ne peut pas être modifié pour les étiquettes de retour.

Si vous souhaitez effectuer les retours séparément de l’expédition principale, vous devez créer une nouvelle connexion MyDHL. Cette fois, saisissez votre numéro de compte retour dans le champ « Account Number » et votre numéro de compte dans le champ « Return Account Number ». En pratique, c’est exactement l’inverse de la première configuration. Ne cochez pas l’option Enable Return Label in the box. Vous pourrez ensuite créer manuellement votre expédition de retour : cliquez ici pour savoir comment faire.

En sélectionnant Fixed Return Receiver Address (Only for 'Enable Return Label in the box'), si l’option Enable Return Label in the box est cochée et qu’une adresse est sélectionnée dans le menu déroulant, les étiquettes dans le colis ne seront pas renvoyées à l’adresse de l’expéditeur, mais à celle définie dans le menu déroulant.

Vous pouvez ajouter et modifier les adresses disponibles à tout moment depuis Admin > My Addresses and parcels > My addresses

 

Nombre par défaut de jours ouvrables supplémentaires requis pour préparer les expéditions

Cette information est utilisée par DHL pour déterminer la date prévue d’expédition, mais elle n’équivaut pas à une demande d’enlèvement (voir ici comment faire). Le nombre de jours requis par défaut est de 1 jour ; vous pouvez le modifier librement en sélectionnant le nombre de jours nécessaires. Le système ignorera automatiquement les jours fériés et les week-ends dans le calcul.

📌 Assurez-vous de le faire sur toutes vos connexions MyDHL, même si vous n’utilisez qu’un seul service.

📌 Si vous choisissez « same day », demandez à DHL jusqu’à quelle heure vous pouvez créer des expéditions, sinon vous risquez d’obtenir une erreur.

 

 

Expéditions internationales

Generate invoice with DHL format

Cette option vous permettra de générer automatiquement vos factures pour les expéditions internationales. Vous pouvez choisir entre une facture proforma et une facture commerciale.

En sélectionnant cette option, la facture sera générée en même temps que l’étiquette d’expédition !

Paperless Trade

Vous pouvez décider d’activer l’option Paperless documentation en cochant « Paperless Trade » dans Carriers > MyDHL > Edit. Dans ce cas, vous devrez transmettre numériquement au transporteur une facture en téléversant votre facture ETD depuis la page Label Creator > Invoice Manager, via l’appel API UploadPaperlessDocumentation, ou en demandant à DHL de générer une facture avec leur format (dans ce cas, veuillez lire les points suivants).

Il est également possible de téléverser le type de déclaration douanière depuis Label Creator > Invoice Manager, et de décider d’activer l’option Generate Invoice with DHL format depuis Carriers > MyDHL > Edit.

Il est important de noter que vous devrez sélectionner la typologie correcte lors du téléversement de votre documentation, par exemple « Customs Declaration ».

Si vous sélectionnez à la fois Generate Invoice with DHL format et Paperless depuis Carriers > MyDHL > Edit, ainsi que le téléversement de la déclaration douanière depuis Label Creator > Invoice Manager, la facture commerciale et la déclaration douanière seront toutes deux transmises électroniquement au transporteur.

Quelques exemples pratiques :

• l’option « Paperless Trade » est activée, mais ni l’ETD n’est téléversé pour une commande spécifique, ni l’option « Generate Invoice with DHL format » n’est activée : une erreur sera renvoyée car vous demandez l’envoi d’une facture dématérialisée, mais aucune facture n’est associée à cette commande

• les options « Generate Invoice with DHL format » et « Paperless » sont toutes deux activées : vous demandez ainsi à DHL de générer une facture et de l’envoyer numériquement sans avoir à l’attacher physiquement au colis (Paperless Trade)

• le document ETD est téléversé et l’option « Generate Invoice with DHL format » est activée : une erreur sera renvoyée car vous demandez la transmission de deux factures différentes pour une seule commande

• vous n’avez pas coché l’option « Paperless Trade », mais vous avez tout de même téléversé le document via l’appel « UploadPaperlessDocumentation » ou via Invoice Manager : la documentation sera quand même transmise au transporteur en mode Paperless.

---

4. Erreurs & dépannage

Lors de la tentative de connexion à MyDHL ou lors de l’expédition de vos commandes, vous pouvez rencontrer certaines erreurs. Pas de panique ! Pour plus d’informations sur la manière de les résoudre, veuillez consulter les guides suivants :

I cannot connect MyDHL

How to fix MyDHL issues