[TW] Significant updates for Logistics Channel Setting Validation Logic

Dear Developer,

We are introducing 3 new Logistics Channel Setting Validation Logic for TW local sellers. To ensure a smooth integration, please review the following changes to validation rules and API behaviors:

● Compulsory Channel: Sellers must enable at least one of the Compulsory Channel in both Shop & Item level, otherwise the system will block the edit & add actions.

● Related Enable: Each channel may contain a “related_enabled_channels” list. When sellers enable the parent channel, the system will automatically enable all channels within this list.

● Related Dependent Block: Each channel may contain a “related_dependent_block_channels” list. If sellers attempt to disable a parent channel, all channels in this list must be disabled first (or simultaneously); otherwise, the system will block the action.

For detailed policy & exclude scenario, please refer to SEH articles:

● Article 1

● Article 2

Scope of Impact

● Compulsory Channel

○ Seller Scope: TW local Mall Sellers, TW local Preferred Sellers

○ Channels: 30001, 30011, 30012, 30017, 30018, 30020, 39303, 39304, 39310, 39311, 39312, 39021, 39013, 39308

● Related Enable

○ Seller Scope: TW local Mall Sellers, TW local Preferred Sellers

○ Channels: 30015 > related_enabled_channels: 30019

● Related Dependent Block

○ Seller Scope: TW local Mall Sellers, TW local Preferred Sellers

○ Channels: 30019 > related_dependent_block_channels: 30015

*The above information is provided only as a system configuration description for the effective date. If there are any subsequent changes, please refer to the following API specification to obtain the system configuration; please use “v2.logistics.get_channel_list” API to obtain the actual available logistics channels for each shop.

Summary of Changes

1. New response parameters to show the realtime system configuration Related API: v2.logistics.get_channel_list

2. New validation logic for shop level logistics channel edit Related API: v2.logistics.update_channel

a. Compulsory Channel validation: If NO Compulsory Channels remain enabled after the request, the system will block the request.> error msg: “{Channel name to be closed} cannot be turned off. Please enable at least 1 of the following channel(s): {All compulsory channel name list}”

b. Related Enable: Enabling a channel with “related_enabled_channels” will enable those channels simultaneously. Check the “updated_channels” parameter in the response to know which channels had been enabled in the request.

c. Related Dependent Block: To disable a channel with “related_dependent_block_channels”, the dependent channels must already be disabled, otherwise the system will block the request.> error msg: “{Channel name to be closed} cannot be turned off due to dependent block rule. Please disable all the following channel(s) before proceed: {related_dependent_block_channels}”

3. New validation logic for item level edit Related API: v2.product.add_item, v2.product.update_item, v2.product.add_model, v2.product.update_model, v2.product.init_tier_variation, v2.product.update_tier_variation, v2.product.update_price

a. Compulsory Channel validation: If NO Compulsory Channels remain enabled after the request, the system will block the request. > error msg: “You have to enable at least one compulsory channel. {All compulsory channel name list enabled in shop level.}”

b. Related Enable: Enabling a channel with “related_enabled_channels” list will auto-enable those channels. (This also applies when you edit existing items that already have the parent channel enabled.)

c. Related Dependent Block: Dependent channels must be disabled either before or within the same request as the parent channel, otherwise the system will block the request. > error msg: “{Channel name to be closed} should be enabled as dependent channels are enabled: {related_dependent_block_channels}”

*We strongly recommend calling “v2.product.get_item_base_info” to obtain the latest item information after making any changes to item details.

Sample Scenarios

For more clarification for the change, you may refer to the following example: (The system configuration shown in this section is for example purposes only. For actual configuration, please refer to the "Scope of Impact" section and the content obtained from the actual API.)

Based on a response from “v2.logistics.get_channel_list” API below

(For easier viewing, this response has been shortened)

"response": {

"logistics_channel_list": [

{

"logistics_channel_id": 30015,

"logistics_channel_name": "蝦皮店到店",

"enabled": true,

"channel_relation_rules": {

"related_enabled_channels": [30019],

"related_dependent_block_channels": []

},

"compulsory_channel": false

},

{

"logistics_channel_id": 30019,

"logistics_channel_name": "蝦皮店到店 - 隔日到貨",

"enabled": false,

"channel_relation_rules": {

"related_enabled_channels": [],

"related_dependent_block_channels": [30015]

},

"compulsory_channel": false

},

{

"logistics_channel_id": 30017,

"logistics_channel_name": "店到家宅配",

"enabled": true,

"channel_relation_rules": {

"related_enabled_channels": [],

"related_dependent_block_channels": []

},

"compulsory_channel": true

},

{

"logistics_channel_id": 30020,

"logistics_channel_name": "新竹物流",

"enabled": true,

"channel_relation_rules": {

"related_enabled_channels": [],

"related_dependent_block_channels": []

},

"compulsory_channel": true

}

]

}

● Compulsory Channel Logic: Since channel 30017 and 30020 are marked “compulsory_channel”: true, you must have at least one of them enabled. If both are disabled, you cannot modify shop logistics settings or item settings.

● Related Enable Logic: Enabling 30015 will automatically trigger the enablement of 30019 at both shop and item levels; or editing items that already enable 30015 will automatically trigger the enablement of 30019.

● Related Dependent Block Logic: To disable 30019, you must ensure 30015 is already disabled (or disabled in the same request for items); otherwise, the request will be blocked.

Effective date

June 22, 2026

開發者您好，

我們即將為 TW Local 賣家推出3項新的物流選項設定檢查邏輯。為確保串接整合順暢，請參考以下關於檢查規則與 API 行為的變更：

● Compulsory Channel：賣家必須在賣場（Shop）與商品（Item）層級至少開啟一個 Compulsory Channel，否則系統將阻擋編輯與新增動作。

● Related Enable：每個物流選項可能包含一個 “related_enabled_channels” 列表。當賣家開啟此物流選項時，系統將自動開啟該列表中的所有物流選項。

● Related Dependent Block：每個物流選項可能包含一個 “related_dependent_block_channels” 列表。若賣家嘗試關閉此物流選項，必須先（或同時）關閉此列表中的所有物流選項；否則系統將阻擋該動作。

關於詳細政策與排除場景，請參考賣家幫助中心文章：

● 文章 1

● 文章 2

影響範圍

● Compulsory Channel

○ 適用賣家：商城賣家、優選賣家

○ 物流選項：30001, 30011, 30012, 30017, 30018, 30020, 39303, 39304, 39310, 39311, 39312, 39021, 39013, 39308

● Related Enable

○ 適用賣家：商城賣家、優選賣家

○ 物流選項： 30015 > related_enabled_channels: 30019

● Related Dependent Block

○ 適用賣家：商城賣家、優選賣家

○ 物流選項： 30019 > related_dependent_block_channels: 30015

*以上資訊僅作為生效日的系統配置說明。若後續有任何變動，請參考下方的 API 規格以獲取當前的系統配置；各賣場實際可使用之物流選項，請依 “v2.logistics.get_channel_list” API 取得。

變更重點摘要

1. 新增回應參數以顯示當下系統配置 相關 API: v2.logistics.get_channel_list

2. 賣場層級物流選項編輯的新檢查邏輯 相關 API: v2.logistics.update_channel

a. Compulsory Channel 檢查：若請求後沒有任何 Compulsory Channels 保持開啟狀態，系統將阻擋該請求。> error msg: “{欲關閉的channel name} cannot be turned off. Please enable at least 1 of the following channel(s): {所有 compulsory channel name list}”

b. Related Enable：開啟帶有 “related_enabled_channels” 的物流選項將同時開啟這些關聯物流選項。請檢查 Response 中的 “updated_channels” 參數以了解請求中哪些物流已在該 request 被開啟。

c. Related Dependent Block：若要關閉帶有 “related_dependent_block_channels” 的物流選項，關聯的物流選項必須已經處於關閉狀態，否則系統將阻擋該請求。> error msg: “{欲關閉的 channel name} cannot be turned off due to dependent block rule. Please disable all the following channel(s) before proceed: {related_dependent_block_channels}”

3. 商品層級編輯的新檢查邏輯 相關 API: v2.product.add_item, v2.product.update_item, v2.product.add_model, v2.product.update_model, v2.product.init_tier_variation, v2.product.update_tier_variation, v2.product.update_price

a. Compulsory Channel 檢查：若請求後該商品沒有任何 Compulsory Channels 保持開啟狀態，系統將阻擋該請求。> error msg: “You have to enable at least one compulsory channel. {所有 shop level enable 的 compulsory channel name list}”

b. Related Enable：在商品設定中開啟帶有 “related_enabled_channels” 的物流選項將自動開啟這些關聯物流選項；如果您編輯的既有商品已經啟用了帶有 “related_enabled_channels” 的物流選項，關聯的物流選項也將在同一個編輯 Request 中被啟用。

c. Related Dependent Block： 若要關閉商品設定中帶有 “related_dependent_block_channels” 的物流選項，關聯的物流選項必須已經處於關閉狀態或在同一個 request 中關閉，否則系統將阻擋該請求。> error msg: “{欲關閉的 channel name} should be enabled as dependent channels are enabled: {related_dependent_block_channels}”

*我們強烈建議在異動任何商品資訊後，呼叫 “v2.product.get_item_base_info” 取得當前最新的商品資訊。

範例場景

為了進一步了解此變更，您可以參考以下範例：

(此章節顯示的系統配置，僅提供範例說明，實際配置請參考 ”影響範圍” 章節以及實際 API 取得之內容)

以下為 “v2.logistics.get_channel_list” API 的 Response 範例

（為方便閱讀，此 Response 僅節錄部分）

"response": {

"logistics_channel_list": [

{

"logistics_channel_id": 30015,

"logistics_channel_name": "蝦皮店到店",

"enabled": true,

"channel_relation_rules": {

"related_enabled_channels": [30019],

"related_dependent_block_channels": []

},

"compulsory_channel": false

},

{

"logistics_channel_id": 30019,

"logistics_channel_name": "蝦皮店到店 - 隔日到貨",

"enabled": false,

"channel_relation_rules": {

"related_enabled_channels": [],

"related_dependent_block_channels": [30015]

},

"compulsory_channel": false

},

{

"logistics_channel_id": 30017,

"logistics_channel_name": "店到家宅配",

"enabled": true,

"channel_relation_rules": {

"related_enabled_channels": [],

"related_dependent_block_channels": []

},

"compulsory_channel": true

},

{

"logistics_channel_id": 30020,

"logistics_channel_name": "新竹物流",

"enabled": true,

"channel_relation_rules": {

"related_enabled_channels": [],

"related_dependent_block_channels": []

},

"compulsory_channel": true

}

]

}

基於以上 Response 我們可以得知以下檢查邏輯：

● Compulsory Channel 邏輯：由於物流選項 30017 與 30020 被標記為 “compulsory_channel”: true，您必須至少開啟其中之一。若兩者皆關閉，您將無法修改賣場物流設置或商品設置。

● Related Enable Logic：在賣場層級的物流設定或是商品物流設定時，若開啟物流選項 30015 或編輯已啟用 30015 的商品，物流選項 30019 將被自動開啟。

● Related Dependent Block Logic：要關閉物流選項 30019，您必須確保物流選項 30015 已經被關閉或在同一個請求中關閉，否則請求將被阻擋。

生效日期

2026 年 06 月 22 日