顺丰物流使用前需要客户自行申请开发者帐号,并对接口进行测试,完成后才能拿到生产环境接口的访问权限。具体授权过程如下。

第一步:注册顺丰开放平台开发者帐号

https://open.sf-express.com/

第二步:登录顺丰开放平台开发者后台,创建开发者应用并关联API

1、选择进入“开发者对接”后台

2、创建开发者应用

3、创建应用后,请保存系统分配的“顾客编码”、“沙箱校验码”、“生产校验码”等信息,这些信息将作为您使用平台API服务的身份证明。

4、给应用关联API:选择以下4个接口

  • 速运API - 下订单接口
  • 速运API - 订单结果查询接口
  • 速运API - 订单确认/取消接口
  • 基础通用API - 云打印面单转PDF接口

选择好接口后,点击“关联”。完成后如下图所示,应用状态为“API测试中”,点击“查看API”在API列表中对接口进行测试

第三步:对开发者应用关联的API进行测试

1、测试时需要用到创建APP时分配的“顾客编码”与“沙盒校验码”,也可以在应用详情页面可获取:

2、测试“速运API - 下订单接口”

2.1 选择下订单接口进行测试

2.2 在测试工具填写“沙盒校验码”,使用默认的“API请求参数”,点击“提交测试”。

温馨提示:此API请求参数中的orderId不可重复,可在测试前进行修改

2.3 测试成功后,将API测试结果中的 orderId 和 waybillNo 信息保存下来,后面测试其它接口需要用到。

2.4 再按上面步骤测试2次(因为顺丰1个接口需要测试3次),注意每次的orderId不能重复。您可查询此接口测试记录,每个接口要有3交成功的测试记录才算测试完成。

温馨提示:后台测试记录数据刷新可能有一段时间的延迟,如果测试记录没有及时在列表显示,请等待1-5分钟再重试刷新查看。

2.5 接口测试完成后,此API的状态为变为“待上线”。下订单接口还需要上传一张测试面单才能上线(待定,后面再处理)。

3、测试“速运API - 订单结果查询接口”

3.1 选择订单结果查询接口进行测试

3.2 在测试工具填写“校验码”,将"API请求参数"里的orderId值替换为测试下单接口时保存的orderId,点击“提交测试”

3.3 提交后提示“提交成功”即可。

3.4 再按上面步骤测试2次(因为顺丰1个接口需要测试3次),注意每次测试的orderId都要使用下订单接口提交成功返回的orderId。您可查询此接口测试记录,每个接口要有3交成功的测试记录才算测试完成。

温馨提示:后台测试记录数据刷新可能有一段时间的延迟,如果测试记录没有及时在列表显示,请等待1-5分钟再重试刷新查看。

3.5 接口测试完成后,此API的状态为变为“待上线”。

4、测试“速运API - 订单确认/取消接口”

4.1 选择订单确认/取消接口进行测试

4.2 在测试工具填写“校验码”,将"API请求参数"里的dealType值改为2(取消订单),将orderId值替换为测试下单接口时保存的orderId,点击“提交测试”。注意:同样此接口也要测试3次,每次测试的orderId都要使用下订单接口提交成功返回的orderId。

4.3 接口测试完成后,此API的状态为变为“待上线”。

5、测试“速运API - 云打印面单转PDF接口”

5.1 选择云打印面单转PDF接口进行配置

5.2 在配置界面,根据您的需要选择模板,也可勾选全部面单模板,再将面单接收方式设置为”同步“,点击”保存“提交设置

5.3 选择云打印面单转PDF接口进行测试

5.4 在测试工具填写“校验码”,将"API请求参数"里的masterWaybillNo值改为测试下单接口时保存的waybillNo,将templateCode值改为后台获取的模板代码,点击“提交测试”。注意:同样此接口也要测试3次。

温馨提示:如果没有保存下单接口时保存的waybillNo信息,可在下单接口测试记录中查看

templateCode模板代码由此处获取:

5.5 共完成3次测试后,此API的状态为变为“待上线”。

第四步:上线开发者应用关联的API

1、上传“电子面单”文件

电子面单文件从这里下载:

2、等上传的电子面单文件审核通过后,上线所有API

3、以上步骤都完成后,此帐号就可以在易仓ERP授权使用了。ERP授权配置时需要用创建应时分配的“顾客编码”,“生产校验码”。也可以从此处查看: