来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 One AWB Update for Shopee PH and MY Cross-border Order
Dear Developer,
The updates below are applicable to Shopee Philippines (PH) and Malaysia (MY) cross-border sellers only.
- Business Background
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 September 1, 2025, cross-border orders on PH and MY sites will gradually adopt the One AWB (1-AWB) model. This change will affect the size and format of AWB.
This model has already been implemented in VN, SG, and TH sites with stable operations. For more details, please refer to the previous announcement: One AWB Update for Shopee VN, SG, TH Cross-border Order.
- API Changes
The API calling process remains exactly the same as before. Please refer to the table below for details:
| 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 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 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. |
- 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.
PH Site:
For PH site, depending on the logistics channel selected by the buyer, the following four types of AWBs may be generated:
MY Site:
For MY site, depending on the logistics channel selected by the buyer, the following four types of AWBs may be generated:
- 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 |
|---|---|---|
| PH | September 1, 2025 | September 22, 2025 |
| MY | October 13, 2025 | October 27, 2025 |
Effective Date: September 1, 2025
尊敬的开发者，
以下更新仅适用于 Shopee 菲律宾和马来西亚站点的跨境卖家。
- 业务背景
为了进一步提升包裹处理时效，为买家提供更好的物流服务体验，Shopee 启动了一项物流提升项目，以实现更高效和精简的运营流程。作为流程优化的一部分，自2025年9月1日起，菲律宾和马来西亚站点的跨境订单将陆续开启一单到底 (1-AWB) 模式，面单尺寸及样式均会发生变化。
该模式此前已在越南 (VN)、新加坡 (SG)、泰国 (TH) 站点实施并稳定运行，详情可参考此前公告：One AWB Update for Shopee VN, SG, TH Cross-border Order。
- 接口改动
接口调用流程与之前一致，具体请参考下表：
| 所需变更 | 技术细节 |
|---|---|
| #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 格式 | 请参阅附件了解各站点面单示例 |
- 面单示例
各站点完整面单示例如下图所示 (实际面单可能会和示例图可能会存在细微出入)
注意：在打印面单时，您需要留意 2-10 模块都必须包含，且不得被其他信息覆盖，否则可能会导致退件。
菲律宾站点：
菲律宾站点根据买家选择的物流渠道不同，可能会打出以下4种面单：
马来西亚站点：
马来西亚站点根据买家选择的物流渠道不同，可能会打出以下4种面单：
- 调整时间
此次面单尺寸与样式调整将分批次逐步上线，并且为帮助卖家更好地适应面单规范调整，在过渡期内，您仍可使用原规范尺寸面单 (10cm*10cm的热敏纸) 进行发货。相关站点面单调整开始时间与过渡期不同，请参考下方表格。
| 站点 | 调整开始时间 | 过渡期截止时间 |
|---|---|---|
| 菲律宾 | 2025年9月1日 | 2025年9月22日 |
| 马来西亚 | 2025年10月13日 | 2025年10月27日 |
上线时间：9月1日