批量获取包裹的标签
该接口用于批量获取包裹的标签文件。
由于不同的渠道的标签尺寸、页数都均有可能不一样,为了减少不必要的麻烦, 此接口限定只能对同一发货渠道的包裹进行批量打印!
请求规格说明
请求方式
GET api/parcels/labels?processCodes={processCode1}|{processCode2}|{processCode3}&parcelNumberType={parcelNumberType}
processCode 为我司处理号或客单号,需统一为处理号或客单号,处理号与客单号不可混合传递。
parcelNumberType 该参数可不传,枚举值:ProcessCode或者ReferenceId;当值为ReferenceId代表使用客单号进行查询,否则代表使用我司处理号进行查询。
处理号或客单号之间用竖线(|)隔开。
如果手动拼接url的话,注意需要将拼接好的处理号或客单号做次urlEncode才能作为queryString的值。
注:花括号{}为参数占位符,实际请求中无需传递
返回数据格式说明
- 正常情况下为 pdf 文件,返回的
Content-Type为application/pdf - 若任意一个包裹不存在,将导致整批包裹标签无法打印
- 若任意一个包裹的标签暂时无法打印,也会导致整批包裹标签无法打印
变更记录
2025-11-04
- 请求路径中新增parcelNumberType参数