提供给商家在发货之前做截单处理,输入物流商编码和收发货地址进行可达判定,目前支持国内主流的物流服务商, 支持快运和快递两种类型
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|
address_type | Number | 必须 | 1 | 1:快递 2:快运 | |||||||
data | RoutingReachableBatchRequestDto | 必须 | 收发信息 | ||||||||
|
|||||||||||
client_info | ClientInfoDto | 必须 | 调用方对象 | ||||||||
|
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
result | BaseResultDto | {} | 结果 |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 | TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret); CainiaoReachableBatchjudgeRequest req = new CainiaoReachableBatchjudgeRequest(); req.setAddressType(1L); CainiaoReachableBatchjudgeRequest.RoutingReachableBatchRequestDto obj1 = new CainiaoReachableBatchjudgeRequest.RoutingReachableBatchRequestDto(); obj1.setCpCode( "STO" ); List<CainiaoReachableBatchjudgeRequest.ReachableAddressAndServiceDto> list3 = new ArrayList<CainiaoReachableBatchjudgeRequest.ReachableAddressAndServiceDto>(); CainiaoReachableBatchjudgeRequest.ReachableAddressAndServiceDto obj4 = new CainiaoReachableBatchjudgeRequest.ReachableAddressAndServiceDto(); list3.add(obj4); CainiaoReachableBatchjudgeRequest.ReceiveAddress obj6 = new CainiaoReachableBatchjudgeRequest.ReceiveAddress(); obj6.setTownName( "蒋村街道" ); obj6.setAddressDetail( "xxxxx" ); obj6.setCityName( "杭州市" ); obj6.setAreaName( "西湖区" ); obj6.setProvinceName( "浙江省" ); list5.setReceiveAddress(obj6); obj4.setServiceCodeList( "{ \"SVC-COD\": { \"value\": 100.5 } }" ); obj4.setObjectId( "abc" ); CainiaoReachableBatchjudgeRequest.AddressDto obj8 = new CainiaoReachableBatchjudgeRequest.AddressDto(); obj8.setTownName( "蒋村街道" ); obj8.setAddressDetail( "yyyyy" ); obj8.setCityName( "杭州市" ); obj8.setAreaName( "西湖区" ); obj8.setProvinceName( "浙江省" ); list7.setSendAddress(obj8); obj4.setOaid( "abc" ); obj4.setOrderId(123456L); obj4.setCaid( "def" ); obj1.setAddressAndServiceList(list3); obj1.setSendBranchCode( "20111" ); req.setData(obj1); CainiaoReachableBatchjudgeRequest.ClientInfoDto obj9 = new CainiaoReachableBatchjudgeRequest.ClientInfoDto(); obj9.setDescription( "xxx打单助手" ); req.setClientInfo(obj9); CainiaoReachableBatchjudgeResponse rsp = client.execute(req, sessionKey); System.out.println(rsp.getBody()); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 | < cainiao_reachable_batchjudge_response > < result > < one_error_info > < error_message ></ error_message > < error_code ></ error_code > </ one_error_info > < success >true</ success > < module > < result_list > < reachable_service_waybill_response_dto > < error_info > < error_message ></ error_message > < error_code ></ error_code > </ error_info > < success >true</ success > < module > < interrupt_reason >物流服务不支持派送</ interrupt_reason > < interrupt_apply_waybill_code >true</ interrupt_apply_waybill_code > </ module > < object_id >0</ object_id > </ reachable_service_waybill_response_dto > </ result_list > </ module > </ result > </ cainiao_reachable_batchjudge_response > |
1 2 3 4 5 6 | < error_response > < code >50</ code > < msg >Remote service error</ msg > < sub_code >isv.invalid-parameter</ sub_code > < sub_msg >非法参数</ sub_msg > </ error_response > |
错误码 | 错误描述 | 解决方案 |
---|---|---|
cpCode为空 | 入参缺失,缺少cpCode | 请传入cpCode |
objectId为空 | 参数错误,缺失objectId | 请在入参中传入objectId |
isv.invalid-argument | 参数非法 | 请检查参数 |
isp.top-mapping-parse-error | top层面字段映射错误,说明是订单加密入参格式不正确 | 请检查oaid参数 |
请求列表为空 | 参数address_and_service_list为空 | 请检查address_and_service_list |
服务code非法 | service_code_list不合法 | service_code_list需要是json格式 |
收货地址 - 省为空 | 收货地址省为空 | 请检查省字段,必填 |
请求列表长度超限制 | address_and_service_list不超过10个 | address_and_service_list不超过10个 |
收货地址 - 详细地址为空 | address_detail详细地址不能为空 | 请检查address_detail字段,不能为空 |
objectId重复 | objectId不能重复 | 请检查objectId字段,保证不重复 |
被限流,请稍后重试 | 被限流,请控速 | 排查为什么超出流量,如果是正常流量,联系菜鸟做调整。 |