来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§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:
-
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 ".
-
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日
