getPackagesLabel(获取包裹面单)

接口说明

    用于获取指定包裹的面单,单次最大查询包裹数量为100个 。

    注意:由于我司系统包裹面单的数量庞大,我司会不定期清理包裹面单文件

    建议在本地保存我司返回的面单文件,给您造成不便,敬请谅解!

1.请求参数

参数级别/参数名称 类型/关系 是否必须提交 参数含义及数值要求
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

2.请求示例 复制代码

					
{
    "data": {
        "syOrderNoList": [
            "SY10000050059",
            "SY10000050067"
        ],
        "packMethod": "0", 
        "dataFormat": "1"
    }
}
					
				



3.返回参数

参数级别/参数名称 类型/关系 是否必定返回 参数含义及数值要求
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时必定返回

4.返回示例 复制代码

					
成功:
{
    "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": "订单不存在或者已经被删除"
            }
        ]
    }
}