2.4 打印标签

本章节将会说明如何使用我们的 API 来打印货物标签。 API 回传的标签内容是编码后的 base64 字符串，使用者需要讲该字符串解码成 byte[] 并储存为 *.pdf 档案使用。用户可以将多个 Hawb 号码传入 API，以获取多个标签。

参数

打印标签配置

序号	参数	资料形态	必填项	说明
1	LabelSize	Enum	是	选择标签尺寸大小
2	LabelFormat	Enum	是	选择标签档案格式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// Values of LabelSize
// 若你使用 SOAP，可使用枚举
// 若你使用 JSON，使用数字即可
// 若你不确定该使用什么，那就选 Inch_6x4
public enum LabelSize {
  Cm_10x10 = 0,
  Inch_6x4 = 1, // 此 API 目前只支持使用 6x4 英寸大小标签
  A4 = 2
}

// Values of LabelFormat
// 若你使用 SOAP，可使用枚举
// 若你使用 JSON，使用数字即可
// 若你不确定该使用什么，那就选 Pdf
public enum LabelFormat {
  Pdf = 0, // 此 API 目前只支持 PDF 格式标签
  Zpl = 1
}

备注：

此 API 目前只支持使用 6x4 英寸大小标签
此 API 目前只支持 PDF 格式标签

范例：

1
2
3
ShipmentsConfiguration _config = new ShipmentsConfiguration();
_config.LabelFormat = LabelFormat.Pdf;
_config.LabelSize = LabelSize.Inch_6x4;

标签参数

序号	参数	资料形态	长度	必填项	说明
1	ShipmentsCredentials	ShipmentsCredentials		是	参考1.2章节
2	ShipmentsConfiguration	ShipmentsConfiguration		是	参考打印标签配置
3	TrackReport	Enum		是	API 提供的报告类型
4	LabelType	Enum		是	选择标签类型
5	HawbNo	String[]	50	是	货物 Hawb 号码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
// Values of LabelSize
// 若你使用 SOAP，可使用枚举
// 若你使用 JSON，使用数字即可
// 若你不确定该使用什么，那就选 Label
public enum TrackReport {
  Label = 0,
  CheckList = 1,
  CommercialInvoice = 2,
  ShipmentsSummary = 3,
  ShipmentsSummary_CSV = 4,
  ShipmentsSummary_Excel = 5,
  AUPostManifest = 6
}

// Values of LabelFormat
// 若你使用 SOAP，可使用枚举
// 若你使用 JSON，使用数字即可
// 若你不确定该使用什么，那就选 LWELabel
public enum LabelType {
  BothLabel = 0,
  LWELabel = 1,
  CarrierLabel = 2
}

范例：

1
2
3
4
5
6
7
8
9
LabelParameter _par = new LabelParameter();
_par.ShipmentsCredentials = _credentials;
_par.ShipmentsConfiguration = _config;
_par.TrackReport = TrackReport.Label;
_par.LabelType = LabelType.BothLabel;

_par.HawbNo = new string[2]
_par.HawbNo[0] = "344010500000151";
_par.HawbNo[1] = "344010500000125";