方向:配送商系统→青云聚信系统
接口:/api/shop/authResultCallback
用途:该接口适用于商家授权。当青云平台门店上的商家授权配送商时,跳转到配送商系统。配送商页面自行定义商家账号的登陆和鉴权方式,并引导商家完成绑定青云门店和配送商门店。配送商系统需记录商家的授权绑定情况。在商家完成配送商侧的授权后,即返回授权结果。青云聚信系统会存储返回的 青云门店id + 配送商门店id 。授权完成,即代表后续青云聚信系统可以在授权范围内,替商家作履约流程的操作对接。如果回调失败,需要配送商进行重试。若配送商侧授权或门店绑定失败,则请配送商在页面上自行提供具体报错和下一步建议,引导商家完成授权。
请注意authStatus字段,0代表授权成功,授权类型为门店授权,门店授权的青云门店,在询价发单时,将使用门店询价、门店发单的接口进行询价发单。1代表授权成功,授权类型为地址授权,地址授权的青云门店,在询价发单时,将使用地址询价、地址发单的接口进行询价发单。
请求参数:
字段 | 描述 | 是否必填 | 类型 | 示例值 | 规则 |
---|---|---|---|---|---|
carrierShopId | 配送商门店id | 是 | string | VP_142352564 | 该青云门店对应商家在配送商系统上的配送商门店,用于后续青云聚信系统指定配送商门店作发单流程。 |
serviceCodes | 门店支持的服务产品编码,配送商于基本信息页面内进行维护 | 否 | list<string> | 发单使用的配送服务编码,发单后会依据此配送服务标准履约,例如:专人直送、四轮配送等。请确保配置的服务产品码值唯一。 | |
shopId | 青云聚信平台门店id | 是 | string | 190000001 | 青云聚信平台的门店id |
authStatus | 授权状态,以及授权的类型:门店授权/地址授权 | 是 | int | 0 |
0 授权成功-门店授权
1 授权失败 2 授权成功-地址授权 |
返回参数:
字段 | 描述 | 是否必填 | 类型 | 示例值 | 规则 |
---|---|---|---|---|---|
code | 结果code | 是 | int | 0 |
1:失败,详情查看message字段
详细枚举见 附录-接口返回结果Code |
message | 失败的描述信息 | 是 | string | 成功 | |
data | 结果 | 否 | / |