FedEx 集成

将 FedEx 账户与 Odoo 的 库存 应用集成，可实现 计算运费 <../setup_configuration>、生成运单标签 <labels> 等功能。首先启用 FedEx 运输连接器，然后配置至少一个 配送方式。

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

自 2025 年 10 月 21 日起，使用最新 API 的 FedEx 集成暂时不可用，Odoo 正在完成对 FedEx 的解决方案提供商验证。当前使用 FedEx 旧版 提供商的已有集成仍可工作，但新建集成已被 阻止。

在此问题解决期间，请前往 提交支持工单 获取可用的变通方案。 ::::

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

本文档包含 FedEx 集成的特定配置细节。通用的第三方承运商集成说明请参阅 third-party shippers <third_party_shipper> 文档。 ::::

要为 FedEx 启用运输连接器，进入 库存应用 --> 配置 --> 设置。向下滚动至 运输连接器 部分，勾选 FedEx 连接器 旁的复选框。

最后点击 保存 保存更改。保存后，会在 FedEx 连接器 下方出现 oi-arrow-right FedEx 配送方式 按钮。

启用 FedEx 运输连接器后，需要配置至少一种配送方式。配置完成后，可在销售订单（SO）中使用该配送方式计算运费并打印运单标签。

要启用配送方式，进入 库存应用 --> 配置 --> 设置，点击 FedEx 连接器 复选框下方的 FedEx 配送方式 按钮。此操作会打开显示所有已有 FedEx 配送方式的页面。

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

若要查看所有已启用连接器的承运商的配送方式，进入 库存应用 --> 配置 --> 配送方式。 ::::

选择一个配送方式打开其表单，或点击 新建 打开空白表单，配置新配送方式。

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

启用 FedEx 运输连接器后，会自动创建两个默认配送方式：FedEx US 和 FedEx International。这两个方式已预配置测试凭证，可用于测试。

在实际发货前，需要将测试凭证替换为有效 FedEx 账户的凭证。 ::::

配送方式表单顶部的字段用于配置该方式在 Odoo 中的运行方式。在 提供商 字段中，从下拉菜单选择 FedEx（若尚未选择）。

该部分其余字段对所有配送提供商通用。填写细节请参阅 third-party shippers <third_party_shipper> 文档。

FedEx 配置 选项卡中的选项用于将方式连接到 FedEx 账户，并配置与该方式相关的配送细节（投递方式、包装类型等）。

需要拥有 FedEx 开发者账户才能获取填写此选项卡所需的信息。创建新账户，请访问 FedEx 的 Open Account 页面，点击 Create Account 并按照指示操作。

创建完 开发者账户 后，进入 My Projects 选项卡，点击 CREATE API PROJECT。

在弹出的 Tell us about your API needs 窗口中，在 I work for a company that: 下拉框中选择 Ships with FedEX and needs to integrate FedEx APIs into their system。

随后在 Select API(s) for your project 步骤中，务必启用以下 API：

  • Ship, Rate & Other APIs
  • Address Validation API
  • Rates and Transit Times API
  • Ship API
  • Trade Documents Upload API

输入 Project name，并选择包裹的寄出或送达国家。

若要将项目迁移至生产环境，点击 Production key 选项卡，然后关联 Shipping Account。复制 API Key、Secret Key 与 Account 编号，粘贴到 配送方式 表单相应字段中。

要启用 FedEx 运单标签的生成，必须对 API 进行认证。登录 FedEx 开发者门户 后，在侧边栏点击 API Certification，并按照要求完成认证。

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

此认证通常需要通过邮件联系 FedEx 支持团队。 ::::

账户号码 是分配给每个 FedEx 账户的唯一编号。

登录 FedEx 账户 (https://www.fedex.com)，点击右上角的账户持有人姓名，选择 My Profile。

在个人资料页面左侧点击 Account Management，即可看到账户号码。

获取到密码和账户号码后，在 FedEx 配置 选项卡的 Password 与 Account Number 字段中填写。

FedEx 配置 选项卡的主体部分包含多项字段，用于提供配送方式的详细信息：

  • FedEx Service Type：使用的 FedEx 服务类型。
  • FedEx Drop-Off Type：包裹交付至 FedEx 的方式。
  • FedEx Package Type：包装类型。
  • Package Weight Unit：重量单位。
  • Package Length Unit：尺寸单位。
  • Label Type：运单标签类型。
  • Label Format：Odoo 生成标签的文件格式。
  • Commercial Invoice Type：商业发票的纸张尺寸与类型。

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

FedEx 配置 选项卡的选择应依据所绑定 FedEx 账户的协商配送服务。可登录 FedEx 网站的 Account Management 页面或咨询客服确认可用服务。 ::::

FedEx 配置 选项卡的 Options 部分提供以下附加设置：

  • Saturday Delivery：勾选后允许在周六送达。
  • Generate Return Label：勾选后在验证配送单时自动生成退货标签。
  • Duties paid by：使用下拉菜单选择关税由 寄件人 还是 收件人 支付。

默认情况下，Odoo 中的配送方式创建于测试环境，只能用于测试，无法生成真实的配送单。

若要在生产环境激活配送方式，点击配送方式表单顶部的 fa-stop Test Environment 智能按钮。点击后，按钮会变为 fa-play Production Environment。

开启生产环境后，使用该配送方式验证配送单即可生成真实的 FedEx 运单标签。

如需返回测试环境，点击 fa-play Production Environment 智能按钮即可。

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

请勿 在配送方式尚未准备好用于真实发货前启用生产环境，以免产生不必要的 FedEx 费用。 ::::