第三方物流承运商

::: {#inventory/shipping/third_party} 用户可以将第三方物流承运商链接到 Odoo 数据库，以便 验证承运商对特定地址的配送， 自动计算运费 <../setup_configuration>，以及 生成运输标签 <labels>。 :::

在 Odoo 中，物流承运商可以应用于销售订单（SO）、 发票或交付订单。想了解配置物流连接器时常见问题的解决方案，请跳转到 故障排除 <inventory/shipping_receiving/third-party-troubles> 部分。

::: seealso

  • dhl_credentials - sendcloud_shipping - ups_credentials :::

以下是 Odoo 中可用的物流连接器列表：

承运商区域可用性
DHL Express <dhl_credentials>全部
Envia.com <envia_shipping>全部
FedEx <fedex>全部
UPS <ups_credentials>全部
美国邮政服务美国
Sendcloud <sendcloud_shipping>部分欧洲国家（详见下文）
Bpost <bpost>比利时
Easypost北美
Shiprocket印度
Starshipit <starshipit_shipping>澳大利亚和新西兰

:::: important ::: title 重要 :::

除上述列出的服务外，DHL 的其他服务 不受支持。

Sendcloud 目前支持 从 奥地利、比利时、法国、德国、意大利、荷兰、西班牙和英国发货，到 任意欧洲国家。 ::::

为确保在 Odoo 中正确设置第三方物流承运商，请按以下步骤操作：

  1. 安装物流连接器 <inventory/shipping_receiving/shipping-connector>。
  2. 设置配送方式 <inventory/shipping_receiving/configure-delivery-method>。
  3. 激活生产环境 <inventory/shipping_receiving/production-env>。
  4. 配置仓库 <inventory/shipping_receiving/configure-source-address>。
  5. 指定产品重量 <inventory/shipping_receiving/configure-weight>。

要安装物流连接器，进入 库存应用 --> 配置 --> 设置。

在 物流连接器 部分，勾选要安装的第三方物流承运商的复选框。可以一次选择多个第三方物流连接器。随后点击 保存。

:::: note ::: title 备注 :::

配送方式 <../setup_configuration> 也可以在 销售、电子商务 与 网站 应用中使用。安装方法请参考 安装应用和模块 <general/install> 文档。 ::::

{.align-center}

要配置 API 凭证并激活物流承运商，请前往 库存应用 --> 配置 --> 运输方式，并选择所需的配送方式。

:::: note ::: title 备注 :::

列表中通常会出现 两个 来自同一 提供商 的配送方式：一个用于国际运输，一个用于国内运输。

可以为特定用途（如 包装 <../../product_management/configure/packaging>）创建额外的配送方式。 ::::

::: seealso 配置配送方式 <../setup_configuration> :::

:::: note ::: title 备注 :::

确保在需要在 网站 应用中提供时，将配送方式设为已发布。要在网站上发布配送方式，点击所需的配送方式，然后点击 未发布 智能按钮，按钮会切换为 已发布。 ::::

::: {#inventory/shipping_receiving/shipping-methods-details} 运输方式 页面包含关于提供商的详细信息： :::

  • 运输方式（必填字段）：配送方式的名称（例如 [FedEx US]、[FedEx EU] 等）。
  • 网站：为连接到特定网站的 电子商务 页面配置运输方式。可从下拉菜单选择适用的网站，或留空以应用于所有网页。
  • 提供商（必填字段）：选择第三方配送服务，如 FedEx。选择提供商后，集成级别、计费策略 与 保险比例 等字段会出现。
  • 集成级别：选择 获取费率 仅获取 预估运费 <inventory/shipping_receiving/third-party-so>，或选择 获取费率并创建发货 以 生成运输标签 <labels>。
  • 公司：若运输方式仅适用于特定公司，请从下拉菜单选择。留空则适用于所有公司。
  • 交付产品（必填字段）：在 销售订单 或发票中添加的交付费用名称。
  • 计费策略：选择直接从承运商获取 预估费用。若需使用实际运费，请参考 实际运费计费 <invoicing> 文档。
  • 费率加价：在基础运费上额外添加的百分比，用于覆盖处理费、包装材料、汇率等费用。
  • 订单金额超过时免运费：在对应的 金额 字段填写阈值，超过该金额的订单将免运费。
  • 保险比例：若包裹在运输途中丢失或被盗，按运费的百分比为发件人提供赔偿。
FedEx 运输方式页面截图。
运输方式 配置页面示例 – FedEx US。

在 配置 选项卡中，填写 API 凭证字段（如 API 密钥、密码、账号等）。不同的 提供商 会要求不同的必填字段。有关特定承运商凭证的详细配置，请参考以下文档：

::: seealso

  • DHL credentials <dhl_credentials> - Sendcloud credentials <sendcloud_shipping> - UPS credentials <ups_credentials> :::

在配置好配送方式后，点击 测试环境 智能按钮，将其设为 生产环境。

:::: warning ::: title 警告 :::

将配送方式设为 生产 后会生成 真实 的运输标签，用户的承运商账户（如 UPS、FedEx 等）会被实际扣费，在 用户向客户收取运费之前。请务必在上线前确认所有配置均正确。 ::::

{.align-center}

确保仓库的 地址（包括邮编）和 电话 正确无误。操作路径：库存应用 --> 配置 --> 仓库，选择目标仓库。

在仓库配置页面，点击 公司 字段打开仓库联系信息页面。

{.align-center}

确认 地址 与 电话 正确，因为物流连接器需要这些信息才能正常工作。

{.align-center}

为保证承运商集成正常工作，请在 库存应用 --> 产品 --> 产品 中选择目标产品，然后切换到 库存 选项卡，在 物流 部分填写 重量。

{.align-center}

物流承运商可在 销售订单（SO）、发票或交付订单上使用。

在 Odoo 中配置好第三方承运商的 配送方式 <inventory/shipping_receiving/configure-delivery-method> 后，前往 销售应用 --> 订单 --> 报价单，创建或打开报价单。

要为报价单分配第三方物流承运商并获取预估运费，请进入 销售应用 --> 订单 --> 报价单，创建或选择已有报价单，然后在 订单行 选项卡右下角点击 添加运费 按钮。

{.align-center}

在弹出的 添加运输方式 窗口中，从 运输方式 下拉菜单选择目标承运商。费用 字段会根据以下因素自动填充：

  • 总订单重量 字段中的数值（若未填写，则使用订单中所有 产品重量 <inventory/shipping_receiving/configure-weight> 的总和）
  • 仓库的 源地址 <inventory/shipping_receiving/configure-source-address> 与客户地址之间的距离

::: {#inventory/shipping_receiving/third-party-rate} 选择承运商后，点击弹窗中的 获取费率 按钮以获取通过物流连接器预估的费用。随后点击 添加 按钮，将运费添加至 销售订单（SO） 或发票中。 :::

::: seealso 产品交付后向客户收取运费 <invoicing> :::

若用户未安装 销售 应用，仅在 库存 应用中进行发货，可在交付订单中指定物流承运商。步骤：在 库存应用 中的 库存概览 仪表盘，选择 交付订单 操作类型，挑选尚未标记为 完成 或 已取消 的交付订单。

在 附加信息 选项卡中，将 承运商 字段设为目标第三方物流承运商。当配送方式处于 生产模式 <inventory/shipping_receiving/configure-delivery-method> 时，会生成 跟踪参考号。

::: seealso 生成运输标签 <labels> :::

{.align-center}

由于物流连接器的配置有时较为复杂，以下检查项可帮助定位问题：

  1. 确认 Odoo 中的 仓库信息 <inventory/shipping_receiving/configure-source-address>（地址与电话）正确且与承运商网站上保存的记录一致。

  2. 验证 包装类型 <inventory/warehouses_storage/package-type> 与参数是否符合承运商要求。可直接在承运商网站上尝试创建发货以确认。

  3. 若 Odoo 预估费用与承运商实际收费出现差异，首先确认配送方式已设为 生产环境 <inventory/shipping_receiving/production-env>。随后在承运商网站和 Odoo 中分别创建发货，比较两者以及 调试日志 中的费用是否一致。

    ::: example 在调试日志中发现请求显示包裹重量为 6 kg，但 FedEx 返回的重量为 7 kg，则问题在 FedEx 端。 :::

通过开启调试日志可追踪运输数据不一致的问题。操作路径：进入配送方式的配置页面（库存应用 --> 配置 --> 运输方式），选择目标运输方式，点击 无调试 智能按钮以激活 调试请求。

{.align-center}

激活 调试请求 后，每次使用物流连接器获取运费时，记录都会保存在 日志 报表中。要访问该报表，请打开 开发者模式 <developer-mode>，然后进入 设置应用 --> 技术 --> 数据库结构 --> 日志。

:::: note ::: title 备注 :::

每次在 销售订单（SO）、发票上点击 获取费率 <inventory/shipping_receiving/third-party-rate>，以及客户通过 网站 应用添加运输方式时，系统都会生成相应的日志。 ::::

{.align-center}

点击 HTTP 请求 条目可打开详情页面，检查 Odoo 向承运商发送的请求信息是否正确。在 HTTP 响应 中，确认收到的返回信息与预期一致。

{.align-center}