接口说明
产生和打印标签,按照请求顺序返回结果。
|
路径
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” |
请求报文
Request
{ "orderIds": [ "AOE8246115L-002", "AOE8246115L-001" ], "masterIds":[], "connoteIds":[], "labelType": 1, "packinglist": false, "merged": true, "labelFormat": "JPG", "dpi": "203" }
响应报文
Response
{ "status":"Success", "errors":null, "data":[ { "status":"Success", "errors":null, "labelContent":"Base64 String", "orderId":"JDQ002445001000931503", "trackingNo":"JDQ002445001000931503", "labelContents":null, "lastMileCarrier": null, "masterRefno":"", "connoteId":"" }, { "status":"Success", "errors":null, "labelContent":"Base64 String", "orderId":"JDQ002446001000931506", "trackingNo":"JDQ002446001000931506", "labelContents":null, "lastMileCarrier": null, "masterRefno":"", "connoteId":"" } ] }
评论
宁镭 发表:
"M":必填字段,用户必须提供相关信息才能继续进行操作或提交表单。Mandatory (required field)
"O":非必填字段,用户可以选择性地填写相关信息,但不是必需的。Optional (non-required field)
"C":选择性填写字段,也就是可选填的字段。Conditional (selective field)