PCE TW GUI MODULE — 進項(AP)實作進度(一頁式)
維護:凡 進項相關 功能/SDF/行為文件有交付意義的變更,CP/CPD 前更新本頁「摘要一句」+「變更紀錄」至少一列(可附 commit hash)。
對象:產品/顧問/開發
最後更新:2026-11-02(公版不含 API進項審核與請購單)
摘要一句
進項核心已上線(交易子列表、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。進項資料、營業人、模組通用與營業人系統設定仍為權限清單,目前只有 Administrator。進項呼叫紀錄與交易建立紀錄改為不需要權限。文字與長文字欄位可全域搜尋。
能力總覽(相對銷項藍圖)
進項無獨立「階段藍圖」文件。公版不含 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 的成功寫入會回上次結果 |
| 驗證、lookup、期別、欄位 CS/UE | 已交付 | PCE_LIB_AP_Validate。發票號碼重複比對正式進項。帳上若有 API進項資料,待審與轉入失敗也列入 |
| 課稅別 NS 稅碼對應 | 已交付 | 進銷項共用;現行 Legacy Tax;Suitelet 維護 |
| NetSuite SuiteTax(共用課稅別/開立) | 部分 | 模組通用 suiteTax 勾選後,AP Write 與交易建立把明細稅碼、稅額寫入 Tax Details,不寫 tax1amt。未勾或交易沒有 Tax Details 時維持 Legacy。課稅別對應維持既有稅碼清單,定案不改。見 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 |
| 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 進項 | 會計/顧問操作 |
| 交易建立介接 | 外部廠商只建交易 |
| AP Write 介接手冊 | 外部廠商 |
| AP Write 技術手冊 | 內部/顧問、錯誤碼 |
| 銷項進度 | 銷項階段(對照用) |
| 營業稅申報進度 | TXT/T02、空白字軌(跨進銷項) |
| SuiteTax 規劃 | NetSuite SuiteTax(進銷項共用課稅別對應;規劃中) |
變更紀錄(新列加在最上方)
| 日期 | 摘要 | Commit/備註 |
|---|---|---|
| 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?