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.
mutation CarrierAccountConnect($input: CarrierAccountConnectInput!) { carrierAccountConnect(input: $input) { errors carrierAccount { credentialProvider id integrationType organization rateType carrier { id code name } credentials { type value } } }}Variables
La mutation requiert le code transporteur DHL, le type de tarif 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 requiert les types d'identifiants suivants :
API_KEY- Votre clé API DHLAPI_PASSWORD- Votre mot de passe API DHLACCOUNT_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 :
{ "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'identifiant non pris en charge
Si vous fournissez un type d'identifiant 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 de types valides mais ne s'authentifient pas avec succès auprès de DHL :
{ "data": { "carrierAccountConnect": { "errors": [ "Failed to get rating from DHL API" ], "carrierAccount": null } }}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 :
- Créer une expédition - Générez des étiquettes d'expédition avec votre compte transporteur DHL connecté
- Calculer le landed cost - Obtenez des calculs précis de droits et taxes pour les expéditions internationales
- Voir les transporteurs pris en charge - Consultez tous les transporteurs et niveaux de service disponibles via Zonos
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.