進項（AP）實作進度

用途與維護說明

用途：查「目前做到哪、還缺什麼」，不必翻 commit 或問人。

維護：凡 進項相關 功能／SDF／行為文件有交付意義的變更，CP／CPD 前更新本頁「摘要一句」＋「變更紀錄」至少一列（可附 commit hash）。

對象：產品／顧問／開發

摘要一句

進項核心已上線（交易子列表、PCE 進項資料 CR、CSV 匯入、AP Write RESTlet、呼叫紀錄、驗證 CS/UE）；模組通用系統設定 的 apFeature 已在 PCE_LIB_ModuleSettings 可解析，但 CSV／RESTlet／交易 UI 尚未全面接 effective 進項 gate（使用說明 A0 仍註「進項 Phase 尚未全面接線」）；營業稅申報檔（TXT／T02） 見營業稅申報進度；加值中心上傳 不在進項現行交付範圍。

進度圖表

依本頁 Markdown 表格自動計算；更新 PCE_GUI_MODULE_ap-status.md 後執行 npm run build:status-html 同步。

整體進度

0%加權完成度

完成／已交付 19
部分／未全面 3
未做／未開始 1

共 23 項計入完成度（完成=1、進行中／部分=0.5、未做=0）

功能清單（驗收）

0%加權完成度

完成／已交付 12
部分／未全面 1

共 13 項計入完成度（完成=1、進行中／部分=0.5、未做=0）

能力總覽

0%加權完成度

完成／已交付 7
部分／未全面 2
未做／未開始 1

共 10 項計入完成度（完成=1、進行中／部分=0.5、未做=0）

能力總覽（相對銷項藍圖）

進項無獨立「階段藍圖」文件；本表以 實際程式＋使用說明 對齊。銷項階段見 AR status。

區塊	狀態	備註
交易掛載（VB／ER／VC／VP 子列表）	已交付	`custtab_pce_trx_einvoice`
PCE 進項資料 CR	已交付	可獨立維護或自交易建立
進項 CSV 匯入 Suitelet	已交付	validateOnly／寫入、範本下載
AP Write RESTlet	已交付	OAuth 2.0 Bearer；見 API 文件
進項匯入／呼叫紀錄	已交付	`customrecord_pce_ap_write_log`
驗證、lookup、期別、欄位 CS/UE	已交付	`PCE_LIB_AP_Validate` 等
課稅別 NS 稅碼對應	已交付	進銷項共用；現行 Legacy Tax；Suitelet 維護
NetSuite SuiteTax（共用課稅別／開立）	未做	SuiteTax 規劃；產營業稅檔完成後；導入時定案稅制
模組通用系統設定 → 進項開關	部分	lib：`isApFeatureEnabledForSubsidiary`；腳本/UI 未全面 assert
無營業人 → 進項 effective	部分	無 subsidiary 營業人時 AR 強制 off；AP 仍依模組／biz 設定解析（與 AR 不對稱）

功能清單（驗收視角）

項目	狀態	說明／入口
Center → 功能入口 → PCE GUI Portal	完成	`customscript_pce_sl_workbench`；集中連結＋各頁「返回 PCE GUI Portal」
Center → 進項（進項資料、CSV 匯入）	完成	`custcentercategory_pce_ap`
交易 PCE 進項資料子列表	完成	CS：`customscript_pce_cs_trans_ap_sublist`
PCE 進項資料 CR＋預設 UE	完成	`customrecord_pce_ap_invoice`
進項 CSV 匯入（含 replay harness 測試）	完成	`customscript_pce_sl_ap_csv_import`
AP Write RESTlet（transactionOnly 等）	完成	`customscript_pce_rl_ap_write`
Write log 寫入與對帳	完成	`PCE_LIB_AP_WriteLog`
AP Write Smoke／Installation smoke	完成	Suitelet + 帳上結果見 `docs/README.md`
Vendor 統編 CS/UE	完成	8 碼檢核
外部介接文件（中／英）+ Postman	完成	`docs/PCE_GUI_MODULE_ap-write-api-*`
模組通用系統設定（Account mapping）	完成	種子 CR；未 mapping 帳號全模組關
模組／營業人 → 擋 CSV／API／子列表（進項 off）	未全面	待 B3 類接線（對齊銷項 gate 模式）
使用說明 §5.1–5.4 進項日常	完成	帳內副本 `PCE_LIB_UserGuideHtml.js`

使用者操作細節：SuiteApp 使用說明 §5.1 起（進項）；API：介接手冊。

本機回歸（不連帳號）

npm run test:ap-validate
npm run test:ap-write-payload
npm run test:ap-write-return-code
npm run test:ap-csv
npm run test:ap-csv-import-replay
node --test test/ap-lookup.test.js
npm run test:module-settings    # 模組 mapping／apFeature 解析

全專案：npm test（含 AP + AR）。

帳上 smoke 紀錄：docs/README.md § Account smoke results。

相關文件（分工）

文件	何時看
本頁 `PCE_GUI_MODULE_ap-status.md`	進度、做／沒做、變更紀錄
HTML 版	瀏覽器檢視（由 `npm run build:status-html` 產生）
使用說明 §4–§5 進項	會計／顧問操作
AP Write 介接手冊	外部廠商
AP Write 技術手冊	內部／顧問、錯誤碼
銷項進度	銷項階段（對照用）
營業稅申報進度	TXT／T02、空白字軌（跨進銷項）
SuiteTax 規劃	NetSuite SuiteTax（進銷項共用課稅別對應；規劃中）

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

日期	摘要	Commit／備註
2026-09-17	能力總覽移除申報檔、AR Write 列（改見營業稅申報／銷項 Phase 6）	（pending）
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	進項 CSV、課稅別對應等 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；Agent 規則 CP vs CPD	`bf4ee74`
2026-09-17	新增本進度頁；整理進項已交付 vs 模組 gate 未全面接線	`6539327`

維護 checklist（CP／CPD 前，有進項變更時）

本頁「摘要一句」仍正確？
「能力總覽」或「功能清單」需改狀態？
「變更紀錄」加一列（日期＋一句＋commit）？
使用者可見行為是否也要改使用說明進項段落與 PCE_LIB_UserGuideHtml.js？
RESTlet 契約／錯誤碼是否更新 technical／integration guide？
帳上 smoke 有新意義結果是否更新 docs/README.md 或 test/results/*.json 引用？
執行 npm run build:status-html 更新 docs/html/PCE_GUI_MODULE_ap-status.html 與 docs/html/index.html？

由 npm run build:status-html 自 Markdown 產生；來源：docs/PCE_GUI_MODULE_ap-status.md。修改進度請先改 Markdown 再重建 HTML。