Ctrl K

NetSuite 電子發票模組異常處理與常見 QA 案例庫

彙整 IZG NetSuite 電子發票模組(Taiwan E-GUI Module)之 SOP、Q&A、真實客服案件排查紀錄,以及關網加值中心介接實務。供系統維運顧問、客服支援團隊及會計系統管理者快速查閱與疑難排解。

模組IZG NetSuite Taiwan E-GUI/關網電子發票
來源izg-netsuite-einvoice-cases.md、IZG - 如何修改發票內容,重新上傳.docx
閱讀對象維運顧問、客服支援、會計系統管理者
關網 Supportadmin01@gateweb.com.tw、service06@gateweb.com.tw 副本 izg.gw.support@inzaghi-corp.com
快速查找 按 Ctrl+K(或 /)開啟搜尋,可輸入案例編號(GUI-QA-002、2.1.3)、客戶名、發票號碼或欄位名(voucherUploadStatus、Lock)。

快速查閱

先看上傳狀態與是否已上大平台,再決定重拋、手動改狀態,或走註銷。

狀態意義常見處置
CCompleted/成功已上傳完成。若要改品名/備註/地址,必須先註銷,不可直接改狀態重拋。
A待重拋註銷完成並改完內容後,把 voucher upload status 從 C 改為 A,背景排程 30–60 分鐘內重傳。
F失敗看 Response Message。Server Error 可重送;品名空白要補 description;022:[E0201] 多為重複上傳,改為 C。
外部發票(電商平台已開立)
  • 外部開立時已自動上傳財政部。NetSuite 僅需建檔產出報稅檔(Voucher Main),不可重複上傳。
  • 外部發票開立:Lock 必須打勾,系統才會自動建立 GW 檔。
  • 外部折讓單開立:開立狀態留空,且 Lock 不可以勾選。
章節何時用
1 標準 Q&A未建 GW、訊息重複、已上傳要改內容
2.1 開立上傳稅差、Server Error、Lock、合併超額、稅差容許度
2.2 折讓Credit Memo 未開立、重綁、單號重複、歷史字軌
2.3 註銷大平台已收件後改品名、備註、地址;畫面 SOP 見 2.3.2
2.4/2.5PDF 下載、補印水印、營業稅 TXT、進項憑證
2.6 設定Sandbox 字軌、載具捐贈、營業人 Role

1. 標準常見問答

Standard Q&A。先對照案例編號與適用客戶,再依步驟處理。

GUI-QA-001發票未建立 GW 處理流程標準 Q&A

客戶反映 NetSuite Invoice 未成功建立至 GW(加值中心系統)。可能原因為原發票資料不符合自動轉開程式的擷取條件。

適用客戶 shopping99、耐德科技 相關排程 GW MR ISSUE EGUI JOB 類型 Map/Reduce

排查與解決步驟

  1. 進入該筆 NetSuite 原發票(Invoice)紀錄頁面。
  2. 檢視頁面下方之「電子發票子列表」(Sublist)各欄位與條件設定。
  3. 確認子列表內的欄位資訊是否符合轉開邏輯,修正缺漏條件後,等待 GW MR ISSUE EGUI JOB 排程再次抓取。
GUI-QA-002憑證上傳失敗:022:[E0201] 訊息重複上傳失敗

GW 憑證上傳時大平台傳回驗證失敗,提示資料重複上傳。

適用客戶 通用 單據 GW Voucher Main 欄位 Upload Status Response Message
錯誤訊息 022:[E0201] No. 11 發票 Validate Fail. 訊息重複

排查與解決步驟

  1. 前往對應的 GW Voucher Main 紀錄。
  2. 將欄位 voucherUploadStatus 的值手動更新為 C(Completed/成功)。
  3. 同步將關聯單據上的「開立狀態」欄位更新為「憑證開立上傳已成功」。
GUI-QA-003發票已上傳但需修改內容須先註銷

發票已完成上傳至財政部大平台,但客戶提出需要修正品名或備註等發票資訊。

適用客戶 通用 單據 GW Voucher Main、GW Voucher Details

排查與解決步驟

  1. 與客戶確認預備修改的具體欄位內容。
  2. 整理相關單據資訊,發信聯絡關網 Support 窗口申請「發票註銷」。郵件格式見 2.3.1。
  3. 待關網回覆註銷完成後,於 NetSuite 依畫面 SOP 修改內容並把上傳狀態改為 A 重拋。操作畫面見 2.3.2。
注意事項 嚴禁於未完成註銷前直接改動單據上傳狀態。

2.1 發票開立與上傳類異常

外幣稅差、Server Error、Lock、外部開立規則、合併超額與稅差容許度。

2.1.1外幣發票稅差導致開立失敗稅差

外幣 Invoice 開立失敗。原因為外幣計算產生 1 元稅額落差(例如 Invoice 上稅額為 7992,而 Voucher Detail 計算為 7993)。

適用客戶 進金生發票 DR54578241

排查與處置步驟

  1. 查看系統 Error Message 確定為稅額不符。
  2. 比對 Invoice 與 Voucher Main 的稅額數據。
  3. 至 Voucher Main 頁面手動將稅額更正為與原單據一致(如 7992),儲存後重新上傳。
2.1.2Server Error 與品名空白上傳失敗上傳失敗

部分單據因大平台或伺服器異常顯示 Server Error(voucherUploadStatus 為 F);部分因明細品名空白導致上傳失敗。

適用客戶 Shopping 99Server Error BD69245175、BD69246793品名空白 BD69248505、BD69248517

排查與處置步驟

  1. 進入客戶環境,路徑:關網電子發票 > 電子發票管理 > 電子發票下載 PDF 作業。
  2. 輸入統編與發票號碼,清除日期進行查詢。
  3. 對於 Server Error 案件,點選「重新上傳憑證」,等待系統背景排程抓取。
  4. 對於品名空白案件,點進該筆 Voucher Detail Record,於 description 欄位補齊品名後儲存,再點選重新上傳。當上傳狀態變更為 C 即完成。
2.1.3銷貨單發票被鎖定(Un-lock)CSV Import

銷貨單之電子發票 Lock 欄位被勾選,導致無法正常進行發票開立或處理。

適用客戶 湧傑單號 INV260404830Internal ID 730048

排查與處置步驟

  1. 於搜尋欄輸入單號找到該筆銷貨單,於「電子發票」分頁確認 LOCK 框被勾選。
  2. 取得該單據之 Internal ID(例如 730048)。
  3. 建立 CSV 檔案(格式為 UTF-8),欄位包含 ID。
  4. 執行 CSV Import:
    • Import Type:Transaction
    • Record Type:Invoice
    • Data Handling:Update
    • Advanced Options:取消勾選 Run Server Scripts
    • Field Mapping:ID → Internal ID;Lock → Default Value 為 NO(取消勾選)
  5. 點擊 Run 執行 Import,完成後確認銷貨單上 Lock 已取消。
2.1.4外部發票開立與外部折讓處理規則規則

電商平台多數為外部開立之發票。外部開立時已自動上傳財政部,NetSuite 僅需建檔以產出報稅檔(Voucher Main),不可重複上傳。

適用客戶 耐德 Shopping 99
情境Lock開立狀態說明
外部發票開立必須打勾依系統自動建立 GW 檔不勾選則不會自動建立 Voucher Main
外部折讓單開立不可以勾選留空誤填開立狀態會導致無法抓取
2.1.5多筆 Invoice 合併開立超額失敗手動建檔

合併張數超過系統限制導致合併開立失敗。

適用客戶 Shopping 99發票 ZX50187203、ZX50187204

採手動 CSV Import 方式建立 Voucher Main,並將開立後之發票資訊回寫至 NetSuite Invoice。

2.1.6稅差平衡額度暫時性調整記得改回

因特例交易計算需調高系統稅差容許度。

適用客戶 湧傑欄位 TAX_DIFF_BALANCE

處置步驟

  1. 路徑:Customization > Lists, Records, & Fields > Record Types。
  2. 找到 GW VOUCHER PROPERTIES,點擊 View Records。
  3. 編輯欄位 TAX_DIFF_BALANCE,將 Voucher Property Value 由預設值 1 暫時修改為客戶指定數值(如 5)。
  4. 待客戶開立完成後,務必重新改回 1。
收尾 此為暫時調整,開立完成後必須改回預設 1。

2.2 折讓單(Credit Memo)與沖銷作業

手建折讓、重新連結、單號重複、歷史字軌、批次更正與防呆原則。

2.2.1手建折讓單未開立排查外部折讓

外部開立之折讓單於 NetSuite 手動建立後未正常產出折讓單據號碼(SHO2026071474997)。

適用客戶 Shopping 99/耐德CM CM00000000042650

排查與處置步驟

  1. 檢查該筆 Credit Memo,確認「開立狀態」是否被誤填。
  2. 外部折讓之標準設定為:「開立狀態」保持空白,且 Lock 欄位不勾選。
  3. 調整欄位後,系統背景排程即可順利抓取開立。
2.2.2折讓單與 Credit Memo 重新連結 SOP三步驟

原 CM 廢棄,新 CM 綁定原折讓單。

適用客戶 耐德 Shopping 99折讓單 SHO2026052240243

步驟一:更新舊單關聯

  • 打開原折讓單的 Voucher Main,於 Transaction 欄位輸入新 CM 號碼,並刪除舊 CM 號碼。
  • 進入 Voucher Detail Record,將各品項開啟,於 NS Document apply ID 及 NS Document number 輸入新 CM 號碼。

步驟二:CSV Import 寫入資訊

將新開 CM 的 Internal ID 貼入 Excel,執行 Transaction - Credit Memo CSV Import。Mapping 欄位:

  • 折讓單單號起號
  • 折讓單單號迄號
  • 發票不上傳 → 選擇 NO
  • 開立狀態 → 填入 憑證開立上傳已成功

步驟三:清理新 CM 自動生成之重複折讓單

刪除順序 進入新 CM 自動生成的空折讓單頁面。必須先刪除 Voucher Detail Record,接著再刪除 Voucher Main(Edit → Actions → Delete)。
2.2.3折讓單單號重複處置單號衝突

因單號重複上傳失敗,手動將折讓單號碼尾數更正後重新上傳。

適用客戶 Shopping 99原單號 SHO2026061553342更正後 SHO2026061553343

例如由 SHO2026061553342 修改為 SHO2026061553343,儲存後重新上傳成功。

2.2.4新增歷史期別字軌開立歷史發票折讓字軌

開立 10 年內歷史舊發票(如 106 年 5–6 月,期別 10606)之折讓單時,系統需有對應字軌檔。

適用客戶 Shopping 99發票 NX26844796期別 10606

處置步驟

  1. 路徑:Customization > Lists, Records, & Fields > Record Types > Assign Log Track。
  2. 新增一筆紀錄,填寫期別 10606、發票類別代碼 31(電子計算機發票)、字軌 NX。
  3. 儲存後,系統即可對該筆歷史發票正常開立折讓單。
2.2.5折讓單上傳失敗與申報期別批次更正兩種情境

伺服器異常失敗重送,或申報期別誤植(如 11504 應改為 11506)。

適用客戶 鹽野義單號 SHI2026060488689、SHI2026041797643、SHI2026050786540

伺服器異常失敗重送

  1. 路徑:關網電子發票 > 折讓(電子發票)管理 > 折讓(電子發票)管理作業。
  2. 輸入折讓單號,點選「查詢」→ 點進單據點選「重新上傳」。

申報期別誤植更正

  1. 透過 CSV Import(Update 模式)更新 Credit Memo。
  2. Mapping ID → Internal ID,將「營業稅申報期別」預設值改為 11506。
  3. 執行後至營業稅申報檔下載 11506 銷項 TXT 檔,搜尋確認是否有代碼 33 開頭之折讓紀錄。
2.2.6更換折讓發票之防呆原則嚴禁未上傳即刪

客戶若需更換折讓對應之發票,必須先完成原折讓單上傳流程後方可進行作廢。

適用客戶 友達 AUO
系統防呆 嚴禁於未上傳加值中心前直接刪除。

2.3 註銷申請與重送作業 SOP

發票已上傳大平台且涉及品名、備註或地址變更時,需先發信給關網 Support 進行註銷。

2.3.1關網發票註銷申請標準 Email範本

當發票已上傳大平台且涉及品名、備註或地址變更時,需先發信給關網 Support 團隊進行註銷。

收件人admin01@gateweb.com.tw、service06@gateweb.com.tw
副本izg.gw.support@inzaghi-corp.com
主旨英薩吉-關網(統編[賣方統編]-[賣方名稱])-註銷

內文內嵌表格

賣方統編賣方公司名稱買方統編買方公司名稱發票日期發票號碼註銷原因
55986684 宇沛永續股份有限公司 69439272 秋雨創新股份有限公司 2026-07-08 BD48040093 品名需要調整
主旨:英薩吉-關網(統編[賣方統編]-[賣方名稱])-註銷

收件人:admin01@gateweb.com.tw; service06@gateweb.com.tw
副本:izg.gw.support@inzaghi-corp.com

請協助註銷下列發票:

賣方統編/賣方公司名稱/買方統編/買方公司名稱/發票日期/發票號碼/註銷原因
2.3.2如何修改發票內容並重新上傳操作畫面 SOP

關網 Support 回覆註銷完成後,在 NetSuite 開啟 GW Voucher Main,改備註/品名,最後把上傳狀態改為 A 觸發重拋。畫面步驟來自《IZG - 如何修改發票內容,重新上傳》。

前置 大平台註銷完成(見 2.3.1) 單據 GW Voucher Main/Voucher Details 來源 IZG - 如何修改發票內容,重新上傳.docx
嚴禁 未完成註銷前,不可把 voucherUploadStatus 從 C 改成 A。

步驟 1:用發票號碼搜尋並開啟 GW Voucher Main

將發票號碼貼入 NetSuite 上方 Search Bar。在 Global Search 結果中點選 GW Voucher Main(不要點 Invoice 或 Voucher Details)。

NetSuite 全域搜尋發票號碼,結果列出 GW Voucher Main 與 Voucher Details
範例:搜尋 NE10090000,選 GW Voucher Main: 18159 VoucherMainRecord。同一關鍵字也會列出 Invoice 與多筆 Voucher Details,改主檔備註/上傳狀態請走 Voucher Main。

步驟 2:修改總備註 mainRemark

進入 GW Voucher Main 後按 Edit。總備註請改頁面中央的 MAINREMARK(mainRemark)欄位,改完先 Save。

GW Voucher Main 編輯畫面,標示 MAINREMARK 與 VOUCHERUPLOADSTATUS
畫面中央為 MAINREMARK。右側可見 VOUCHERUPLOADSTATUS 目前為 C——請先改完備註與品名再動這個欄位。細項備註若需要,在對應 Voucher Detail 的 ITEM REMARK。

步驟 3:修改品名 description

  1. 捲到頁面最下方,開啟 Custom 子標籤。
  2. 點進對應的 voucherMainInternalID/GW Voucher Details 品項紀錄。
  3. 修改 description(DESCRIPTION)欄位後務必 Save。
品名格式 不可夾帶特殊格式字元或跳行符號,否則重拋大平台可能再被退回。

步驟 4:確認內容後將上傳狀態改為 A

  1. 回到 GW Voucher Main,確認備註與品名都已儲存。
  2. 將 voucherUploadStatus(畫面欄位 VOUCHERUPLOADSTATUS)由 C 改為 A 並 Save。
  3. 背景排程約 30–60 分鐘內自動重新上傳大平台。完成後狀態應回到 C。
欄位對照 Word 原文標示 mainRemark、description、voucherUploadStatus;NetSuite 畫面常顯示為 MAINREMARK、DESCRIPTION、VOUCHERUPLOADSTATUS,是同一組欄位。
2.3.3買方地址錯誤註銷重送主檔舊地址

Sales Order 建立時帶入客戶主檔舊地址。

適用客戶 亞德士發票 BG80929181

發信申請註銷,同步更新 Sales Order/Customer 地址資訊後,照 2.3.2 畫面 SOP 將 voucherUploadStatus 改為 A 重新上傳。

2.3.4批次修正作廢發票狀態CSV Import

對於作廢狀態顯示空白或上傳失敗之單據,整理 Internal ID 匯入 CSV 批次更新。

適用客戶 亞德士
Mapping更新值
Internal ID → 開立狀態憑證作廢上傳已成功

2.4 PDF 發票下載與列印設定

合開逾時、補印水印、B2C 兌獎限制下的重印。

2.4.1多筆 Invoice 合開發票下載 PDF 失敗逾時

過多筆 Invoice 合開一張發票,導致標準下載頁面逾時失敗。

適用客戶 湧傑發票 DK10921346
  1. 路徑:關網電子發票 > 基本管理 > 營業人基本資料。
  2. 找到對應公司名稱,點選「發票寄送人」。
  3. 切換至 Communication TAB,即可直接下載該筆發票之 PDF 檔案。
2.4.2去除 PDF 發票「補印」字樣水印

已列印過的 PDF 會帶「補印」水印,客戶需要乾淨檔時取消列印註記。

適用客戶 湧傑
  1. 搜尋發票號碼進入對應之 GW Voucher Main 頁面。
  2. 點選 Edit,取消勾選 IS PRINTED PDF 並儲存。
  3. 重新至 PDF 下載作業匯出,檔案即不會顯示「補印」水印。
2.4.3B2C 電子發票重複下載 PDF兌獎限制

B2C 發票具兌獎限制,預設僅允許下載一次。若客戶需重印,需解除列印註記。

適用客戶 亞德士發票 AY82588372

進入 Voucher Main 編輯,取消勾選 is printed PDF 後儲存,即可再次下載。

2.5 營業稅申報與進銷項憑證管理

報稅檔 TXT、憑證格式代號、進項刪除與關聯、空白發票補救。

2.5.1營業稅報稅檔(TXT)下載失敗排查 SOP進銷項分流

下載營業稅申報檔失敗時,先拆分進項/銷項,再用 Saved Search 找異常列。

適用客戶 耐德 Shopping 99
  1. 進入 關網營業稅申報 > 營業稅申報 > 營業稅申報檔下載。
  2. 拆分下載判斷:將進項檔與銷項檔分別下載。若銷項成功而進項失敗,確定為進項資料異常。
  3. 利用 Saved Search 排查:使用預設之 Saved Search「會計-進項發票或憑證(VB、VC)」檢視資料。
  4. 觀察資料列底色,標示異常底色者即為錯誤資料(例如:漏填「憑證格式代號」)。補齊資料後即可正常產檔。
2.5.2憑證格式代號批次更新CSV Import

大平台格式正確但 NetSuite 格式代號異常時,以 Invoice CSV Import 批次更正。

適用客戶 Shopping 99發票 ZA69244092
Field Mapping值
ID → Internal ID—
憑證格式代號Default Value = 35. 一般稅額電子發票
2.5.3刪除進項憑證作業Vendor Bill

從應付帳單的電子發票分頁刪除指定進項憑證。

適用客戶 湧傑單據 VENDBILL260702114憑證 CXI31152132142、CUI31153101529
  1. 路徑:Transactions > Payables > Enter Bills > List。
  2. 進入該筆 Vendor Bill,切換至「電子發票」分頁。
  3. 點擊欲刪除之進項憑證編輯,執行 Actions > Delete。
2.5.4進項發票連結應付帳單GW AP Import

使用 Saved CSV Import 範本把進項發票關聯到 Vendor Bill。

適用客戶 亞德士範本 GW AP Import Template

將 Vendor Bill 之 Internal ID 填入 CSV 檔之 Transaction No 欄位,即可完成關聯。

2.5.5空白發票漏上傳稅務補救人工申報

系統及大平台皆無此發票紀錄,確認為未使用之空白發票號碼。

適用客戶 湧傑發票 ZD96789309、ZD96789411、ZD96793253

於營業稅申報時,指示會計人員以人工手動方式補列入空白發票申報檔中。

2.6 系統設定、字軌管理與載具捐贈

Sandbox 測試字軌、載具/捐贈判讀,以及營業人基本資料與 Role。

2.6.1Sandbox 測試區匯入字軌 SOPSB

正式區資料覆蓋 SB 後,需重新設定測試字軌,並關閉從正式區帶過來的字軌。

適用客戶 台新餐飲(UNITECH)
  1. 準備 CSV 字軌檔案(欄位包含期別、字軌、起號、迄號;發票類別代碼需為文字格式如 07)。範例:11505-11506, JB, 21000000, 21000099
  2. 路徑:關網電子發票 > 基本管理 > 字軌管理 → 點選「匯入電子發票字軌」。
  3. 關閉舊字軌:將從正式區覆蓋過來的字軌全選(Mark All),將狀態手動調整為 已使用完畢 並儲存,防範測試環境誤用正式字軌。
防呆 SB 覆蓋後若未關閉正式字軌,測試開立可能用掉真實字軌區間。
2.6.2載具、捐贈碼與關網會員載具設定規則判讀邏輯

開立頁面載具與捐贈欄位的系統判讀,與是否勾選「捐贈發票」無關的陷阱。

適用客戶 進金生(宇豐)
設定項目系統操作與設定方式系統判讀邏輯/注意事項
共通性載具 載具類型選擇 手機條碼 或 自然人憑證,填入 載具號碼-1 與 載具號碼-2 系統帶入 XML 送至加值中心與財政部
捐贈發票 於開立頁面填入受贈團體之 捐贈碼(3–7 碼數字) 只要「捐贈碼」有填值,即使未勾選「捐贈發票」,系統仍會判定為捐贈
關網會員載具 下拉選單項目之一 屬關網發行之會員載具,未額外付費訂閱該服務之客戶不可選用
排查提示 客戶反映「為何變成捐贈發票」時,優先檢查捐贈碼欄位是否有值,不要只看「捐贈發票」核取方塊。
2.6.3新增營業人基本資料與 Role 權限配置權限

新客戶上線時建立營業人主檔並指定處理/審核 Role。

適用客戶 星耀能源
  1. 路徑:關網電子發票 > 基本管理 > 營業人基本資料 > New。
  2. 依照客戶 Excel 提供之公司資訊填寫。
  3. Role 權限設定:處理 Role SS2C-ADM;審核作廢 Role SS2C-fiancial(文件原文拼法)。

3.1 營業稅法核心要點

排查開立、課稅別與兌獎爭議時可對照的法規重點。

  1. 加值型營業稅:應納稅額 = 銷項稅額 − 進項稅額(稅率 5%)。
  2. 零稅率 vs. 免稅
    • 零稅率(0%):旨在鼓勵外銷及保稅區交易(如科學園區、自由貿易港區、海關管理保稅工廠/倉庫)。零稅率發票不可參加中獎領獎。
    • 免稅:適用於生鮮水果、醫療教育、農漁業等。免稅發票之中獎發票可以領獎。
  3. 代收轉付原則:符合「收轉無差額」且「最終憑證抬頭為消費者/委託人」者,不計入代收商家營收,免開立統一發票。

3.2 中獎發票與兌獎規範

項目說明
發票保存營業人對消費者發票資料需保存 5 年。
可兌獎非營業人/扣繳單位(如機關團體、執行業務事務所、私立機構等)。
不可兌獎一般營業人(公司行號、股份有限公司等)。

3.3 申報檔與電子發票 MIG 檔規範

關網/大平台訊息代號與 401 申報檔長度。

MIG訊息代號

與財政部電子發票訊息交換格式對照

代號意義對應單據
F0401發票開立Invoice
F0501發票作廢—
F0701發票註銷—
D0401折讓單開立Credit Memo
401 申報檔格式 每筆紀錄長度為 81 Bytes,包含格式代號(如 31、35、21)、統編、流水號、開立日期、未稅金額、課稅別及稅額。