浏览指南›

VedronERP · 配送与承运商

FedEx集成

FedEx 提供全球国际快递和快运服务。此集成使用 FedEx Ship API v1(REST)并通过 OAuth2 身份验证,以创建货运、生成 PDF 面单,并为非欧盟目的地生成清关文件。

步骤 1 — 创建 FedEx 开发者账户

  1. 请前往 developer.fedex.com 并点击 "Sign Up"(如果您已有 FedEx.com 账户,可直接登录)。
  2. 在门户中创建或加入您公司的 Organization。
  3. 点击 "My Projects" → "Create a Project"。
  4. 从 API 目录中选择 "Ship API"(可选 "Track API")。
  5. 在提示时输入您的 FedEx 账户编号——这会将计费绑定到您的项目。
  6. 完成项目设置以接收您的测试(沙箱)凭证。

步骤 2 — 获取您的 API 凭证

创建项目后,请前往 Project Overview 页面并打开 "API credentials" 标签页。您将看到:

  • [API Key] — 也称为 Client ID。用于标识您的应用程序。
  • [Secret Key] — 也称为 Client Secret。重要提示:此密钥仅显示一次。请立即复制并保存——如果丢失,必须重新生成。
  • [Account Number] — 您的 9 位 FedEx 计费账户编号。显示在项目概览的单独位置。

Warning: Secret Key 首次生成时仅显示一次。请立即将其保存到安全位置。如果丢失,您需要重新生成它并更新所有使用它的系统。

步骤 3 — 测试环境(沙箱)

FedEx 提供用于测试的沙箱环境。沙箱使用单独的测试凭证(同样显示在您的项目中)以及基础 URL apis-sandbox.fedex.com。请使用沙箱验证您的集成在正式上线前能生成有效的面单。

步骤 4 — 生产认证

在您可以打印正式生产面单之前,FedEx 要求完成一个验证流程。其中包括:

  1. 向 FedEx 提交 Product Information Worksheet 和 Validation Cover Sheet。
  2. 提供测试期间生成的样品面单以供条码审核。
  3. FedEx 的 Bar Code Analysis Group 会在 3 个工作日内审核面单。
  4. 获批后,您的项目将转为生产状态。
  5. 从 Project Overview 页面获取您的生产 API Key 和 Secret Key。

步骤 5 — 在 ERP 中配置凭证

请前往凭证页面,选择 FedEx,并填写以下字段:

  • [API Key] — 来自 FedEx Developer Portal 的生产 API Key(Client ID)。
  • [Secret Key] — 您的生产 Secret Key(Client Secret)。
  • [Account Number] — 您的 9 位 FedEx 计费账户编号。
  • [Sender Name] — 印在面单上作为发件人的名称。
  • [Sender Company] — 您的公司名称。
  • [Sender Street] — 您的发货地址街道。
  • [Sender Postal Code] — 发货邮政编码。
  • [Sender City] — 发货城市。
  • [Sender Country] — 2 位国家代码(例如 DE、NL、PL)。
  • [Sender Phone] — 发件人的联系电话。
  • [Sender Email] — 发件人的联系电子邮箱。

创建 FedEx 货运

  1. 打开您要发货的订单。
  2. 点击 "Create Shipment"(创建货运)并选择 FedEx 作为承运商。
  3. 验证收件人姓名、地址、城市、邮政编码和国家。
  4. 输入包裹重量(KG)。
  5. 可选输入尺寸(长、宽、高,单位 cm)。
  6. 选择 FedEx 服务类型(见下文)。
  7. 选择取件类型:"Drop off at FedEx location"(送至 FedEx 网点)或 "Scheduled pickup"(预约取件)。
  8. 对于欧盟以外的货运,请填写报关明细。
  9. 点击 "Create Shipment"(创建货运)提交请求。
  10. 下载 PDF 面单(4x6 英寸格式)并打印。

可用的 FedEx 服务类型

  • INTERNATIONAL_PRIORITY — 最快的国际服务,定时送达
  • INTERNATIONAL_ECONOMY — 经济型国际服务,定日送达
  • EUROPE_FIRST_INTERNATIONAL_PRIORITY — 优先递送至欧洲目的地,上午 9:00 或 10:00 前送达
  • FEDEX_EXPRESS_SAVER — 欧洲/国际范围内的经济型快递
  • PRIORITY_OVERNIGHT — 下一个工作日上午 10:30 前送达(美国及特定市场)
  • FEDEX_GROUND — 陆运递送(美国、加拿大)
  • FEDEX_2_DAY — 2 个工作日送达(美国及特定市场)

清关文件(非欧盟货运)

对于发往欧盟以外目的地(例如英国、美国、瑞士、挪威)的货运,需要商业发票和报关单。ERP 将提示您填写以下附加信息:

  • 商品描述 — 包裹内物品(例如“电子元件”、“配件”)
  • HS/关税代码 — 商品的 harmonized system 编码(请查询适合您产品类别的正确代码)
  • 制造国家 — 货物的生产地
  • 申报价值 — 以货运货币计的单位价值
  • 件数 — 数量
  • 关税支付方 — 通常为 'SENDER'(由您支付)或 'RECIPIENT'(由客户支付)

Tip: 对于欧盟出口商,向欧盟以外地区出口时,您可能还需要提供 EORI 编号以满足海关合规要求。如有疑问,请联系 FedEx 或您的报关行。

OAuth 令牌与身份验证

ERP 系统会自动处理 OAuth2 身份验证。它使用您的 API Key 和 Secret Key 向 FedEx 请求访问令牌(有效期为 1 小时),并在每次发货请求前自动刷新令牌。无需手动管理令牌。

Warning: 如果您遇到身份验证错误(401 Unauthorized),可能是您的凭证已在 FedEx Developer Portal 上重新生成。请在 ERP 的“凭证”页面中更新 API Key 和 Secret Key。