来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 [MY] Important Update for Open Platform AWB API - Next Day Delivery & GDEX
[MY] Important Update for Open Platform AWB API - Next Day Delivery & GDEX
Dear Developers,
The updates below are effective for selected Shopee MY seller only.
A. Introducing New Logistics Channel (Next Day Delivery)
Effective on 18 November 2024, Next Day Delivery (Channel ID: 2002) is a new logistic channel to fulfill next day delivery service to buyers. This channel is only applicable to selected Shopee MY local sellers only.
Kindly note the changes for the response data in the response body regarding Shipping Carrier Related APIs.
Scenario
When developers call v2.logistics.get_channel_list, the response body will be as follows:
Sample of Response body:
{
"logistics_channel_id": 2002,
"logistics_channel_name": "Next Day Delivery",
"cod_enabled": true,
"enabled": true,
"fee_type": "SIZE_INPUT",
"size_list": [],
"weight_limit": {
"item_max_weight": 30,
"item_min_weight": 0
},
"item_max_dimension": {
"height": 125,
"width": 125,
"length": 125,
"unit": "cm",
"dimension_sum": 0
},
"force_enable": false,
"mask_channel_id": 0,
"logistics_description": "********",
"volume_limit": {
"item_max_volume": 130000,
"item_min_volume": 0
},
"logistics_capability": {
"seller_logistics": false,
"direct_delivery": false
},
"seller_logistic_has_configuration": null,
"support_cross_border": false,
"block_seller_cover_shipping_fee": false,
"support_pre_order": false
}
Related APIs:
v2.logistics.get_channel_list
v2.logistics.update_channel
v2.product.add_item
v2.product.update_item
v2.product.get_item_base_info
v2.logistics.get_shipping_parameter
v2.logistics.get_tracking_number
v2.logistics.get_shipping_document_parameter
v2.order.get_order_detail
v2.logistics.get_shipping_document_data_info
Effective Date:
18 November 2024
B. Introducing New Shipping Carrier (SPX Express (NDD))
- Please note that starting from 18 November 2024, "SPX Express (NDD)” (Channel ID: 20066) will be a new shipping carrier parked under Next Day Delivery (Channel ID: 2002) logistic channel.
Affected Logistics Channels
Do note that this is a new fulfillment channel for this new logistics channel.
| logistics_channel_id | mask_channel_id | shipping_carrier |
|---|---|---|
| 20066 | 2002 | SPX Express (NDD) |
Kindly note the changes for the response data in the response body regarding the new Shipping Carrier (channel_id=20066) Related APIs.
Scenario
When developers call v2.logistics.get_shipping_document_data_info and v2.order.get_order_detail, the response body will be as follows:
Sample of response body:
v2.logistics.get_shipping_document_data_info
{
"error": "",
"message": "",
"response": {
"shipping_document_info": {
"cod": false,
"cod_amount": "0",
"create_date_ymd_sl": "2024/10/29",
"deliver_area": "",
"delivery_hub": "",
"dely_fri_label": "",
"dely_sat_label": "",
"dely_sun_label": "",
"destination_base_code": "",
"ec_order_no": "",
"is_lm_dg_bool": 1,
"last_mile_tracking_number": "",
"last_third_digits_buyer_phone": "",
"logistics_channel_id": 20066,
"manufacturers_name": "",
"manufacturers_website": "",
"mutual_check": 0,
"order_weight": 1000,
"parcel_size": "",
"pickup_hub": "",
"preferred_delivery_option": 1,
"recipient_addr": "Midvalley City, Mid Valley City, Bandar Kuala Lumpur, Kuala Lumpur, W.P. Kuala Lumpur, W.P. Kuala Lumpur",
"recipient_sort_code": {
"first_recipient_sort_code": "AM Hub A",
"second_recipient_sort_code": "",
"third_recipient_sort_code": ""
},
"return_sort_code": {
"return_first_sort_code": "AM Hub A"
},
"sender_sort_code": {
"first_sender_sort_code": "",
"second_sender_sort_code": "",
"third_sender_sort_code": ""
},
"shipping_carrier": "SPX Express (NDD)",
"shopee_tracking_number": "MY2474207445406U",
"sod": false,
"spx_receive_station": {
"spx_first_receive_station": ""
},
"spx_sub_district": "",
"tracking_number": "SPXMY04851479837A",
"zone": "",
"zone_code": ""
},
"recipient_address_info": null
},
"request_id": "e3e3e7f32598b3e98e90058006371301:01000284fcd4892f:0000000c37808991"
}
v2.order.get_order_detail
{
"error": "",
"message": "",
"response": {
"order_list": [
{
"advance_package": false,
"booking_sn": "",
"cod": false,
"create_time": 1730186575,
"currency": "MYR",
"days_to_ship": 1,
"message_to_seller": "",
"order_sn": "241029SRX17WB1",
"order_status": "PROCESSED",
"region": "MY",
"reverse_shipping_fee": 0,
"ship_by_date": 1730193930,
"shipping_carrier": "SPX Express (NDD)",
"update_time": 1730187006
}
]
},
"request_id": "e3e3e7f32598ba02ec76359e2a822701:0100020523af1d6d:0000007ce50001d2"
}
Action to take from developers
When calling this API “v2.logistics.get_shipping_document_data_info”,
If the response body field "shipping_carrier" returns as "SPX Express (NDD)", the developer should hardcode the wording "NDD" at the top right of the AWB.
Related APIs:
v2.order.get_order_detail
v2.logistics.get_shipping_document_data_info
Effective Date:
18 November 2024
C. Introducing New Shipping Carrier (GDEX)
Please note that starting from 8 November 2024, "GDEX” (Channel ID: 20025) will be a new shipping carrier parked under Doorstep Delivery (Channel ID: 2000) logistic channel.
Affected Logistics Channels
Do note that this is a new fulfillment channel for this logistics channel.
| logistics_channel_id | mask_channel_id | shipping_carrier |
|---|---|---|
| 20025 | 2000 | GDEX |
Kindly note the changes for the response data in the response body regarding the new Shipping Carrier (channel_id=20025) Related APIs.
Scenario
When developers call v2.logistics.get_shipping_document_data_info, v2.order.get_order_detail and v2.logistics.get_channel_list, the response body will be as follows:
Sample of response body:
v2.logistics.get_shipping_document_data_info
{
"error": "",
"message": "",
"response": {
"shipping_document_info": {
"cod": false,
"cod_amount": "0",
"create_date_ymd_sl": "2024/10/15",
"deliver_area": "",
"delivery_hub": "",
"dely_fri_label": "",
"dely_sat_label": "",
"dely_sun_label": "",
"destination_base_code": "",
"ec_order_no": "",
"is_lm_dg_bool": 0,
"last_mile_tracking_number": "",
"last_third_digits_buyer_phone": "",
"logistics_channel_id": 20025,
"manufacturers_name": "",
"manufacturers_website": "",
"mutual_check": 0,
"order_weight": 1000,
"parcel_size": "",
"pickup_hub": "",
"preferred_delivery_option": 1,
"recipient_addr": "Midvalley City, Mid Valley City, Bandar Kuala Lumpur, Kuala Lumpur, W.P. Kuala Lumpur, W.P. Kuala Lumpur",
"recipient_sort_code": {
"first_recipient_sort_code": "KLV-KULC",
"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": "GDEX",
"shopee_tracking_number": "MY2401650725563U",
"sod": false,
"spx_receive_station": {
"spx_first_receive_station": ""
},
"spx_sub_district": "",
"tracking_number": "GDSP50000000141",
"zone": "",
"zone_code": ""
},
"recipient_address_info": null
},
"request_id": "317a860d247b3ef8008d552c2e895900:0100026c74d733ee:000000d2d074afe7"
}
v2.order.get_order_detail
{
"error": "",
"message": "",
"response": {
"order_list": [
{
"advance_package": false,
"booking_sn": "",
"cod": false,
"create_time": 1728960021,
"currency": "MYR",
"days_to_ship": 1,
"message_to_seller": "",
"order_sn": "241015K5X7F504",
"order_status": "PROCESSED",
"region": "MY",
"reverse_shipping_fee": 0,
"ship_by_date": 1728975600,
"shipping_carrier": "GDEX",
"update_time": 1728960115
}
]
},
"request_id": "317a860d247b450631fb6037d32eeb00:010002ee4077fd9f:00000056ddb29dab"
}
v2.logistics.get_channel_list
{
"error": "",
"message": "",
"request_id": "14a471c4ff1950e0759a627237a56141:020002ee9bbaa47d:0100001889a9672b",
"response": {
"logistics_channel_list": [
{
"logistics_channel_id": 20025,
"logistics_channel_name": "GDEX",
"cod_enabled": false,
"enabled": true,
"fee_type": "SIZE_INPUT",
"size_list": [],
"weight_limit": {
"item_max_weight": 30,
"item_min_weight": 0
},
"item_max_dimension": {
"height": 200,
"width": 200,
"length": 200,
"unit": "cm",
"dimension_sum": 0
}
]
}
Related APIs:
v2.order.get_order_detail
v2.logistics.get_shipping_document_data_info
v2.logistics.get_channel_list
Affected Fields:
shipping_carrier
logistics_channel_id
Effective Date:
8 November 2024
尊敬的开发者，
以下更新仅适用于选定的Shopee MY本地卖家。
A. 引入新的包装/虚拟物流渠道 (Next Day Delivery)
自2024年11月18日起，引入Next Day Delivery（渠道ID：2002）为一种新的物流渠道，用于履行快捷服务给买家。此物流渠道只适用特定的Shopee MY本地卖家。
请注意与有关Shipping Carrier的API相关的响应数据的变更。
场景
当开发者调用v2.logistics.get_channel_list时，响应主体将如下所示：
响应体示例：
{
"logistics_channel_id": 2002,
"logistics_channel_name": "Next Day Delivery",
"cod_enabled": true,
"enabled": true,
"fee_type": "SIZE_INPUT",
"size_list": [],
"weight_limit": {
"item_max_weight": 30,
"item_min_weight": 0
},
"item_max_dimension": {
"height": 125,
"width": 125,
"length": 125,
"unit": "cm",
"dimension_sum": 0
},
"force_enable": false,
"mask_channel_id": 0,
"logistics_description": "********",
"volume_limit": {
"item_max_volume": 130000,
"item_min_volume": 0
},
"logistics_capability": {
"seller_logistics": false,
"direct_delivery": false
},
"seller_logistic_has_configuration": null,
"support_cross_border": false,
"block_seller_cover_shipping_fee": false,
"support_pre_order": false
}
影响API：
v2.logistics.get_channel_list
v2.logistics.update_channel
v2.product.add_item
v2.product.update_item
v2.product.get_item_base_info
v2.logistics.get_shipping_parameter
v2.logistics.get_tracking_number
v2.logistics.get_shipping_document_parameter
v2.order.get_order_detail
v2.logistics.get_shipping_document_data_info
生效日期：
2024年11月18日
B. 引入新的履约物流渠道 (SPX Express (NDD))
自2024年11月18日起， "SPX Express (NDD)” (Channel ID: 20066) 将会是在 Next Day Delivery (Channel ID: 2002) 下的一个新的履约物流渠道。
受影响的物流渠道
目前这是一个针对包装/虚拟物流渠道下的一个新的履约物流渠道。
| logistics_channel_id | mask_channel_id | shipping_carrier |
|---|---|---|
| 20066 | 2002 | SPX Express (NDD) |
请注意关于新履约物流渠道（channel_id=20066）相关API的响应数据在响应体中的变更。
场景
当开发者调用 v2.logistics.get_shipping_document_data_info 和 v2.order.get_order_detail时，响应体将如下所示：
响应示例：
v2.logistics.get_shipping_document_data_info
{
"error": "",
"message": "",
"response": {
"shipping_document_info": {
"cod": false,
"cod_amount": "0",
"create_date_ymd_sl": "2024/10/29",
"deliver_area": "",
"delivery_hub": "",
"dely_fri_label": "",
"dely_sat_label": "",
"dely_sun_label": "",
"destination_base_code": "",
"ec_order_no": "",
"is_lm_dg_bool": 1,
"last_mile_tracking_number": "",
"last_third_digits_buyer_phone": "",
"logistics_channel_id": 20066,
"manufacturers_name": "",
"manufacturers_website": "",
"mutual_check": 0,
"order_weight": 1000,
"parcel_size": "",
"pickup_hub": "",
"preferred_delivery_option": 1,
"recipient_addr": "Midvalley City, Mid Valley City, Bandar Kuala Lumpur, Kuala Lumpur, W.P. Kuala Lumpur, W.P. Kuala Lumpur",
"recipient_sort_code": {
"first_recipient_sort_code": "AM Hub A",
"second_recipient_sort_code": "",
"third_recipient_sort_code": ""
},
"return_sort_code": {
"return_first_sort_code": "AM Hub A"
},
"sender_sort_code": {
"first_sender_sort_code": "",
"second_sender_sort_code": "",
"third_sender_sort_code": ""
},
"shipping_carrier": "SPX Express (NDD)",
"shopee_tracking_number": "MY2474207445406U",
"sod": false,
"spx_receive_station": {
"spx_first_receive_station": ""
},
"spx_sub_district": "",
"tracking_number": "SPXMY04851479837A",
"zone": "",
"zone_code": ""
},
"recipient_address_info": null
},
"request_id": "e3e3e7f32598b3e98e90058006371301:01000284fcd4892f:0000000c37808991"
}
v2.order.get_order_detail
{
"error": "",
"message": "",
"response": {
"order_list": [
{
"advance_package": false,
"booking_sn": "",
"cod": false,
"create_time": 1730186575,
"currency": "MYR",
"days_to_ship": 1,
"message_to_seller": "",
"order_sn": "241029SRX17WB1",
"order_status": "PROCESSED",
"region": "MY",
"reverse_shipping_fee": 0,
"ship_by_date": 1730193930,
"shipping_carrier": "SPX Express (NDD)",
"update_time": 1730187006
}
]
},
"request_id": "e3e3e7f32598ba02ec76359e2a822701:0100020523af1d6d:0000007ce50001d2"
}
开发者需采取的行动
在调用以下 API “v2.logistics.get_shipping_document_data_info” 时，如果响应体字段 “shipping_carrier" 返回"SPX Express (NDD)"，开发者须于运单 (AWB) 右上区部份硬编 "NDD" 的字眼。
运单（AWB）示例
影响API：
v2.order.get_order_detail
v2.logistics.get_shipping_document_data_info
生效日期：
2024年11月18日
C. 引入新的履约物流渠道 (GDEX)
自2024年11月8日起，GDEX（渠道 ID：20025）将成为“Doorstep Delivery” 虚拟物流渠道（渠道ID：2000）下的新履约物流渠道。
受影响的物流渠道
请注意，这是此虚拟物流渠下的的新履约物流渠道。
| logistics_channel_id | mask_channel_id | shipping_carrier |
|---|---|---|
| 20025 | 2000 | GDEX |
请注意关于新履约物流渠道（channel_id=20025）相关API的响应数据在响应体中的变更。
场景
当开发者调用 v2.logistics.get_shipping_document_data_info, v2.order.get_order_detail 和 v2.logistics.get_channel_list 时，响应体将如下所示：
响应体示例：
v2.logistics.get_shipping_document_data_info
{
"error": "",
"message": "",
"response": {
"shipping_document_info": {
"cod": false,
"cod_amount": "0",
"create_date_ymd_sl": "2024/10/15",
"deliver_area": "",
"delivery_hub": "",
"dely_fri_label": "",
"dely_sat_label": "",
"dely_sun_label": "",
"destination_base_code": "",
"ec_order_no": "",
"is_lm_dg_bool": 0,
"last_mile_tracking_number": "",
"last_third_digits_buyer_phone": "",
"logistics_channel_id": 20025,
"manufacturers_name": "",
"manufacturers_website": "",
"mutual_check": 0,
"order_weight": 1000,
"parcel_size": "",
"pickup_hub": "",
"preferred_delivery_option": 1,
"recipient_addr": "Midvalley City, Mid Valley City, Bandar Kuala Lumpur, Kuala Lumpur, W.P. Kuala Lumpur, W.P. Kuala Lumpur",
"recipient_sort_code": {
"first_recipient_sort_code": "KLV-KULC",
"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": "GDEX",
"shopee_tracking_number": "MY2401650725563U",
"sod": false,
"spx_receive_station": {
"spx_first_receive_station": ""
},
"spx_sub_district": "",
"tracking_number": "GDSP50000000141",
"zone": "",
"zone_code": ""
},
"recipient_address_info": null
},
"request_id": "317a860d247b3ef8008d552c2e895900:0100026c74d733ee:000000d2d074afe7"
}
v2.order.get_order_detail
{
"error": "",
"message": "",
"response": {
"order_list": [
{
"advance_package": false,
"booking_sn": "",
"cod": false,
"create_time": 1728960021,
"currency": "MYR",
"days_to_ship": 1,
"message_to_seller": "",
"order_sn": "241015K5X7F504",
"order_status": "PROCESSED",
"region": "MY",
"reverse_shipping_fee": 0,
"ship_by_date": 1728975600,
"shipping_carrier": "GDEX",
"update_time": 1728960115
}
]
},
"request_id": "317a860d247b450631fb6037d32eeb00:010002ee4077fd9f:00000056ddb29dab"
}
v2.logistics.get_channel_list
{
"error": "",
"message": "",
"request_id": "14a471c4ff1950e0759a627237a56141:020002ee9bbaa47d:0100001889a9672b",
"response": {
"logistics_channel_list": [
{
"logistics_channel_id": 20025,
"logistics_channel_name": "GDEX",
"cod_enabled": false,
"enabled": true,
"fee_type": "SIZE_INPUT",
"size_list": [],
"weight_limit": {
"item_max_weight": 30,
"item_min_weight": 0
},
"item_max_dimension": {
"height": 200,
"width": 200,
"length": 200,
"unit": "cm",
"dimension_sum": 0
}
]
}
影响API：
v2.order.get_order_detail
v2.logistics.get_shipping_document_data_info
V2.logistics.get_channel_list
受影响的字段：
shipping_carrier
logistics_channel_id
生效日期：
2024年11月8日