Phase 0 — 規格與對齊（本文件，進行中）
- 盤點現況與命名
- 銷項憑證欄位清單（MIG 4.1 表頭／表身；見欄位對照）
- 確認第一批交易類型：僅 Invoice + Credit Memo（§6）
- 開立銷項發票與「PCE 銷項資料」：一張開立＝一筆主檔＋N 筆商品子明細（§9.2 A）
- 格式代碼 31–36 種子已加入安裝腳本（31／32／35 各兩筆；37–38 暫不種子）；發票本管理與開立取配號已交付
產出：本藍圖 +（建議）欄位對照表 Excel／Markdown 附錄。
用途與維護說明
用途：查「目前做到哪、還缺什麼」，不必翻 commit 或問人。
維護：凡 銷項相關 功能／SDF／行為文件有交付意義的變更，CP／CPD 前更新本頁「摘要一句」＋「變更紀錄」至少一列（可附 commit hash）。
對象：產品／顧問／開發
摘要一句
Phase 0–3 為核心範圍（計入整體完成度）。Phase 1 已可上線使用（主檔、開立、發票本、取配號、作廢 UI／核心、發票本 CSV、主檔上傳狀態／作廢上傳閘道）；模組通用系統設定＋營業人主檔 已 gate 銷項，Portal 未勾 銷項功能 時不顯示銷項；Invoice／Credit Memo 表身欄位與檢視頁開立 已交付（不做 AP 式 1:N 子列表）。零稅率開立（通關方式、零稅率原因、上傳 TXT）已完成。Phase 4–7 為加購，不計入整體完成度：Phase 7 背景自動開立發票已實作；Phase 4–6 與 Phase 7 排程 Search 仍規劃中。零稅率清單 PDF 仍屬加購 Phase 5。模組通用勾選 suiteTax，或帳號已啟用 SuiteTax 時，開立查詢不再使用 netamountnotax／taxamount／taxcode，表頭未稅改讀 netamount，明細稅碼與稅額仍從 Tax Details 讀，確認頁表頭稅額改為明細稅額合計，折讓稅額符號與未稅一致。課稅別對應維持既有稅碼清單，定案不改。SuiteTax 帳上已開立台幣銷項發票與折讓單。銷項主檔與銷項明細仍為權限清單，目前只有 Administrator。發票本、自訂明細、上傳佇列、背景開立佇列與對照表改為不需要權限。文字與長文字欄位可全域搜尋。開立發票確認頁的格式代號，客戶主檔有值就用客戶，否則用模組通用；兩邊都沒填則為 35-銷項一般稅額計算之電子發票。折讓單仍預設 33。折抵發票為不上傳時，折讓單預設不上傳。Sale 類交易的 PCE 銷項分頁有唯讀子列表「發票明細」，列出這張單已開立的銷項主檔。應稅、免稅、零稅率銷售額、營業稅額、總計與可折餘額顯示千分位。
進度圖表
依本頁 Markdown 表格自動計算；更新 PCE_GUI_MODULE_ar-status.md 後執行 npm run build:status-html 同步。
整體進度
0%加權完成度
- 完成／已交付 25
- 進行中 1
- 未做／未開始 1
- 決議不做（不計入完成度） 1
- 加購 Phase 4–7（不計入完成度） 15
功能清單（驗收）
0%加權完成度
- 完成／已交付 22
- 進行中 1
- 未做／未開始 1
- 決議不做（不計入完成度） 1
- 加購 Phase 4–7（不計入完成度） 12
Phase 細項（藍圖 §5）
自 PCE_GUI_MODULE_ar-blueprint.md 自動嵌入；編輯藍圖後執行 npm run build:status-html 同步。
請點選上方「階段藍圖（摘要）」中的 Phase 以顯示細項。
Phase 1 — 主檔與開立作業（MVP）
目標：使用者可在 PCE GUI → 銷項 維護銷項資料，並用「開立銷項發票」畫面建立一筆銷項。
| 工作項 | 說明 |
|---|---|
| Custom Record | customrecord_pce_ar_invoice＋…_line（§9.2 A）；欄位見 MIG 4.1 對照 |
| 發票本 | customrecord_pce_ar_invoice_book＋發票本管理（模組設定）；開立時依 §9.5 取配號 |
| 導覽 | 中心標籤「銷項」只留 PCE 銷項資料。開立、背景開立、作廢在 Portal → 銷項；上傳監控與錯誤在 Portal → 加值中心；發票本管理在 Portal → 模組設定 |
| 開立銷項發票 Suitelet | prototype 作版面起點；查詢 Invoice／Credit Memo 後以「單張／合併開立」建立主檔；清單僅顯示 issue_invoice=T、發票/折讓單狀態空白、未鎖定、發票號碼空白；賣方／買方規則見 §9.3／§9.4 |
| Client／UE | 檢核、連動、feature flag；賣方依子公司 mapping 不可覆寫 |
| Lookup／字軌 | 格式代碼 31–36 種子已入安裝腳本（31／32／35 各兩筆）；開立取配號已整合（PCE_LIB_AR_BookAllocate.js） |
| 文件 | SuiteApp 使用說明 §5.5／§5.6、本藍圖 §9.5 |
| SuiteApp | 與進項同一 app：com.netsuite.pceguitw |
本階段不做：交易子列表、CSV、外部 API。
Prototype：僅作 UX／版面參考；正式欄位以「完整對齊加值中心」為準（§9.1）。
Phase 2 — 銷項交易延伸
已定案不做：在 Invoice／Credit Memo 上複製進項 「PCE 進項資料」1:N 子列表（一筆交易掛多筆 customrecord_pce_ar_invoice）。銷項維持 PCE 銷項主檔 CR ＋開立 Suitelet；交易頁僅 表身 PCE 欄位、自訂商品明細、檢視頁開立（Phase 1 已部分交付，見使用說明 §3.5）。
Phase 2 規劃主項：
| 範圍 | NetSuite 類型 | 備註 |
|---|---|---|
| Phase 2（本階段） | Customer Deposit | 轉開發票（見下表） |
| 現行／維護 | Invoice、Credit Memo | 表身 CS/UE、開立按鈕；不做 AP 式 1:N 子列表 |
| 暫不做 | Cash Sale | 門市／現金流程另議 |
| 暫不做 | Cash Refund | 同上 |
Customer Deposit → 銷項發票（規劃）
Customer Deposit 在 NS 無稅碼、無商品明細；開立電子發票時需特別處理：
| 面向 | 方向 |
|---|---|
| 金額基礎 | 以原 Customer Deposit 總額為含稅金額，依適用稅率（由客戶設定之發票明細／課稅別推定）反推未稅金額與稅額；明細加總須與含稅總額一致（尾差規則待訂） |
| 發票明細 | 提供客戶可自行設定之 Customer Deposit 預設發票商品明細（品名、數量、單價邏輯、課稅別等；儲存位置待訂：模組設定 CR 或子公司／客戶層級） |
| 開立入口 | 自 Customer Deposit 檢視／開立 Suitelet 選定訂金 → 帶入或覆寫明細 → 建立 PCE 銷項主檔並取配號 |
| 文件／測試 | 使用說明 §5、含稅反推與多列明細之單元測試（待建） |
Invoice／Credit Memo（現行，非 Phase 2 新建）：custtab_pce_trx_ar_einvoice 為表身與自訂商品明細；開立仍走 開立銷項發票 Suitelet，來源交易帶入商品列（§9.2 A 寫入 PCE 主檔＋line CR）。
Phase 3 — 強化與合規
> 實作規格（TXT＋sFTP、開立／作廢兩管線）：PCE_GUI_MODULE_ar-phase3.md > 帳上：2026-10-07 連線、三支 GUID、正式區路徑、排程、開立上傳→ACK 已通過。作廢上傳→ACK 見該頁 Checklist。
| 工作項 | 說明 |
|---|---|
| 發票本／期別 | 進階控管（多本、鎖定、盤點） |
| 加值中心 | 上傳流程銜接（TXT 中介檔＋sFTP；連線在模組通用設定；開立上傳→ACK 已通過） |
| 零稅率開立 | 已實作。課稅別為零稅率時，通關方式註記與零稅率原因必填，寫入主檔並帶入上傳 TXT。零稅率銷售額合計已有。清單 PDF 仍屬加購 Phase 5 |
| 權限與回歸 | 權限收斂、冒煙測試 Suitelet、Browser／API 回歸清單 |
| 欄位精簡 | 依實務刪減「完整對齊」後確認不需要的欄位（呼應 §9.1） |
Phase 4–7 為加購，不計入 銷項進度 的整體完成度。
Phase 4 — 每期申報對帳報表（加購）
目標：提供客戶每一申報期別（營業稅雙月期）申報前所需的對帳報表——自 NetSuite／PCE 銷項資料彙整，供會計與顧問勾稽帳載、發票本、加值中心（若已上傳）是否一致。
規劃範圍（待細化規格）：
| 面向 | 方向 |
|---|---|
| 期別／主體 | 依統一編號、申報期別（ROC 雙月）、子公司篩選 |
| 資料來源 | PCE 銷項主檔／明細、關聯 Invoice／Credit Memo、發票本狀態、上傳狀態欄（Phase 3 若已接加值中心） |
| 報表類型 | 開立／作廢／折讓明細、格式與稅額小計、與 NS 交易金額差異、缺號／重複號警示（規則待訂） |
| 交付 | Suitelet 查詢＋匯出（CSV 為 MVP；PDF／Excel 視需求）；可選 Saved Search／Workbook 範本 |
| 文件 | 對帳邏輯說明、顧問操作步驟（併入使用說明 §5 或獨立對帳手冊） |
優先序：高於 Phase 6（外部憑證寫入）；申報週期性剛性需求，宜在加值中心銜接（Phase 3）就緒或並行規劃。
Phase 5 — 憑證 PDF 下載（加購）
目標：提供使用者下載已開立銷項憑證與申報／加值中心作業所需之 PDF（必要時再擴充 ZIP 批次下載）。
規劃範圍（待細化規格）：
| 文件類型 | 方向 |
|---|---|
| B2B 發票 PDF | 已開立之 B2B 電子發票（如格式 35 等）；內容對齊 MIG／加值中心版面（範本待訂） |
| 折讓單 PDF | 已開立折讓證明（格式 33／34） |
| 零稅率清單 PDF | 依期別／統編彙整零稅率銷項之清單 PDF（申報或內部覆核用） |
| 其他 | 依加值中心、申報或客戶合約所需之附表、證明或匯出（類型清單待與顧問確認後增列） |
| 面向 | 方向 |
|---|---|
| 入口 | 查詢已開立／作廢發票與折讓單 第 2 段。先有查詢清冊，再在同一頁下載單張 PDF |
| 資料來源 | customrecord_pce_ar_invoice＋明細、關聯 NS 交易、發票號碼／狀態 |
| 文件 | 使用說明 §5、PDF 欄位與範本對照（待建） |
Phase 6 — CSV 與 Write API（加購）
目標：讓已在 NetSuite 以外開立的銷項憑證（含對應交易資料）寫入 NS——批次匯入與外部系統介接，技術面比照 AP Write。
優先序：低於 Phase 1–5。主路徑是 NS 內開立／Suitelet；Phase 6 給「外部先開票、後補登 NS」或異質系統匯入，非多數客戶上線必備。
與 Phase 1 發票本 CSV 區隔：發票本 CSV 是字軌／配號主檔維護（Phase 1 已交付）；Phase 6 是銷項憑證／Write API，不是發票本匯入。
| 元件 | 建議 |
|---|---|
| Suitelet | customscript_pce_sl_ar_csv_import（範本／欄位說明／validateOnly） |
| RESTlet | customscript_pce_rl_ar_write |
| Actions | arInvoiceOnly／transactionOnly／transactionWithArInvoices（命名對齊 AP） |
| Log | customrecord_pce_ar_write_log |
| Auth | 沿用 OAuth 2.0 Bearer |
| 文件／Postman | PCE_GUI_MODULE_ar-write-api-*.md + collection |
Phase 7 — 開立自動化（加購；背景開立已交付）
目標：在 Phase 1 互動式開立穩定後，支援自動／批次開立銷項發票與銷項折讓（折讓證明），降低大量重複人工操作。
已交付 MVP（2026-10）：背景自動開立發票（多筆 Invoice 佇列、35-07 加值中心上傳、進度 Suitelet）。操作見 使用說明 §5.8；技術見 ar-auto-issue.md、AR status。
規劃範圍（待細化規格）：
| 面向 | 方向 |
|---|---|
| 觸發方式 | Saved Search＋排程 Map/Reduce、Workflow Action、條件式 User Event，或 Suitelet 批次選取（待選型） |
| 批次開立發票 | 來源為已勾選開立、表身就緒之 Invoice 等；重用既有開立／取配號 lib；需 idempotency、失敗重試與部分成功策略 |
| 批次開立折讓 | 來源 Credit Memo／可折餘額規則與現行 Suitelet 一致；非當期無主檔等邊界與 Phase 1 相同 |
| 治理與可觀測 | 治理額度分批、批次／逐筆 log、失敗清單與通知（email 或 Center 待辦，待訂） |
| 與 Phase 6 區隔 | Phase 6＝外部已開立憑證寫入 NS；Phase 7＝NS 內待開立交易自動／批次開立 |
| 文件 | 自動化觸發條件、顧問設定步驟、與手動 Suitelet 差異說明（待建） |
優先序：Saved Search 排程批次、折讓背景開立等仍低於 Phase 2–5；MVP 背景開立已上線，其餘待規格細化。
營業稅申報
目標：依 PCE 營業人 合併該營業人之 進項（PCE 進項資料等）與 銷項（PCE 銷項主檔／明細），產出申報營業稅所需之 TXT 與 T02 檔案。
| 面向 | 方向 |
|---|---|
| 期別／主體 | 依統一編號、申報期別（ROC 雙月）、營業人 |
| 進項來源 | customrecord_pce_ap_invoice、交易子列表關聯進項等 |
| 銷項來源 | customrecord_pce_ar_invoice＋明細 |
| 產出 | 申報 TXT、T02（對齊 Documentation/ 報稅 TXT Mapping 與組字範例） |
| 空白字軌／空白發票 | 依發票本（格式、字軌、期別）列印空白發票；未使用字軌／號碼彙整與申報檔銜接 |
| 入口 | Suitelet 或 Center（規劃中） |
| 與 Phase 4 區隔 | Phase 4 為申報前對帳報表；本項為正式申報檔產生 |
| 與 Phase 5 區隔 | Phase 5 為已開立憑證 PDF；本項為媒體申報檔 |
優先序：與 Phase 3 加值中心、Phase 4 對帳可並行規劃；SuiteTax 實作排在申報檔能力之後（見 SuiteTax 規劃）。
階段狀態統計
0%加權完成度
- 完成／已交付 3
- 加購 Phase 4–7（不計入完成度） 3
階段總覽
| 階段 | 藍圖定義 | 狀態 | 備註 |
|---|---|---|---|
| Phase 0 | 規格、MIG 對照、命名 | 完成 | 見 藍圖 |
| Phase 1 | 主檔、開立 Suitelet、發票本、取配號 MVP | 已交付 | 作廢、折讓核心亦在程式內；持續小修 |
| Phase 2 | Customer Deposit 轉開發票 | 已交付 | 單筆 CD、5% 反推、檢視頁開立；品名：營業人系統設定（有值）→ 模組通用 → 訂金表頭；課稅別／Suitelet 清單選 CD 不在範圍 |
| Phase 3 | 進階控管、加值中心上傳銜接、零稅率開立、權限收斂 | 進行中（3B） | Issue／Void 上傳 MR、Ack；監控與錯誤在 Portal → 加值中心（冒煙不在側欄）；sFTP 連線、三支 GUID、正式區路徑、MR 排程、開立上傳→ACK 已通過；作廢上傳→ACK 仍待驗；零稅率開立（通關方式、零稅率原因、上傳 TXT）已完成；ar-phase3.md · 換中心 |
| Phase 4 | 每期申報對帳報表（期別／統編彙整、勾稽匯出） | 未開始 | 加購。申報前對帳；規格見 藍圖 §5 |
| Phase 5 | 憑證 PDF 下載（B2B 發票、折讓、零稅率清單等） | 未開始 | 加購。入口定為查詢頁的後續，見 ar-issued-query.md。零稅率清單 PDF 仍另做 |
| Phase 6 | 銷項 CSV、AR Write RESTlet、write log | 未開始 | 加購。外部已開立憑證寫入 NS；優先序低。發票本 CSV 屬 Phase 1，不算 Phase 6 |
| Phase 7 | 開立自動化：背景／批次開立 | 部分完成 | 加購。背景自動開立發票（佇列＋MR、多筆 INV、35-07 上傳）；見 ar-auto-issue.md |
詳細範圍仍以 藍圖 §5 為準；本頁反映 程式與文件現況，若與藍圖頂部日期舊述不一致，以本頁為準。營業稅申報（TXT／T02） 見 獨立進度頁。
功能清單（驗收視角）
用途與維護說明
狀態 決議不做：產品／顧問已正式決議不在本 SuiteApp 範圍內，不是待開發項目。
加購（Phase 4–7）：可另購，不計入整體完成度。
| 項目 | 狀態 | 說明／入口 |
|---|---|---|
| PCE 銷項資料（主檔／明細 CR） | 完成 | Center → 銷項。表單：基本資訊含建立日期與最後修改；已折讓獨立成組；作廢／註銷含作廢換開 |
| 交易「發票明細」子列表 | 完成 | Sale 類交易的 PCE 銷項 分頁。唯讀。Saved Search customsearch_pce_gui_ar_details 隨 SuiteApp 部署。依銷項主檔的來源交易單據列出這張單已開立的銷項主檔。應稅、免稅、零稅率銷售額、營業稅額、總計與可折餘額有千分位 |
| PCE GUI Portal | 完成 | 側欄分組：說明、模組設定（課稅別、發票本管理）、進項、銷項（含新增開帳前銷項發票）、加值中心（上傳監控、上傳錯誤）。發票本配號設定在中心標籤，不在 Portal。未勾通用設定 銷項功能 時不顯示銷項。冒煙不在側欄 |
| Portal 銷項內頁 UI（查詢條件／workbench） | 部分完成 | 背景自動開立、作廢 workbench 單卡；加值中心上傳錯誤／監控 Bootstrap＋查詢 card（UploadErrorsHtml／UploadMonitorHtml）；開立清單／發票本仍舊版；詳 ar-portal-ui.md |
| 開立銷項發票／折讓 Suitelet | 完成 | 查詢、合併、自訂明細、POST 開立；確認頁商品明細品名可修改（最多 500 字，空白沿用原品名）；工具頁下拉可輸入關鍵字過濾；非台幣（含自訂明細；明細維持交易幣別，開立時再換算）改以外幣含稅×匯率反推台幣稅額；商品明細品名可在模組通用系統設定填搜尋欄位 ID；發票部門、分類、自定義配號預設不指定；有綁定部門／類別時才帶入發票的對應值；開立清單可再加表頭查詢欄位（含下拉與說明）；商品明細單位改抓 Units 縮寫，Search 沒有單位時改讀品項列；金額 0 的商品仍顯示並寫入明細（說明、小計、群組等非商品且金額 0 仍略過）；已作廢、已拒絕不可開立；查詢結果欄位標題可點選排序，並顯示課稅別（應稅／免稅／零稅率／混合稅）；Portal 開立完成後主檔開新分頁，iframe 留日期／買方／金額摘要與回查詢清單；交易頁首開立按鈕進入 Portal，側欄預設收合，右側為該單確認頁；開立發票的格式代號先看客戶主檔，沒填再用模組通用，兩邊都沒填則為 35-銷項一般稅額計算之電子發票，折讓單仍預設 33。折抵發票為不上傳時，折讓單預設不上傳 |
| 開立取配號（31–36、折讓 33/34） | 完成 | 部門、類別、自定義配號須與發票本完全相同，空白只對空白。折讓前綴在營業人系統設定，空白則不加前綴；取號邏輯 |
| 發票本 CR、配號、查詢／手動建立 | 完成 | 手動輸入：期別＋字軌＋起訖號已存在（含停用）則只擋該本 |
| 發票本 CSV 匯入（MR＋匯入紀錄） | 完成 | customscript_pce_sl_ar_book_csv_import；切本後只擋重複的本，其餘仍建立；同檔重複只留先出現的本 |
| 查詢已開立／作廢發票與折讓單 | 完成 | Portal → 銷項 → 查詢發票／折讓單（customscript_pce_sl_ar_doc_query）。只讀主檔；狀態只有已開立、已作廢。統一編號與憑證種類必選，一次只查發票或折讓單。可再依買方公司、課稅別、發票／折讓單號碼或 INV／CM 編號查詢。結果顯示課稅別。憑證日期可不填，不填則查全部。結果不截斷總筆數，每頁 50 筆。預設憑證日期由新到舊，點欄位標題會重排全部結果並回到第 1 頁。來源交易超過 2 筆先顯示…，移上去看全部。PDF、通知信尚未做。見 ar-issued-query.md |
| 新增開帳前銷項發票 | 完成 | Portal → 銷項 → 新增開帳前銷項發票（customscript_pce_sl_ar_open_import／MR customscript_pce_mr_ar_open_import）。模組通用須勾 銷項功能 與 新增開帳前銷項發票（custrecord_pce_modsys_ar_open_imp，預設不勾）才顯示選單。可手動新增，或 CSV 匯入。兩者都只寫主檔表頭（已開立、不上傳、勾 開帳匯入），不建明細、不上傳加值中心。作廢查詢排除。營業稅申報預設不含；通用設定有勾 新增開帳前銷項發票 時，下載頁才出現「含開帳匯入」，勾了才進 TXT／T02。查詢發票／折讓單與空白字軌仍看得到／當已使用。之後折讓依發票號碼扣可折餘額。不算 Phase 6 外部憑證 API |
| 空白未使用字軌號碼 CSV | 完成 | Portal → 營業稅申報 → 空白未使用字軌（customscript_pce_sl_ar_blank_track）。須勾產報稅檔功能。給電子發票整合服務平台，不是營業稅 81 碼 TXT。只含發票類別 07、08。已開立、已作廢、已註銷的號碼會扣掉。檔名 E0402_{統編}_{發票年月}.csv，沒有標題列 |
| 作廢 Suitelet＋lib | 完成 | 查詢結果依憑證日期由舊到新。單月 15 日（含）以前，上一期發票與折讓單仍可作廢（例如 11/15 可作廢 11510）。顧客押金來源只更新訂金發票狀態，不作廢訂金。作廢與作廢換開在主檔為待上傳時都會排入作廢上傳佇列，來源交易更新失敗也會排入。作廢換開清空來源號碼、狀態與鎖定以便重開；上傳中與 ACK 只更新主檔。帳上流程需自行 smoke |
| 主檔上傳狀態／錯誤訊息；開立→已開立＋待上傳或不上傳；作廢上傳閘道 | 完成 | resolveInitialUploadStatusId；sFTP 出站 job Phase 3A 骨架已建（規格） |
| 加值中心上傳佇列／log CR；Issue／Void／Ack MR | 進行中 | 作廢 enqueue、Void MR；上傳錯誤 Suitelet §9.3；sFTP Helper；三支 GUID、排程、開立上傳→ACK 已通過；出站檔名 INVTEXT_{統編}_{YYMMDDHHMMSS}（台灣時間），每一筆主檔一個檔，同一秒多筆時時間逐筆加 1 秒；ACK 只下載啟用中營業人統編，其他統編不下載、不改遠端；同一個 ACK 檔內每個 ElcInvData 都回寫；上傳 TXT 與下載 ACK 存進檔案櫃「PCE 加值中心交換檔」，上傳紀錄與上傳監控可開啟；作廢上傳→ACK 仍待驗 |
| 零稅率開立（通關方式、零稅率原因、上傳 TXT） | 完成 | 課稅別為零稅率（2）時，確認頁必填通關方式（1／2）與零稅率原因（71–79），寫入主檔並帶入上傳 TXT（I27、I56）。另可選出口報單類別（代碼對照 G3、G5、D1、D5、B1、B2、B8、B9、F4、F5），並可填出口報單號碼、輸出或結匯日期、證明文件名稱、證明文件號碼（選填，只存主檔，不進上傳 TXT）。背景自動開立不收集這些欄位；零稅率請改走一般開立。折讓不適用。零稅率銷售額合計既有。清單 PDF 仍屬加購 Phase 5 |
| 折讓閘道／可折餘額 | 完成 | lib＋單元測試；UI 隨開立／折讓流程 |
| 模組通用系統設定 → 銷項開關 | 完成 | Account ID 必填；名稱與設定鍵表單不可改；稅差容許正整數、預設 1（銷項共用） |
| 模組通用 → 加值中心 sFTP（主機／使用者／HostKey／路徑） | 完成 | HostKey 安裝後空白；啟用時三支 GUID 與 HostKey 必填；連線、正式區路徑、開立上傳→ACK 已通過；作廢上傳→ACK 待驗 |
| 無營業人主檔 → 銷項視為關 | 完成 | subsidiary 無 business info 則 effective AR off |
| Invoice／CM 表身銷項欄位 CS/UE | 完成 | 開立勾選、feature gate、銷項未開時 disable。使用者自行取消是否開立後，畫面儲存與再次編輯不會再勾回；變更客戶或 subsidiary 仍會重算。Make Copy 清除開立狀態／號碼／鎖定後重套 subsidiary 邏輯 |
| 交易頁「開立銷項發票／折讓」按鈕 | 完成 | 僅檢視（VIEW）；編輯頁不顯示（避免未存明細）；已作廢、已拒絕不顯示 |
| 開立／作廢 Suitelet POST feature assert | 完成 | 模組＋營業人未就緒時拒絕 |
| AP 式交易 1:N 銷項子列表 | 決議不做 | 已決；銷項用主檔 CR＋開立 Suitelet |
| Customer Deposit 轉開銷項發票 | 完成 | 檢視頁單筆開立；含稅反推（應稅 5%）；表頭品名優先序：訂金欄位 → PCE 營業人系統設定 → 模組通用；Make Copy 依營業人／通用覆寫；不可多筆 CD 合併 |
| Customer Deposit 發票商品明細設定 | 完成 | 單列自動明細＋品名層級如上；課稅別固定應稅 5%（產品定案不擴充） |
| 營業稅申報檔（TXT＋T02，進項＋銷項合併） | 完成 | PCE GUI Portal → 營業稅申報。81 碼進銷項與 83 碼零稅率可下載。銷售額與稅額申報書（TET）本來就不做。見 營業稅申報進度 |
| 每期申報對帳報表（Suitelet／匯出） | 未做 | 加購 Phase 4；申報前對帳，規劃中 |
| B2B 已開立發票 PDF 下載 | 未做 | 加購 Phase 5。入口為查詢頁第 2 段，見 ar-issued-query.md |
| 已開立折讓單 PDF 下載 | 未做 | 加購 Phase 5。同上 |
| 零稅率清單 PDF 下載 | 未做 | 加購 Phase 5 |
| 其他申報／加值中心所需 PDF | 未做 | 加購 Phase 5；類型待確認 |
| 銷項憑證 CSV 匯入（Phase 6 完整 API／明細） | 未做 | 加購 Phase 6；外部已開立憑證寫入 NS（含明細／API）。開帳表頭匯入已另交付，不算本列 |
| AR Write RESTlet／write log | 未做 | 加購 Phase 6；同上，優先序低 |
| 背景自動開立（35-07 上傳、佇列、多筆 Invoice、進度分頁） | 完成 | 加購 Phase 7。PCE GUI Portal 入口「背景自動開立」；PCE_SL_AR_AutoIssueWorkbench 分頁提交／進度；提交成功 redirect 進度分頁；未指定發票日期時依來源 Invoice trandate 遞增開立，有指定則依 internal id 遞增（佇列建立＋MR 輸入）；規格 |
| 自動／批次開立銷項發票（排程／Search） | 未做 | 加購 Phase 7 後續；與 MVP 背景按鈕區隔 |
| 自動／批次開立銷項折讓 | 未做 | 加購 Phase 7 設計規劃；與現行折讓規則對齊 |
| B1-7 歷史交易批次清勾 issue flag | 未做 | 僅文件標「未來 MR」 |
| NetSuite SuiteTax 支援（課稅別／開立） | 完成 | 模組通用 suiteTax 勾選後，開立與清單改從 Tax Details 讀稅碼、稅額，確認頁表頭稅額用明細稅額合計。Tax Details 稅額為 0、稅率不是 0 時，改以稅基×稅率或品項稅額帶入。未勾 suiteTax 的混合稅若表頭稅額被讀成 0，改用品項稅額合計。折讓未稅為負時，明細稅額也維持負號，避免和未稅×稅率差一個正負號。查詢不再使用 netamountnotax／taxamount／taxcode。課稅別對應維持既有稅碼清單，定案不改。SuiteTax 帳上已開立台幣銷項發票與折讓單。見 SuiteTax 規劃 |
使用者操作細節：SuiteApp 使用說明 §5（帳上副本：PCE_LIB_UserGuideHtml.js，改手冊時需同步）。
本機回歸（不連帳號）
npm run test:ar-phase1 # 核心：開立、取號、發票本 CSV、module-settings、交易 UE 等
npm run test:ar-allowance # 折讓
npm run test:ar-void # 作廢
npm run test:ar-custom-lines # 自訂明細
npm run test:ar-auto-issue # 背景開立佇列／MR 排程
npm run test:ar-auto-issue-monitor # 進度查詢摘要／發票日期 enrichment
npm run test:ar-auto-issue-queue-sort # 背景開立提交／MR 處理排序
npm run test:taiwan-date # UTC+8 曆日（進度頁建立日）
npm run test:workbench # Portal 殼（☰ 側欄）案數與檔案對照：Phase 1 測試清單。
相關文件（分工）
| 文件 | 何時看 |
|---|---|
本頁 PCE_GUI_MODULE_ar-status.md | 進度、做／沒做、最近變更 |
| HTML 版 | 瀏覽器檢視（由 npm run build:status-html 產生） |
| 藍圖 | 階段策略、命名、決策 §9 |
| 使用說明 §5 | 會計／顧問操作步驟 |
| 取號邏輯 | 開立取號現行規則 |
| 背景自動開立 | Phase 7 佇列、MR、進度頁 |
| Portal 銷項 UI | iframe 查詢條件／workbench 交付範圍 |
| 查詢已開立發票／折讓單 | 規劃：查詢清冊，之後同一頁下載 PDF、寄通知信 |
| Phase 3 加值中心 | MIG TXT 組檔、sFTP 上傳、ACK 抓取、三支 MR |
| 換加值中心 | 從汎宇改接另一家時要改的分層 |
| sFTP Helper | 建置 Credential GUID、Host Key、試連下載；三支 GUID 與連線已通過 |
| MIG 欄位對照 | 主檔／表身欄位 |
| Phase 1 測試清單 | 單元測試範圍 |
| 進項進度 | 進項（AP）一頁式 status |
| SuiteTax 規劃 | 課稅別對應維持既有清單；台幣發票與折讓已在 SuiteTax 帳上開立 |
變更紀錄（新列加在最上方）
| 日期 | 摘要 | Commit／備註 |
|---|---|---|
| 2026-11-12 | 發票明細的應稅、免稅、零稅率、稅額、總計、可折餘額顯示千分位 | (pending) |
| 2026-11-11 | 開立折讓確認頁：折抵發票為不上傳時，折讓單預設不上傳 | (pending) |
| 2026-11-10 | Sale 的「發票明細」子列表與 Saved Search 納入 SuiteApp | (pending) |
| 2026-11-09 | 開立發票確認頁格式代號：客戶主檔優先，否則模組通用，再否則 35 電子發票 | (pending) |
| 2026-11-06 | 混合稅表頭稅額被讀成 0 時，未開 suiteTax 改用品項稅額合計；有開時另以稅基×稅率補上。多個稅額列改加總 | (pending) |
| 2026-11-06 | 再點開立選單回到空白查詢；確認開立頁會先問是否放棄 | (pending) |
| 2026-11-06 | 銷售額與稅額申報書（TET）本來就不做；營業稅申報檔改列完成 | (pending) |
| 2026-11-05 | Portal 公司標誌改到身分列左側，與環境、使用者、角色同一行 | (pending) |
| 2026-11-05 | Portal 頁首：Company Logo (Pages) 有檔案時，標誌顯示在身分列正下方 | 27bdbbf |
| 2026-11-05 | 開帳前發票入口、通用設定核取方塊改名為「新增開帳前銷項發票」；單筆表單標題改為「手動新增」 | (pending) |
| 2026-11-04 | 營業稅申報「含開帳匯入」只在通用設定勾了顯示開帳前匯入時出現；未勾時 TXT／T02 不含開帳前匯入 | (pending) |
| 2026-11-04 | 開帳匯入顯示開關改單獨讀取，避免欄位未部署時 Portal 銷項整組消失 | (pending) |
| 2026-11-04 | 模組通用新增「新增開帳前銷項發票」；Portal／Suitelet 依此開關 | (pending) |
| 2026-11-04 | 開帳前銷項發票 CSV 匯入：主檔開帳匯入欄位、Portal 入口、MR 寫入表頭；申報／作廢排除 | 8d2f45d |
| 2026-11-04 | 課稅別對應維持既有稅碼清單，定案不改；SuiteTax 帳上已開立台幣銷項發票與折讓單 | (pending) |
| 2026-11-04 | 空白未使用字軌改到 Portal 營業稅申報，跟產報稅檔功能一起顯示 | (pending) |
| 2026-11-04 | SuiteTax 開立折讓時，明細稅額符號跟未稅金額走，不再把負稅額取成正數 | (pending) |
| 2026-11-04 | 銷項可下載電子發票 07／08 空白未使用字軌號碼 CSV | (pending) |
| 2026-11-04 | 查詢發票／折讓單改為每頁 50 筆，不再截斷總筆數 | (pending) |
| 2026-11-04 | 查詢發票／折讓單可依課稅別篩選，結果顯示課稅別 | (pending) |
| 2026-11-04 | 查詢結果欄位改為憑證號碼、憑證狀態，上傳狀態移到憑證狀態右邊 | (pending) |
| 2026-11-04 | 查詢發票／折讓單的憑證日期改為選填，都不填則查全部 | (pending) |
| 2026-11-04 | 查詢結果的來源交易超過兩筆先顯示…，滑鼠移上去顯示全部 | (pending) |
| 2026-11-03 | 查詢發票／折讓單的憑證種類改為必選，一次只查發票或折讓單 | (pending) |
| 2026-11-03 | 查詢發票／折讓單結果可點欄位標題排序，預設仍依憑證日期由新到舊 | (pending) |
| 2026-11-03 | 查詢發票／折讓單的統一編號改為必選，空白顯示請選擇營業人統編 | (pending) |
| 2026-11-03 | 查詢發票／折讓單改以統一編號、買方公司、INV／CM 編號查詢，狀態只留已開立與已作廢 | (pending) |
| 2026-11-03 | Portal 銷項新增查詢發票／折讓單（已開立、已作廢、已註銷；PDF 與通知信尚未做） | (pending) |
| 2026-11-03 | SuiteTax 確認頁表頭稅額改為 Tax Details 明細合計，不再用 amount 減 netamount | (pending) |
| 2026-11-03 | SuiteTax 開立載入交易不再查無效欄位 taxcode，稅碼改由 Tax Details 帶入 | (pending) |
| 2026-11-03 | SuiteTax 查詢發票改讀 netamount，不再查無效欄位 netamountnotax | (pending) |
| 2026-11-02 | Portal 頁首在環境名稱後顯示該列 NetSuite Account ID | (pending) |
| 2026-11-02 | Portal 不列發票本配號設定；維護改走中心標籤模組設定 | (pending) |
| 2026-10-30 | Portal 清單改以 Search 取 rectype，並用相對路徑組網址 | 69d1651 |
| 2026-10-29 | 銷項主檔與明細以外的紀錄改為不需要權限 | fe73f3a |
| 2026-10-29 | 銷項自訂紀錄權限清單補上 Administrator，才能部署 | 682e544 |
| 2026-10-29 | 銷項自訂紀錄改為權限清單，文字與長文字欄位可全域搜尋 | 2cb3344 |
| 2026-10-29 | 模組通用 suiteTax 勾選後，銷項開立與清單改從 Tax Details 讀稅 | 6e3ac89 |
| 2026-10-20 | 作廢換開清空來源號碼、狀態與鎖定，上傳中與 ACK 仍只更新主檔 | d0fcebd |
| 2026-10-20 | 使用者取消是否開立後，畫面儲存不再自動勾回 | e3bc868 |
| 2026-10-20 | 背景自動開立不收集通關方式、零稅率原因與報單 | 3841da1 |
| 2026-10-20 | 確認頁商品明細品名可修改，空白沿用原品名 | 604662b |
| 2026-10-20 | 作廢換開不更新來源交易，上傳中與 ACK 也不回寫 | 1fce793 |
| 2026-10-20 | 主檔表單：已折讓獨立成組，建立日期與最後修改放在基本資訊 | c973cc6 |
| 2026-10-20 | 作廢換開的 ACK 只更新主檔上傳狀態，不回寫來源交易 | 912e6dd |
| 2026-10-20 | 作廢與作廢換開只要待上傳就排入作廢上傳佇列，來源交易失敗也排入 | 7f7aab2 |
| 2026-10-20 | 顧客押金來源作廢改更新訂金欄位，不再出現 Invalid Record Type | 7f7aab2 |
| 2026-10-20 | 單月 15 日（含）以前，作廢仍接受上一期發票與折讓單 | 99cc173 |
| 2026-10-20 | 作廢查詢結果依憑證日期由舊到新排列 | 9b250d1 |
| 2026-10-20 | 上傳 TXT 與下載 ACK 留在檔案櫃，上傳紀錄可開啟核對 | 6f87c95 |
| 2026-10-20 | 同一個 ACK 檔內的每一筆 ElcInvData 都回寫主檔 | 3323783 |
| 2026-10-20 | 未勾銷項功能時，Portal 不顯示銷項 | 38bb60d |
| 2026-10-20 | 加值中心 sFTP 不再合併同統編，每一筆主檔各自產生一個 TXT | 3968542 |
| 2026-10-19 | Portal 可依營業人與雙月期別下載進銷項 TXT 與零稅率 T02 | fce1be4 |
| 2026-10-19 | 開立完成頁按回查詢清單時顯示處理中 | a2e019a |
| 2026-10-19 | 加值中心上傳監控按重新整理時顯示處理中 | a2e019a |
| 2026-10-19 | 加值中心出站檔名改為 INVTEXT_統編_YYMMDDHHMMSS，同統編合併不加張數 | a2e019a |
| 2026-10-19 | 開立清單查詢結果顯示課稅別：應稅、免稅、零稅率或混合稅 | 4cb4984 |
| 2026-10-19 | 交易頁首開立進入 Portal，側欄預設收合，右側為該單確認頁 | 6cd0736 |
| 2026-10-19 | 發票本手動輸入與匯入：期別、字軌、起訖號已存在則只擋該本，同列其餘仍建立 | c7d9448 |
| 2026-10-19 | 未選日期時 Chrome 與 Edge 都顯示年/月/日 | f4a129a |
| 2026-10-19 | 發票部門、分類、自定義配號預設不指定；有綁定才帶入發票值 | 56e6edc |
| 2026-10-19 | 金額 0 的商品仍顯示在開立頁並寫入明細 | 0653ff4 |
| 2026-10-19 | ACK 只下載啟用中營業人統編；其他統編不下載、不改遠端 | f13ef85 |
| 2026-10-19 | 查詢、送出與載入等待時顯示處理中動畫 | 7560a43 |
| 2026-10-19 | 開立清單總計與確認頁單價、數量、金額顯示千分位 | a019ff4 |
| 2026-10-19 | 外幣自訂明細維持交易幣別，開立時再換算台幣 | 81761bd |
| 2026-10-19 | 開立的部門、類別、自定義配號須與發票本完全相同，空白只對空白 | 902a6d7 |
| 2026-10-15 | 零稅率出口報單類別改為代碼對照下拉 | 902a6d7 |
| 2026-10-14 | 零稅率發票必填通關方式與原因，並可填報單與證明文件 | 09a3d18 |
| 2026-10-14 | 開立清單查詢結果欄位標題可點選排序 | 4d79f6a |
| 2026-10-14 | 已作廢、已拒絕（Rejected）的單據不可開立發票／折讓單 | df69b60 |
| 2026-10-14 | 商品明細單位改抓 Units 縮寫；Search 沒有單位時改讀品項列 units | df69b60 |
| 2026-10-13 | 開立清單額外查詢欄位改為欄位ID、選項來源、畫面名稱；地點等下拉改搜來源紀錄 | fd0f161 |
| 2026-10-13 | 模組通用可勾選綁定部門、綁定類別；開立時帶入來源交易的部門／類別並用來配發票本 | 9b07fe8 |
| 2026-10-13 | 開立品名來源無法當搜尋欄位時改讀紀錄值，避免有填卻仍用品名說明 | 93d1933 |
| 2026-10-13 | 開立品名來源改單獨查詢；該欄查不到時不再讓帳號對應失敗、營業人下拉變空 | 91341f7 |
| 2026-10-13 | 模組通用系統設定可填開立品名來源欄位 ID；格式不符無法儲存，查不到則改回 memo | 6dcf9c3 |
| 2026-10-13 | 進度頁查詢後切到提交背景開立再查，不再帶出進度頁結果 | 00ac4bf |
| 2026-10-13 | 背景自動開立進度頁按重設仍留在 Portal 內，不再嵌出含頁首的完整頁 | 00ac4bf |
| 2026-10-13 | 建立發票本後切到查詢分頁，統一編號與格式下拉仍有選項；手動輸入期別／字軌提示改為民國五碼與兩碼英文 | 474313c |
| 2026-10-13 | 工具頁下拉（開立、作廢、發票本、上傳錯誤、背景進度等）都可輸入關鍵字過濾 | d486ade |
| 2026-10-09 | 非台幣開立改以交易幣別含稅（fxamount）× 匯率反推台幣稅額；lookup 不再讀不支援的 subtotal | 50b0e72 |
| 2026-10-09 | 開立載入明細時排除無品項的 Custom GL Impact（外幣尾差不再要求稅碼） | 50b0e72 |
| 2026-10-08 | 零稅率開立改列 Phase 3 必做（通關方式、零稅率原因、上傳 TXT） | 49790fa |
| 2026-10-07 | Phase 4–7 列為加購，不計入整體完成度 | c82a112 |
| 2026-10-07 | 文件與架構圖對齊：Portal 加值中心、開立 ACK 已過、作廢 ACK 待驗 | 5cef3c4 |
| 2026-10-07 | 新增換加值中心修改範圍說明（現行契約為汎宇） | d8cf9e8 |
| 2026-10-07 | 模組通用設定的加值中心 sFTP HostKey 安裝後為空白，不再寫入「待產生」 | eb861a9 |
| 2026-10-07 | 加值中心 sFTP 啟用時，三支 GUID 與 HostKey 為必填 | eb861a9 |
| 2026-10-07 | 模組通用系統設定：名稱與設定鍵表單不可改；NetSuite Account ID 改為必填 | eb861a9 |
| 2026-10-07 | 開立單頭稅差容許改讀模組通用系統設定（預設 1 元，只能填正整數；表單分類為銷項共用） | f3da08c |
| 2026-10-07 | 折讓單前綴改存 PCE 營業人系統設定；空白則自動號碼不加前綴 | ed2641f |
| 2026-10-07 | Portal 側欄新增「加值中心」：上傳監控、上傳錯誤；不再掛在銷項下 | 712ba1e |
| 2026-10-07 | 加值中心上傳冒煙不顯示在 PCE GUI Portal；Suitelet 仍可直接開啟 | 86320c9 |
| 2026-10-07 | 開立、背景開立、作廢、上傳錯誤／監控、課稅別對應、發票本管理、操作手冊改由 PCE GUI Portal 進入；中心標籤只留主檔清單 | 379dbd4 |
| 2026-10-07 | 三支 GUID、正式區路徑、MR 排程、開立上傳→ACK 先標通過；作廢上傳→ACK 仍待驗 | 79622e6 |
| 2026-10-07 | 加值中心 sFTP 連線測試已通過 | (pending) |
| 2026-10-07 | Portal 開立結果頁顯示日期、格式、買方與金額摘要；明細仍開銷項資料 | d8bbbe0 |
| 2026-10-07 | Portal 開立完成標題改為「銷項發票: 號碼 已建立」或「折讓單: 號碼 已建立」 | f370013 |
| 2026-10-07 | Portal 開立完成後，銷項主檔改在新分頁開啟；iframe 留開立結果與回查詢清單 | 53d6b35 |
| 2026-10-07 | 確認開立按「回查詢清單」再進確認頁時，保留 Portal 嵌入，避免頁內再出現一層頁首 | 782177f |
| 2026-10-07 | 背景自動開立：查詢後的批次條件改為與查詢表單相同的四欄格線與輸入框 | c2054f6 |
| 2026-10-07 | 上傳監控按「上傳錯誤清單」後，Portal 左側選單改高亮加值中心上傳錯誤 | 804c824 |
| 2026-10-07 | 加值中心上傳監控拿掉 queue／log 清單連結；頁面表格已顯示進行中佇列與最近紀錄 | deaaa1d |
| 2026-10-06 | ACK 輪詢：E0501 等沒有 StatusCode 的下載檔略過並記 idempotency，不標 ParseFailed、不改上傳狀態 | b0fe72b |
| 2026-10-06 | ACK 輪詢：自訂紀錄搜尋改用 created／result.id，逐檔捕捉錯誤，避免 Array.forEach 把真正例外收成 UNEXPECTED_ERROR | b0fe72b |
| 2026-10-06 | 加值中心 sFTP：N/sftp 改傳主機名稱與埠，避免把 sftp://主機:22 當成主機名稱 | b0fe72b |
| 2026-10-06 | 模組通用設定：加值中心 sFTP HostKey 改長文字，可存完整主機金鑰 | 27289ca |
| 2026-10-06 | 開立寫入 MIG 訊息編號（35/36＝F0401、33/34＝B0101、31＝A0101）；上傳組檔時空值依格式代號補上 | 0c1ac7f |
| 2026-10-06 | 銷項與共用自訂紀錄開啟 Show Notes，上傳佇列等紀錄表單才會出現 System Notes 分頁 | 993b973 |
| 2026-10-06 | 開立上傳 MR：銷項明細品名與主檔發票類別補進欄位定義，避免 mapSellerTaxBatch 讀取 undefined.id | (pending) |
| 2026-10-06 | 加值中心上傳監控：自訂紀錄檢視連結改 url.resolveRecord，避免 SuiteQL SELECT id FROM CustomRecordType 丟出 Unknown identifier ID | (pending) |
| 2026-10-06 | 作廢查詢與背景自動開立：單號半列，日期起訖各四分之一並列 | (pending) |
| 2026-10-06 | 銷項欄位與 Map/Reduce 腳本參數補上使用者看的欄位說明（<help>） | 2bfc2ec |
| 2026-10-06 | Phase 3 建置：SFTP Helper Suitelet（SDF）＋操作說明；重構 PCE_SL_SFTP_Connections.js | 3e6cc7a |
| 2026-10-05 | 上傳錯誤清單：發票／折讓期別未查詢前預設當期雙月期別 | 7bab249 |
| 2026-10-05 | 上傳錯誤清單 DOM／fetch fragment 對齊開立（filter+結果同 host、非 embedded card、header／footer） | 7a87d06 |
| 2026-10-05 | 上傳錯誤查詢條件 UI 對齊開立頁（必填統一編號、filter card、查詢後才 Search） | 9121d64 |
| 2026-10-05 | 上傳錯誤查詢：營業人改開立同款子公司下拉；查詢 card 按鈕整併 | 9b04717 |
| 2026-10-05 | ar-phase3 §Checklist 核對：3A～3B 程式 ✅、帳上 E2E ⬜ | 805285d |
| 2026-10-05 | 上傳錯誤／監控 Suitelet Bootstrap＋查詢 card（UploadErrorsHtml／UploadMonitorHtml） | 805285d |
| 2026-10-05 | ar-phase3.md §Checklist：3A～3D 完成／未完成與建議優先順序 | 6cc3bbd |
| 2026-10-05 | modsys Entry Form custform_pce_modsys：環境／模組功能／銷項共用／sFTP 分組 | 5bae3ac |
| 2026-10-05 | modsys 三欄 sFTP passwordGuid；MR 優先 modsys、Script Parameter 後備；冒煙檢查對齊 | 0ea1ba8 |
| 2026-10-05 | §7.4 Issue／Void MR 依賣方統編分組、同統編多主檔合併 INVTEXT（_M{n} 檔名、log 註明合併主檔） | 885ee83 |
| 2026-10-05 | 上傳錯誤 Suitelet §9.3：查詢條件、完整欄位、主檔／交易連結、UploadErrorsSearch | 888d509 |
| 2026-10-05 | Ack path_done 搬移＋upload_log ACK 檔名 idempotency | 25ca3d2 |
| 2026-10-05 | 加值中心上傳監控 Suitelet（active queue、上傳中主檔、log） | f034ae0 |
| 2026-10-05 | 加值中心上傳冒煙 Suitelet（modsys 就緒、upload_log／queue 連結、JSON 匯出） | d67af22 |
| 2026-10-05 | 上傳佇列去重（pending／processing／outbound）；Ack 對帳 queue→done／failed、MessageNo 限上傳中 | 3174fe0 |
| 2026-10-05 | Phase 3B：作廢 INVTEXT、VacUploadVoid MR、作廢 enqueue、上傳錯誤 Suitelet；Center／Portal 入口 | 76f2309 |
| 2026-10-05 | Ack MR＋VacAckParser／VacAckApply；INVTEXT 組檔＋test:ar-vac-* | 7eef52e |
| 2026-10-05 | Phase 3A 骨架：upload queue／log、modsys sFTP 路徑、Vac sFTP／佇列 LIB、Issue 上傳 MR、開立 enqueue | 66d4e67 |
| 2026-10-05 | ar-phase3.md：sFTP 每 MR 一組 GUID、測試區目錄 /／ACK/、Ack 走 list.txt | `4f68059` |
| 2026-10-04 | 作廢 Suitelet 清單改 workbench 單卡（銷項發票｜折讓單 card-header-tabs、查詢條件 embedded）；Portal iframe 分頁同步頂栏 intro | 756fbdc |
| 2026-10-04 | PCE_LIB_ModuleSettings：Mapping 僅讀 custrecord_pce_modsys_ns_account（不再 Search 已刪舊欄），避免營業人統編下拉全空；未 Mapping 時 audit 日誌 | a586130 |
| 2026-10-04 | 交易新增 發票錯誤訊息（custbody_pce_ar_error_msg）：背景自動開立失敗時寫入原因，開立成功／Make Copy／作廢換開清空（Phase 3 上傳失敗共用）；狀態文字改「已開立但上傳失敗，請確認錯誤訊息」「已開立且已成功上傳大平台」及作廢對應值 | 3ddd06c／42b78fc |
| 2026-10-04 | 交易發票狀態清單：開立上傳三值改名、新增作廢上傳中／失敗／已上傳大平台；Phase 3 上傳錯誤清單與重送規格 | `4f68059` |
| 2026-10-04 | Phase 3 ACK 規則定案（C 成功、E9001–3 失敗、S0002 忽略）；出站依賣方統編分檔 | `4f68059` |
| 2026-10-04 | 模組通用：custrecord_pce_modsys_ns_account（原 …_ns_accounts）；UI「NetSuite Account ID」；Install 移轉 | 31112a0 |
| 2026-10-04 | 模組通用設定：加值中心 sFTP 主機／使用者／HostKey（正式／測試種子）；Install 補填 | e065825 |
| 2026-10-04 | ar-phase3.md 對齊汎宇文件 1／2：MIG INVTEXT、ACK01 UecML、Ack MR、狀態機；docs/reference/ PDF、docs/samples/vac-sftp/ | `4f68059` |
| 2026-10-04 | Phase 2 定案：CD 品名 PCE 營業人系統設定（custrecord_pce_bizsys_cd_line_desc）→ 模組通用；Phase 2 標 已交付 | 6da5124 |
| 2026-10-04 | 新增 ar-portal-ui.md；記錄 workbench 對齊試做（199d5a3／6658650）已 reset 至 c0e6ed7 | 217b60e |
| 2026-10-03 | Portal iframe：共用 PceShellHeader 文案 + postMessage 同步步驟／分頁頂栏 | a121bb0 |
| 2026-10-03 | Customer Deposit Make Copy：品名一律以模組通用設定覆寫（不保留來源） | 460fb80 |
| 2026-10-03 | Portal 側欄收合：☰ 按鈕 flex 置中（修正收合後偏左） | 138ff2e |
| 2026-10-03 | Customer Deposit 品名：beforeLoad 新建預填、EDIT 空白補填；Install 補 modsys 顧客押金品名 | b1ad557 |
| 2026-10-03 | 文件／手冊／AGENTS：Portal ☰ 側欄、功能入口、npm run cpd | 35acc63 |
| 2026-10-03 | Workbench 側欄：收合／展開按鈕改 ☰（取代「收合選單」文字） | be17a24 |
| 2026-10-03 | 背景 workbench：card-header-tabs 單卡 + 查詢 embedded subsection（取代 stack） | 8b09862 |
| 2026-10-03 | 背景 workbench：分頁列與查詢條件 card 視覺接合（pce-tab-root--stack） | 5be57dc |
| 2026-10-03 | 查詢條件展開：toolbar 與表單列之間加大內距 | 02b1c79 |
| 2026-10-03 | 查詢條件 card 版面：card-body 合一、展開態 header 邊線、下方間距改 sibling | fec2f09 |
| 2026-10-03 | 查詢條件 toolbar 文案「查詢條件」、與下方區塊加大間距 | 8bfcfda |
| 2026-10-03 | 修正篩選收合：改 is-open／data-pce-filter-toggle（不再用 Bootstrap Collapse） | e4054e7 |
| 2026-10-03 | 修正篩選 card 展開後無法收合（自管 toggle + collapsing CSS） | f5e9e5a |
| 2026-10-03 | 查詢條件 UI：篩選列 + 條件 badge、toolbar 重設／編輯條件（方案 A） | 01f8fad |
| 2026-10-03 | 防網格閃爍：Bootstrap preload + .pce-bootstrapping 就緒前隱藏（不覆寫 row/col） | 8f01afd |
| 2026-10-03 | 還原 FOUC body 隱藏／自訂 row 格線；查詢標題改 pce-filter-head-toggle + h5 | 1db907d |
| 2026-10-03 | 查詢條件收合：標題／摘要固定字級（避免 btn-link、small 縮字） | 70e93df |
| 2026-10-03 | 工具頁 FOUC：Bootstrap 就緒前隱藏 body + 查詢表單 critical grid／收合 CSS | 9b67eed |
| 2026-10-03 | 修正開立列表 renderListPage：listMainInner 改 let（const 重賦值 TypeError） | f00e60f |
| 2026-10-03 | 查詢 UX：fetch 局部更新結果（custpage_fragment），避免整頁重載閃屏 | d90361b |
| 2026-10-03 | 查詢 UX：進度改 POST monitor_search、收合無動畫、查詢中按鈕防連點 | 217a52d |
| 2026-10-03 | 背景進度分頁：進入不自動查詢；須按查詢（日期未填仍預設當日） | fc80375 |
| 2026-10-03 | 開立／背景提交／作廢／背景進度：查詢有結果時自動收合「查詢條件」並顯示摘要；0 筆維持展開 | fc80375 |
| 2026-10-03 | 背景自動開立：未指定發票日期依 trandate 遞增開立；有指定則依 internal id 遞增 | 1e98c08 |
| 2026-10-03 | 背景開立：提交／進度同頁預渲染（切 tab 無「載入中…」，對齊發票本／作廢） | 3eb3401 |
| 2026-10-03 | Workbench 收合側欄：僅 ☰ 展開、選單隱藏不可點（移除單字圖示） | 59883c3 |
| 2026-10-03 | Workbench 收合側欄：縮寫圖示、目前頁橘底高亮、☰ 展開按鈕 | 9470218 |
| 2026-10-03 | Portal iframe：發票本／作廢／背景開立 client-side 分頁＋進度 lazy fragment（custpage_fragment=T） | ec94a56 |
| 2026-10-03 | 作廢 Suitelet：分頁／返回查詢保留 pce_embed（Portal iframe 無雙頂栏） | 6b8ee47 |
| 2026-10-03 | Portal iframe 工作區填滿視窗高度；embed 子頁加寬 | 7742225 |
| 2026-10-03 | Portal SPA：PCE_LIB_PceLayout、Workbench iframe；開立／作廢／背景／發票本／課稅別／手冊 embed | b3d116c |
| 2026-10-03 | 方案 A：背景自動開立合併 Suitelet 分頁；Center／Portal 單一入口；提交成功導向進度 | ceff7ca |
| 2026-10-03 | 背景自動開立發票：查詢表單開始／結束日期並排同一列 | e2205e6 |
| 2026-10-03 | 操作手冊 §5.8、ar-auto-issue、README 對齊背景開立／進度與成功訊息 | 0634777 |
| 2026-10-03 | 背景開立提交成功：不顯示批次／MR 工作編號；改「已提交…→立即查看進度與結果」連結 | d6d4d83 |
| 2026-10-03 | 背景進度：拆出 PCE_LIB_AR_AutoIssueQueueMonitor（Suitelet／HTML 不載入 Issue）；建立日 Search 用 DATE、錯誤 fallback | 91888bd |
| 2026-10-03 | 背景進度：移除 date-fns bundle（修正 Suitelet 載入錯誤）；PCE_LIB_TaiwanDate 改原生 UTC+8 | 7c60f69 |
| 2026-10-03 | 背景進度：修正發票日期 Search Date 格式化、建立日預設／查詢 DATETIME、錯誤時仍顯示日期 | 8f23bff |
| 2026-10-03 | 背景進度：建立日查詢改 date-fns（Asia/Taipei）＋PCE_LIB_TaiwanDate bundle | 0f14dc6 |
| 2026-10-03 | 背景開立進度：明細發票日期改讀 PCE 主檔憑證日期；建立日期查詢預設起迄為當天 | 442c065 |
| 2026-10-03 | Customer Deposit：模組「顧客押金品名」、表頭品名欄、確認開立讀 CD；禁止多筆 CD 合併 | `8ffdd21` |
| 2026-10-03 | 背景開立進度：查詢移除批次 ID；明細改顯示發票號碼連結 PCE 銷項主檔 | 7493ef0 |
| 2026-10-03 | 背景自動開立清單：可指定發票部門／分類／自定義發票本配號（custpage_bg_*，寫入佇列 issueOptions） | 9a2abbf |
| 2026-10-03 | 背景自動開立進度 Suitelet（批次摘要、佇列明細、自動重新整理；Center／Portal／提交成功連結） | 1365b03 |
| 2026-10-02 | 合併開立：不同幣別拒絕；清單頁／伺服器強化幣別 ID 比對（缺幣別亦擋） | b24196a |
| 2026-10-02 | 修正 Make Copy 存檔：beforeSubmit 為 CREATE 時偵測開立欄位並清除；beforeLoad COPY 同步清欄 | 5fcea4e |
| 2026-10-02 | Invoice／CM／Customer Deposit Make Copy：清除 PCE 開立欄位後依 subsidiary 套用與 CREATE 相同之「是否開立」；CM COPY 亦帶入折抵發票號 | 7c35865 |
| 2026-10-02 | 銷項主檔／來源 CR 交易欄位允許 CUSTOMERDEPOSIT（訂金轉開） | 70cf942 |
| 2026-10-02 | Customer Deposit 表頭 Search：CustDep + mainline + consolidation NONE 與專用欄位 | f729e5e |
| 2026-10-02 | 修正 Customer Deposit 開立確認頁：表頭 Search 改 runMainlineSearch（非 Invoice bundle） | 8a60449 |
| 2026-10-02 | Phase 7：背景自動開立發票（多筆佇列、inv 狀態、指定日期；一般開立確認頁移除背景按鈕） | 3f6bbc9 |
| 2026-10-01 | 折讓寫入 PCE 商品明細數量存正數（與 AD 金額一致；CM Search 負數量取 abs） | 00ddbe3 |
| 2026-10-02 | Phase 7 MVP：背景自動開立 Suitelet／Center／Portal＋ PCE_MR_AR_IssueBackground（35-07 上傳） | 9acf987 |
| 2026-10-01 | 開立表頭／CM 明細改 bundle Search 正負（INV/CM 取消 lookup；CM 不做 abs；折讓確認頁顯示 Search 符號） | acd3f0b |
| 2026-10-01 | 單頭稅差應稅未稅合計改代數加總（Discount 負未稅不再 abs 誤加） | 07d5ae1 |
| 2026-10-01 | 開立 bundle Search 增 creditamount／debitamount；INV 負額 credit 轉正、Discount 缺 quantity 依 amount／rate 推算 | 36b4464 |
| 2026-10-01 | 合併開立稅差改加總比對；稅差錯誤訊息改「稅額 … 應稅商品之未稅金額合計×稅率」 | 4ecb2a9 |
| 2026-10-01 | 開立單頭稅差：改為應稅未稅合計×稅率；相差 >1 元阻擋開立並提示調整 NS 發票稅額 | 676fbea |
| 2026-10-01 | 修正開立確認頁「找不到來源交易」：bundle Search 表頭列 mainline=* 亦視為表頭 | fcef9ab |
| 2026-10-01 | 淨額開立單頭稅差改加總比對（INV／CM 明細與 NS 稅額代數加總，非逐單） | 80dd1c6 |
| 2026-10-01 | 開立寫入 PCE 明細：發票保留正負（Discount／淨額 CM 為負）；折讓 AD 仍存正數；MR 帶 storePositiveLineAmounts | f1cb1f6 |
| 2026-10-01 | 開立清單 Search 僅 mainline（amount／netamountnotax）；bundle 仍多列含 TaxItem／明細 | 2f997eb |
| 2026-10-01 | 開立來源 Search：表頭＋明細合併為 bundle（consolidationtype NONE、cogs/shipping F、amount/netamountnotax/taxamount）；同一 request 只跑一次 Search | 2f997eb |
| 2026-10-01 | 開立明細稅：tax1amt 無法 Search，改 record.load 依 line key；HTML 跳脫集中 PCE_LIB_HtmlEscape | 64dfb44 |
| 2026-09-27 | 開立明細稅額：優先 NS tax1amt（交易幣別）；外幣 fallback 修正；折讓不再 AD11 覆寫 | 512df90 |
| 2026-09-27 | 折讓明細：單價正數；AD11 稅額依未稅×稅率推算並對齊單頭（帳上若仍為此版，請再部署上列 tax1amt 修正） | 35091bb |
| 2026-09-27 | 折讓確認頁表頭／明細金額以負數顯示；開立主檔仍寫正數 | 9e5abe0 |
| 2026-09-24 | 折讓 33／34：未填號碼時自動產生 PCE＋13 碼，查重重試至唯一 | c957e62 |
| 2026-09-24 | 折讓開立：16 碼折讓證明單號僅寫 allowance_no，不寫 invoice_no | fc8efe2 |
| 2026-09-24 | 開立確認頁 POST 修正：避免 custpage_action=form 殘留導致無法開立 | a1a6745 |
| 2026-09-24 | CM 自 Invoice 建立：清除複製 PCE 狀態／號碼，帶入折抵發票號碼 | 2d42f53 |
| 2026-09-24 | 作廢部分成功提示：依 vacUpload 指定還原上傳狀態文案 | 66c9b0a |
| 2026-09-24 | 作廢部分成功提示：重試須還原上傳狀態（上傳成功／不上傳） | fbc3091 |
| 2026-09-24 | 發票本查詢 NS 篩選：35-07 改格式時預設全部；移除欄位提示 | fb0723f |
| 2026-09-24 | 發票本查詢：非 35-07 格式時 NS→加值中心 篩選僅「否」 | 3aaa3b9 |
| 2026-09-24 | PCE 發票狀態新增不透過NS上傳（開立／作廢）並回寫交易 | 3fb6b04 |
| 2026-09-24 | 作廢後上傳狀態：原不上傳維持不上傳，其餘改待上傳 | 424f2cb |
| 2026-09-24 | 作廢查詢結果憑證日期改以 search getValue 格式化顯示 | 0fecfa1 |
| 2026-09-24 | PCE 發票狀態選項更名＋新增已作廢等待上傳；作廢回寫交易狀態 | d7ba341 |
| 2026-09-24 | 銷項主檔表單新增「加值中心資訊」區塊（vac 上傳／上傳狀態／錯誤訊息） | 9635568 |
| 2026-09-24 | 帳內工具頁／操作手冊移除 PwC logo；docs/html 實作進度頁保留 | 783e1b7 |
| 2026-09-24 | 手冊 §1.2／§5.7 索引、取號文件 §3.2.1 連結、README、UserGuideHtml FAQ | 9c5fcda |
| 2026-09-24 | 開立依 vacUpload 寫主檔待上傳或不上傳；手冊 §3.2.1／§5.7、欄位對照、UserGuideHtml | c21bae6 |
| 2026-09-23 | 銷項主檔上傳狀態／錯誤訊息；開立已開立；作廢限上傳成功或不上傳 | 7e470e7 |
| 2026-09-23 | 發票本查詢/更新：修正 lookupFields 陣列解析，儲存 NS／狀態不再誤判鎖定 | 1e74fa2 |
| 2026-09-23 | 發票本查詢/更新：結果顯示 NS→加值中心；單本「調整設定」可改 NS（僅未使用 35-07）與狀態（僅未使用/停用） | 8210dc1 |
| 2026-09-23 | 發票本手動輸入：35-07 可選「是否透過 NS 傳至加值中心」（同 CSV nsToPlatform） | f9dc05e |
| 2026-09-21 | 表身／主檔備註改 Long Text；模組 Account IDs 改 Free-Form Text | 2e34ebb／47f801c |
| 2026-09-21 | INV／CM／訂金表身總備註；確認開立頁發票備註預填 | 2e34ebb |
| 2026-09-21 | Customer Deposit 開立：表頭稅額改反推值；整數未稅；驗證未稅＋稅＝訂金 | 8d8c457 |
| 2026-09-21 | Customer Deposit：存檔讀 customer 自動勾選開立；按鈕須已勾選 | 90bfa30 |
| 2026-09-21 | Customer Deposit 轉開：含稅反推、預設品名顧客押金、UE 與表身欄位 | ab02ac3 |
| 2026-09-18 | 自訂明細開立合併：品名不同則不合併（品項＋單價＋課稅別＋品名） | 516e61c |
| 2026-09-18 | 確認開立頁明細備註自 INV／CM 預填；空 lineRemarks 不覆蓋來源備註 | 50fa3dd |
| 2026-09-17 | 新增 Phase 7：自動／批次開立銷項發票與折讓（設計規劃） | d5167fb |
| 2026-09-17 | Phase 3 移除空白發票備註（僅列營業稅申報頁） | （pending） |
| 2026-09-17 | 空白字軌／空白發票下載改列營業稅申報進度；Phase 3 移除該項 | fc33a02 |
| 2026-09-17 | 營業稅申報改獨立進度頁＋頂部導覽分頁（進銷項合併 TXT／T02） | 49442f0 |
| 2026-09-17 | 全 SuiteApp 用語稽核：落地→已交付、煙測/煙霧→冒煙、開立程序→開立流程、透過 NS 空格 | （pending） |
| 2026-09-17 | 用語：SuiteTax「適配」改「支援」（進度頁／索引／規劃文件） | 0d7d545 |
| 2026-09-17 | 功能清單「決議不做」列：徽章、整列樣式、圖表圖例（不計完成度） | e828a92 |
| 2026-09-17 | AR 進度頁用語：分期改為階段（表格、stepper、圖表） | 92b43bd |
| 2026-09-17 | 進度頁／藍圖用語改台灣繁體（掛、擴充、比照 AP Write 等） | f8878ad |
| 2026-09-17 | 新增 Phase 5 憑證 PDF 下載；原 CSV／Write API 改 Phase 6 | （pending） |
| 2026-09-17 | 定案不做 AP 式 Invoice/CM 1:N 銷項子列表；Phase 2 聚焦 Customer Deposit 轉開 | a1f3477 |
| 2026-09-17 | Phase 2 納入 Customer Deposit 轉開（含稅反推、可設定發票明細） | （pending） |
| 2026-09-17 | 新增 Phase 4 每期申報對帳報表；原 CSV／Write API 改 Phase 5 | （pending） |
| 2026-09-17 | Phase 5 敘述：外部已開立發票寫入 NS、優先序低於 Phase 1–4 | （pending） |
| 2026-09-17 | 藍圖／status：Phase 3 與 Phase 4 對調（強化合規前移、CSV／API 後移） | （pending） |
| 2026-09-17 | 用語統一為加值中心（Phase 3、文件／UI 標籤；取代關網、大平台） | dbfd706 |
| 2026-09-17 | 進度頁納入 SuiteTax 規劃（功能列＋文件連結） | （pending） |
| 2026-09-17 | Center 分類「工作台」改為「功能入口」 | fe6dac6 |
| 2026-09-17 | PCE GUI Portal 更名並精簡使用者可見文案（Center／手冊／入口頁） | fa1b3eb |
| 2026-09-17 | 工作台左側選單＋panel 導向修正；銷項工具頁可返回 Portal | b9d321f |
| 2026-09-17 | PCE 全功能工作台（Center「工作台→全功能入口」；Portlet 捷徑） | 0d4d8d9 |
| 2026-09-17 | 開立／作廢／發票本管理 Bootstrap 頁配色對齊操作手冊（共用 PCE_LIB_PceTheme） | 098e6c0 |
| 2026-09-17 | 操作手冊 Suitelet／Portlet 配色與進度頁一致（PwC 橙＋白底頂列） | e90bbdc |
| 2026-09-17 | 進度頁 Logo 改去背 mark、頂部白底＋橙底線（對齊簡報） | 4945c94 |
| 2026-09-17 | 進度 HTML 頂部列加入簡報 PwC logo | eae556c |
| 2026-09-17 | 進度頁 PwC 簡報配色；維護用語改 CP／CPD | bf4ee74 |
| 2026-09-17 | HTML 進度頁嵌入藍圖 §5 Phase 細項；分期 stepper 顯示定義／備註 | 7820bb8 |
| 2026-09-17 | 新增本進度頁；整理 Phase 1 交付與 Phase 2 部分、Phase 3 未開始 | （本 commit） |
| 2026-09-17 | 帳內操作手冊 HTML 與 markdown 規則同步（模組設定、檢視頁開立、營業人 gate） | 1393d24 |
| 2026-09-17 | 開立按鈕僅 VIEW；UE 單元測試 | 4cd305d |
| 2026-09-17 | 無 PCE 營業人主檔則 effective 銷項關閉 | 36bd6f3 |
| 2026-09-17 | AR feature gate：UI、Suitelet POST、CS/UE 連動 | 8ac2311 |
維護 checklist（CP／CPD 前，有銷項變更時）
- 本頁「摘要一句」仍正確？
- 「功能清單」或「階段總覽」需改狀態？
- 「變更紀錄」加一列（日期＋一句＋commit）？
- 使用者可見行為是否也要改 使用說明 §5 與
PCE_LIB_UserGuideHtml.js？ - 取號規則變更是否更新 ar-invoice-numbering.md？
- 新／改測試是否更新 ar-phase1-tests.md 或
package.jsonscripts？ - 執行
npm run build:status-html更新docs/html/PCE_GUI_MODULE_ar-status.html與docs/html/index.html？
由 npm run build:status-html 自 Markdown 產生；來源：docs/PCE_GUI_MODULE_ar-status.md。修改進度請先改 Markdown 再重建 HTML。