VedronERP · 配送与承运商
FedEx集成
FedEx 提供全球国际快递和快运服务。此集成使用 FedEx Ship API v1(REST)并通过 OAuth2 身份验证,以创建货运、生成 PDF 面单,并为非欧盟目的地生成清关文件。
步骤 1 — 创建 FedEx 开发者账户
- 请前往 developer.fedex.com 并点击 "Sign Up"(如果您已有 FedEx.com 账户,可直接登录)。
- 在门户中创建或加入您公司的 Organization。
- 点击 "My Projects" → "Create a Project"。
- 从 API 目录中选择 "Ship API"(可选 "Track API")。
- 在提示时输入您的 FedEx 账户编号——这会将计费绑定到您的项目。
- 完成项目设置以接收您的测试(沙箱)凭证。
步骤 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 要求完成一个验证流程。其中包括:
- 向 FedEx 提交 Product Information Worksheet 和 Validation Cover Sheet。
- 提供测试期间生成的样品面单以供条码审核。
- FedEx 的 Bar Code Analysis Group 会在 3 个工作日内审核面单。
- 获批后,您的项目将转为生产状态。
- 从 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 货运
- 打开您要发货的订单。
- 点击 "Create Shipment"(创建货运)并选择 FedEx 作为承运商。
- 验证收件人姓名、地址、城市、邮政编码和国家。
- 输入包裹重量(KG)。
- 可选输入尺寸(长、宽、高,单位 cm)。
- 选择 FedEx 服务类型(见下文)。
- 选择取件类型:"Drop off at FedEx location"(送至 FedEx 网点)或 "Scheduled pickup"(预约取件)。
- 对于欧盟以外的货运,请填写报关明细。
- 点击 "Create Shipment"(创建货运)提交请求。
- 下载 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。