[TH] Shopee OpenAPI updates for Express delivery orders

Dear Developers,

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

Starting September 25, 2025, there will be changes on order flow and logistics channel info for Express Delivery orders.

Key changes

1.Channel info and name will be changed according to the table

2. Once the buyer places an order with Express Delivery - ส่งด่วน - 7002, then the platform will now automatically assign either Express Delivery (SHP Food) - 70123 or Express Delivery (SPX) - 70067 to each order.

3. AWB format changes for channel ID 70123 and 70067.

- Logistic Channel names

- Barcode position on Express Delivery (SPX)

4. Currently, Express Delivery items are only sold under Channel ID 70123. Starting from September 25, the platform will change these items to the mask channel 7002. The system will automatically determine whether the order is fulfilled by 70123 or 70067 in the backend. Buyers can continue to place orders as usual, and sellers do not need to migrate manually, as the items originally under 70123 will be migrated to 7002 for sale.

5. The Express Delivery (SPX) - 70067 service will initially be available in Bangkok and its vicinity, with continuous expansion to new service areas. Please refer to the timeslot and other details on the seller's article [https://seller.shopee.co.th/edu/article/19315]

Potential Impacts & Next actions:

1. If you call v2.product.add_item, v2.product.update_item to create/update an Express Delivery item with channel 70123, the logic needs to be modified with new channel ID 7002. Sample changes are as follows.

[ BEFORE ]

{

"description": "Express Delivery items",

"logistic_info": [

{

"enabled": true,

"logistic_id": 70123

}

]

}

[ AFTER ]

{

"description": "Express Delivery items",

"logistic_info": [

{

"enabled": true,

"logistic_id": 7002

}

]

}

Note：After an order is placed, you can call v2.order.get_order_detail to check the shipping carrier and logistics channel ID from the parameters "shipping_carrier" and "logistics_channel_id".

2. When you call v2.logistics.get_channel_list to get a channel list for your shops, you may get the new channel name. Sample changes are as follows.

[ BEFORE ]

{

"logistics_channel_id": 7002,

"logistics_channel_name": "SPX Express - FS"

}

{

"logistics_channel_id": 70123,

"logistics_channel_name": "Express Delivery - ส่งด่วน"

}

{

"logistics_channel_id": 70067,

"logistics_channel_name": "SPX Express - FS"

}

[ AFTER ]

{ "logistics_channel_id": 7002, "logistics_channel_name": "Express Delivery - ส่งด่วน"

} "logistics_channel_id": 70123, "logistics_channel_name": "Express Delivery (SHP Food)", "mask_channel_id": 7002

}

{ "logistics_channel_id": 70067, "logistics_channel_name": "Express Delivery (SPX)", "mask_channel_id": 7002 }

3. When you call v2.logistics.get_shipping_parameter for orders that have shipping channel ID as 70067, you will get a new timeslot list. Please select and use right timeslot id upon the time_text. Response sample is as follows:

[ BEFORE ]

"time_slot_list": [

{

"date": 1715850000,

"pickup_time_id": "1715850000_5"

}

]

[ AFTER ]

"time_slot_list": [

{

"date": 1715850000,

"time_text": "8.30-12.30",

"pickup_time_id": "1715850000_5"

},

{

"date": 1715850000,

"time_text": "9.30-13.30",

"pickup_time_id": "1715936500_1"

},

{

"date": 1715850000,

"time_text": "13.00-15.00",

"pickup_time_id": "1715937500_2"

},

{

"date": 1715850000,

"time_text": "16.00-19.00",

"pickup_time_id": "1715938500_3"

}

]

亲爱的开发者，

以下更新仅适用于特定的Shopee泰国本地卖家。

自 2025年9月25日起，平台将对Express Delivery订单的履约流程及物流渠道信息进行调整。

主要变更内容

1. 渠道信息与名称变更，具体请参考下方对照表。

2. 订单分配逻辑：当买家选择 Express Delivery - ส่งด่วน - 7002 下单后，系统将会自动为订单分配 Express Delivery (SHP Food) - 70123 或 Express Delivery (SPX) - 70067。

3. AWB样式调整：Channel ID 70123 与 70067 的 AWB 格式将会如下变化：

- 渠道名称变更

- Express Delivery (SPX) 的条码位置调整

4. 目前，Express Delivery 商品仅在 Channel ID 70123 售卖，9月25日后，平台将为原本启用 Channel ID 70123 的商品变更为mask channel 7002。系统会自动分配订单由 70123 或 70067 履约，买家仍能像往常一样正常下单，卖家无需手动迁移，原本 70123 的商品会迁移到 7002 进行售卖。

5. Express Delivery (SPX) - 70067 服务将率先覆盖曼谷及周边地区，并将逐步扩展至更多服务范围。更多配送时段及相关细节，请参考卖家中心文章：[https://seller.shopee.co.th/edu/article/19315]

潜在影响与后续操作

1. 如果您调用 v2.product.add_item 或 v2.product.update_item 来创建/更新启用Express Delivery channel ID 70123商品，请改为使用新的Channel ID 7002。代码示例如下：

[变更前]

{

"description": "Express Delivery items",

"logistic_info": [

{

"enabled": true,

"logistic_id": 70123

}

]

}

[变更后]

{

"description": "Express Delivery items",

"logistic_info": [

{

"enabled": true,

"logistic_id": 7002

}

]

}

Note：当买家下单后，如需确认订单渠道，可调用 v2.order.get_order_detail，并查看返回参数中的 "shipping_carrier" 与 "logistics_channel_id"。

2. 调用 v2.logistics.get_channel_list 获取店铺的物流渠道列表时，您会获取到新的渠道名称。代码示例如下：

[变更前]

{

"logistics_channel_id": 7002,

"logistics_channel_name": "SPX Express - FS"

}

{

"logistics_channel_id": 70123,

"logistics_channel_name": "Express Delivery - ส่งด่วน"

}

{

"logistics_channel_id": 70067,

"logistics_channel_name": "SPX Express - FS"

}

[变更后]

{

"logistics_channel_id": 7002, "logistics_channel_name": "Express Delivery - ส่งด่วน"

} "logistics_channel_id": 70123, "logistics_channel_name": "Express Delivery (SHP Food)", "mask_channel_id": 7002 } { "logistics_channel_id": 70067, "logistics_channel_name": "Express Delivery (SPX)", "mask_channel_id": 7002 }

3. 调用 v2.logistics.get_shipping_parameter 时，对于使用Channl ID 70067 的订单，将返回新的 配送时段（time slot）列表。您需要选择并传递正确的 pickup_time_id。

[变更前]

"time_slot_list": [

{

"date": 1715850000,

"pickup_time_id": "1715850000_5"

}

]

[变更后]

"time_slot_list": [

{

"date": 1715850000,

"time_text": "8.30-12.30",

"pickup_time_id": "1715850000_5"

},

{

"date": 1715850000,

"time_text": "9.30-13.30",

"pickup_time_id": "1715936500_1"

},

{

"date": 1715850000,

"time_text": "13.00-15.00",

"pickup_time_id": "1715937500_2"

},

{

"date": 1715850000,

"time_text": "16.00-19.00",

"pickup_time_id": "1715938500_3"

}

]