DOCS
AccueilE-commerce mondial Fulfillment Transporteurs Connexion via API

Connexion du compte transporteur DHL

Connectez votre compte transporteur DHL en toute sécurité pour accéder à des tarifs d'expédition négociés et créer des étiquettes directement via Zonos.

Pour commencer 

Le processus de connexion du compte transporteur DHL valide vos identifiants et garantit que votre compte est correctement configuré pour récupérer les tarifs et générer des étiquettes d'expédition. Lorsque vous connectez votre compte DHL, Zonos effectue un appel de cotation test pour vérifier que la connexion fonctionne correctement avant de stocker vos identifiants.

Pour vous inscrire auprès de DHL Express ou configurer via votre Zonos Dashboard, suivez les étapes de ce guide.

Fonctionnement de la connexion du compte transporteur DHL 

Connexion de votre compte transporteur DHL :

  • Valide que vous avez fourni les types d'identifiants corrects pour DHL
  • Effectue un appel de cotation en direct à l'API DHL pour confirmer que les identifiants sont valides
  • Stocke votre compte connecté dans Zonos pour les cotations et la création d'étiquettes futures
  • Renvoie les détails du compte connecté, y compris vos informations de compte DHL et le type de tarif

Une fois connecté, votre compte transporteur DHL peut être utilisé pour obtenir des tarifs d'expédition en temps réel basés sur vos tarifs négociés (le cas échéant) et créer des étiquettes d'expédition DHL.

Connecter votre compte DHL 

Utilisez la mutation carrierAccountConnect pour connecter votre compte transporteur DHL avec vos identifiants.

Mutation

Utilisez cette mutation pour connecter votre compte transporteur DHL et valider vos identifiants.

1mutation CarrierAccountConnect($input: CarrierAccountConnectInput!) {
2 carrierAccountConnect(input: $input) {
3 errors
4 carrierAccount {
5 credentialProvider
6 id
7 integrationType
8 organization
9 rateType
10 carrier {
11 id
12 code
13 name
14 }
15 credentials {
16 type
17 value
18 }
19 }
20 }
21}

Variables

La mutation requiert le code transporteur DHL, le type de tarif et vos identifiants de compte DHL.

1{
2 "input": {
3 "carrierCode": "DHL",
4 "rateType": "NEGOTIATED",
5 "credentials": [
6 {
7 "type": "API_KEY",
8 "value": "actual_api_key_value"
9 },
10 {
11 "type": "API_PASSWORD",
12 "value": "actual_api_password_value"
13 },
14 {
15 "type": "ACCOUNT_NUMBER",
16 "value": "actual_account_number_value"
17 }
18 ]
19 }
20}

DHL requiert les types d'identifiants suivants :

  • API_KEY - Votre clé API DHL
  • API_PASSWORD - Votre mot de passe API DHL
  • ACCOUNT_NUMBER - Votre numéro de compte DHL

Vous trouverez ces identifiants dans le portail de votre compte DHL ou en contactant votre représentant de compte DHL.

Exemples de réponse

Connexion réussie

Lorsque les identifiants sont valides et que DHL renvoie les tarifs avec succès :

1{
2 "data": {
3 "carrierAccountConnect": {
4 "errors": [],
5 "carrierAccount": {
6 "credentialProvider": "ORGANIZATION",
7 "id": "carrier_account_123",
8 "integrationType": "REST",
9 "organization": "organization_id",
10 "rateType": "NEGOTIATED",
11 "carrier": {
12 "id": "carrier_123",
13 "code": "dhl",
14 "name": "DHL"
15 },
16 "credentials": [
17 {
18 "type": "API_KEY",
19 "value": "actual_api_key_value"
20 },
21 {
22 "type": "API_PASSWORD",
23 "value": "actual_api_password_value"
24 },
25 {
26 "type": "ACCOUNT_NUMBER",
27 "value": "actual_account_number_value"
28 }
29 ]
30 }
31 }
32 }
33}

Erreur : type d'identifiant non pris en charge

Si vous fournissez un type d'identifiant que DHL ne prend pas en charge :

1{
2 "data": {
3 "carrierAccountConnect": {
4 "errors": [
5 "Credential type SITE_ID is not supported by carrier DHL"
6 ],
7 "carrierAccount": null
8 }
9 }
10}

Erreur : identifiants invalides

Si les identifiants sont de types valides mais ne s'authentifient pas avec succès auprès de DHL :

1{
2 "data": {
3 "carrierAccountConnect": {
4 "errors": [
5 "Failed to get rating from DHL API"
6 ],
7 "carrierAccount": null
8 }
9 }
10}

Après la connexion

Une fois votre compte transporteur DHL connecté avec succès :

  • Le compte est stocké dans votre organisation et lié à vos identifiants
  • Vous pouvez récupérer les tarifs d'expédition DHL en utilisant vos tarifs négociés (le cas échéant)
  • Vous pouvez créer des étiquettes d'expédition DHL via l'API Zonos
  • Le compte transporteur peut être utilisé pour plusieurs expéditions sans reconnexion

Prochaines étapes 

Après avoir connecté votre compte transporteur DHL :

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CarrierAccountConnectInput

MUTATIONS

carrierAccountConnect

Cette page a-t-elle été utile?

Obtenir de l'aide·Documents juridiques·© 2026 Zonos
Sur cette page :
  • Connexion du compte transporteur DHL
  • Pour commencer
  • Fonctionnement de la connexion du compte transporteur DHL
  • Connecter votre compte DHL
  • Prochaines étapes