新预分拣接口
注意：实际因业务配置不同，预分拣接口返回除了站点简码（siteShortCode）以外其他字段都可能没值，如果没值就不打印该字段，可以正常下单基本信息
| 接口名称 | SORTING_DATA_FETCH |
|---|---|
| 请求方式 | Post application/x-www-form-urlencoded |
| 功能描述 | 商家在下单前调用该接口获取站点信息打印在面单上 |
| 编码 | UTF-8 |
入参
| 项目 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 对接码 | logistic_provider_id | String | 是 | 菜鸟侧提供 |
| 签名 | data_digest | String | 是 | Base64(Md5(logistics_interface+双方约定的secretKey)),0.2 签名方法 |
| 业务报文 | logistics_interface | String | 是 | JSON |
logistics_interface内容
| 项目 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 淘宝卖家id | sellerId | long | 否 | |
| 业务单号 | bizId | String(40) | 是 | 一般情况下给订单号 |
| 发件人信息 | fromContact | ContactDTO | 是 | |
| 收件人信息 | toContact | ContactDTO | 是 | |
| 扩展信息 | feature | Map<String,String> | 否 |
ContactDTO内容
| 项目 | 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 联系人名称 | contactName | String(20) | 否 | |
| 电话 | telephone | String(20) | 否 | |
| 手机 | mobilePhone | String(20) | 否 | |
| 国家 | outCountry | String | 否 | |
| 省 | outProvince | String(20) | 是 | |
| 市 | outCity | String(20) | 是 | 对于实际没有市行政区域的（如海南部分地区）可以不传 |
| 区县 | outDistrict | String(20) | 是 | 对于实际没有区县行政区域的（如东莞部分地区）可以不传 |
| 乡镇 | outTown | String(30) | 否 | |
| 详细地址 | detailAddress | String(256) | 是 |
出参
| 项目 | 名称 | 类型 | 必填 |
|---|---|---|---|
| 成功标识 | success | boolean | 是 |
| 错误码 | errorCode | String | 否 |
| 错误说明 | errorMsg | String | 否 |
| 预分拣信息 | sortingDataResponseDTO | SortingDataResponseDTO | 是 |
示例报文
url:
http://edi-daily.xpm.cainiao.com/ext/gateway/ediNewStandardSorting/ediNewStandardSorting/api
请求： 仅供参考，实际测试账号需联系菜鸟速递开发提供
logistics_interface:
{"sellerId":"111222","bizId":"test190219001","fromContact":{"contactName":"张三","telephone":"025-88888888","mobilePhone":"13000000000","outCountry":"","outProvince":"江苏省","outCity":"南京市","outDistrict":"玄武区","outTown":"","detailAddress":"长江路90号"},"toContact":{"contactName":"李四","telephone":"0571-77777777","mobilePhone":"13111111111","outCountry":"","outProvince":"江苏省","outCity":"南京市","outDistrict":"玄武区","outTown":"","detailAddress":"长江路99号"}}
data_digest: JybFSIoS4FWlAzR9uLJwSg==
logistic_provider_id: edi_test_json
返回：
{"success":true,"sortingDataResponseDTO":{"firstChuteShortCode":"W1","cityShortCode":"A1","cpShortCode":"wx","bizId":"test190219001","siteName":"朱雀站","firstRdcShortCode":"qmltgg003","siteShortCode":"ZQ","omsRdcChuteCodeDTOS":[{"chuteShortCode":"W1","rdcId":2197,"rdcShortCode":"qmltgg003","rdcShortName":"3阡陌联调公共分拨003"},{"rdcId":2248,"rdcShortCode":"qmltcp001","rdcShortName":"阡陌联调CP分拨001"},{"rdcId":2265,"rdcShortName":"阡陌联调CP分拨002"}]}}