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

[MY] Important Update for AWB & Masked Channel Migration (City-Link Express)

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 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_idshipping_carrier
20023City-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_idshipping_carriermask_channel_id (Old)mask_channel_id (New)
20023City-Link Express21002000

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_idshipping_carrier
20023City-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_idshipping_carriermask_channel_id (目前)mask_channel_id (计划)
20023City-Link Express21002000

请注意相关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日

#