来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存,可追溯
- 官方原文可核对
资料正文
§1 [MY] Important Update for AWB & Masked Channel Migration (City-Link Express)
[MY] Important Update for AWB & Masked Channel Migration (City-Link Express)
Dear Developers,
The updates below are applicable to selected Shopee MY local sellers only.
A. Airway Bill (AWB) Template Update for City-Link Express
We would like to inform you that, effective 22 April 2025, there will be changes to the Airway Bill (AWB) template for shipping carrier City-Link Express (Channel ID: 20023). Specifically, the logo on the AWB will be updated.
| logistics_channel_id | shipping_carrier |
|---|---|
| 20023 | City-Link Express |
Scenario:
When calling the API v2.order.get_order_detail, there are some changes on Airway Bill (AWB) Logo if the Response body field "logistics_channel_id" returns "20023".
Sample of Response body :
v2.order.get_order_detail:
{
"error": "",
"message": "",
"request_id": "e3e3e7f332d4bd7c7124c11df836b401:0100026a88e699a0:000000a8fcb65753",
"response": {
"order_list": [
{
"advance_package": false,
"booking_sn": "",
"cod": false,
"create_time": 1726196971,
"currency": "MYR",
"days_to_ship": 3,
"message_to_seller": "",
"order_sn": "240913T2H7Q5NA",
"order_status": "CANCELLED",
"package_list": [
{
"allow_self_design_awb": true,
"group_shipment_id": null,
"item_list": [
{
"item_id": 800894907,
"model_id": 0,
"model_quantity": 1,
"order_item_id": 800894907,
"product_location_id": "MYZ",
"promotion_group_id": 0
}
],
"logistics_channel_id": 20023,
"logistics_status": "LOGISTICS_REQUEST_CANCELED",
"package_number": "OFG179896082204720",
"parcel_chargeable_weight_gram": 0,
"shipping_carrier": "City-Link Express"
}
],
"region": "MY",
"reverse_shipping_fee": 0,
"ship_by_date": 1726543281,
"update_time": 1728318137
}
]
}
Logo Material:
Effective Date: 22 April 2025
B. Migration of Mask Channel for City-Link Express
We would like to inform you that, effective 28 April 2025, shipping carrier City-Link Express (Channel ID: 20023), currently parked under the mask channel Bulky Delivery (Channel ID: 2100), will be migrated to parked under the mask channel Doorstep Delivery (Channel ID: 2000).
| logistics_channel_id | shipping_carrier | mask_channel_id (Old) | mask_channel_id (New) |
|---|---|---|---|
| 20023 | City-Link Express | 2100 | 2000 |
Kindly note the changes for the response data in the response body regarding Shipping Carrier Related APIs.
Scenario
When calling the API v2.logistics.get_channel_list, the response body will be as follows:
Sample of Response body:
{
"error": "",
"message": "",
"request_id": "14a471c4ff1950e0759a627237a56141:020002ee9bbaa47d:0100001889a9672b",
"response": {
"logistics_channel_list": [
{
"block_seller_cover_shipping_fee": false,
"cod_enabled": false,
"enabled": false,
"fee_type": "SIZE_INPUT",
"force_enable": false,
"item_max_dimension": {
"dimension_sum": 0,
"height": 150,
"length": 150,
"unit": "cm",
"width": 150
},
"logistics_capability": {
"direct_delivery": false,
"seller_logistics": false
},
"logistics_channel_id": 20023,
"logistics_channel_name": "City-Link Express",
"logistics_description": "********",
"mask_channel_id": 2000,
"seller_logistic_has_configuration": null,
"size_list": [],
"support_cross_border": false,
"support_pre_order": true,
"volume_limit": {
"item_max_volume": 0,
"item_min_volume": 0
},
"weight_limit": {
"item_max_weight": 30,
"item_min_weight": 1
}
]
}
Related APIs:
v2.logistics.get_channel_list
Affected field:
mask_channel_id
Effective Date: 28 April 2024
亲爱的开发者,
以下更新仅适用于特定的 Shopee 马来西亚本地卖家。
A. 关于 City-Link Express 的面单模板更新
从2025年4月22日开始,City-Link Express(Channel ID:20023)的面单模板将进行更新,特别是面单上的标志将被更改。
| logistics_channel_id | shipping_carrier |
|---|---|
| 20023 | City-Link Express |
在调用 v2.order.get_order_detail 时,如果响应体字段 “logistics_channel_id” 返回 “20023”,则面单会有一些变化。
响应体示例:
v2.order.get_order_detail:
{
"error": "",
"message": "",
"request_id": "e3e3e7f332d4bd7c7124c11df836b401:0100026a88e699a0:000000a8fcb65753",
"response": {
"order_list": [
{
"advance_package": false,
"booking_sn": "",
"cod": false,
"create_time": 1726196971,
"currency": "MYR",
"days_to_ship": 3,
"message_to_seller": "",
"order_sn": "240913T2H7Q5NA",
"order_status": "CANCELLED",
"package_list": [
{
"allow_self_design_awb": true,
"group_shipment_id": null,
"item_list": [
{
"item_id": 800894907,
"model_id": 0,
"model_quantity": 1,
"order_item_id": 800894907,
"product_location_id": "MYZ",
"promotion_group_id": 0
}
],
"logistics_channel_id": 20023,
"logistics_status": "LOGISTICS_REQUEST_CANCELED",
"package_number": "OFG179896082204720",
"parcel_chargeable_weight_gram": 0,
"shipping_carrier": "City-Link Express"
}
],
"region": "MY",
"reverse_shipping_fee": 0,
"ship_by_date": 1726543281,
"update_time": 1728318137
}
]
}
标志资源:
生效日期: 2025年4月22日
B. City-Link Express的虚拟渠道迁移
从2025年4月28日开始,原虚拟渠道 Bulky Delivery (Channel ID: 2100) 下的履约渠道 City-Link Express(渠道ID:20023),将迁移至虚拟渠道 Doorstep Delivery (Channel ID: 2000)之下。
| logistics_channel_id | shipping_carrier | mask_channel_id (目前) | mask_channel_id (计划) |
|---|---|---|---|
| 20023 | City-Link Express | 2100 | 2000 |
请注意相关API的响应数据在响应体中的变更。
场景
在调用 v2.logistics.get_channel_list 时,响应体将如下所示:
响应体示例:
{
"error": "",
"message": "",
"request_id": "14a471c4ff1950e0759a627237a56141:020002ee9bbaa47d:0100001889a9672b",
"response": {
"logistics_channel_list": [
{
"block_seller_cover_shipping_fee": false,
"cod_enabled": false,
"enabled": false,
"fee_type": "SIZE_INPUT",
"force_enable": false,
"item_max_dimension": {
"dimension_sum": 0,
"height": 150,
"length": 150,
"unit": "cm",
"width": 150
},
"logistics_capability": {
"direct_delivery": false,
"seller_logistics": false
},
"logistics_channel_id": 20023,
"logistics_channel_name": "City-Link Express",
"logistics_description": "********",
"mask_channel_id": 2000,
"seller_logistic_has_configuration": null,
"size_list": [],
"support_cross_border": false,
"support_pre_order": true,
"volume_limit": {
"item_max_volume": 0,
"item_min_volume": 0
},
"weight_limit": {
"item_max_weight": 30,
"item_min_weight": 1
}
]
}
影响API:
v2.logistics.get_channel_list
受影响的字段:
mask_channel_id
生效日期:2025年4月28日
