Connectez le 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.

Commencer 

Le processus de connexion du compte transporteur DHL valide vos identifiants et assure 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 tarification de 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(/docs/global-ecommerce/shipping-labels/carriers/dhl-express-rating).

Comment fonctionne la connexion du compte transporteur DHL 

Connecter votre compte transporteur DHL:

• Valide que vous avez fourni les bons types d'identifiants pour DHL
• Effectue un appel de tarification en direct à l'API DHL pour confirmer que les identifiants sont valides
• Stocke votre compte connecté dans Zonos pour les évaluations d'expédition et la création d'étiquettes à l'avenir
• Renvoie les détails du compte connecté, y compris vos informations de compte DHL et le type de rate

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.

Connectez 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.

mutation CarrierAccountConnect($input: CarrierAccountConnectInput!) {
  carrierAccountConnect(input: $input) {
    errors
    carrierAccount {
      credentialProvider
      id
      integrationType
      organization
      rateType
      carrier {
        id
        code
        name
      }
      credentials {
        type
        value
      }
    }
  }
}

Variables

La mutation nécessite le code de transporteur DHL, rate type, et vos identifiants de compte DHL.

{
  "input": {
    "carrierCode": "DHL",
    "rateType": "NEGOTIATED",
    "credentials": [
      {
        "type": "API_KEY",
        "value": "actual_api_key_value"
      },
      {
        "type": "API_PASSWORD",
        "value": "actual_api_password_value"
      },
      {
        "type": "ACCOUNT_NUMBER",
        "value": "actual_account_number_value"
      }
    ]
  }
}

DHL nécessite 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 pouvez trouver ces identifiants dans votre portail de 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 :

{
  "data": {
    "carrierAccountConnect": {
      "errors": [],
      "carrierAccount": {
        "credentialProvider": "ORGANIZATION",
        "id": "carrier_account_123",
        "integrationType": "REST",
        "organization": "organization_id",
        "rateType": "NEGOTIATED",
        "carrier": {
          "id": "carrier_123",
          "code": "dhl",
          "name": "DHL"
        },
        "credentials": [
          {
            "type": "API_KEY",
            "value": "actual_api_key_value"
          },
          {
            "type": "API_PASSWORD",
            "value": "actual_api_password_value"
          },
          {
            "type": "ACCOUNT_NUMBER",
            "value": "actual_account_number_value"
          }
        ]
      }
    }
  }
}

Erreur : type d'identification non pris en charge

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

{
  "data": {
    "carrierAccountConnect": {
      "errors": ["Credential type SITE_ID is not supported by carrier DHL"],
      "carrierAccount": null
    }
  }
}

Erreur : identifiants invalides

Si les identifiants sont valides mais ne parviennent pas à s'authentifier auprès de DHL :

{
  "data": {
    "carrierAccountConnect": {
      "errors": ["Failed to get rating from DHL API"],
      "carrierAccount": null
    }
  }
}

Que se passe-t-il après la connexion

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

• Le compte est enregistré 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 se reconnecter

Étapes suivantes 

Après avoir connecté votre compte transporteur DHL :

• Créer une expédition - Générez des étiquettes d'expédition en utilisant votre compte transporteur DHL connecté
• Calculer landed cost - Obtenez des calculs précis des droits et taxes pour les expéditions internationales
• Voir les transporteurs pris en charge - Voir tous les transporteurs et niveaux de service disponibles via Zonos