接单校验接口
基本信息
接口名称 | |
---|---|
请求方式 | Post application/x-www-form-urlencoded |
功能描述 | 商家调用该接口判断是否可达(仅限c揽业务) |
编码 | UTF-8 |
入参
项目 | 名称 | 类型 | 必填 | 描述 | 备注 |
---|---|---|---|---|---|
对接码 | logistic_provider_id | String | 是 | 菜鸟侧提供 | |
签名 | data_digest | String | 是 | Base64(Md5(logistics_interface+双方约定的secretKey)) ,0.2 签名方法 | x-www-form-urlencoded格式可能会出现加号变空格的情况,发请求之前可以对签名进行urlencode |
业务报文 | logistics_interface | String | 是 | JSON |
logistics_interface内容
项目 | 名称 | 类型 | 必填 | 描述 | 示例 |
---|---|---|---|---|---|
业务单号 | bizId | String | 是 | 业务单号 | 621000153894 |
下单时间 | orderTime | String | 是 | 下单时间 | 2023-07-18 20:14:37 |
寄件地址 | fromAddress | String | 是 | 寄件地址 | 浙江省杭州市西湖区中节能西溪首座 |
收件地址 | toAddress | String | 是 | 收件地址 | 浙江省杭州市西湖区中节能西溪首座 |
扩展信息 | feature | Map |
否 | 扩展信息 |
出参
项目 | 名称 | 类型 | 必填 | 描述 | 备注 |
---|---|---|---|---|---|
成功标识 | success | Boolean | 是 | ||
错误码 | errorCode | String | 否 | ||
错误说明 | errorMsg | String | 否 |
示例报文
url:
http://edi-daily.xpm.cainiao.com/ext/gateway/ediStandardOrderAbilityCheck/api
请求:
仅供参考,实际测试账号需联系菜鸟速递开发提供
logistic_provider_id: edi_test_json
logistics_interface: {"bizId":"621000153894","orderTime":"2023-07-18 20:14:37","fromAddress":"浙江省杭州市西湖区中节能西溪首座","toAddress":"浙江省杭州市西湖区中节能西溪首座"}
data_digest: 4HQeJTYreTvD57k8tU8xCQ==
返回:
{"success":true}
附录
常见错误码
错误码 | 原因 |
---|---|
12001 | 未订购服务产品 |
12102 | 保价未订购 |
12103 | 线路未订购 |
12104 | 超出接单范围 |
12105 | 无法上门收件 |
12106 | 无法识别地址 |
12000 | 其他错误 |