接口说明
产生和打印标签,按照请求顺序返回结果。
|
路径
HTTP Verb | URL |
---|---|
Post | /services/shipper/labels |
请求字段
1 | Field (API) | Data Type | Length | Mandatory | Details | |
2 | orderIds | String | 80 | O | 我们支持用户使用Tracking Number / Ref No.查询 | |
3 | masterIds | String | 80 | C | 我们支持用户使用Master Ref No. 查询 | |
4 | labelType | String | 80 | O | labelType: 0表示默认值10cm * 15cm, 1表示10cm * 15cm, 2表示A4, 4表示10cm * 10cm,目前API只支持这三种格式; | |
5 | packinglist | Boolean | true/false | O | 是否打印拣货清单 | |
6 | merged | Boolean | true/false | O | 指定是否需要合并为一个PDF文件,默认拆分; 若选择合并,则只会合并打印出成功的订单,并且按照请求参数中订单的顺序进行合并。 | |
7 | labelFormat | String | 3 | O | 标签格式,可选JPG格式,不填默认为PDF格式。JPG格式面单不支持合并,当同时选择打印packinglist时,会返回多个文件。 可选ZPL格式。选择ZPL时,字段值为“ZPL”。 | |
8 | dpi | String | 3 | O | 当标签格式为ZPL时,支持填写此字段,“300”和“203”是支持的。如不填写,默认为“300” |
请求报文
代码块 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{ "orderIds": [ "420950359361211015300000143152" ], "masterIds": null, "labelType": 1, "packinglist": false, "merged": false, "labelFormat": null, "dpi": null } |
响应报文
代码块 | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
{ "status": "Success", "errors": null, "data": [ { "status": "Success", "errors": null, "warnings": null, "labelContent":"Base64 String", "orderId": "420950359361211015300000143152", "trackingNo": "420950359361211015300000143152", "lastMileCarrier": null, "labelUrl": "https://qa.etowertech.com/label/download/EXAk3ggLz6rYQqOU2wRIaA/1", "labelContents": null } ], "warnings": null } |