时效表达接口
注意:该接口是下单前查询某个区域预计揽收时效用的,不是下单后查询某单的计划揽收时间基本信息
接口名称 | |
---|---|
请求方式 | Post application/x-www-form-urlencoded |
功能描述 | 商家调用该接口查询预计揽收信息 |
编码 | 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 |
寄件地址 | fromAddress | String | 是 | 寄件地址 | 浙江省杭州市西湖区中节能西溪首座 |
下单时间 | orderTime | String | 是 | 下单时间 | 2023-07-18 20:14:37 |
扩展信息 | feature | Map |
否 | 扩展信息 |
出参
项目 | 名称 | 类型 | 必填 | 描述 | 备注 |
---|---|---|---|---|---|
成功标识 | success | Boolean | 是 | ||
错误码 | errorCode | String | 否 | ||
错误说明 | errorMsg | String | 否 | ||
计划揽收信息 | expectCollectInfo | ExpectCollectInfo | 否 |
计划揽收信息内容
项目 | 名称 | 类型 | 必填 | 描述 | 备注 |
---|---|---|---|---|---|
截单时间 | cutOffTime | String | 是 | 该时间点前下单默认可以当天揽收,该时间点后下单次日揽收 | 17:00 |
示例报文
url:
http://edi-daily.xpm.cainiao.com/ext/gateway/ediStandardExpectCollectTimeQuery/api
请求:
仅供参考,实际测试账号需联系菜鸟速递开发提供
logistic_provider_id: edi_test_json
logistics_interface: {"bizId":"621000153894","fromDetailAddress":"浙江省杭州市西湖区中节能西溪首座"}
data_digest: 4HQeJTYreTvD57k8tU8xCQ==
返回:
{"success":true,"expectCollectInfo":{"cutOffTime":"17:00"}}