DHL 整合

DHL 是 Odoo 的 库存 应用程序中提供*运输连接器*的运输承运商之一。通过在应用程序的设置中启用运输连接器，并配置至少一种 运输方法，计算运费 和 生成运输标签 的过程大大简化。

注解

虽然系统为不同物流商提供了多种运输连接器，此说明文档专门详述 DHL 的整合配置设置。如需配置所有物流商通用集成设置的指引，请参阅： 第三方物流商 。

启用 DHL 运输连接器

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

向下滚动至 运输连接器 部分，勾选 DHL 快递连接器 旁的复选框，最后点击 保存 应用更改。

Then, click the :icon:`fa-arrow-right` DHL Shipping Methods link to open a page showing all shipping methods with the Provider set to DHL.

配置 DHL 运输方式

启用 DHL 运输连接器后，即可为该物流商配置运输方式。配置完成后，可将运输方式作为行项添加至销售订单（SO），实现运费自动计算和运单自动生成功能。

要创建新的 DHL 运输方式，请导航至 库存应用 ‣ 配置 ‣ 设置。在 运输连接器 部分，选择 DHL 运输连接器 复选框下方的 DHL 运输方式 链接。

注解

您也可以通过导航至 库存应用 ‣ 配置 ‣ 运输方式 查看所有物流商的现有运输方式。

点击 新建 打开空白运输方式表单。若已有运输方式创建完成，也可在此界面进行选择。

DHL 运输方式配置表单

一般信息

首先在 运输方式 字段中输入名称以开始配置。

在 服务商 下拉菜单中选择 DHL 选项。选择后，表单底部将显示新的 DHL 配置 标签页。

本部分其他字段与各物流商的运输方式表单完全一致。具体配置方法请参阅 第三方物流商 文档。

DHL配置

运输方式表单中的 DHL 配置 标签页用于将用户的 DHL 账户与 Odoo 对接，并配置运输方式详细信息。

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.

重要

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.

运输详情

DHL 配置 标签页的其余字段用于配置运输方式本身：

  • 区域 ：该运输方式的适用地区。

  • DHL 产品：从 DHL 购买的运输服务（如全球特快）。

  • DHL 包裹类型：用于配送的 DHL 包装类型（如DHL箱子）

  • 包裹重量单位 ：显示包裹重量的计量单位。

  • 包裹尺寸单位 ：显示包裹大小的计量单位。

  • 标签格式 ：生成运输标签的文件格式。

  • 标签模板 ：打印运输标签的纸张尺寸。

重要

为运输方式选择服务选项前，请确认该 DHL 账户实际开通了相应服务。可用服务取决于与 DHL 签订的合同条款。

选项

在 DHL 配置 标签页底部的 选项 区域提供以下附加设置：

  • 生成退件标签 ：启用此选项可在确认交货单时自动生成退件标签。

  • 应税物品 ：若该运输方式涉及海关关税或其他税费，请启用此选项。

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).