| 参数级别/参数名称 | 类型/关系 | 是否必须提交 | 参数含义及数值要求 |
|---|---|---|---|
| packageList/ | 一对多 | Y | |
| packageList/ syOrderNo |
String | N |
顺友流水号 客户订单号 注意:只能出现二者中的一个。 |
| packageList/ customerNo |
String | N | |
| packageList/ predictionWeight |
Double | Y |
包裹总重量(单位:kg) 系统接收后自动四舍五入至3位小数 |
| packageList/ packageLength |
Double | N |
包裹长度(单位:cm) 系统接收后自动四舍五入至2位小数 |
| packageList/ packageWidth |
Double | N |
包裹宽度(单位:cm) 系统接收后自动四舍五入至2位小数 |
| packageList/ packageHeight |
Double | N |
包高高度(单位:cm) 系统接收后自动四舍五入至2位小数 |
{
"data": {
"packageList":[
{
"syOrderNo":"SY10000050059",
"packageLength" : 1.00,
"packageWidth" : 1.00,
"packageHeight" : 1.00,
"predictionWeight": 0.1
},
{
"syOrderNo": "SY10000050067",
"packageLength" : 2.00,
"packageWidth" : 2.00,
"packageHeight" : 2.00,
"predictionWeight": 0.2
}
]
}
}
| 参数级别/参数名称 | 类型/关系 | 是否必定返回 | 参数含义及数值要求 |
|---|---|---|---|
| ack | String | Y | 接口是否访问成功 SUCCESS:成功 FAILURE:失败 该字段仅用于判断服务接口是否正常响应,请勿用于判断包裹时否创建或预报成功。 |
| errorCode | String | Y | 当ack为FAILURE的时候,返回的错误代码 |
| errorMsg | String | Y | 当ack为FAILURE的时候,返回的错误信息 |
| resultList / | 一对多 | N | |
| resultList / orderNo |
String | Y | 传入的单号 |
| resultList / predictionWeight |
Double | N | 传入的重量 |
| resultList / reviseWeight |
Double | N | 修订的重量 |
| resultList / predictionFreight |
Double | N | 预估的费用 |
| resultList / currencyCode |
String | N | 费用的币种 |
| resultList / processStatus |
String | N | 处理状态(success:成功 failure:失败) 存在resultList时必定返回 |
| resultList / errorCode |
String | N | 错误代码 processStatus为failure时必定返回 请参见附录 |
| resultList / errorMsg |
String | N | 错误信息 processStatus为failure时必定返回 |
成功:
{
"ack":"success",
"accessId":"1523212195922387848",
"data":{
"resultList":[
{
"processStatus":"success",
"orderNo":"SY10000050059"
}
]
}
}
失败:
{
"ack": "failure",
"errorMsg": "非法的传入参数",
"errorCode": "S1002"
}