Integración con DHL

DHL es uno de los transportistas que cuenta con un conector de envío en Inventario de Odoo. El proceso para calcular tarifas de envío y generar etiquetas de envío se simplifica bastante al habilitar el conector en los ajustes de la aplicación y configurar al menos un método de envío.

Nota

Aunque hay varios conectores de envío disponibles para distintos transportistas, esta documentación detalla la configuración específica para integrar DHL. Consulte la documentación sobre transportistas externos para obtener instrucciones sobre cómo configurar los ajustes de integración comunes para todos los transportistas.

Activar el conector de envío de DHL

Before creating a DHL shipping method, enable the carrier’s shipping connector. To do so, navigate to Inventory app ‣ Configuration ‣ Settings.

Vaya a la sección Conectores de envío y seleccione la casilla que se encuentra junto a Conector de DHL Express. Recuerde hacer clic en Guardar para implementar los cambios.

Then, click the DHL Shipping Methods link to open a page showing all shipping methods with the Provider set to DHL.

Configurar el método de envío de DHL

Después de activar el conector de envío para DHL, puede configurar métodos de envío para el transportista. Una vez que los haya configurado podrá agregar un método de envío como un artículo en una línea a las órdenes de venta, lo que le permitirá calcular las tasas de envío y generar etiquetas de envío de forma automática.

Vaya a Inventario ‣ Configuración ‣ Ajustes para crear un nuevo método de envío de DHL. En la sección Conectores de envío, haga clic en el enlace Métodos de envío de DHL que se encuentra abajo de la casilla Conector de DHL Express.

Nota

También puede ver los métodos de envío existentes para cada transportista en Inventario ‣ Configuración ‣ Métodos de envío.

Haga clic en Nuevo para abrir un formulario de método de envío vacío. Si ya creó un método de envío, podrá seleccionarlo en esta pantalla.

El formulario para un método de envío DHL.

Información general

Para empezar a configurar el método de envío, escriba su título en el campo Método de envío.

Seleccione la opción DHL en el menú desplegable Proveedor. Después, aparecerá la pestaña nueva Configuración de DHL en la parte inferior del formulario.

El resto de los campos de esta sección son idénticos en los formularios de métodos de envío para cada transportista. Consulte la documentación sobre transportistas externos para obtener instrucciones sobre cómo configurarlos de forma correcta.

Configuración de DHL

La pestaña Configuración de DHL del formulario de método de envío se usa para conectar la cuenta de DHL del usuario con Odoo y configurar los detalles del método de envío.

DHL developer credentials

To integrate DHL with Odoo, developer credentials must be retrieved from DHL’s Developer Portal. These credentials are used to link the user’s DHL account to Odoo’s Inventory app.

Importante

The SiteID and Password are different credentials than the ones used to log in to a DHL account.

With DHL Express Account

If a DHL Express account is available, log into the DHL Developer portal and request a DHL API account number.

Then, in Odoo, on the shipping method form, enter the DHL API Key in the DHL SiteID field, and the API Secret in the DHL Password field.

Without DHL Express Account

If a DHL Express account is not available:

  1. Begin by opening a DHL Express account.

  2. Once the developer portal account has been confirmed, log in to the portal using the username and password. Click the user avatar in the top-right corner of the screen to open the user dashboard.

  3. On the dashboard, open the Apps tab, and create an app. Follow the four steps in the app creation flow (app name, needed apps, app status, confirmation) to complete the setup.

    Setup to create DHL account.
  4. After setting up the DHL Express account, go here to get the DHL API Key and API Secret credentials.

Then, in Odoo, on the shipping method form, enter the DHL API Key in the DHL SiteID field, and the API Secret in the DHL Password field.

Detalles de envío

El resto de los campos de la pestaña Configuración de DHL se usan para configurar el método de envío en sí:

  • Región: La región en la que se usa el método de envío.

  • Producto de DHL: El servicio de envío adquirido de DHL (por ejemplo, Express Worldwide).

  • Tipo de paquete de DHL: El tipo de paquete de DHL que se usa para la entrega (por ejemplo, caja de DHL).

  • Unidad de peso del paquete: La unidad de medida que se usa para mostrar el peso del paquete.

  • Unidad de dimensión del paquete: La unidad de medida que se usa para mostrar el tamaño del paquete.

  • Formato de la etiqueta: El formato del archivo que se usa para generar las etiquetas de envío.

  • Plantilla de la etiqueta: El tamaño del papel que se usa para imprimir las etiquetas de envío.

Importante

Antes de seleccionar las opciones de servicio para un método de envío, asegúrese de que estos estén disponibles para la cuenta de DHL. Los servicios disponibles dependen del contrato que haya negociado con DHL.

Opciones

En la sección Opciones ubicada en la parte inferior de la pestaña Configuración de DHL hay otros ajustes disponibles:

  • Generar etiqueta de devolución: Habilite esta opción para generar una etiqueta de devolución de forma automática luego de validar una orden de entrega.

  • Material imponible: Active esta opción si el método de envío está sujeto a impuestos aduaneros u otros aranceles.

Turn on the DHL Connection

Once the DHL connection is set up, use the smart buttons at the top of the form to publish, turn on production mode or activate debug logging.

  • Unpublished/Published: determines if this shipping method is available on the user’s eCommerce website.

  • Test Environment/Production Environment: determines whether label creation is for testing and cancelled immediately (Test) or generate real shipping label that is charged to DHL account (Production).

  • No Debug/Debug Requests: determines whether API requests and responses are logged in Odoo (turn on developer mode and go to Settings app ‣ Technical ‣ Logging).