页面树结构

版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

...

1Field (API)Data TypeLengthMandatoryDetails
2orderIdsString80O

我们支持用户使用Tracking Number / Ref No.查询

3masterIdsString80C我们支持用户使用Master Ref No. 查询
4labelTypeString80O

labelType:

0表示默认值10cm * 15cm,

1表示10cm * 15cm,

2表示A4,

4表示10cm * 10cm,目前API只支持这三种格式;

5packinglistBooleantrue/falseO是否打印拣货清单
6mergedBooleantrue/falseO

指定是否需要合并为一个PDF文件,默认拆分;

若选择合并,则只会合并打印出成功的订单,并且按照请求参数中订单的顺序进行合并。

7labelFormatString3O

标签格式,可选JPG格式,不填默认为PDF格式。JPG格式面单不支持合并,当同时选择打印packinglist时,会返回多个文件。

可选ZPL格式。选择ZPL时,字段值为“ZPL”。

8dpiString3O当标签格式为ZPL时,支持填写此字段,“300”和“203”是支持的。如不填写,默认为“300”



响应字段

Field

Data Type

Mandatory

Details

status


String

M

Failure(失败)

Success(成功)

Partial Success(部分成功)

errors


Array

O

报错信息

data


Array

M

具体的数据列表


statusStringM

Success/Failure


errors
O报错信息

warningsStringO警告消息

labelContentStringM面单Base64内容

orderIdStringM同请求报文中的orderIds值,为Tracking Number / Ref No.

trackingNoStringM

尾程单号


lastMileCarrierStringO订单所属服务的尾程供应商

labelUrlStringM面单URL

labelContentsStringO/
warnings
StringO警告消息

请求报文

代码块
languagejs
borderStylesolid
firstline1
titleRequest
linenumberstrue
{
  "orderIds": [
    "420950359361211015300000143152"
  ],
  "masterIds": null,
  "labelType": 1,
  "packinglist": false,
  "merged": false,
  "labelFormat": null,
  "dpi": null
}

...

代码块
languagejava
firstline1
titleResponse
linenumberstrue
{
    "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
}