一、问题场景
进行同城配送发货时,呼叫顺丰的骑手进行配送
二、操作步骤
商户需要先自行与顺丰相关人员沟通,开好顺丰店铺,获取店铺ID并注册顺丰开放平台账号(开放平台网址:https://openic.sf-express.com/#/homepage)
需要先申请两个ID:测试开发者ID、非测试开发者ID,且测试ID通过订单状态测试后,正式账号审核状态会自动通过
参数配置
以下操作均先以操作测试账号
回调地址URL全部填写:https://mercury-node-center.nhsoft.cn/earth-server-delivery/nhsoft.earth.delivery.order.orderStatusCallback/SFTC
配置测试店铺
1、把测试账号的开发者id和密钥复制出来,填写到渠道配置里面顺丰对应的位置,并开启顺丰渠道
2、 配送规则将测试店铺ID填写到门店配送通道中
3、以上配置完毕后在进行配送发单测试(需暂时将门店地址改为北京地区且需把 北京市海淀区学清嘉创大厦A座15层 包含在范围内)
1)发单开发者ID必须为测试环境对应的开发者ID;
2)发单店铺ID必须为:3243279847393;企业发单企业ID必须为:1161885087;个人发单下单手机号必须为:13203559287;
3)收件信息为(收件人姓名:顺丰同城,收件人手机:188******** (当前登录顺丰开放平台的手机号)【收件人手机号不允许更改,如更改为其他号码发单,发单时会自动变更为当前账号手机号】,收件地址:北京市海淀区学清嘉创大厦A座15层)。
按照以上要求在小程序中进行下单, 并在订单管理-销售订单中进行呼叫顺丰骑手测试发货,发货后在配送聚合-订单管理中查找顺丰骑手单号
拿到顺丰单号后到顺丰开放平台“自助联调工具”中进行回调测试,回调测试全部通过结束后再将非测试ID重复1-2的流程配置
三、注意事项
1、聚合配送里面,把开发者id和密钥复制进去。密钥这里直接复制进去的话,前面会带个空格,需要检查一下
2、以上操作步骤对接设置完后,配置检查了都没问题,乐檬系统下单发起配送时如果报错:请求签名sign校验失败。
需要联系顺丰那边的技术进行处理,乐檬系统配置时是按顺丰开放平台显示的密钥进行配置的,但有时因为顺丰那边的问题,顺丰开放平台上显示的密钥是错误的,与顺丰后台实际对接校验的密钥不是同一个,需要让顺丰提供正确的密钥进行配置对接才可以
3、注意下面的品类,要和顺丰那边的设置的一样。这个设置是找顺丰那边的对接人员设置品类
若配送聚合中与顺丰侧品类不同,或顺丰侧未配置将会报错
1、报错:呼叫骑手失败:店铺未配置当前物品类型或车型
2、报错:没有匹配的计价规则或计价规则已失效
4、报错:未找到店铺ID与开发者ID的映射关系