Fedex(新版RESTful接口)

(此文档是FEDEXREST的帐号授权指引,适用于fedex最新RESTful API、请使用浏览器的无痕模式浏览)

注意:如果已经有了账号并已经授权新版api托运权限,可直接进行代理对接
测试环境代理对接网址:https://wsbeta.fedex.comhttps://test.fedex.comhttps://apis-sandbox.fedex.com
正式环境代理对接网址:https://www.fedex.com

第一步:进入Fedex官方网站申请fedex帐号(如果已经有fedex帐号可跳过此步骤)

打开网站:https://www.fedex.com/

1、注册FEDEX账号

1.1.点击开设帐号

1.2.按要求填写帐号信息

1.3.注册完成后开通fedex帐号(开通帐号过程中有问题可联系fedex工作人员)
注册成功后将会获得Fedex 9位数物流帐号(Account Number),在物流预报过程中将会用到。

第二步:进入Fedex开发者中心申请开发者帐号

打开网站:https://developer.fedex.com/api/zh-cn/home.html# 用第一步注册的FEDEX账号,登陆开发者中心。

1、创建组织


1.1、点击我的项目

1.2、点击创建组织

1.3、按步骤填写



2 创建托运账号


2.1、添加托运账号

入口一、组织创建成功之后,点击添加账户下 添加托运账号

入口二、管理组织-》货运账号-》添加账户

2.2、填写账号信息

地址来源一、我的档案-》账户管理-》信用卡和帐单信息(或帐单信息)-》地址1

地址来源二、我的档案-》联系信息-》地址1

2.3、勾选相关申请项


货运账号成功后如下图:

3、创建API项目







3.2、创建生产秘钥(密钥只会显示一次,切记需要自行保存到文本中去)



4、创建测试标签(完成以上步骤后提供账号信息给到客服联系技术协助处理,客户也可自行添加测试,提供测试订单号查询报文)

自动生成测试文件工具地址:http://39.108.159.43:8030/#/fedex

4.1、添加代理资料

测试时对接网址:https://apis-sandbox.fedex.com
测试通过后修改对接网址:https://www.fedex.com

4.2、填写fedex帐号(accountNumber)、测试环境开发者授权API KEY(client_id)和SECRET KEY(client_secret)

4.3、添加渠道报价表,绑定上面新建的代理

4.4、配置打单参数设置

4.5、测试创建订单,在订单预录记录新建订单,选择渠道刚刚绑定的承运路线,填写上完整的收发件人信息(需要正确的符合fedex要求的信息),获取转单号并打印地址标签和发票。


4.6、如果需要用到多个fedex服务,则重复4.3-4.5的步骤完成制单测试。


4.7、完成制单测试通过后,提供订单号(每种fedex服务提供一个订单号即可),技术协助拿到请求的报文。

5、发送邮件审核


5.1、填写标签封面表


下载标签封面表:http://doc.logistic.wang:8181/attach_files/d2-2024/376

重要!重要!重要!

1、FedEx 9-Digit Account Number:9位数字的托运帐号;
2、FedEx Production Authentication Key: 生产环境的CLIENT KEY,注意不要填写测试环境的CLIENT KEY;
3、Service Requested:填写自己实际需要申请的服务类型,例如:Ground、Express等;
4、Label Image Type: PDF
5、勾选了哪个标签服务类型,就需要打印该服务标签并扫描;例如,勾选了Ground类型服务标签,则需向对应的客成经理索要对应的标签包,然后自己打印后扫描;

5.2、发送邮件给FEDEX审核


邮件发送地址:label@fedex.com

邮件申请需要的附件清单如下:

1、标签封面表 (步骤5.1中填写)

2、测试标签压缩包:向客户成功经理索要的测试标签压缩包 ,压缩包有三个文件,分别是发货标签(shipment_label.zpl或shipment_label.pdf),发票文件(invoice_label.pdf),请求报文(request_log.txt)

3、标签扫描件:将客户经理提供的压缩包中shipment_label*文件打印并扫描,完成后将标签扫描件一起打包到zip压缩包中。

4、将标签封面表、标签压缩包(zip文件)一起发给label@fedex.com审核。

注意:如果在封面表中勾选了多个标签服务类型,则每个服务类型需要有一个压缩包与扫描件,例如:勾选了,Ground与Express两张服务类型,客户经理需给两个压缩包,一个Ground的标签测试压缩包,一个Express的标签测试压缩包,需将这两种类型中的测试压缩包中测试物流标签都打印并扫

7、多套账号申请


一个物流账号(托运账号:9位数Account Number)只能绑定一个API项目(即申请的TOKEN);故如果客户需申请多个物流账号,则需要重复操作步骤2-6;申请到对应生产TOKEN后再ERP多账号使用;

8、正式账号切换制单


将代理信息中的api对接参数替换为正式环境的信息
注意:上述只是系统整理的步骤,具体步骤可能和实际有区别,对接正式环境的打单必须申请官方认证通过

文档更新时间: 2024-07-10 18:31   作者:dy13750292337