快工助手跨境电商知识与商机助手
快工云仓服务介绍

[MY] Important Update for Open Platform AWB API - 2-Day Delivery

Shopee 官方资料 · Shopee Open Platform 变更通知（Announcements） · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存，可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.announcements
语言
en
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/announcementtopic/apitopic/changelogtopic/developertopic/logistics-channel-awb-updates

资料正文

§1 [MY] Important Update for Open Platform AWB API - 2-Day Delivery

Dear Developers,

The updates below are effective for selected Shopee MY seller only.

A. Introducing New Logistics Channel

Effective on 2 September 2024, 2-Day Delivery (Channel ID: 2104) is a new logistic channel to fulfill express 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": 2104,

"logistics_channel_name": "2-Day Delivery",

"cod_enabled": false,

"enabled": true,

"fee_type": "SIZE_INPUT",

"size_list": [],

"weight_limit": {

"item_max_weight": 2,

"item_min_weight": 0.01

},

"item_max_dimension": {

"height": 5,

"width": 25,

"length": 35,

"unit": "cm",

"dimension_sum": 0

},

"force_enable": false,

"mask_channel_id": 0,

"logistics_description": "",

"volume_limit": {

"item_max_volume": 0,

"item_min_volume": 0

},

"logistics_capability": {

"seller_logistics": false

},

"seller_logistic_has_configuration": null,

"support_cross_border": false,

"block_seller_cover_shipping_fee": 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:

2 September 2024

B. Introducing New Shipping Carrier

  1. Please note that starting from 2 September 2024, "Shopee Express (2DD)” (Channel ID: 20044) will be a new shipping carrier parked under 2-Day Delivery (Channel ID: 2104) logistic channel.

Affected Logistics Channels

Do note that this is a new fulfillment channel for this new logistics channel.

logistics_channel_idmask_channel_idlogistics_channel_name
200442104Shopee Express (2DD)

Kindly note the changes for the response data in the response body regarding the new Shipping Carrier (channel_id=20044) 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": "",

"request_id": "620f0cd9a2bb8f657591b1a0cfa38721:000000e33ff9a4b5:0000000000000000",

"response": {

"recipient_address_info": null,

"shipping_document_info": {

"cod": false,

"cod_amount": "0",

"create_date_ymd_sl": "2024/09/02",

"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": 20044,

"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": "04-04009-B2",

"second_recipient_sort_code": "D01",

"third_recipient_sort_code": "BFT_SP-Beaufort"

},

"return_sort_code": {

"return_first_sort_code": ""

},

"sender_sort_code": {

"first_sender_sort_code": "",

"second_sender_sort_code": "",

"third_sender_sort_code": ""

},

"shipping_carrier": "SPX Express (2DD)",

"shopee_tracking_number": "SPXMY046763321508",

"sod": false,

"spx_receive_station": {

"spx_first_receive_station": ""

},

"spx_sub_district": "",

"tracking_number": "SPXMY046763321508",

"zone": "",

"zone_code": ""

}

v2.order.get_order_detail

{

"error": "",

"message": "",

"request_id": "4529c68c417030caaffe226f1b8b6f21",

"response": {

"order_list": [

{

"cod": false,

"create_time": 1716257540,

"currency": "MYR",

"days_to_ship": 2,

"message_to_seller": "",

"order_sn": "240521UU12JYBJ",

"order_status": "PROCESSED",

"region": "MY",

"reverse_shipping_fee": 0,

"ship_by_date": 1716564600,

"shipping_carrier": "SPX Express (2DD)",

"update_time": 1716277196

}

]

}

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 (2DD)", the developer should hardcode the wording "2DD" under Order Details (Courier) at the top right of the AWB.

Related APIs:

v2.order.get_order_detail

v2.logistics.get_shipping_document_data_info

Effective Live Date:

2 September 2024

尊敬的开发者，

以下更新仅适用于选定的Shopee MY本地卖家。

A. 引入新的包装/虚拟物流渠道

自2024年9月2日起，引入2-Day Delivery（渠道ID：2104）为一种新的物流渠道，用于履行快捷服务给买家。此物流渠道只适用特定的Shopee MY本地卖家。

请注意与有关Shipping Carrier的API相关的响应数据的变更。

场景

当开发者调用v2.logistics.get_channel_list时，响应主体将如下所示：

响应主体示例：

{

"logistics_channel_id": 2102,

"logistics_channel_name": "2-Day Delivery",

"cod_enabled": false,

"enabled": true,

"fee_type": "SIZE_INPUT",

"size_list": [],

"weight_limit": {

"item_max_weight": 2,

"item_min_weight": 0.01

},

"item_max_dimension": {

"height": 5,

"width": 25,

"length": 35,

"unit": "cm",

"dimension_sum": 0

},

"force_enable": false,

"mask_channel_id": 0,

"logistics_description": "",

"volume_limit": {

"item_max_volume": 0,

"item_min_volume": 0

},

"logistics_capability": {

"seller_logistics": false

},

"seller_logistic_has_configuration": null,

"support_cross_border": false,

"block_seller_cover_shipping_fee": 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年9月2日

B. 引入新的履约物流渠道

自2024年9月2日起， "Shopee Express (2DD)” (Channel ID: 20044) 将会是在 2-Day Delivery (Channel ID: 2104) 下的一个新的履约物流渠道。

受影响的物流渠道

目前这是一个针对包装/虚拟物流渠道下的一个新的履约物流渠道。

  1. 自2024年9月2日起， "Shopee Express (2DD)” (Channel ID: 20044) 将会是在 2-Day Delivery (Channel ID: 2104) 包装/虚拟物流渠道下的一个新的履约物流渠道。

受影响的物流渠道

logistics_channel_idmask_channel_idlogistics_channel_name
200442104Shopee Express (2DD)

请注意新的履约渠道（channel_id=20044）在shipping_carrier字段的变化。

场景

当开发者调用 v2.logistics.get_shipping_document_data_info 和 v2.order.get_order_detail时，响应主体将如下所示：

响应示例：

v2.logistics.get_shipping_document_data_info

{

"error": "",

"message": "",

"request_id": "620f0cd9a2bb8f657591b1a0cfa38721:000000e33ff9a4b5:0000000000000000",

"response": {

"recipient_address_info": null,

"shipping_document_info": {

"cod": false,

"cod_amount": "0",

"create_date_ymd_sl": "2024/09/02",

"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": 20044,

"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": "04-04009-B2",

"second_recipient_sort_code": "D01",

"third_recipient_sort_code": "BFT_SP-Beaufort"

},

"return_sort_code": {

"return_first_sort_code": ""

},

"sender_sort_code": {

"first_sender_sort_code": "",

"second_sender_sort_code": "",

"third_sender_sort_code": ""

},

"shipping_carrier": "SPX Express (2DD)",

"shopee_tracking_number": "SPXMY046763321508",

"sod": false,

"spx_receive_station": {

"spx_first_receive_station": ""

},

"spx_sub_district": "",

"tracking_number": "SPXMY046763321508",

"zone": "",

"zone_code": ""

}

v2.order.get_order_detail

{

"error": "",

"message": "",

"request_id": "4529c68c417030caaffe226f1b8b6f21",

"response": {

"order_list": [

{

"cod": false,

"create_time": 1716257540,

"currency": "MYR",

"days_to_ship": 2,

"message_to_seller": "",

"order_sn": "240521UU12JYBJ",

"order_status": "PROCESSED",

"region": "MY",

"reverse_shipping_fee": 0,

"ship_by_date": 1716564600,

"shipping_carrier": "SPX Express (2DD)",

"update_time": 1716277196

}

]

}

开发者需采取的行动

在调用以下 API “v2.logistics.get_shipping_document_data_info” 时，如果响应体字段 “shipping_carrier" 返回名为"SPX Express (2DD)"，开发者须于运单 (AWB) 右上区的 Order Details (Courier) 部份硬编 "2DD" 的字眼。

运单（AWB）示例

影响API：

v2.order.get_order_detail

v2.logistics.get_shipping_document_data_info

生效日期：

2024年9月2日

#