来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 One AWB Update for Shopee VN, SG, TH Cross-border Order
Dear Developer,
The updates below are applicable to Shopee Vietnam (VN), Singapore (SG), and Thailand (TH) cross-border sellers only.
To further improve parcel processing efficiency and provide a better logistics experience for buyers, Shopee is launching a logistics improvement project with more streamlined and efficient operational process. As part of this improvement, starting from May 12, 2025, cross-border orders on VN, SG, and TH sites will gradually adopt the One AWB (1-AWB) model. This change will affect the size and format of AWB.
§2 1. API Changes
1. API Changes
| Required Change | Technical Details |
| #1 Determine if the shop is in 1-AWB whitelist using OpenAPI | Call the v2.shop.get_shop_info API. Use the new parameter is_one_awb to check if the shop is in 1-AWB whitelist. 1) If the shop is not in 1-AWB whitelist, is_one_awb will return false. You may continue printing AWB in the original format (10cm x 10cm thermal paper). 2) If the shop is in 1-AWB whitelist, is_one_awb will return true. Refer to Change #2 to determine if the order is 1-AWB. Note: If the shop is in 1-AWB whitelist, you must switch to use new AWB size (10cm x 15cm thermal paper), regardless of whether the order is 1-AWB or not. |
| #2 Determine if the order is 1-AWB using OpenAPI | Call the v2.order.get_order_detail API. Use the existing parameter allow_self_design_awb to identify if the order is 1-AWB. 1) If the order is not 1-AWB, allow_self_design_awb will return true, and self-designed AWBs are still allowed. 2) If the order is 1-AWB, allow_self_design_awb will return false. Self-designed AWBs are no longer allowed. Proceed to Change #3 for the next steps. |
| #3 Use different OpenAPI to print standard AWB | 1. If the order is 1-AWB, call v2.logistics.download_shipping_document to download the AWB file and ensure end-to-end logistics compatibility. 2. Do not use v2.logistics.get_shipping_document_data_info to obtain shipping data or self-design the AWB. This will result in an error: "Not allowed to self design AWB." 3. After arranging shipment, wait a few seconds before printing the AWB to allow the system to generate the LMTN properly. Suggested delay time: 3–5 seconds (to ensure complete label information) 4. Failure to comply may result in rejection, pickup failure, or delayed/cancelled delivery. Note: Unless restricted by system or process, it is recommended to fully adopt v2.logistics.download_shipping_document for all orders. |
| #4 Familiarize yourself with the new 1-AWB format | Please refer to the attached samples for AWB examples by site. |
§3 2. AWB Samples
2. AWB Samples
Below are sample AWBs for each site (actual labels may slightly differ from the samples):
Note: When printing the AWB, ensure modules 2–10 are fully included and not obscured by any other information, or it may result in return shipments.
VN Site:
SG Site:
TH Site:
§4 3. Rollout Timeline
3. Rollout Timeline
The change in AWB size and format will be rolled out in phases. To help sellers adapt, you may continue using the original AWB size (10cm x 10cm thermal paper) during a transition period. The rollout and transition timelines vary by site, please refer to the table below.
| Site | Rollout Start Date | Transition End Date |
|---|---|---|
| VN | May 12, 2025 | June 10, 2025 |
| SG | June 2, 2025 | June 23, 2025 |
| TH | July 14, 2025 | July 28, 2025 |
Effective Date: May 12, 2025
尊敬的开发者，
以下更新仅适用于 Shopee 越南、新加坡、泰国站点的跨境卖家。
为了进一步提升包裹处理时效，为买家提供更好的物流服务体验，Shopee启动了一项物流提升项目，以实现更高效和精简的运营流程。作为流程优化的一部分，自2025年5月12日起，越南、新加坡和泰国站点的跨境订单将陆续开启一单到底 (1-AWB) 模式，面单尺寸及样式均会发生变化。
§5 1. 接口改动
1. 接口改动
| 所需变更 | 技术细节 |
|---|---|
| #1 调用 OpenAPI 确定店铺是否在一单到底白名单内 | 调用 v2.shop.get_shop_info 接口，通过新增参数 is_one_awb 识别店铺是否在一单到底白名单内 1) 若店铺 不在 一单到底白名单内，is_one_awb 将会返回 false，您仍可使用原规范尺寸面单 (10cm10cm的热敏纸) 进行打印 2) 若店铺 在 一单到底白名单内，is_one_awb 将会返回 true，请参阅变更 #2 判断订单是否是一单到底 注意：若店铺在一单到底白名单内，无论订单是否是一单到底，您均需改为使用新规范尺寸面单 (10cm15cm的热敏纸) 进行打印 |
| #2 调用 OpenAPI 确定订单是否是一单到底 | 调用 v2.order.get_order_detail 接口，通过已有参数 allow_self_design_awb 识别订单是否是一单到底 1) 若订单 不是 一单到底，allow_self_design_awb 将会返回 true，您可以继续使用自画面单 2) 若订单 是 一单到底，allow_self_design_awb 将会返回 false，系统将不再允许自画面单，后续流程请参阅变更 #3 |
| #3 使用不同的 OpenAPI 打印标准 AWB | 1. 若订单是一单到底，请调用 v2.logistics.download_shipping_document 直接下载 AWB 文件，确保端到端物流可以使用 1-AWB 2. 请 不要 使用 v2.logistics.get_shipping_document_data_info 获取运单数据并自画 AWB，该接口将返回报错：Not allowed to self design AWB 3. 打印 AWB 前，请在安排发货后等待几秒，以便系统能够准确生成LMTN 建议延迟时间：3-5 秒 (确保面单信息获取完整) 4. 未能遵守流程可能导致包裹被拒收、无法取件或交付延误/取消 备注：若无系统或流程上的限制，建议全面采用 v2.logistics.download_shipping_document 处理所有订单 |
| #4 熟悉新的 1-AWB 格式 | 请参阅附件了解各站点面单示例 |
§6 2. 面单示例
2. 面单示例
各站点完整面单示例如下图所示 (实际面单可能会和示例图可能会存在细微出入)
注意：在打印面单时，您需要留意 2-10 模块都必须包含，且不得被其他信息覆盖，否则可能会导致退件
越南站点：
新加坡站点：
泰国站点：
§7 3. 调整时间
3. 调整时间
此次面单尺寸与样式调整将分批次逐步上线，并且为帮助卖家更好地适应面单规范调整，在过渡期内，您仍可使用原规范尺寸面单 (10cm*10cm的热敏纸) 进行发货。相关站点面单调整开始时间与过渡期不同，请参考下方表格。
上线时间：5月12日