接单校验接口

基本信息

接口名称
请求方式 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
success为true时即为可达

示例报文

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 其他错误