顺丰物流使用前需要客户自行申请开发者帐号,并对接口进行测试,完成后才能拿到生产环境接口的访问权限。具体授权过程如下。
第一步:注册顺丰开放平台开发者帐号
第二步:登录顺丰开放平台开发者后台,创建开发者应用并关联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授权配置时需要用创建应时分配的“顾客编码”,“生产校验码”。也可以从此处查看: