PCE TW GUI — SuiteTax 支援規劃

導入假設（產品）：客戶在 上線 PCE 前 即已在 NetSuite 決定 Legacy 或 SuiteTax；本規劃 不 涵蓋「營運中把同一帳號從 Legacy 改 SuiteTax」後的對應轉換、匯出／匯入或重新對應 SOP。

1. 為什麼需要

2. 現況（Legacy 假設）

2.1 資料模型（不變）

• customrecord_pce_tax_type：custrecord_pce_taxtype_code_value（1／2／3）＋ custrecord_pce_taxtype_ns_taxcode（MULTISELECT，存 NS 稅碼 internal id）。
• 語意：同一 PCE 課稅別可對多個 NS 稅碼（例如不同稅率皆屬應稅）。

2.2 程式 touch points

2.3 帳上設定入口

• PCE GUI Portal → 模組設定 → 課稅別稅碼對應（customscript_pce_sl_taxtype_mapping）。

3. SuiteTax vs Legacy（工作假設，需帳上驗證）

以下為實作前必須在 已啟用 SuiteTax 的 sandbox／客戶帳 核對的項目；細節以 Oracle Help／該帳 API 為準。

原則：PCE 仍只關心「line 上選了哪個 NS 稅碼 id → 對到 1／2／3」；差異集中在 如何列舉合法稅碼 與 如何從交易讀出同一個 id**。

4. 目標與非目標

4.1 目標（MVP）

1. 依帳號稅制（Legacy 或 SuiteTax）走對應 UI／開立分支；實作上以偵測或 上線時寫死的模組設定 二擇一（見 §5.1），不處理稅制中途切換。
2. 銷項開立（含自訂明細、來源 Invoice／CM）在 SuiteTax 帳號可完成 taxcode 反查與未對應驗證，產出正確 PCE 課稅別。台幣發票與折讓已在帳上開立。
3. Legacy 帳號行為不變（回歸測試必過）。
4. 文件：使用說明、操作手冊 HTML 各加一段「SuiteTax 帳號注意事項」。

4.2 非目標（第一版不做）

• 替 NetSuite 計算 稅額或改寫 SuiteTax engine 設定。
• 完整 tax details 子表逐行同步到 PCE 明細（除非實測證明僅讀 taxcode 不足）。
• 多國 VAT／US sales tax 通用化（仍以 台灣 PCE 課稅別 1／2／3 為範圍；他國稅碼若出現在清單，僅作映射，不保證報稅語意）。
• AP Write／進項 CSV 全面重寫（除非發現 SuiteTax 導致 taxType 來源交易 不一致，再開子項）。
• Legacy → SuiteTax 帳號稅制轉換 後的對應修補、資料匯出／匯入、專用 migration 文件（不在範圍）。
• 改課稅別對應的稅碼清單。既有對應是正確的，SuiteTax 帳也沿用，不另做 SuiteTax 稅碼下拉。

5. 建議架構

5.1 稅制引擎抽象層（新建 library）

建議：common/PCE_LIB_NsTaxEngine.js（名稱可調），對外固定 API：

設定（可選）：模組通用設定增加 NS 稅制 列舉 AUTO | LEGACY | SUITETAX（預設 AUTO），供 導入／建帳 時與 NetSuite 對齊；正常營運中不預期變更。

5.2 改接現有模組（薄改）

PCE_SL_TaxTypeMapping.js     → listTaxCodesForMapping()
PCE_LIB_AR_Lookup.js         → （map 仍讀 CR；可加引擎無關快取）
PCE_LIB_AR_Issue.js          → getLineTaxCodeId / 驗證未對應
PCE_LIB_AR_IssueSearch.js    → 確認 search column 在 SuiteTax 仍可用
PCE_CS_Trans_AR_Body.js      → 同上

5.3 資料相容

• 不新增 第二套 multiselect 欄位；同一帳號內只會存在 一種 稅制下的稅碼 id。
• 對應 UI 可選：儲存的 id 若在現行稅制搜尋不到則標示無效（設定錯誤或環境不一致時除錯用），非為稅制轉換流程設計。

6. 分期建議

7. 測試策略

8. 風險與決策點

1. 僅帳級 SuiteTax vs 子公司混用：若存在「部分子公司 Legacy」，getTaxEngineMode 必須 依 subsidiary 而非全帳一種。
2. taxcode search column：SuiteTax 下 saved search 是否仍回傳相同 internal id；若否，Issue 查詢需改 join 或改載入方式。
3. 對應 multiselect 儲存值：Legacy 與 SuiteTax 的 id 不可跨帳／跨稅制複製（僅防顧問誤拷 sandbox 設定）。
4. Performance：SuiteTax 稅碼數量可能更大 → 對應 UI 考慮 subsidiary 篩選或分頁（第二版；對應表仍全帳共用，見 §9）。

9. 產品決策（已確認）

10. 相關文件

變更紀錄