用途與維護說明
用途：查「目前做到哪、還缺什麼」，不必翻 commit 或問人。
維護：凡 進項相關 功能／SDF／行為文件有交付意義的變更，CP／CPD 前更新本頁「摘要一句」＋「變更紀錄」至少一列（可附 commit hash）。
對象：產品／顧問／開發
摘要一句
進項核心已上線（交易子列表、PCE 進項資料 CR、CSV 匯入、AP Write RESTlet、呼叫紀錄、驗證 CS/UE）。公版 AP Write 只有 apInvoiceOnly、transactionOnly、transactionWithApInvoices。API進項審核、API進項資料、stageApIntake／updateApIntake，以及請購單 createPurchaseReq／updatePurchaseReq（custompurchase_dfo_purchase_req）不在公版；需要的客戶部署 Client/DFO-SB。Portal 在已勾 進項功能 時顯示進項 CSV，不顯示進項資料清單（中心標籤仍保留）。進項資料可勾 已申報；CSV 欄位 filed 可在新建時寫入，既有資料用 NetSuite CSV 匯入更新。另有獨立的 交易建立 RESTlet（customscript_pce_rl_tx_create），只建立 Vendor Bill／Expense Report／Vendor Credit／Vendor Prepayment，不寫進項憑證、不共用 AP Write 函式庫。模組通用系統設定 的 apFeature 已在 PCE_LIB_ModuleSettings 可解析，但 CSV／RESTlet／交易 UI 尚未全面接 effective 進項 gate（使用說明 A0 仍註「進項 Phase 尚未全面接線」）；營業稅申報檔（TXT／T02） 見 營業稅申報進度；加值中心上傳 不在進項現行交付範圍。模組通用勾選 suiteTax 後，AP Write 與交易建立改把稅寫入 Tax Details。課稅別對應維持既有稅碼清單，定案不改。財政部公告字軌可在 PCE GUI Portal → 模組設定 → 財政部年度字軌 查詢、手動新增或 CSV 匯入。進項資料、營業人、模組通用與營業人系統設定仍為權限清單，目前只有 Administrator。進項呼叫紀錄與交易建立紀錄改為不需要權限。文字與長文字欄位可全域搜尋。
進度圖表
依本頁 Markdown 表格自動計算；更新 PCE_GUI_MODULE_ap-status.md 後執行 npm run build:status-html 同步。
整體進度
0%加權完成度
- 完成／已交付 20
- 部分／未全面 7
功能清單（驗收）
0%加權完成度
- 完成／已交付 12
- 部分／未全面 3
能力總覽
0%加權完成度
- 完成／已交付 8
- 部分／未全面 4
能力總覽（相對銷項藍圖）
進項無獨立「階段藍圖」文件。公版不含 API進項審核與請購單。本表以 實際程式＋使用說明 對齊。銷項階段見 AR status。
| 區塊 | 狀態 | 備註 |
|---|---|---|
| 交易掛載（VB／ER／VC／VP 子列表） | 已交付 | custtab_pce_trx_einvoice |
| PCE 進項資料 CR | 已交付 | 可獨立維護或自交易建立 |
| 進項 CSV 匯入 Suitelet | 已交付 | validateOnly／寫入、範本下載；入口為 PCE GUI Portal → 進項 |
| AP Write RESTlet | 部分 | OAuth 2.0 Bearer。公版三種 action：apInvoiceOnly、transactionOnly、transactionWithApInvoices。尚未帳上驗證。見 API 文件 |
| 交易建立 RESTlet | 已交付 | 只建交易；見 交易建立介接 |
| 進項匯入／呼叫紀錄 | 已交付 | customrecord_pce_ap_write_log；不需要權限。相同 requestId 的成功寫入會回上次結果 |
| 財政部年度字軌 | 已交付 | Portal → 模組設定 → 發票本管理下方。查詢、手動新增、CSV 匯入 customrecord_pce_mof_track。已存在（含停用）略過且不重新啟用。customscript_pce_sl_mof_track |
| 驗證、lookup、期別、欄位 CS/UE | 已交付 | PCE_LIB_AP_Validate。逐條規則見 進項憑證檢核。交易子列表、進項資料 CS 與驗證 UE 的 Audience 含 Employees；部署覆寫後，選格式 28／29 會反灰不該填的欄位，空白海關繳納證號碼擋存檔。發票號碼重複比對正式進項。帳上若有 API進項資料，待審與轉入失敗也列入 |
| 課稅別 NS 稅碼對應 | 已交付 | 進銷項共用；現行 Legacy Tax；Suitelet 維護 |
| NetSuite SuiteTax（共用課稅別／開立） | 部分 | 模組通用 suiteTax 勾選後，AP Write 與交易建立把明細稅碼、稅額寫入 Tax Details，不寫 tax1amt。未勾或交易沒有 Tax Details 時維持 Legacy。課稅別對應維持既有稅碼清單，定案不改。銷項台幣發票與折讓已在 SuiteTax 帳上開立。見 SuiteTax 規劃 |
| 模組通用系統設定 → 進項開關 | 部分 | Portal 側欄與總覽依已 Mapping 設定的 進項功能 顯示或隱藏。lib：isApFeatureEnabledForSubsidiary；CSV／RESTlet／交易 UI 尚未全面 assert |
| 無營業人 → 進項 effective | 部分 | 無 subsidiary 營業人時 AR 強制 off；AP 仍依模組／biz 設定解析（與 AR 不對稱） |
功能清單（驗收視角）
| 項目 | 狀態 | 說明／入口 |
|---|---|---|
| Center → 功能入口 → PCE GUI Portal | 完成 | SPA 殼（☰ 收合／展開；收合時選單隱藏）。未勾通用設定 進項功能 時不顯示進項。不顯示進項資料清單。已勾進項功能時顯示進項 CSV。子頁 pce_embed=T 省略 PCE 頂栏 |
| Center → 進項（進項資料） | 完成 | custcentercategory_pce_ap 只列 PCE 進項資料。Portal 不顯示這份清單 |
| 交易 PCE 進項資料 子列表 | 完成 | CS：customscript_pce_cs_trans_ap_sublist。Audience 含 Employees；未部署前選 28 不會反灰 |
| PCE 進項資料 CR＋預設 UE | 完成 | customrecord_pce_ap_invoice；存取為權限清單，目前只有 Administrator。發票號碼等文字欄位可全域搜尋。可勾 已申報（custrecord_pce_ap_tax_filed） |
| 進項 CSV 匯入（含 replay harness 測試） | 完成 | customscript_pce_sl_ap_csv_import。已勾 進項功能 時 Portal 顯示 |
| AP Write RESTlet（transactionOnly 等） | 部分 | customscript_pce_rl_ap_write。公版三種 action。API進項審核與請購單不在公版 |
| 交易建立 RESTlet | 完成 | customscript_pce_rl_tx_create；不寫進項憑證。呼叫紀錄 customrecord_pce_tx_create_log 不需要權限 |
| 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 |
| 營業稅進項媒體檔 | 部分 | PCE GUI Portal → 營業稅申報；只納入申報營業稅已勾選的進項。見 營業稅申報進度 |
使用者操作細節：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-write-log
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 進項 | 會計／顧問操作 |
| 進項憑證檢核規則 | 畫面、CSV、API 共用的逐條檢核 |
| 交易建立介接 | 外部廠商只建交易 |
| AP Write 介接手冊 | 外部廠商 |
| AP Write 技術手冊 | 內部／顧問、錯誤碼 |
| 銷項進度 | 銷項階段（對照用） |
| 營業稅申報進度 | TXT／T02、空白字軌（跨進銷項） |
| SuiteTax 規劃 | NetSuite SuiteTax（進銷項共用課稅別對應；規劃中） |
變更紀錄（新列加在最上方）
| 日期 | 摘要 | Commit／備註 |
|---|---|---|
| 2026-11-06 | Portal 模組設定、發票本管理下方新增財政部年度字軌（查詢、手動新增、CSV 匯入） | (pending) |
| 2026-11-04 | 課稅別對應維持既有稅碼清單，定案不改 | (pending) |
| 2026-11-04 | 進項憑證檢核逐條規則寫入文件 | (pending) |
| 2026-11-03 | 進項子列表／進項資料 CS 與驗證 UE 補 Employees Audience，並於部署時覆寫 | (pending) |
| 2026-11-02 | 公版拿掉 API進項審核與請購單；這兩項只留在 Client/DFO-SB | (pending) |
| 2026-11-01 | 交易上的 API進項資料子列表離開該列時驗證 | (pending) |
| 2026-10-30 | 廠商介接文件改名為進項憑證與請購單的介接技術文件 | 7067046 |
| 2026-10-30 | 請購單改用 createPurchaseReq／updatePurchaseReq | 7067046 |
| 2026-10-30 | 請購單合約(專案)欄位為 cseg_dfo_contract | 7067046 |
| 2026-10-30 | 請購單不帶進項憑證 | 7067046 |
| 2026-10-30 | stageApIntake／updateApIntake 可建立與更新請購單 | 1dd2853 |
| 2026-10-30 | 發票號碼重複檢核加入待審與轉入失敗的 API進項資料 | b733999 |
| 2026-10-30 | 沒有正式進項時，回應不帶 apInvoices.id | 5efd4ab |
| 2026-10-30 | 廠商可用 updateApIntake 更正待審或轉入失敗的憑證與交易 | 9955104 |
| 2026-10-30 | 來源交易單據拿掉單據種類篩選 | b1dbd92 |
| 2026-10-30 | 相同 requestId 改讀呼叫紀錄 Long Text，避免重複建立 | 9b4d8fc |
| 2026-10-30 | Portal 顯示 API進項資料改由獨立核取方塊決定 | 69d1651 |
| 2026-10-30 | Portal 不顯示進項資料；API進項資料改為查詢頁並可審核 | 69d1651 |
| 2026-10-30 | Portal 清單改以 Search 取 rectype，並用相對路徑組網址 | 69d1651 |
| 2026-10-30 | 外部廠商技術文件只含 stageApIntake（含 HTML） | 1d1b74c |
| 2026-10-30 | 客戶部署不鎖 API進項資料 | 47d89d3 |
| 2026-10-30 | API進項資料對齊 PCE 進項資料、不含已申報，表單分進項資料與審核兩組 | 47d89d3 |
| 2026-10-30 | API進項審核文件：設計、流程、技術 | 47d89d3 |
| 2026-10-30 | 模組通用表單顯示 API進項審核 | 07847a8 |
| 2026-10-29 | API進項審核開啟後才接受 stageApIntake，並關閉進項 CSV 匯入 | 0ec61c6 |
| 2026-10-29 | 進項呼叫紀錄與交易建立紀錄改為不需要權限 | fe73f3a |
| 2026-10-29 | 進項資料新增已申報；CSV 欄位 filed 可寫入 | 96d72b6 |
| 2026-10-29 | 進項自訂紀錄權限清單補上 Administrator，才能部署 | 682e544 |
| 2026-10-29 | 進項自訂紀錄改為權限清單，文字與長文字欄位可全域搜尋 | 2cb3344 |
| 2026-10-29 | suiteTax 勾選後，AP Write 與交易建立改寫 Tax Details | 6e3ac89 |
| 2026-10-20 | 未勾進項功能時，Portal 不顯示進項 | 38bb60d |
| 2026-10-19 | 已勾申報營業稅的進項納入 Portal 進銷項 TXT | fce1be4 |
| 2026-10-19 | 進項資料發票號碼開啟全域搜尋 | f1651d9 |
| 2026-10-19 | 進項 CSV、課稅別對應與 Portal 載入等待時顯示處理中動畫 | 7560a43 |
| 2026-10-16 | 新增交易建立 RESTlet，與進項憑證及 AP Write 函式庫分開 | 7f05482 |
| 2026-10-07 | 進項 CSV 匯入改由 PCE GUI Portal 進入；中心標籤只留進項資料清單 | 379dbd4 |
| 2026-10-06 | 進項呼叫紀錄開啟 Show Notes，表單才會出現 System Notes 分頁 | (pending) |
| 2026-10-06 | 進項主檔、供應商統編與呼叫紀錄欄位補上使用者看的欄位說明（<help>） | (pending) |
| 2026-10-03 | Portal SPA：進項 CSV pce_embed 嵌入模式（POST／redirect 保留） | b3d116c |
| 2026-10-01 | CSV 匯入／Write smoke 等 HTML 跳脫改用共用 PCE_LIB_HtmlEscape | 64dfb44 |
| 2026-09-24 | 帳內工具頁／操作手冊移除 PwC logo；docs/html 實作進度頁保留 | 783e1b7 |
| 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。