快工助手跨境电商知识与商机助手

[MY] Important Update for Open Platform AWB API - Instant 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 - Instant Delivery

Dear Developers,

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

Introducing New Shipping Carrier - Instant Delivery

Please note that starting from 2 Sept 2025, "Instant Delivery" (Channel ID: 23000) will be a new shipping carrier to provide instant delivery service to the buyers. This channel only supports delivery distances not more than 30km.

Affected Logistics Channels

Do note that this is a new fulfillment channel that does not park under any masked channel.

logistics_channel_idshipping_carrier
23000Instant Delivery

Kindly note the changes for the response data in the response body regarding the new Shipping Carrier (channel_id=23000) related APIs.

Scenario

When developers call v2.order.get_order_detail and 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": "e3e3e7f33c2762915151bbd46fba5d00:01000288aadf4e34:0000002f31b943ab",

"response": {

"order_list": [

{

"advance_package": false,

"booking_sn": "",

"cod": true,

"create_time": 1754982137,

"currency": "MYR",

"days_to_ship": 1,

"hot_listing_order": false,

"message_to_seller": "",

"order_sn": "250812KTHCWARC",

"order_status": "PROCESSED",

"package_list": [

{

"allow_self_design_awb": true,

"group_shipment_id": null,

"item_list": [

{

"item_id": 26216964650,

"model_id": 0,

"model_quantity": 1,

"order_item_id": 26216964650,

"product_location_id": "MYZ",

"promotion_group_id": 0

}

],

"logistics_channel_id": 23000,

"logistics_status": "LOGISTICS_REQUEST_CREATED",

"package_number": "OFG208681337209796",

"parcel_chargeable_weight_gram": 0,

"shipping_carrier": "Instant Delivery",

"sorting_group": ""

}

],

"region": "MY",

"reverse_shipping_fee": 0,

"ship_by_date": 1755061200,

"shipping_carrier": "Instant Delivery",

"update_time": 1754985273

}

]

}

v2.logistics.get_shipping_document_data_info

{

"error": "",

"message": "",

"request_id": "e3e3e7f33c27826f64895c34681d7400:010002a7f53cbf96:0000001a0d770657",

"response": {

"recipient_address_info": null,

"shipping_document_info": {

"cod": true,

"cod_amount": "15.6",

"create_date_ymd_sl": "2025/08/12",

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

"manufacturers_name": "",

"manufacturers_website": "",

"mutual_check": 0,

"order_weight": 5500,

"parcel_size": "",

"pickup_hub": "",

"preferred_delivery_option": 2,

"recipient_sort_code": {

"first_recipient_sort_code": "",

"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": "Instant Delivery",

"shopee_tracking_number": "MY258708804210K",

"sod": false,

"sorting_group": "",

"spx_receive_station": {

"spx_first_receive_station": ""

},

"spx_sub_district": "",

"tracking_number": "2697141308077568874",

"unpackaged_sku_id": "",

"unpackaged_sku_id_qrcode": "",

"zone": "",

"zone_code": ""

}

Action to take from Developers

When calling v2.order.get_order_detail or v2.logistics.get_shipping_document_data_info, if the response body field "logistics_channel_id" returns as "23000", the developer should:

  1. Hardcode the wording "Instant" under Order Details (Courier) at the top right of the AWB.

  2. For sellers who use the Shopee system generated AWB, please take note "COD" wording will be displayed above the recipient postcode on the right column if the “cod” parameter returns"true ".

  3. For sellers who use self-design AWB, developers need to hardcode "COD" wording above the recipient postcode on the right column if “cod” parameter returns"true ".

For this channel, sellers are able to pre-print AWB before arranging shipment.

AWB Sample

Related APIs:

v2.order.get_order_detail

v2.logistics.get_shipping_document_data_info

Affected field:

shipping_carrier

logistics_channel_id

Effective Date:

2 September 2025

亲爱的开发者,

以下更新仅适用于特定的Shopee马来西亚本地卖家。

引入新的履约物流渠道 - Instant Delivery

自2025年9月2日起,“Instant Delivery” (渠道 ID:23000) 将作为新的新履约物流渠道,向买家提供即时配送服务。该渠道仅支持配送距离不超过30公里的订单。

受影响的物流渠道

这个新的履约物流渠道将不属于任何虚拟物流渠道。

logistics_channel_idshipping_carrier
23000Instant Delivery

请注意新的履约渠道 (channel_id=23000) 相关API响应体中的响应数据变化。

场景

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

响应示例:

v2.order.get_order_detail

{

"error": "",

"message": "",

"request_id": "e3e3e7f33c2762915151bbd46fba5d00:01000288aadf4e34:0000002f31b943ab",

"response": {

"order_list": [

{

"advance_package": false,

"booking_sn": "",

"cod": true,

"create_time": 1754982137,

"currency": "MYR",

"days_to_ship": 1,

"hot_listing_order": false,

"message_to_seller": "",

"order_sn": "250812KTHCWARC",

"order_status": "PROCESSED",

"package_list": [

{

"allow_self_design_awb": true,

"group_shipment_id": null,

"item_list": [

{

"item_id": 26216964650,

"model_id": 0,

"model_quantity": 1,

"order_item_id": 26216964650,

"product_location_id": "MYZ",

"promotion_group_id": 0

}

],

"logistics_channel_id": 23000,

"logistics_status": "LOGISTICS_REQUEST_CREATED",

"package_number": "OFG208681337209796",

"parcel_chargeable_weight_gram": 0,

"shipping_carrier": "Instant Delivery",

"sorting_group": ""

}

],

"region": "MY",

"reverse_shipping_fee": 0,

"ship_by_date": 1755061200,

"shipping_carrier": "Instant Delivery",

"update_time": 1754985273

}

]

}

v2.logistics.get_shipping_document_data_info

{

"error": "",

"message": "",

"request_id": "e3e3e7f33c27826f64895c34681d7400:010002a7f53cbf96:0000001a0d770657",

"response": {

"recipient_address_info": null,

"shipping_document_info": {

"cod": true,

"cod_amount": "15.6",

"create_date_ymd_sl": "2025/08/12",

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

"manufacturers_name": "",

"manufacturers_website": "",

"mutual_check": 0,

"order_weight": 5500,

"parcel_size": "",

"pickup_hub": "",

"preferred_delivery_option": 2,

"recipient_sort_code": {

"first_recipient_sort_code": "",

"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": "Instant Delivery",

"shopee_tracking_number": "MY258708804210K",

"sod": false,

"sorting_group": "",

"spx_receive_station": {

"spx_first_receive_station": ""

},

"spx_sub_district": "",

"tracking_number": "2697141308077568874",

"unpackaged_sku_id": "",

"unpackaged_sku_id_qrcode": "",

"zone": "",

"zone_code": ""

}

开发者需采取的行动:

在调用v2.order.get_order_detail或v2.logistics.get_shipping_document_data_info时,如果响应体字段 “logistics_channel_id”返回为“23000”,开发者须:

  1. 请在面单 (AWB) 右上角的Order Details (Courier) 部分硬编码“Instant”字眼。

  2. 对于使用Shopee系统面单 (AWB) 的卖家,请注意,如果“cod”参数返回为“true”,则“COD”字眼将显示在右侧栏收件人邮编的上方。

  3. 对于使用自画面单 (AWB) 的卖家,如果“cod”参数返回为“true”,开发人员需要将“COD”字眼硬编码在右侧栏收件人邮编的上方。

对于此渠道,卖家可以在安排发货前预先打印面单 (AWB)。

面单 (AWB) 示例

影响API:

v2.order.get_order_detail

V2.logistics.get_shipping_document_data_info

受影响的字段:

shipping_carrier

logistics_channel_id

生效日期:

2025年9月2日

#