来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 [MY] Important Update for SPX Express (Bulky) & Shopee Express (East Malaysia)
[MY] Important Update for SPX Express (Bulky) & Shopee Express (East Malaysia)
Dear Developers,
The updates below are applicable to selected Shopee MY local sellers only.
§2 1. Support New Logistics Channel (SPX Express (Bulky))
1. Support New Logistics Channel (SPX Express (Bulky))
Please note that starting from 26 Dec 2024, Shopee will rollout a new fulfillment channel called "SPX Express (Bulky)" (Channel ID: 20204) under the masked channel of Bulky & Heavy Delivery (Channel ID: 2100).
Kindly note the changes for the response data in the response body regarding Shipping Carrier Related APIs.
Airway Bill (AWB) Template Update for Shipping Carrier: "Bulky" & "COD" Indicator
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": "76120e3c75f5adc15aa34a753b099921",
"response": {
"order_list": [
{
"advance_package": false,
"booking_sn": "",
"cod": true,
"create_time": 1722218732,
"currency": "MYR",
"days_to_ship": 2,
"message_to_seller": "",
"order_sn": "240729TPVGDQ09",
"order_status": "PROCESSED",
"package_list": [
{
"package_number": "OFG188298045213455",
"group_shipment_id": null,
"logistics_status": "LOGISTICS_REQUEST_CREATED",
"shipping_carrier": "SPX Express (Bulky)",
"item_list": [
{
"item_id": 843992325,
"model_id": 0,
"model_quantity": 1,
"order_item_id": 843992325,
"promotion_group_id": 0,
"product_location_id": "MYZ"
}
],
"parcel_chargeable_weight_gram": 0,
"allow_self_design_awb": true,
"logistics_channel_id": 20204
}
],
"region": "MY",
"reverse_shipping_fee": 0,
"ship_by_date": 1722355199,
"update_time": 1722230735
}
]
}
v2.logistics.get_shipping_document_data_info:
{
"error": "",
"message": "",
"request_id": "6f182860156b2cdd77e15d5b7910ec21:0000002d65ea0557:0000000000000000",
"response": {
"recipient_address_info": null,
"shipping_document_info": {
"cod": true,
"cod_amount": "0",
"create_date_ymd_sl": "2024/07/29",
"deliver_area": "KOLEJ VOKSAIONAL TANAH MERAH-O",
"delivery_hub": "",
"dely_fri_label": "H",
"dely_sat_label": "H",
"dely_sun_label": "H",
"destination_base_code": "",
"ec_order_no": "",
"is_lm_dg_bool": 0,
"last_mile_tracking_number": "",
"last_third_digits_buyer_phone": "",
"logistics_channel_id": 20204,
"manufacturers_name": "",
"manufacturers_website": "",
"mutual_check": 0,
"order_weight": 0,
"parcel_size": "",
"pickup_hub": "",
"preferred_delivery_option": 2,
"recipient_sort_code": {
"first_recipient_sort_code": "KN1-MCH-a-Z1",
"second_recipient_sort_code": "",
"third_recipient_sort_code": "C-15-KVTM.1-O"
},
"return_sort_code": {
"return_first_sort_code": "KV1-OUG-c-Z"
},
"sender_sort_code": {
"first_sender_sort_code": "",
"second_sender_sort_code": "",
"third_sender_sort_code": ""
},
"shipping_carrier": "SPX Express (Bulky)",
"shopee_tracking_number": "MY243563384502Q",
"sod": false,
"spx_receive_station": {
"spx_first_receive_station": ""
},
"spx_sub_district": "",
"tracking_number": "SPXMY049887032147",
"zone": "",
"zone_code": "B-03-SPTH.5"
}
} }
Changes Required & Action by Developers:
-
When calling this API v2.order.get_order_detail or v2.logistics.get_shipping_document_data_info, if the response body field "shipping_carrier" returns the "shipping_carrier" named "SPX Express (Bulky)", the developer should hardcode the wording "Bulky" under Order Details (Courier) at the top right of the AWB.
-
When calling the following API v2.logistics.get_shipping_document_data_info, there are some changes on Airway Bill (AWB) layout of the Response body field “shipping_carrier" returns SPX Express (Bulky) and "cod" returns "true", the developer should hardcode the wording "COD" under Order Details (Courier) at the top right of the AWB.
Sample AWB:
Airway Bill (AWB) Template Update for Shipping Carrier: L/M/H Confidence Indicator
SPX Express (Bulky) has a new feature which allows the system to tag orders as low/mid/high confidence in terms of successful deliveries on weekends. This weekend delivery label is more helpful in determining whether delivery attempts should be made on Friday, Saturday or Sunday, subjected to the recipient state.
When calling the following API v2.logistics.get_shipping_document_data_info, there are some changes on Airway Bill (AWB) layout of the Response body field “shipping_carrier" returns SPX Express (Bulky).
Changes Required:
To add the "dely_fri_label", "dely_sat_label" or "dely_sun_label" parameters depending on the recipient state. For each of the weekend delivery labels, the value of L, M, H represent the chances of successful delivery attempts on weekends. Requirement details as below:
- recipient_address.state = Kelantan, Terengganu, Kedah or Johor:
- To add "dely_fri_label" and "dely_sat_label" parameters
- Separate the 2 parameters with “-” sign
- recipient_address.state ≠Kelantan, Terengganu, Kedah or Johor.
- To add "dely_sat_label" and "dely_sun_label" parameters
- Separate the 2 parameters with “-” sign
Scenario:
When calling the following API v2.logistics.get_shipping_document_data_info, there are additional parameters to be included on Airway Bill (AWB) if the Response body field “shipping_carrier" returns SPX Express (Bulky)
Please request with $.recipient_address_info.key(state) uses the $.response.recipient_address_info.key in the response body to determine the additional parameters to be used:
Sample of Response body:
{
"error": "",
"message": "",
"request_id": "a846509833be819fd7e8dbf3ad48dd21:00000003749e471e:0000000000000000",
"response": {
"recipient_address_info": null,
"shipping_document_info": {
"cod": false,
"cod_amount": "0",
"create_date_ymd_sl": "2024/07/29",
"deliver_area": "KOLEJ VOKSAIONAL TANAH MERAH-O",
"delivery_hub": "",
"dely_fri_label": "H",
"dely_sat_label": "H",
"dely_sun_label": "H",
"destination_base_code": "",
"ec_order_no": "",
"is_lm_dg_bool": 0,
"last_mile_tracking_number": "",
"last_third_digits_buyer_phone": "",
"logistics_channel_id": 20204,
"manufacturers_name": "",
"manufacturers_website": "",
"mutual_check": 0,
"order_weight": 0,
"parcel_size": "",
"pickup_hub": "",
"preferred_delivery_option": 2,
"recipient_sort_code": {
"first_recipient_sort_code": "KN1-MCH-a-Z1",
"second_recipient_sort_code": "",
"third_recipient_sort_code": "C-15-KVTM.1-O"
},
"return_sort_code": {
"return_first_sort_code": "KV1-OUG-c-Z"
},
"sender_sort_code": {
"first_sender_sort_code": "",
"second_sender_sort_code": "",
"third_sender_sort_code": ""
},
"shipping_carrier": "SPX Express (Bulky)",
"shopee_tracking_number": "MY243563384502Q",
"sod": false,
"spx_receive_station": {
"spx_first_receive_station": ""
},
"spx_sub_district": "",
"tracking_number": "SPXMY049887032147",
"zone": "",
"zone_code": "B-03-SPTH.5"
}
Related APIs
v2.order.get_order_detail
v2.logistics.get_shipping_document_data_info
Effective Date:
26 Dec 2024
§3 2. Airway Bill (AWB) Template Update for SPX (East Malaysia)
2. Airway Bill (AWB) Template Update for SPX (East Malaysia)
Please note that starting from 20 Dec 2024, SPX (East Malaysia) (Channel ID: 20033) will have some changes on the Airway Bill (AWB) template.
Important Note:
Do note that this shipping carrier "SPX Express (East Malaysia)" (Channel ID: 20033) is a fulfillment channel under the masked channel "Doorstep Delivery" (Channel ID: 2000).
| logistics_channel_id | mask_channel_id | shipping_carrier |
|---|---|---|
| 20033 | 2000 | SPX (East Malaysia) |
When the API v2.order.get_order_detail returns SPX Express (East Malaysia) under the parameter shipping_carrier, 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 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.shipping_carrier returns SPX Express (East Malaysia):
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:
20 Dec 2024
尊敬的开发者，
以下更新仅适用于特定的Shopee马来西亚本土卖家。
§4 1. 支持新的物流渠道 (SPX Express (Bulky))
1. 支持新的物流渠道 (SPX Express (Bulky))
自2024年12月26日起，Shopee将推出 “SPX Express (Bulky)” 渠道 (Channel ID：20204)，该渠道位于 “Bulky Delivery” 虚拟渠道 (Channel ID：2100 ) 下。
请注意下述关于新履约物流渠道 (Channel ID: 20024) 相关API的响应数据变更。
AWB 模板更新：添加 “Bulky” 和 “COD” 标识
当开发者调用 v2.order.get_order_detail 和 v2.logistics.get_shipping_document_data_info 时，响应体将如下所示：
响应体示例：
v2.order.get_order_detail：
{
"error": "",
"message": "",
"request_id": "76120e3c75f5adc15aa34a753b099921",
"response": {
"order_list": [
{
"advance_package": false,
"booking_sn": "",
"cod": true,
"create_time": 1722218732,
"currency": "MYR",
"days_to_ship": 2,
"message_to_seller": "",
"order_sn": "240729TPVGDQ09",
"order_status": "PROCESSED",
"package_list": [
{
"package_number": "OFG188298045213455",
"group_shipment_id": null,
"logistics_status": "LOGISTICS_REQUEST_CREATED",
"shipping_carrier": "SPX Express (Bulky)",
"item_list": [
{
"item_id": 843992325,
"model_id": 0,
"model_quantity": 1,
"order_item_id": 843992325,
"promotion_group_id": 0,
"product_location_id": "MYZ"
}
],
"parcel_chargeable_weight_gram": 0,
"allow_self_design_awb": true,
"logistics_channel_id": 20204
}
],
"region": "MY",
"reverse_shipping_fee": 0,
"ship_by_date": 1722355199,
"update_time": 1722230735
}
]
}
v2.logistics.get_shipping_document_data_info：
{
"error": "",
"message": "",
"request_id": "6f182860156b2cdd77e15d5b7910ec21:0000002d65ea0557:0000000000000000",
"response": {
"recipient_address_info": null,
"shipping_document_info": {
"cod": true,
"cod_amount": "0",
"create_date_ymd_sl": "2024/07/29",
"deliver_area": "KOLEJ VOKSAIONAL TANAH MERAH-O",
"delivery_hub": "",
"dely_fri_label": "H",
"dely_sat_label": "H",
"dely_sun_label": "H",
"destination_base_code": "",
"ec_order_no": "",
"is_lm_dg_bool": 0,
"last_mile_tracking_number": "",
"last_third_digits_buyer_phone": "",
"logistics_channel_id": 20204,
"manufacturers_name": "",
"manufacturers_website": "",
"mutual_check": 0,
"order_weight": 0,
"parcel_size": "",
"pickup_hub": "",
"preferred_delivery_option": 2,
"recipient_sort_code": {
"first_recipient_sort_code": "KN1-MCH-a-Z1",
"second_recipient_sort_code": "",
"third_recipient_sort_code": "C-15-KVTM.1-O"
},
"return_sort_code": {
"return_first_sort_code": "KV1-OUG-c-Z"
},
"sender_sort_code": {
"first_sender_sort_code": "",
"second_sender_sort_code": "",
"third_sender_sort_code": ""
},
"shipping_carrier": "SPX Express (Bulky)",
"shopee_tracking_number": "MY243563384502Q",
"sod": false,
"spx_receive_station": {
"spx_first_receive_station": ""
},
"spx_sub_district": "",
"tracking_number": "SPXMY049887032147",
"zone": "",
"zone_code": "B-03-SPTH.5"
}
} }
开发人员所需采取的操作:
1）调用 “v2.order.get_order_detail” 或 “v2.logistics.get_shipping_document_data_info” 时，如果响应参数 “shipping_carrier” 返回 “SPX Express (Bulky)”，开发人员应在面单 (AWB) 右上角的 Order Details （Courier）下添加 “Bulky”。
2）调用 “v2.logistics.get_shipping_document_data_info” 时，如果响应参数 “shipping_carrier” 返回 “SPX Express (Bulky)” 且 “cod” 返回 “true”，开发人员应在面单 (AWB) 右上角的 Order Details （Courier)下添加 “COD”。
面单示例
AWB 模板更新：添加 L/M/H Confidence 标识
SPX Express (Bulky) 推出了一项新功能，该功能允许系统根据周末成功送达的可能性将订单标记为低/中/高等级。这个周末配送标签有助于根据收件人所在州来确定是否应该在周五、周六或周日进行配送尝试。
调用 v2.logistics.get_shipping_document_data_info 时，如果响应参数 “shipping_carrier” 返回 SPX Express (Bulky)，面单 (AWB) 布局会有一些变化。
所需更改：
需要根据收件人所在州添加 “dely_fri_label”、“dely_sat_label” 或 “dely_sun_label” 参数。对于每个周末配送标签，L、M、H 的值代表周末成功配送尝试的可能性。具体要求如下：
1）如果 recipient_address.state = Kelantan, Terengganu, Kedah 或 Johor：
- 添加 “dely_fri_label” 和 “dely_sat_label” 参数
- 用 “-” 符号分隔这两个参数
2）如果 recipient_address.state ≠ Kelantan, Terengganu, Kedah 或 Johor：
- 添加 “dely_sat_label” 和 “dely_sun_label” 参数
- 用 “-” 符号分隔这两个参数
场景：
调用 v2.logistics.get_shipping_document_data_info 时，如果响应参数 “shipping_carrier” 返回 SPX Express (Bulky)，面单 (AWB) 上需要包含额外的参数。
请使用 $.recipient_address_info.key(state) 请求，并根据响应正文中的 $.response.recipient_address_info.key 来确定需要使用的额外参数。
响应体示例：
{
"error": "",
"message": "",
"request_id": "a846509833be819fd7e8dbf3ad48dd21:00000003749e471e:0000000000000000",
"response": {
"recipient_address_info": null,
"shipping_document_info": {
"cod": false,
"cod_amount": "0",
"create_date_ymd_sl": "2024/07/29",
"deliver_area": "KOLEJ VOKSAIONAL TANAH MERAH-O",
"delivery_hub": "",
"dely_fri_label": "H",
"dely_sat_label": "H",
"dely_sun_label": "H",
"destination_base_code": "",
"ec_order_no": "",
"is_lm_dg_bool": 0,
"last_mile_tracking_number": "",
"last_third_digits_buyer_phone": "",
"logistics_channel_id": 20204,
"manufacturers_name": "",
"manufacturers_website": "",
"mutual_check": 0,
"order_weight": 0,
"parcel_size": "",
"pickup_hub": "",
"preferred_delivery_option": 2,
"recipient_sort_code": {
"first_recipient_sort_code": "KN1-MCH-a-Z1",
"second_recipient_sort_code": "",
"third_recipient_sort_code": "C-15-KVTM.1-O"
},
"return_sort_code": {
"return_first_sort_code": "KV1-OUG-c-Z"
},
"sender_sort_code": {
"first_sender_sort_code": "",
"second_sender_sort_code": "",
"third_sender_sort_code": ""
},
"shipping_carrier": "SPX Express (Bulky)",
"shopee_tracking_number": "MY243563384502Q",
"sod": false,
"spx_receive_station": {
"spx_first_receive_station": ""
},
"spx_sub_district": "",
"tracking_number": "SPXMY049887032147",
"zone": "",
"zone_code": "B-03-SPTH.5"
}
影响接口：
v2.order.get_order_detail
v2.logistics.get_shipping_document_data_info
上线时间：
2024年12月26日
§5 2. 关于 SPX Express (East Malaysia) 渠道的面单模板更新
2. 关于 SPX Express (East Malaysia) 渠道的面单模板更新
请注意，从2024年12月20日开始，SPX Express (East Malaysia) 渠道 (Channel ID：20033) 的面单模板将进行一些更改。
重要提示：
请注意，“SPX Express (East Malaysia)” 渠道 (Channel ID: 20033) 是位于 Doorstep Delivery 渠道 (Channel ID: 2000) 虚拟渠道下的履约渠道。
| logistics_channel_id | mask_channel_id | shipping_carrier |
|---|---|---|
| 20033 | 2000 | SPX (East Malaysia) |
当 v2.order.get_order_detail 的响应参数 shipping_carrier 返回 SPX Express (East Malaysia) 时，不允许自画面单。开发者需要按照调用流程获取正确的面单（AWB）标签。有关更多信息，请参考 V2.0 API Call Flow 中的 “Arrange Shipment” 部分。
如果您坚持使用自画面单（AWB），可能会缺少3PL (第三方物流) 履约所需的必要信息，或包含错误的细节，从而导致您的包裹无法送达买家。
当 v2.order.get_order_detail 的响应参数 shipping_carrier 返回 SPX Express (East Malaysia) 时，系统生成的面单 (AWB) 新格式如下：
影响j接口：
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
上线时间：
2024年12月20日