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

[MY] Important Update for Shipping Carrier AWB - BEST Cargo

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 Shipping Carrier AWB - BEST Cargo

Dear Developers,

The updates below are applicable to selected Shopee MY local sellers only.

Airway Bill (AWB) Template Update for BEST Cargo:

Please note that starting from 4 Dec 2025, BEST Cargo (Channel ID: 20103) will have some changes on the Airway Bill (AWB) template.

When calling the following API v2.order.get_order_detail or v2.logistics.get_shipping_document_data_info, there are some changes on Airway Bill (AWB) layout if the Response body field “logistics_channel_id" returns “20103” and “cod” returns “true”.

Sample of Response body:

v2.logistics.get_shipping_document_data_info

{

"error": "",

"message": "",

"request_id": "e3e3e7f3447cd84f890b017c5d98a800:010002b72b00174c:00000012d8d83dbb",

"response": {

"recipient_address_info": null,

"shipping_document_info": {

"cod": true,

"cod_amount": "30.12",

"create_date_ymd_sl": "2025/11/26",

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

"manufacturers_name": "",

"manufacturers_website": "",

"mutual_check": 0,

"order_weight": 22000,

"parcel_size": "",

"pickup_hub": "",

"preferred_delivery_option": 2,

"recipient_sort_code": {

"first_recipient_sort_code": "A-CKLBAR-00-00",

"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": "BEST Cargo",

"shopee_tracking_number": "MY259262776274G",

"sod": false,

"sorting_group": "",

"spx_receive_station": {

"spx_first_receive_station": ""

},

"spx_sub_district": "",

"tracking_number": "MYSP0000919905",

"unpackaged_sku_id": "",

"unpackaged_sku_id_qrcode": "",

"zone": "",

"zone_code": ""

}

v2.order.get_order_detail

{

"error": "",

"message": "",

"request_id": "e3e3e7f3447d0aebc84343fa329cfe00:01000281c4f0e5e2:000000466509600b",

"response": {

"order_list": [

{

"advance_package": false,

"booking_sn": "",

"cod": true,

"create_time": 1764151624,

"currency": "MYR",

"days_to_ship": 1,

"hot_listing_order": false,

"is_buyer_shop_collection": false,

"message_to_seller": "",

"order_sn": "251126RRCDDA20",

"order_status": "PROCESSED",

"package_list": [

{

"allow_self_design_awb": true,

"group_shipment_id": null,

"item_list": [

{

"item_id": 43016462789,

"model_id": 0,

"model_quantity": 1,

"order_item_id": 43016462789,

"product_location_id": "MYZ",

"promotion_group_id": 0

}

],

"logistics_channel_id": 20103,

"logistics_status": "LOGISTICS_REQUEST_CREATED",

"package_number": "OFG217850824241376",

"parcel_chargeable_weight_gram": 0,

"shipping_carrier": "BEST Cargo",

"sorting_group": ""

}

],

"region": "MY",

"reverse_shipping_fee": 0,

"ship_by_date": 1764259199,

"update_time": 1764151687

}

]

}

Changes Required in BEST Cargo 20103:

  1. For sellers who use the Shopee system generated AWB, please take note the Order Details (Courier) section will display “COD” wording if the “cod” parameter returns"true ".

  2. For sellers who use self-design AWB, you need to hardcode “COD '' wording in the Order Details (Courier) section if “cod” parameter returns"true ".

Effective Date on Live:

4 Dec 2025

亲爱的开发者,

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

关于AWB模板更新:

请注意,从2025年12月4日开始,BEST Cargo(渠道ID:20103)的AWB模板将进行一些更改。

在调用API v2.logistics.get_shipping_document_data_info或v2.order.get_order_detail时,如果响应体字段“logistics_channel_id”返回“20103”,并且响应体字段“cod”返回 true,则运单AWB会有一些变化。

响应主体示例:

v2.logistics.get_shipping_document_data_info

{

"error": "",

"message": "",

"request_id": "e3e3e7f3447cd84f890b017c5d98a800:010002b72b00174c:00000012d8d83dbb",

"response": {

"recipient_address_info": null,

"shipping_document_info": {

"cod": true,

"cod_amount": "30.12",

"create_date_ymd_sl": "2025/11/26",

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

"manufacturers_name": "",

"manufacturers_website": "",

"mutual_check": 0,

"order_weight": 22000,

"parcel_size": "",

"pickup_hub": "",

"preferred_delivery_option": 2,

"recipient_sort_code": {

"first_recipient_sort_code": "A-CKLBAR-00-00",

"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": "BEST Cargo",

"shopee_tracking_number": "MY259262776274G",

"sod": false,

"sorting_group": "",

"spx_receive_station": {

"spx_first_receive_station": ""

},

"spx_sub_district": "",

"tracking_number": "MYSP0000919905",

"unpackaged_sku_id": "",

"unpackaged_sku_id_qrcode": "",

"zone": "",

"zone_code": ""

}

v2.order.get_order_detail

{

"error": "",

"message": "",

"request_id": "e3e3e7f3447d0aebc84343fa329cfe00:01000281c4f0e5e2:000000466509600b",

"response": {

"order_list": [

{

"advance_package": false,

"booking_sn": "",

"cod": true,

"create_time": 1764151624,

"currency": "MYR",

"days_to_ship": 1,

"hot_listing_order": false,

"is_buyer_shop_collection": false,

"message_to_seller": "",

"order_sn": "251126RRCDDA20",

"order_status": "PROCESSED",

"package_list": [

{

"allow_self_design_awb": true,

"group_shipment_id": null,

"item_list": [

{

"item_id": 43016462789,

"model_id": 0,

"model_quantity": 1,

"order_item_id": 43016462789,

"product_location_id": "MYZ",

"promotion_group_id": 0

}

],

"logistics_channel_id": 20103,

"logistics_status": "LOGISTICS_REQUEST_CREATED",

"package_number": "OFG217850824241376",

"parcel_chargeable_weight_gram": 0,

"shipping_carrier": "BEST Cargo",

"sorting_group": ""

}

],

"region": "MY",

"reverse_shipping_fee": 0,

"ship_by_date": 1764259199,

"update_time": 1764151687

}

]

}

BEST Cargo 20103 的变更要求:

1.对于使用 Shopee 系统生成运单号(AWB)的卖家,请注意,如果 “cod” 参数返回为 "true",Order Details (Courier)部分将显示 “COD” 字样。

2.对于使用自定义运单(AWB)的卖家,如果 “cod” 参数返回为 "true",需要在 Order Details (Courier)部分硬编码显示 “COD” 字样

生效日期:

2025年12月4日

#