換加值中心 — 修改範圍

本文不選下一間加值中心，也不改程式。對方契約（檔案格式、傳輸、回覆檔）到手後，用下面三檔對照再估工時。

1. 結論

不是只改「把檔案送上 sFTP」那一步。 開立、取號、折讓、作廢、上傳佇列與主檔上傳狀態可以留著。要動的是加值中心契約：出站檔、傳輸、回覆檔。這三塊都在 Vac* 程式，沒有散進開立主流程。

三支 password GUID 是 NetSuite N/sftp 的限制（每支 MR 各一組 Credential），不是汎宇規定。對方若不用 sFTP，模組設定上的 GUID／HostKey／目錄可以不再使用。

2. 不用改

這些只負責「發票已開、待送出、送完後的狀態」，不認識汎宇主機或 ACK 碼。

狀態機若仍是「送出 → 等回覆 → 成功或失敗」，監控與錯誤清單的畫面可以留。回覆欄位名稱若變了，錯誤訊息的寫入點要對一下 PCE_LIB_AR_VacAckApply.js。

3. 要改的分層

flowchart LR
  issue[開立與作廢]
  queue[上傳佇列]
  txt[出站檔 VacTxtPayload]
  sftp[傳輸 VacSftpClient]
  ack[回覆 VacAckParser]
  status[上傳狀態]
  issue --> queue --> txt --> sftp --> ack --> status

流程圖原文

開立寫入佇列之後才進入加值中心。換中心從 出站檔 開始看。

3.1 出站檔（對方規格不同就必改）

主檔與明細欄位是台灣電子發票資料，多半還用得上。變的是匯出格式（TXT、XML 或 API 本文）。

3.2 傳輸（仍是 sFTP 就改設定；換協定就要改程式）

模組設定欄位（主機、使用者、埠、HostKey、上傳／ACK／已處理目錄、三支 GUID、啟用）在 customrecord_pce_module_sys_setting。對方仍用 sFTP 時，這些欄位可沿用，種子與說明要改成新主機。啟用時必填的是三支 GUID 與 HostKey，這條規則是為現行 sFTP 寫的。

3.3 回覆（幾乎一定要改）

新中心若回 JSON、Email 或另一種 XML，解析與套用要重寫。成功／失敗仍應落在既有上傳狀態，監控頁才不用重做。

3.4 診斷與測試（契約一變就要重跑）

4. 換之前先問對方

1. 出站檔是不是 MIG 4.1 中介 TXT（INVTEXT、@|@|）？不是的話，PCE_LIB_AR_VacTxtPayload.js 要換。
2. 傳輸是不是 sFTP？不是的話，PCE_LIB_AR_VacSftpClient.js 與三支 GUID 不適用。
3. 回覆檔長什麼樣、成功與失敗的代碼是什麼？對照 PCE_LIB_AR_VacAckParser.js。
4. 檔名、目錄、一個檔能否混多家賣方統編？現在同一 INVTEXT 不可混統編。
5. 開立與作廢是不是兩次上傳、各等一次回覆？現在是兩支 MR 加一支 ACK 輪詢。
6. 正式區與測試區的主機、帳號、目錄是否分開？現在種子各一筆。

5. 相關文件