来自 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)
Please note that starting from 3 July 2025, "Self Collection Point (SPX Express)" (Channel ID: 20097) will have some changes on the Airway Bill (AWB) template.
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)" (Channel ID: 20097) Airway Bill Template:
- To reduce the height of Sender Details (Pengirim) section
- To enlarge the font size of “Recipient Name” field
Related APIs:
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:
3 July 2025
尊敬的开发者，
以下更新仅适用于特定的 Shopee 马来西亚本土卖家。
关于 Self Collection Point (SPX Express) 的 AWB 模板更新
请注意，从 2025年7月3日 开始，Self Collection Point (SPX Express) (渠道ID：20097) 的面单模板将进行一些更改。
在调用 v2.order.get_order_detail 时，如果响应体字段 “logistics_channel_id” 返回 “20097”，则面单会有一些变化。
响应体示例：
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) 的模板变更：
- 缩小 “Sender Details (Pengirim)” 部分的高度
- 放大 “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月3日