# PCE TW GUI MODULE — 銷項（AR）實作進度（一頁式）

> **用途**：查「目前做到哪、還缺什麼」，不必翻 commit 或問人。  
> **維護**：凡 **銷項相關** 功能／SDF／行為文件有交付意義的變更，**CP／CPD 前**更新本頁「摘要一句」＋「變更紀錄」至少一列（可附 commit hash）。  
> **對象**：產品／顧問／開發  
> **最後更新**：2026-09-17

---

## 摘要一句

**Phase 1 已可上線使用**（主檔、開立、發票本、取配號、作廢 UI／核心、發票本 CSV）；**模組通用系統設定＋營業人主檔** 已 gate 銷項；**Invoice／Credit Memo 表身欄位與檢視頁開立** 已交付（**不做** AP 式 1:N 子列表）；**Phase 4–6** 與 **Phase 7 自動／批次開立**（設計規劃）**皆規劃中、尚未開始**。

---

## 階段總覽

| 階段 | 藍圖定義 | 狀態 | 備註 |
|------|----------|------|------|
| Phase 0 | 規格、MIG 對照、命名 | **完成** | 見 [藍圖](./PCE_GUI_MODULE_ar-blueprint.md) |
| Phase 1 | 主檔、開立 Suitelet、發票本、取配號 MVP | **已交付** | 作廢、折讓核心亦在程式內；持續小修 |
| Phase 2 | Customer Deposit 轉開發票 | **進行中** | Inv/CM 維持表身＋Suitelet；**不做** AP 式 1:N 子列表 |
| Phase 3 | 進階控管、加值中心上傳銜接、權限收斂 | **未開始** | |
| Phase 4 | 每期申報對帳報表（期別／統編彙整、勾稽匯出） | **未開始** | 申報前對帳；規格見 [藍圖 §5](./PCE_GUI_MODULE_ar-blueprint.md#5-分期藍圖) |
| Phase 5 | 憑證 PDF 下載（B2B 發票、折讓、零稅率清單等） | **未開始** | 已開立憑證；其他所需 PDF 依需求增列 |
| Phase 6 | 銷項 CSV、AR Write RESTlet、write log | **未開始** | **外部已開立**憑證寫入 NS；優先序低。發票本 CSV 屬 Phase 1，**不算** Phase 6 |
| Phase 7 | 開立自動化（設計規劃）：自動／批次開立銷項發票、銷項折讓 | **未開始** | 與 Phase 6（外部寫入）區隔；見 [藍圖 §5](./PCE_GUI_MODULE_ar-blueprint.md#5-分期藍圖) |

詳細範圍仍以 [藍圖 §5](./PCE_GUI_MODULE_ar-blueprint.md#5-分期藍圖) 為準；本頁反映 **程式與文件現況**，若與藍圖頂部日期舊述不一致，**以本頁為準**。**營業稅申報（TXT／T02）** 見 [獨立進度頁](./PCE_GUI_MODULE_vat-filing-status.md)。

---

## 功能清單（驗收視角）

> 狀態 **決議不做**：產品／顧問已正式決議不在本 SuiteApp 範圍內，**不是**待開發項目。

| 項目 | 狀態 | 說明／入口 |
|------|------|------------|
| PCE 銷項資料（主檔／明細 CR） | 完成 | Center → 銷項 |
| PCE GUI Portal | 完成 | Center → 功能入口 → PCE GUI Portal；集中連結各銷項／設定工具 |
| 開立銷項發票／折讓 Suitelet | 完成 | 查詢、合併、自訂明細、POST 開立 |
| 開立取配號（31–36、折讓 33/34） | 完成 | [取號邏輯](./PCE_GUI_MODULE_ar-invoice-numbering.md) |
| 發票本 CR、配號、查詢／手動建立 | 完成 | 模組設定／發票本相關 Suitelet |
| 發票本 CSV 匯入（MR＋匯入紀錄） | 完成 | `customscript_pce_sl_ar_book_csv_import` |
| 作廢 Suitelet＋lib | 完成 | 帳上流程需自行 smoke |
| 折讓閘道／可折餘額 | 完成 | lib＋單元測試；UI 隨開立／折讓流程 |
| 模組通用系統設定 → 銷項開關 | 完成 | Account ID mapping；`PCE_LIB_ModuleSettings` |
| 無營業人主檔 → 銷項視為關 | 完成 | subsidiary 無 business info 則 effective AR off |
| Invoice／CM 表身銷項欄位 CS/UE | 完成 | 開立勾選、feature gate、銷項未開時 disable |
| 交易頁「開立銷項發票／折讓」按鈕 | 完成 | **僅檢視（VIEW）**；編輯頁不顯示（避免未存明細） |
| 開立／作廢 Suitelet POST feature assert | 完成 | 模組＋營業人未就緒時拒絕 |
| AP 式交易 1:N 銷項子列表 | **決議不做** | 已決；銷項用主檔 CR＋開立 Suitelet |
| Customer Deposit 轉開銷項發票 | 未做 | Phase 2；訂金總額視為含稅，反推未稅／稅額 |
| Customer Deposit 發票商品明細設定 | 未做 | Phase 2；客戶可設定預設明細範本（規格見藍圖 §5） |
| 營業稅申報檔（TXT＋T02，進項＋銷項合併） | 未做 | [營業稅申報進度](./PCE_GUI_MODULE_vat-filing-status.md) |
| 每期申報對帳報表（Suitelet／匯出） | 未做 | Phase 4；申報前對帳，規劃中 |
| B2B 已開立發票 PDF 下載 | 未做 | Phase 5 |
| 已開立折讓單 PDF 下載 | 未做 | Phase 5 |
| 零稅率清單 PDF 下載 | 未做 | Phase 5 |
| 其他申報／加值中心所需 PDF | 未做 | Phase 5；類型待確認 |
| 銷項憑證 CSV 匯入 | 未做 | Phase 6；外部已開立發票寫入 NS |
| AR Write RESTlet／write log | 未做 | Phase 6；同上，優先序低 |
| 自動／批次開立銷項發票 | 未做 | Phase 7 設計規劃；排程／MR 或 Workflow 等待選型 |
| 自動／批次開立銷項折讓 | 未做 | Phase 7 設計規劃；與現行折讓規則對齊 |
| B1-7 歷史交易批次清勾 issue flag | 未做 | 僅文件標「未來 MR」 |
| NetSuite SuiteTax 支援（課稅別／開立） | 未做 | [SuiteTax 規劃](./PCE_GUI_MODULE_suitetax-plan.md)；**營業稅申報檔**完成後排程；導入時定案 Legacy／SuiteTax |

使用者操作細節：[SuiteApp 使用說明 §5](./PCE_GUI_MODULE_suiteapp-user-guide.md)（帳上副本：`PCE_LIB_UserGuideHtml.js`，改手冊時需同步）。

---

## 本機回歸（不連帳號）

```bash
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    # 自訂明細
```

案數與檔案對照：[Phase 1 測試清單](./PCE_GUI_MODULE_ar-phase1-tests.md)。

---

## 相關文件（分工）

| 文件 | 何時看 |
|------|--------|
| **本頁** `PCE_GUI_MODULE_ar-status.md` | 進度、做／沒做、最近變更 |
| [HTML 版](./html/PCE_GUI_MODULE_ar-status.html) | 瀏覽器檢視（由 `npm run build:status-html` 產生） |
| [藍圖](./PCE_GUI_MODULE_ar-blueprint.md) | 階段策略、命名、決策 §9 |
| [使用說明 §5](./PCE_GUI_MODULE_suiteapp-user-guide.md) | 會計／顧問操作步驟 |
| [取號邏輯](./PCE_GUI_MODULE_ar-invoice-numbering.md) | 開立取號現行規則 |
| [MIG 欄位對照](./PCE_GUI_MODULE_ar-field-map-mig41.md) | 主檔／表身欄位 |
| [Phase 1 測試清單](./PCE_GUI_MODULE_ar-phase1-tests.md) | 單元測試範圍 |
| [進項進度](./PCE_GUI_MODULE_ap-status.md) | 進項（AP）一頁式 status |
| [SuiteTax 規劃](./PCE_GUI_MODULE_suitetax-plan.md) | NetSuite SuiteTax 支援（規劃中，非 AR 階段內交付） |

---

## 變更紀錄（新列加在最上方）

| 日期 | 摘要 | Commit／備註 |
|------|------|----------------|
| 2026-09-17 | 新增 Phase 7：自動／批次開立銷項發票與折讓（設計規劃） | （pending） |
| 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_GUI_MODULE_suiteapp-user-guide.md) 與 `PCE_LIB_UserGuideHtml.js`？
- [ ] 取號規則變更是否更新 [ar-invoice-numbering.md](./PCE_GUI_MODULE_ar-invoice-numbering.md)？
- [ ] 新／改測試是否更新 [ar-phase1-tests.md](./PCE_GUI_MODULE_ar-phase1-tests.md) 或 `package.json` scripts？
- [ ] 執行 `npm run build:status-html` 更新 `docs/html/PCE_GUI_MODULE_ar-status.html` 與 `docs/html/index.html`？