Significant OpenAPI updates for logistic

Dear Developers,

Please note the following updates:

1. AWB Pre-print AWB Flag

A new field "preprint" (boolean) has been added to the Response Parameters of v2.logistics.get_channel_list, indicating whether a logistics channel supports printing AWBs before shipment.

- When the value is true, the channel supports pre-printing.

- When the value is false, the channel does not support pre-printing.

For orders using the logistics channel where preprint = true, can follow the process below to print AWBs before shipment:

- You can sequentially call the v2.logistics.get_shipping_document_parameter, v2.logistics.create_shipping_document, v2.logistics.get_shipping_document_result, and v2.logistics.download_shipping_document APIs to print the System AWBs before shipment.

- You can also call v2.logistics.get_shipping_document_data_info before shipment to retrieve the information required for printing the self-designed AWBs.

Affected API

v2.logistics.get_channel_list

Effective Date

2025/09/12

2. [Only for TW 30029 Logistics Channel] Batch TO Label Printing & Self-designed Unpackaged SKU ID Label Update

2.1 A new field "quantity" (int, optional) has been added to the Request Parameters of v2.logistics.download_to_label. This parameter allows sellers to specify the number of TO Labels to be printed, with a range of 1–20. The system will return the specified number of TO Labels in a single file, each with a unique identifier.

2.2 For logistics channel 30029, the specification of the self-designed Unpackaged SKU ID Label has been updated. For details, please refer to the FAQ.

Affected API

v2.logistics.download_to_label

Effective Date

2025/09/12

尊敬的开发者，

请留意以下变更：

1. 新增 AWB 预打印标识字段

在 v2.logistics.get_channel_list 的 Response Parameters 中新增字段：“preprint”（boolean 格式），用于标识物流渠道是否支持在发货前预打印面单

- 当值为 true 时，表示该渠道支持预打印；

- 当值为 false 时，表示该渠道不支持预打印。

对于preprint=true的物流渠道的订单，可以按照以下流程在发货前打印运单：

- 在发货前依次调用v2.logistics.get_shipping_document_parameter、v2.logistics.create_shipping_document、v2.logistics.get_shipping_document_result、v2.logistics.download_shipping_document 接口打印系统面单；

- 在发货前调用 v2.logistics.get_shipping_document_data_info 获取自画面单所需的信息来打印自画面单。

影响API

v2.logistics.get_channel_list

上线时间

2025/09/12

2. [Only for TW 30029 Logistics Channel] 支持批量获取装箱单 & 虾皮商品编码标签规范更新

2.1 在 v2.logistics.download_to_label 的 Request Parameters 中新增字段 “quantity”（int 格式，非必填）。

可以通过此字段指定所需的装箱单张数，输入范围为 1 到 20，系统将在同一份文件中返回对应数量、具有独立编码的装箱单。

2.2 对于Channel ID 30029，自画“虾皮商品编码标签”规范有更新，详细信息请参考FAQ。

影响API

v2.logistics.download_to_label

上线时间

2025/09/12