来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 [MY] Important Update for Self Collection Point (SPX Express)
Dear Developers,
The updates below are applicable to selected Shopee MY local sellers only.
Introducing New Shipping Carrier
Effective 14 February 2025, Shopee will rollout a new shipping carrier Self Collection Point (SPX Express) (Channel ID: 20097). This channel is only applicable to selected Shopee MY local sellers only.
Note:
-
This new shipping carrier will be replacing another existing shipping carrier with the same channel name, Self Collection Point (SPX Express), but different channel ID, which is 20099.
-
The existing channel with channel ID 20099 will be renamed to Self Collection Point (SPX Express) - for orders before 17 Feb on 14 February 2025, and fully sunset by 20 February 2025.
Please refer to the following timeline:
Kindly note the changes for the response data in the response body regarding Shipping Carrier Related APIs.
Scenario:
When developers call v2.order.get_order_detail, or v2.logistics.get_shipping_document_data_info, the response body will be as follows:
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
}
]
}
v2.logistics.get_shipping_document_data_info:
{ "error": "", "message": "", "request_id": "e3e3e7f32d5b61d2407d3408133dbe00:010002cfb31ad49d:000000222aab7d5a", "response": { "recipient_address_info": null, "shipping_document_info": { "cod": false, "cod_amount": "0", "create_date_ymd_sl": "2025/02/05", "deliver_area": "", "delivery_hub": "", "dely_fri_label": "M", "dely_sat_label": "M", "dely_sun_label": "M", "destination_base_code": "", "ec_order_no": "", "is_lm_dg_bool": 1, "last_mile_tracking_number": "", "last_third_digits_buyer_phone": "", "logistics_channel_id": 20097, "manufacturers_name": "", "manufacturers_website": "", "mutual_check": 0, "order_weight": 1000, "parcel_size": "", "pickup_hub": "", "preferred_delivery_option": 2, "recipient_sort_code": { "first_recipient_sort_code": "SBH-MGL--a", "second_recipient_sort_code": "", "third_recipient_sort_code": "" }, "return_sort_code": { "return_first_sort_code": "" }, "sender_sort_code": { "first_sender_sort_code": "", "second_sender_sort_code": "", "third_sender_sort_code": "" }, "shipping_carrier": "Self Collection Point (SPX Express)", "shopee_tracking_number": "MY259868630369T", "sod": false, "spx_receive_station": { "spx_first_receive_station": "" }, "spx_sub_district": "", "tracking_number": "MY259868630369T", "zone": "", "zone_code": "" } } }
When the API v2.order.get_order_detail returns 20097 under the parameter package_list.logistics_channel_id, 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 when the Response Body v2.order.get_order_detail returns 20097 under the parameter package_list.logistics_channel_id:
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:
14 Feb 2025
尊敬的开发者,
以下更新仅适用于特定的Shopee马来西亚本土卖家。
引入新的物流渠道
从2025年2月14日起,Shopee将引入新的物流渠道:Self Collection Point (SPX Express) (Channel ID: 20097)。该物流渠道只适用特定的Shopee马来西亚本土卖家。
注意:
1)该新的物流渠道将取代另一个同样以Self Collection Point (SPX Express)为渠道名,但拥有不同渠道ID:20099的已有物流渠道。
2)以20099为渠道ID的已有物流渠道将于2025年2月14日更名为Self Collection Point (SPX Express) - for orders before 17 Feb,并于2025年2月20日下线。
请参考以下时间线:
请注意与Shipping Carrier相关的API的响应数据的变更。
场景:
当开发者调用v2.order.get_order_detail或v2.logistics.get_shipping_document_data_info时,响应体将如下所示:
响应体示例:
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
}
]
}
v2.logistics.get_shipping_document_data_info:
{ "error": "", "message": "", "request_id": "e3e3e7f32d5b61d2407d3408133dbe00:010002cfb31ad49d:000000222aab7d5a", "response": { "recipient_address_info": null, "shipping_document_info": { "cod": false, "cod_amount": "0", "create_date_ymd_sl": "2025/02/05", "deliver_area": "", "delivery_hub": "", "dely_fri_label": "M", "dely_sat_label": "M", "dely_sun_label": "M", "destination_base_code": "", "ec_order_no": "", "is_lm_dg_bool": 1, "last_mile_tracking_number": "", "last_third_digits_buyer_phone": "", "logistics_channel_id": 20097, "manufacturers_name": "", "manufacturers_website": "", "mutual_check": 0, "order_weight": 1000, "parcel_size": "", "pickup_hub": "", "preferred_delivery_option": 2, "recipient_sort_code": { "first_recipient_sort_code": "SBH-MGL--a", "second_recipient_sort_code": "", "third_recipient_sort_code": "" }, "return_sort_code": { "return_first_sort_code": "" }, "sender_sort_code": { "first_sender_sort_code": "", "second_sender_sort_code": "", "third_sender_sort_code": "" }, "shipping_carrier": "Self Collection Point (SPX Express)", "shopee_tracking_number": "MY259868630369T", "sod": false, "spx_receive_station": { "spx_first_receive_station": "" }, "spx_sub_district": "", "tracking_number": "MY259868630369T", "zone": "", "zone_code": "" } } }
当v2.order.get_order_detail的响应参数package_list.logistics_channel_id返回20097时,不允许自画面单。开发者需要按照调用流程获取正确的面单 (AWB) 标签。有关更多信息,请参考V2.0 API Call Flow中的“Arrange Shipment”部分。
如果您坚持使用自画面单 (AWB),可能会缺少3PL (第三方物流) 履约所需的必要信息,或包含错误的细节,从而导致您的包裹无法送达买家。
当v2.order.get_order_detail的响应参数package_list.logistics_channel_id返回20097时,系统生成的面单 (AWB) 新格式如下:
影响接口:
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年2月14日
