Aller au contenu

API DHL Express

Globe Pickup Points s’intègre à DHL Express via l’API MyDHL, ce qui permet d’expédier en express dans le monde entier directement depuis Shopify. Avec cette intégration, vous pouvez :

  • Exporter vos commandes vers DHL Express et recevoir immédiatement un numéro de suivi
  • Imprimer des étiquettes d’expédition dans Shopify
  • Livrer à l’adresse du client ou vers un DHL Express Service Point
  • Transmettre toutes les données douanières (codes SH, conditions DDP ou DAP) sur les envois internationaux

DHL Express est activé boutique par boutique, sur demande. Si vous ne le voyez pas lors de l’ajout d’un nouveau transporteur, contactez le support et nous l’activerons pour votre boutique.


  1. Dans votre administration Shopify, ouvrez Globe Pickup Points et accédez à Étiquettes d’expédition. Ajoutez un nouveau transporteur et sélectionnez DHL Express.
  2. Sélectionnez l’EnvironnementProduction pour les expéditions réelles, ou Développement (test) pour l’environnement de test MyDHL. Les identifiants de test et de production sont différents.
  3. Saisissez votre Nom d’utilisateur et votre Mot de passe — vos identifiants API DHL Express, obtenus sur le portail développeur DHL ou auprès de votre gestionnaire de compte DHL.
  4. Saisissez votre Numéro de compte — le compte DHL Express sur lequel les expéditions sont facturées.
  5. Renseignez les coordonnées de l’expéditeur utilisées comme expéditeur sur chaque étiquette : Nom de l’expéditeur, Adresse de l’expéditeur (rue et numéro), Ville de l’expéditeur, Code postal de l’expéditeur, Pays de l’expéditeur, Téléphone de l’expéditeur et Email de l’expéditeur. Seuls les pays pris en charge par cette intégration figurent dans la liste des pays.
  6. Saisissez une Description par défaut du contenu de l’envoi — une courte description du contenu de l’envoi pour les douanes (par exemple Goods ou Clothing). Ce champ est obligatoire : une commande sans description, par défaut ou au niveau de la commande, n’est pas exportée.
  7. Vous pouvez également définir, dans les paramètres avancés, un Code HS par défaut et un Poids par défaut (kg), utilisés lorsque les produits n’en ont pas.
  8. Configurez Expédier les commandes automatiquement, Tagger les commandes avec le numéro de suivi et Tag personnalisé après l’export selon vos besoins.
  9. Associez vos méthodes d’expédition Shopify aux services DHL Express activés sur votre compte.

Export des commandes et impression des étiquettes

Section intitulée « Export des commandes et impression des étiquettes »

Vous pouvez exporter vos commandes vers DHL Express et imprimer les étiquettes d’expédition directement depuis Shopify, par lots ou une par une. Consultez Créer des étiquettes d’expédition pour le fonctionnement général.

Chaque commande est envoyée comme un colis unique. DHL renvoie le numéro de suivi et le PDF de l’étiquette dans la même réponse : les étiquettes sont donc prêtes à imprimer dès l’export. Si Expédier les commandes automatiquement est activé, le traitement de la commande est créé avec le numéro de suivi et un lien vers le suivi DHL.

Une chose que cette intégration ne fait pas : aucun enlèvement par coursier n’est réservé. Les expéditions sont créées sans demande d’enlèvement — organisez la collecte avec DHL comme vous le faites habituellement.


ServiceDescription
DHL Express WorldwideLivraison express standard de porte à porte
DHL Express Worldwide – Service Point (D2SVP)Livraison vers un DHL Express Service Point
DHL Express 12:00Livraison à heure garantie avant 12:00
DHL Express 10:30Livraison à heure garantie avant 10:30
DHL Express 9:00Livraison à heure garantie avant 09:00
DHL Economy SelectService économique

Globe choisit le code produit DHL correspondant au trajet — national, intra-UE ou mondial — à partir du service que vous avez sélectionné. Le service doit tout de même être actif sur votre compte DHL ; DHL rejette les expéditions pour les produits pour lesquels vous n’avez pas de contrat.


  • Service Point (D2SVP) — le colis est livré au DHL Express Service Point sélectionné par le client au paiement. Globe transmet l’identifiant MyDHL du point (6 caractères) ainsi que le service à valeur ajoutée Service Point de DHL, afin que l’étiquette porte le marquage SPD. Le Service Point est défini comme destinataire et l’adresse du client est transmise comme acheteur, ce que DHL exige pour ce service.
  • Livraison à domicile — tous les autres services livrent à l’adresse de livraison du client.

Un export Service Point nécessite un véritable point DHL Express, issu de la carte des points de retrait DHL Express (configurée avec les mêmes identifiants MyDHL — voir Ajouter des transporteurs de points de retrait). Les commandes sans point de retrait, ou dont le point provient du réseau d’un autre transporteur, sont rejetées lors de l’export.


Les expéditions qui franchissent une frontière douanière — tout ce qui n’est ni national ni intra-UE — sont exportées avec une déclaration électronique complète construite à partir des lignes de la commande : description, quantité, prix unitaire, poids, code SH et pays de fabrication. Les codes SH proviennent du code du système harmonisé du produit dans Shopify et, à défaut, de votre Code HS par défaut ; le pays de fabrication provient du pays d’origine du produit et, à défaut, de votre pays d’expéditeur.

Dans la section Douanes et taxes des paramètres du transporteur :

ParamètreEffet
Pays DDPDestinations expédiées en conditions DDP (droits et taxes à votre charge). Tout le reste utilise DAP.
Envoyer les valeurs hors TVA pour les paysPour les destinations sélectionnées, la valeur déclarée est envoyée hors TVA.

Pour chaque commande, vous pouvez remplacer le Code SH et la Description du contenu dans la fenêtre d’étiquette avant l’export.


Le paiement à la livraison est transmis à DHL sous la forme du service à valeur ajoutée d’encaissement en espèces. Le montant correspond au montant restant dû sur la commande, dans la devise de la commande, encaissé en espèces. Le paiement à la livraison doit être activé sur votre compte DHL Express et disponible sur le trajet de destination — DHL Express ne le propose que dans un nombre limité de pays, vérifiez donc auprès de DHL avant de le proposer au paiement. Si le service n’est pas disponible, DHL rejette l’expédition entière.


La synchronisation des statuts de livraison n’est pas disponible pour DHL Express : les statuts ne sont pas réécrits dans Shopify. Le numéro de suivi et le lien de suivi restent tout de même attachés au traitement de la commande, ce qui permet de suivre le colis sur dhl.com. Les étiquettes de retour ne sont pas prises en charge non plus.


Les étiquettes sont générées au format PDF en 300 DPI, dans les formats suivants :

FormatPositions par feuille
A61
A6 sur A44

Lors de l’impression A6 sur A4, vous pouvez choisir une position de départ sur la feuille (positions 1–4) pour réutiliser des planches partiellement utilisées. Les étiquettes sont conservées au moment de l’export : une réimpression ne rappelle donc pas DHL.


ProblèmeSolution
Erreur d’authentificationVérifiez que le Nom d’utilisateur, le Mot de passe et le Numéro de compte correspondent à l’Environnement sélectionné — les identifiants de test ne fonctionnent pas en production.
La description du contenu est obligatoireDéfinissez une Description par défaut du contenu de l’envoi dans les paramètres du transporteur, ou renseignez la Description du contenu sur la commande.
Service Point : aucun point de retrait sélectionnéLa commande utilise le service Service Point mais ne comporte aucun point de retrait. Le client n’en a pas sélectionné au paiement.
Service Point : le point de retrait doit être un identifiant de site à 6 caractèresLe point sélectionné ne provient pas du réseau DHL Express. Le client doit sélectionner un DHL Express Service Point.
Type de produit inconnuLa méthode d’expédition est associée à un service qui n’existe plus. Réassociez la méthode d’expédition dans les paramètres du transporteur.
Expédition rejetée par DHLLe message d’erreur complet de DHL apparaît dans le résultat de l’export — généralement un produit non activé sur votre compte, un code postal invalide ou un numéro de téléphone manquant.
Aucune donnée d’étiquette trouvée à l’impressionL’étiquette enregistrée est absente pour ces commandes. Réexportez les commandes pour générer de nouvelles étiquettes.