来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 [MY] Important Update for Shipping Carrier AWB (Self Collection Point)
Dear Developers,
The updates below are applicable to selected Shopee MY local sellers only.
Airway Bill (AWB) Template Update for Self Collection Point (SPX Express)
With regards to the recent announcement dated 25 June 2025, there are further changes on the Airway Bill (AWB) template for “Self Collection Point (SPX Express)” (Channel ID: 20097), effective 9 July 2025.
When calling the v2.order.get_order_detail, there are some changes on Airway Bill (AWB) layout if the response body field “logistics_channel_id” returns “20097”.
Sample of Response body:
v2.order.get_order_detail
{
"error": "",
"message": "",
"request_id": "e3e3e7f32de904197c6a4266f2380c00:01000222cbeb736f:000000708c5da67b",
"response": {
"order_list": [
{
"advance_package": false,
"booking_sn": "",
"cod": false,
"create_time": 1738718691,
"currency": "MYR",
"days_to_ship": 1,
"message_to_seller": "",
"order_sn": "250205C5636ARH",
"order_status": "COMPLETED",
"package_list": [
{
"allow_self_design_awb": true,
"group_shipment_id": null,
"item_list": [
{
"item_id": 28551229946,
"model_id": 0,
"model_quantity": 1,
"order_item_id": 28551229946,
"product_location_id": "MYZ",
"promotion_group_id": 0
}
],
"logistics_channel_id": 20097,
"logistics_status": "LOGISTICS_DELIVERY_DONE",
"package_number": "OFG192417891284379",
"parcel_chargeable_weight_gram": 1000,
"shipping_carrier": "Self Collection Point (SPX Express)"
}
],
"region": "MY",
"reverse_shipping_fee": 0,
"ship_by_date": 1738805098,
"update_time": 1739032107
}
]
}
For “Self Collection Point (SPX Express)” (Channel ID: 20097), self-design AWB is not allowed, developers will need to follow the call flow to get the correct Airway Bill (AWB) labels. For more info can refer to the “Arrange Shipment” section from V2.0 API call Flow.
If you insist on using a self-designed AWB, it may lack of essential information required for 3PL fulfillment or contain incorrect details, resulting in your parcel being undeliverable to the buyer.
Below is a sample of the new Airway Bill (AWB) layout generated by the system for “Self Collection Point (SPX Express)” (Channel ID: 20097) order:
Changes Involved in Self Collection Point (SPX Express) 20097 Airway Bill Template:
-
To remove the SPX Express Website section
-
To reduce the height of Sender Details (Pengirim) section
-
To enlarge the font size of “Recipient Name” field under the Recipient Details (Penerima) section
-
To add additional section on the bottom left of the AWB template to display the “Recipient Name”
Related API:
v2.order.get_order_detail
v2.logistics.get_shipping_document_parameter
v2.logistics.create_shipping_document
v2.logistics.get_shipping_document_result
v2.logistics.download_shipping_document
Effective Date:
9 July 2025
尊敬的开发者，
以下更新仅适用于特定的 Shopee 马来西亚本土卖家。
关于 Self Collection Point (SPX Express) 的 AWB 模板更新
关于2025年6月25日发布的公告，Self Collection Point (SPX Express) (渠道ID：20097) 的面单模板将于2025年7月9日进行进一步调整。
在调用 v2.order.get_order_detail 时，如果响应体字段 “logistics_channel_id” 返回 “20097”，则面单AWB会有一些变化。
响应体示例：
v2.order.get_order_detail
{
"error": "",
"message": "",
"request_id": "e3e3e7f32de904197c6a4266f2380c00:01000222cbeb736f:000000708c5da67b",
"response": {
"order_list": [
{
"advance_package": false,
"booking_sn": "",
"cod": false,
"create_time": 1738718691,
"currency": "MYR",
"days_to_ship": 1,
"message_to_seller": "",
"order_sn": "250205C5636ARH",
"order_status": "COMPLETED",
"package_list": [
{
"allow_self_design_awb": true,
"group_shipment_id": null,
"item_list": [
{
"item_id": 28551229946,
"model_id": 0,
"model_quantity": 1,
"order_item_id": 28551229946,
"product_location_id": "MYZ",
"promotion_group_id": 0
}
],
"logistics_channel_id": 20097,
"logistics_status": "LOGISTICS_DELIVERY_DONE",
"package_number": "OFG192417891284379",
"parcel_chargeable_weight_gram": 1000,
"shipping_carrier": "Self Collection Point (SPX Express)"
}
],
"region": "MY",
"reverse_shipping_fee": 0,
"ship_by_date": 1738805098,
"update_time": 1739032107
}
]
}
Self Collection Point (SPX Express) (渠道ID：20097) 的订单不允许自画面单。开发者需要按照调用流程获取正确的面单 (AWB) 标签。有关更多信息，请参阅 V2.0 API Call Flow 中的 “Arrange Shipment” 部分。
如果您坚持使用自画面单 (AWB)，可能会缺少3PL (第三方物流) 履约所需的必要信息，或包含错误的细节，从而导致您的包裹无法送达买家。
下面是 “Self Collection Point (SPX Express)” (渠道 ID：20097) 订单生成的新面单 (AWB) 示例:
Self Collection Point (SPX Express) (渠道ID：20097) 的模板变更：
-
删除 SPX Express Website 的部分
-
缩小 “Sender Details (Pengirim)” 部分的高度
-
在 Recipient Details (Penerima) 的部分放大 “Recipient Name” 字段的字体大小
-
在模板的左下角添加 “Recipient Name” 的字段
影响API：
v2.order.get_order_detail
v2.logistics.get_shipping_document_parameter
v2.logistics.create_shipping_document
v2.logistics.get_shipping_document_result
v2.logistics.download_shipping_document
生效日期：
2025年7月9日