时效表达接口
注意：该接口是下单前查询某个区域预计揽收时效用的，不是下单后查询某单的计划揽收时间基本信息
| 接口名称 | |
|---|---|
| 请求方式 | 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"}}