Primeros pasos
El proceso de conexión de la cuenta de transportista DHL valida sus credenciales y garantiza que su cuenta esté configurada correctamente para obtener tarifas y generar etiquetas de envío. Cuando conecta su cuenta de DHL, Zonos realiza una llamada de prueba de rating para verificar que la conexión funciona correctamente antes de almacenar sus credenciales.
Para registrarse en DHL Express o configurarse a través de Zonos Dashboard, siga los pasos de esta guía.
Cómo funciona la conexión de cuenta de transportista DHL
Al conectar su cuenta de transportista DHL:
- Se valida que haya proporcionado los tipos de credenciales correctos para DHL
- Se realiza una llamada de rating en vivo a la API de DHL para confirmar que las credenciales son válidas
- Se almacena su cuenta conectada en Zonos para futuras valoraciones de envío y creación de etiquetas
- Se devuelven los detalles de la cuenta conectada, incluida su información de cuenta de DHL y el tipo de tarifa
Una vez conectada, su cuenta de transportista DHL puede utilizarse para obtener tarifas de envío en tiempo real basadas en sus tarifas negociadas (si aplica) y crear etiquetas de envío de DHL.
Conecte su cuenta de DHL
Utilice la mutación carrierAccountConnect para conectar su cuenta de transportista DHL con sus credenciales.
Mutación
Utilice esta mutación para conectar su cuenta de transportista DHL y validar sus credenciales.
mutation CarrierAccountConnect($input: CarrierAccountConnectInput!) { carrierAccountConnect(input: $input) { errors carrierAccount { credentialProvider id integrationType organization rateType carrier { id code name } credentials { type value } } }}Variables
La mutación requiere el código de transportista DHL, el tipo de tarifa y las credenciales de su cuenta de 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 requiere los siguientes tipos de credenciales:
API_KEY- Su API key de DHLAPI_PASSWORD- Su API password de DHLACCOUNT_NUMBER- Su account number de DHL
Puede encontrar estas credenciales en el portal de su cuenta de DHL o contactando con su representante de cuenta de DHL.
Ejemplos de respuesta
Conexión correcta
Cuando las credenciales son válidas y DHL devuelve tarifas correctamente:
{ "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" } ] } } }}Error: tipo de credencial no compatible
Si proporciona un tipo de credencial que DHL no admite:
{ "data": { "carrierAccountConnect": { "errors": [ "Credential type SITE_ID is not supported by carrier DHL" ], "carrierAccount": null } }}Error: credenciales no válidas
Si los tipos de credenciales son válidos pero no se autentican correctamente con DHL:
{ "data": { "carrierAccountConnect": { "errors": [ "Failed to get rating from DHL API" ], "carrierAccount": null } }}Qué ocurre tras la conexión
Una vez conectada correctamente su cuenta de transportista DHL:
- La cuenta se almacena en su organización y se vincula a sus credenciales
- Puede obtener tarifas de envío de DHL utilizando sus tarifas negociadas (cuando aplique)
- Puede crear etiquetas de envío de DHL a través de la API de Zonos
- La cuenta de transportista puede utilizarse en múltiples envíos sin volver a conectar
Próximos pasos
Tras conectar su cuenta de transportista DHL:
- Crear un envío — genere etiquetas de envío utilizando su cuenta de transportista DHL conectada
- Calcular Landed Cost — obtenga cálculos precisos de aranceles e impuestos para envíos internacionales
- Ver transportistas compatibles — consulte todos los transportistas y niveles de servicio disponibles a través de Zonos
Conectar cuenta de transportista DHL
Conecte de forma segura su cuenta de transportista DHL para acceder a tarifas de envío negociadas y crear etiquetas directamente a través de Zonos.