DOCS
InicioComercio electrónico global Fulfillment Transportistas Conectar vía API

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.

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.

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 mutación requiere el código de transportista DHL, el tipo de tarifa y las credenciales de su cuenta de 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 requiere los siguientes tipos de credenciales:

  • API_KEY - Su API key de DHL
  • API_PASSWORD - Su API password de DHL
  • ACCOUNT_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:

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}

Error: tipo de credencial no compatible

Si proporciona un tipo de credencial que DHL no admite:

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}

Error: credenciales no válidas

Si los tipos de credenciales son válidos pero no se autentican correctamente con DHL:

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

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
GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

CarrierAccountConnectInput

MUTATIONS

carrierAccountConnect

¿Fue útil esta página?

Obtener soporte·Documentos legales·© 2026 Zonos
En esta página:
  • Conectar cuenta de transportista DHL
  • Primeros pasos
  • Cómo funciona la conexión de cuenta de transportista DHL
  • Conecte su cuenta de DHL
  • Próximos pasos