在 Odoo 中集成 DHL 运输连接器的完整指南
DHL 集成
DHL 是 Odoo 库存 应用中提供 运输连接器 的运输承运商之一。通过在应用设置中启用该连接器，并配置至少一种 运输方式，运费计算 <../setup_configuration> 与 标签生成 <labels> 的过程将大大简化。
:::: note ::: title 注意 :::
虽然针对不同承运商提供了多种运输连接器，但本文档专门说明了集成 DHL 的配置设置。有关所有承运商通用的集成设置说明，请参阅 第三方承运商 <third_party_shipper> 文档。
::::
启用 DHL 运输连接器
在创建 DHL 运输方式之前，需要先启用该承运商的运输连接器。操作路径为 库存应用 --> 配置 --> 设置。
向下滚动至 运输连接器 部分，勾选 DHL Express 连接器 复选框。最后点击 保存 以应用更改。
随后，点击 fa-arrow-right DHL 运输方式 链接，可打开一个页面，显示所有 供应商 为 DHL 的运输方式。
配置 DHL 运输方式
启用 DHL 运输连接器后，即可为该承运商配置运输方式。配置完成后，运输方式可作为销售订单（SO）的行项目添加，实现运费的自动计算和标签的自动生成。
要创建新的 DHL 运输方式，进入 库存应用 --> 配置 --> 设置。在 运输连接器 部分，点击 DHL 运输方式 链接（位于 DHL Express 连接器 复选框下方）。
:::: note ::: title 注意 :::
也可以通过 库存应用 --> 配置 --> 运输方式 查看每个承运商已有的运输方式。
::::
点击 新建 打开空白的运输方式表单。如果已经创建过运输方式，可在此页面中选择已有记录。
一般信息
在 运输方式 字段输入名称后，使用 供应商 下拉菜单选择 DHL。此时表单底部会出现一个新的 DHL 配置 选项卡。
本节的其他字段在各承运商的运输方式表单中保持一致。有关这些通用字段的配置说明，请参阅 第三方承运商 <third_party_shipper> 文档。
DHL 配置
DHL 配置 选项卡用于将用户的 DHL 账户与 Odoo 关联，并设置运输方式的详细信息。
DHL 开发者凭证
要在 Odoo 中集成 DHL，必须从 DHL 开发者门户获取开发者凭证。这些凭证用于将用户的 DHL 账户链接至 Odoo 库存 应用。
:::: important ::: title 重要 :::
SiteID 与 Password 与登录 DHL 账户使用的凭证不同。 ::::
使用 DHL Express 账户
如果已有 DHL Express 账户，登录 DHL 开发者门户 并 申请 DHL API 账户号。
随后，在 Odoo 的运输方式表单中，将 DHL API Key 填入 DHL SiteID 字段，将 API Secret 填入 DHL Password 字段。
没有 DHL Express 账户
如果没有 DHL Express 账户：
访问 DHL Express 开户页面 开通账户。
开通开发者门户账户后，使用用户名和密码登录门户。点击右上角的用户头像打开用户仪表盘。
在仪表盘的 应用 选项卡中创建一个应用，按照四步流程（应用名称、所需应用、应用状态、确认）完成设置。
完成 DHL Express 账户设置后，前往 此处 获取 DHL API Key 与 API Secret。
随后，在 Odoo 的运输方式表单中，将 DHL API Key 填入 DHL SiteID，将 API Secret 填入 DHL Password。
运输细节
DHL 配置 选项卡其余字段用于配置具体的运输方式：
- 地区：使用该运输方式的地区。
- DHL 产品：从 DHL 购买的运输服务（如 Express Worldwide）。
- DHL 包装类型：配送使用的 DHL 包装（如 DHL Box）。
- 包裹重量单位：显示包裹重量的计量单位。
- 包裹尺寸单位：显示包裹尺寸的计量单位。
- 标签格式：生成运输标签的文件格式。
- 标签模板：打印运输标签时使用的纸张尺寸。
:::: important ::: title 重要 :::
在为运输方式选择服务选项前，请确认该服务已在 DHL 账户中可用。可用服务取决于与 DHL 签订的合同。 ::::
选项
DHL 配置 选项卡底部的 选项 区域提供以下附加设置：
- 生成退货标签：勾选后，在验证交货单后自动生成退货标签。
- 应税物料：若运输方式涉及海关或其他税费，请勾选此项。
启用 DHL 连接
完成 DHL 连接设置后，可使用表单顶部的快捷按钮发布、切换至生产模式或激活调试日志。
- 未发布/已发布：决定该运输方式是否在用户的 电商 网站上可用。
- 测试环境/生产环境：决定标签创建是用于测试并立即取消（测试）还是生成真实标签并计费至 DHL 账户（生产）。
- 无调试/调试请求：决定是否在 Odoo 中记录 API 请求与响应（需开启
开发者模式 <developer-mode>并前往设置应用 --> 技术 --> 日志）。