| 参数级别/参数名称 | 类型/关系 | 是否必须提交 | 参数含义及数值要求 |
|---|---|---|---|
| syOrderNoList | List<String> | N |
顺友流水号 客户订单号 注意:只能出现二者中的一个。 |
| customerNoList | List<String> | N | |
| packMethod | String | N |
标签返回时的打包方式 0:返回包含多个面单的单个PDF文件 1:返回包含多个PDF文件的ZIP包,每个PDF文件中仅包含一个包裹的面单信息,仅有一个包裹时也将被打包为ZIP 默认值:0 |
| dataFormat | String | N |
0:标签返回数据类型为 byte 数组 1:标签返回数据类型为URL路径 默认值:0 |
{
"data": {
"syOrderNoList": [
"SY10000050059",
"SY10000050067"
],
"packMethod": "0",
"dataFormat": "1"
}
}
| 参数级别/参数名称 | 类型/关系 | 是否必定返回 | 参数含义及数值要求 |
|---|---|---|---|
| ack | String | Y | 接口是否访问成功 SUCCESS:成功 FAILURE:失败 该字段仅用于判断服务接口是否正常响应,请勿用于判断包裹时否创建或预报成功。 |
| errorCode | String | Y | 当ack为FAILURE的时候,返回的错误代码 |
| errorMsg | String | Y | 当ack为FAILURE的时候,返回的错误信息 |
| labelData / | byte[] | N | 面单数据(dataFormat为0或者不填时返回) |
| labelPath / | String | N | 面单路径(dataFormat为1时返回) |
| resultList / | 一对多 | N | |
| resultList / orderNo |
String | Y | 传入的单号 |
| resultList / processStatus |
String | Y | 处理状态(success:成功 failure:失败) 存在resultList时必定返回 |
| resultList / errorCode |
String | N | 错误代码 processStatus为failure时必定返回 请参见附录 |
| resultList / errorMsg |
String | N | 错误信息 processStatus为failure时必定返回 |
成功:
{
"ack": "success",
"data": {
"labelData":".........",
"resultList": [
{
"processStatus": "success",
"orderNo": "SY10000050059"
},
{
"processStatus": "success",
"orderNo": "SY10000050067"
}
]
}
}
失败:
{
"ack": "success",
"data": {
"resultList": [
{
"processStatus": "failure",
"orderNo": "SY10000050059",
"errorCode": "S1010",
"errorMsg": "订单不存在或者已经被删除"
},
{
"processStatus": "failure",
"orderNo": "SY10000050067",
"errorCode": "S1010",
"errorMsg": "订单不存在或者已经被删除"
}
]
}
}