Ctrl K

PCE TW GUI MODULE — 進項(AP)實作進度(一頁式)

用途:查「目前做到哪、還缺什麼」,不必翻 commit 或問人。
維護:凡 進項相關 功能/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/updatePurchaseReq7067046
2026-10-30請購單合約(專案)欄位為 cseg_dfo_contract7067046
2026-10-30請購單不帶進項憑證7067046
2026-10-30stageApIntake/updateApIntake 可建立與更新請購單1dd2853
2026-10-30發票號碼重複檢核加入待審與轉入失敗的 API進項資料b733999
2026-10-30沒有正式進項時,回應不帶 apInvoices.id5efd4ab
2026-10-30廠商可用 updateApIntake 更正待審或轉入失敗的憑證與交易9955104
2026-10-30來源交易單據拿掉單據種類篩選b1dbd92
2026-10-30相同 requestId 改讀呼叫紀錄 Long Text,避免重複建立9b4d8fc
2026-10-30Portal 顯示 API進項資料改由獨立核取方塊決定69d1651
2026-10-30Portal 不顯示進項資料;API進項資料改為查詢頁並可審核69d1651
2026-10-30Portal 清單改以 Search 取 rectype,並用相對路徑組網址69d1651
2026-10-30外部廠商技術文件只含 stageApIntake(含 HTML)1d1b74c
2026-10-30客戶部署不鎖 API進項資料47d89d3
2026-10-30API進項資料對齊 PCE 進項資料、不含已申報,表單分進項資料與審核兩組47d89d3
2026-10-30API進項審核文件:設計、流程、技術47d89d3
2026-10-30模組通用表單顯示 API進項審核07847a8
2026-10-29API進項審核開啟後才接受 stageApIntake,並關閉進項 CSV 匯入0ec61c6
2026-10-29進項呼叫紀錄與交易建立紀錄改為不需要權限fe73f3a
2026-10-29進項資料新增已申報;CSV 欄位 filed 可寫入96d72b6
2026-10-29進項自訂紀錄權限清單補上 Administrator,才能部署682e544
2026-10-29進項自訂紀錄改為權限清單,文字與長文字欄位可全域搜尋2cb3344
2026-10-29suiteTax 勾選後,AP Write 與交易建立改寫 Tax Details6e3ac89
2026-10-20未勾進項功能時,Portal 不顯示進項38bb60d
2026-10-19已勾申報營業稅的進項納入 Portal 進銷項 TXTfce1be4
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-03Portal SPA:進項 CSV pce_embed 嵌入模式(POST/redirect 保留)b3d116c
2026-10-01CSV 匯入/Write smoke 等 HTML 跳脫改用共用 PCE_LIB_HtmlEscape64dfb44
2026-09-24帳內工具頁/操作手冊移除 PwC logo;docs/html 實作進度頁保留783e1b7
2026-09-17能力總覽移除申報檔、AR Write 列(改見營業稅申報/銷項 Phase 6)(pending)
2026-09-17進度頁納入 SuiteTax 規劃(能力列+文件連結)(pending)
2026-09-17Center 分類「工作台」改為「功能入口」fe6dac6
2026-09-17PCE GUI Portal 更名並精簡使用者可見文案(Center/手冊/入口頁)fa1b3eb
2026-09-17工作台左側選單+panel 導向修正;各工具頁返回 Portalb9d321f
2026-09-17PCE 全功能工作台(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 logoeae556c
2026-09-17進度頁 PwC 簡報配色;維護用語改 CP/CPD;Agent 規則 CP vs CPDbf4ee74
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?