Conectar DHL Express: tarifas en vivo, etiquetas y rastreo
Obtenga la API Key y el API Secret de su app MyDHL API aprobada en DHL Developer Portal, péguelos junto con su número de cuenta de DHL Express en Integration, pruebe y empiece a cotizar y enviar.
El conector de DHL Express obtiene tarifas en vivo, compra etiquetas y rastrea envíos mediante la MyDHL API. Las tarifas y los envíos se facturan a su cuenta de DHL Express. Es solo DHL Express: no es DHL eCommerce, que usa otra API y otras credenciales.
Requisitos previos#
- Una cuenta de DHL Express y su número de cuenta de DHL Express: está en una factura de DHL o en mydhl+, en My Profile.
- Acceso a DHL Developer Portal (developer.dhl.com) con una app MyDHL API aprobada.
- Empiece en sandbox si quiere practicar primero: ponga true en el campo sandbox. El entorno de prueba tiene un límite diario de llamadas.
Obtener credenciales#
- Vaya a DHL Developer Portal (developer.dhl.com) → Apps → su app MyDHL API aprobada.
- En la sección Credential, haga clic en Show key junto a API Key y cópiela. Esta API Key es lo que ingresará como API Username: no es su inicio de sesión del sitio mydhl+.
- En la misma sección Credential, haga clic en Show key junto a API Secret y cópielo. Este API Secret es lo que ingresará como API Password.
- Encuentre su número de cuenta de DHL Express en una factura de DHL o en mydhl+ → My Profile. Guárdelo junto con la Key y el Secret: necesita los tres para completar la conexión.
Completar en Integration#
- Abra Integration → Marketplace → DHL Express → Nueva conexión.
- API Username: pegue la API Key de la sección Credential de su app MyDHL API. A pesar del nombre del campo, aquí va la API Key, no un nombre de inicio de sesión de mydhl+.
- API Password: pegue el API Secret de la misma sección Credential. A pesar del nombre del campo, aquí va el API Secret, no su contraseña del sitio mydhl+.
- DHL Express Account Number: ingrese su número de cuenta de DHL Express, de una factura de DHL o de mydhl+ → My Profile. Tarifas y etiquetas se facturan a esta cuenta, por lo que un número incorrecto solo se nota después, al cotizar o emitir la etiqueta.
- Use sandbox (opcional): ponga true para usar el entorno de prueba mientras practica; déjelo en blanco para producción.
Probar la conexión#
MyDHL no tiene endpoint de token, por lo que la prueba funciona distinto que en otros transportistas: envía su API Key y su API Secret al endpoint de rastreo y busca un número de envío que no existe. Si DHL responde 404 — envío no encontrado — es una buena noticia: significa que sus credenciales fueron aceptadas y que solo falta ese envío inventado. La prueba aprueba con ese 404. Un 401 o 403 sí es el fallo real: significa que las credenciales fueron rechazadas. La prueba es de solo lectura, no crea ningún envío y no verifica su número de cuenta: un número de cuenta incorrecto puede pasar la prueba y fallar después, al cotizar o emitir una etiqueta.
Mapping / elegir plantilla#
DHL Express no necesita mapping de pedidos: trabaja con paquetes, no con pedidos. Lo que configura aquí es el mapping de servicios del transportista: en la configuración de la conexión, relacione cada servicio de DHL Express que realmente ofrece con el nombre de servicio que usa al enviar, y deje sin mapear los servicios que no ofrece. La comparación de tarifas solo cotizará los servicios mapeados, para que un paquete nunca se cotice ni se etiquete con un servicio que su cuenta no envía.
Activar#
Tras activar, la conexión queda disponible para comparar tarifas y comprar etiquetas al enviar, con facturación al número de cuenta de DHL Express de la conexión. Las actualizaciones de rastreo vuelven automáticamente y se registran en el envío. Vigile los primeros envíos en Runs / Logs antes de dejarlo sin supervisión, sobre todo la primera cotización, porque la prueba no verifica el número de cuenta.
Preguntas frecuentes#
La prueba menciona 404 o envío no encontrado: ¿falló?
No: para DHL Express, ese 404 es la señal de éxito. La prueba busca a propósito un número de envío que no existe. Recibir una respuesta de no encontrado significa que DHL aceptó su API Key y su API Secret y solo rechazó ese envío inventado.
Considere la prueba como aprobada y continúe con el mapping y la activación. Solo una respuesta 401 o 403 significa que la prueba realmente falló.
La prueba falla con 401 o 403
DHL rechazó las credenciales. Las causas habituales son que la API Key o el API Secret se copiaron mal, que se intercambiaron, o que se ingresó una contraseña del sitio mydhl+ — o credenciales de DHL eCommerce — en lugar del API Secret de MyDHL.
Vuelva a DHL Developer Portal → Apps → su app MyDHL API aprobada → sección Credential, haga clic de nuevo en Show key y copie con cuidado: API Key en API Username y API Secret en API Password. Luego pruebe de nuevo.
La prueba pasa, pero las cotizaciones o etiquetas fallan
La prueba de conexión no verifica en absoluto su número de cuenta, por lo que puede aprobar con un número de cuenta incorrecto. El error solo aparece cuando una cotización o etiqueta real intenta facturar a esa cuenta.
Contraste el número de cuenta de DHL Express con una factura de DHL o con mydhl+ → My Profile, corríjalo en la conexión y vuelva a cotizar.
Usé mi acceso de mydhl+ o mis credenciales de DHL eCommerce y no funciona
Son tres conjuntos de credenciales distintos que no se sustituyen entre sí: el acceso al sitio mydhl+ es para el sitio web, las credenciales de DHL eCommerce pertenecen a otra API, y esta conexión solo acepta la API Key y el API Secret de una app MyDHL API.
Use solo las credenciales de MyDHL API para esta conexión: DHL Developer Portal → Apps → su app MyDHL API aprobada → sección Credential → Show key para la API Key y el API Secret. Guarde las credenciales de eCommerce para el conector de eCommerce.