Este módulo integra la API de DHL Parcel con Odoo. No es válido para otras integraciones de DHL como el Express, que usan otras APIs.
IMPORTANTE: Hay varias APIs distintas para DHL España y DHL Parcel, esta API solo funciona para una de ellas. Para notificar y pedir las credenciales correctas a tu comercial de integración, se puede pasar el documento que hay en /doc para indicar exactamente cuál es la API que se quiere usar. El formato de las credenciales que se usan en esta es el siguiente:
Usuario: 11000000EMPRESA Pass: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Puede que se acepte algún otro formato, pero no ha sido posible verificarlo.
DISCLAIMER: This app is independently developed and is not affiliated with, endorsed by, verified by, certified by, or approved by DHL. DHL is a trademark of DHL International GmbH and is referenced only to describe compatibility with DHL services.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 19.0Conecta Odoo a la API de envíos de DHL Parcel para que puedas enviar paquetes, imprimir etiquetas, rastrear entregas, retener o liberar envíos y cerrar el día, todo desde el método de entrega y la pantalla de transferencia.
Este módulo añade DHL Parcel como opción de transportista de entrega en Odoo. En el formulario del método de entrega aparece una pestaña "DHL Parcel Configuration" donde se introducen el usuario, la contraseña, el código de cliente, los incoterms, el tipo de producto (B2B o B2C), el formato de etiqueta (PDF, ZPL o EPL) y servicios opcionales como contra reembolso, entrega antes de las 13:30 y envío asegurado.
Cuando se valida un traslado, Odoo envía el envío a DHL Parcel, almacena la referencia de seguimiento y publica la etiqueta y los detalles del envío en el chatter del traslado. Desde el traslado se puede imprimir la etiqueta de DHL Parcel, retener un envío para que no se procese o volver a liberarlo; el traslado muestra si el envío está actualmente retenido.
Las actualizaciones de seguimiento obtienen los últimos eventos de DHL Parcel y rellenan el historial de seguimiento y el estado de entrega del traslado. Los envíos también se pueden cancelar.
Un botón "End day" en el método de entrega abre un pequeño asistente donde se cierra el día para una, varias o todas las cuentas de cliente y se guarda el informe PDF resultante en el transportista.
Reglas de negocio: los transportistas con contra reembolso se ocultan en el pago del sitio web, el importe declarado de contra reembolso procede del total del pedido de venta vinculado, el valor asegurado se calcula a partir de las líneas del pedido de venta del traslado y el peso del envío se redondea y nunca es inferior a 1 kg. DHL Parcel no calcula las tarifas de entrega, por lo que se debe utilizar otro método de cálculo de precios.
Depende de
Modelos y campos (4)
- sale.order · amplía un modelo existente
- stock.picking · amplía un modelo existentedhl_parcel_shipment_held (DHL Parcel shipment on hold)
- delivery.carrier · amplía un modelo existentedelivery_type, dhl_parcel_uid (DHL Parcel UID), dhl_parcel_product (DHL Product), dhl_parcel_incoterm (DHL Parcel incoterms), dhl_parcel_password (DHL Parcel Password), dhl_parcel_pre_1330 (Pre 13:30), dhl_parcel_insurance (Insured shipment), dhl_parcel_label_format (Label format), dhl_parcel_customer_code (DHL Parcel customer code), dhl_parcel_cash_on_delivery (Cash on delivery DHL), dhl_parcel_insurance_expenses (Insurance expenses), dhl_parcel_last_end_day_report (DHL Parcel last manual end day report), dhl_parcel_last_end_day_report_name (Filename)
- dhl.parcel.endday.wizard · modelo nuevocarrier_id (DHL Parcel Service), customer_accounts (Customer codes to end day for), all_customer_accounts (All customer accounts)
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 6 confirmadas, 3 sin información de 9 versiones.
Fuentes · Odoo 18.0
Confirmado el 2026-11-03 en la rama 18.0 de OCA/l10n-spain.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Instalación
Fuente · Odoo 19.0Depende de los módulos de OCA/delivery-carrier delivery_package_number y delivery_state.
La API de DHL Parcel no provee métodos de cálculo de precio, de modo que para poder calcular los costes de envío sería recomendable instalar el módulo delivery_price_method.
Configuración
Fuente · Odoo 19.0Para configurar el transportista:
- Vaya a Inventario \> Configuración \> Entrega \> Método de envío y cree uno nuevo.
- Escoja DHL Parcel Como proveedor.
- Configure los datos de servicio que tiene contratados y el producto de envío que desea utilizar.
El código de cliente es el UID con un guión y sin letras al final i.e. UID = 08100000AB, tu Código de cliente sería 08-100000
Estas son las distintas operaciones posibles con este módulo:
Grabar servicios
> 1. Al confirmar el albarán, el servicio se grabará en DHL Parcel. > 2. Con la respuesta, se registrará en el chatter la referencia de > envío y las etiquetas correspondientes. > 3. Para gestionar los bultos del envío, se puede utilizar el campo de > número de bultos que añade delivery_package_number (ver el README > para mayor información) o bien el flujo nativo de Odoo con > paquetes de envío. El módulo mandará a la API de DHL Parcel el > número correspondiente y podremos descargar las etiquetas en PDF > con su correspondiente numeración.
Cancelar servicios
> 1. Al igual que en otros métodos de envío, en los albaranes de salida > podemos cancelar un servicio determinado mediante la acción > correspondiente en la pestaña de Información Adicional, sección > Información de entrega una vez el pedido esté confirmado y la > expedición generada. > 2. Podremos generar una nueva expedición una vez cancelado si fuese > necesario.
Obtener etiquetas
> 1. Si por error hubiésemos eliminado el adjunto de las etiquetas que > obtuvimos en la grabación del servicio, podemos obtenerlas de > nuevo pulsando en el botón "Etiqueta DHL Parcel" que tenemos en la > parte superior de la vista formulario del albarán.
Seguimiento de envíos
> 1. El módulo está integrado con delivery_state para poder recabar la > información de seguimiento de nuestros envíos directamente desde > la API de DHL Parcel. > 2. Para ello, vaya al albarán con un envío DHL Parcel ya grabado y en > la pestaña de Información adicional verá el botón Actualizar > seguimiento para pedir a la API que actualice el estado de este > envío en Odoo.
Cierre del día
> 1. Desde un smart button en el formulario del transportista, se puede > cerrar el día manualmente.
Depuración de errores
> 1. Es importante tener en cuenta que solo funcionará con códigos > postales de España (por lo menos para el consignatario). > 2. También puede activar Odoo con --log-level=debug para registrar > las peticiones y las respuestas en el log.
Contrareembolso
> 1. Al crear un envío con un método que tiene marcado el check de > contrareembolso, asumirá que hay un pedido vinculado al albarán y > usará el importe total del pedido como importe del > contrareembolso. Métodos de envío con este check no se encontrarán > disponibles en la web si se está usando.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.