NetSuite 電子發票模組異常處理與常見 QA 案例庫
彙整 IZG NetSuite 電子發票模組(Taiwan E-GUI Module)之 SOP、Q&A、真實客服案件排查紀錄,以及關網加值中心介接實務。供系統維運顧問、客服支援團隊及會計系統管理者快速查閱與疑難排解。
| 模組 | IZG NetSuite Taiwan E-GUI/關網電子發票 |
| 來源 | izg-netsuite-einvoice-cases.md、IZG - 如何修改發票內容,重新上傳.docx |
| 閱讀對象 | 維運顧問、客服支援、會計系統管理者 |
| 關網 Support | admin01@gateweb.com.tw、service06@gateweb.com.tw 副本 izg.gw.support@inzaghi-corp.com |
GUI-QA-002、2.1.3)、客戶名、發票號碼或欄位名(voucherUploadStatus、Lock)。快速查閱
先看上傳狀態與是否已上大平台,再決定重拋、手動改狀態,或走註銷。
| 狀態 | 意義 | 常見處置 |
|---|---|---|
C | Completed/成功 | 已上傳完成。若要改品名/備註/地址,必須先註銷,不可直接改狀態重拋。 |
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.5 | PDF 下載、補印水印、營業稅 TXT、進項憑證 |
| 2.6 設定 | Sandbox 字軌、載具捐贈、營業人 Role |
1. 標準常見問答
Standard Q&A。先對照案例編號與適用客戶,再依步驟處理。
客戶反映 NetSuite Invoice 未成功建立至 GW(加值中心系統)。可能原因為原發票資料不符合自動轉開程式的擷取條件。
排查與解決步驟
- 進入該筆 NetSuite 原發票(Invoice)紀錄頁面。
- 檢視頁面下方之「電子發票子列表」(Sublist)各欄位與條件設定。
- 確認子列表內的欄位資訊是否符合轉開邏輯,修正缺漏條件後,等待
GW MR ISSUE EGUI JOB排程再次抓取。
GW 憑證上傳時大平台傳回驗證失敗,提示資料重複上傳。
022:[E0201] No. 11 發票 Validate Fail. 訊息重複排查與解決步驟
- 前往對應的 GW Voucher Main 紀錄。
- 將欄位
voucherUploadStatus的值手動更新為C(Completed/成功)。 - 同步將關聯單據上的「開立狀態」欄位更新為「憑證開立上傳已成功」。
2.1 發票開立與上傳類異常
外幣稅差、Server Error、Lock、外部開立規則、合併超額與稅差容許度。
外幣 Invoice 開立失敗。原因為外幣計算產生 1 元稅額落差(例如 Invoice 上稅額為 7992,而 Voucher Detail 計算為 7993)。
排查與處置步驟
- 查看系統 Error Message 確定為稅額不符。
- 比對 Invoice 與 Voucher Main 的稅額數據。
- 至 Voucher Main 頁面手動將稅額更正為與原單據一致(如 7992),儲存後重新上傳。
部分單據因大平台或伺服器異常顯示 Server Error(voucherUploadStatus 為 F);部分因明細品名空白導致上傳失敗。
排查與處置步驟
- 進入客戶環境,路徑:
關網電子發票 > 電子發票管理 > 電子發票下載 PDF 作業。 - 輸入統編與發票號碼,清除日期進行查詢。
- 對於 Server Error 案件,點選「重新上傳憑證」,等待系統背景排程抓取。
- 對於品名空白案件,點進該筆 Voucher Detail Record,於
description欄位補齊品名後儲存,再點選重新上傳。當上傳狀態變更為C即完成。
銷貨單之電子發票 Lock 欄位被勾選,導致無法正常進行發票開立或處理。
排查與處置步驟
- 於搜尋欄輸入單號找到該筆銷貨單,於「電子發票」分頁確認
LOCK框被勾選。 - 取得該單據之
Internal ID(例如730048)。 - 建立 CSV 檔案(格式為 UTF-8),欄位包含
ID。 - 執行 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(取消勾選)
- 點擊 Run 執行 Import,完成後確認銷貨單上 Lock 已取消。
電商平台多數為外部開立之發票。外部開立時已自動上傳財政部,NetSuite 僅需建檔以產出報稅檔(Voucher Main),不可重複上傳。
| 情境 | Lock | 開立狀態 | 說明 |
|---|---|---|---|
| 外部發票開立 | 必須打勾 | 依系統自動建立 GW 檔 | 不勾選則不會自動建立 Voucher Main |
| 外部折讓單開立 | 不可以勾選 | 留空 | 誤填開立狀態會導致無法抓取 |
合併張數超過系統限制導致合併開立失敗。
採手動 CSV Import 方式建立 Voucher Main,並將開立後之發票資訊回寫至 NetSuite Invoice。
因特例交易計算需調高系統稅差容許度。
處置步驟
- 路徑:
Customization > Lists, Records, & Fields > Record Types。 - 找到 GW VOUCHER PROPERTIES,點擊
View Records。 - 編輯欄位
TAX_DIFF_BALANCE,將Voucher Property Value由預設值1暫時修改為客戶指定數值(如5)。 - 待客戶開立完成後,務必重新改回
1。
1。2.2 折讓單(Credit Memo)與沖銷作業
手建折讓、重新連結、單號重複、歷史字軌、批次更正與防呆原則。
外部開立之折讓單於 NetSuite 手動建立後未正常產出折讓單據號碼(SHO2026071474997)。
排查與處置步驟
- 檢查該筆 Credit Memo,確認「開立狀態」是否被誤填。
- 外部折讓之標準設定為:「開立狀態」保持空白,且
Lock欄位不勾選。 - 調整欄位後,系統背景排程即可順利抓取開立。
原 CM 廢棄,新 CM 綁定原折讓單。
步驟一:更新舊單關聯
- 打開原折讓單的 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 自動生成之重複折讓單
因單號重複上傳失敗,手動將折讓單號碼尾數更正後重新上傳。
例如由 SHO2026061553342 修改為 SHO2026061553343,儲存後重新上傳成功。
開立 10 年內歷史舊發票(如 106 年 5–6 月,期別 10606)之折讓單時,系統需有對應字軌檔。
處置步驟
- 路徑:
Customization > Lists, Records, & Fields > Record Types > Assign Log Track。 - 新增一筆紀錄,填寫期別
10606、發票類別代碼31(電子計算機發票)、字軌NX。 - 儲存後,系統即可對該筆歷史發票正常開立折讓單。
伺服器異常失敗重送,或申報期別誤植(如 11504 應改為 11506)。
伺服器異常失敗重送
- 路徑:
關網電子發票 > 折讓(電子發票)管理 > 折讓(電子發票)管理作業。 - 輸入折讓單號,點選「查詢」→ 點進單據點選「重新上傳」。
申報期別誤植更正
- 透過 CSV Import(Update 模式)更新 Credit Memo。
- Mapping
ID→Internal ID,將「營業稅申報期別」預設值改為11506。 - 執行後至營業稅申報檔下載
11506銷項 TXT 檔,搜尋確認是否有代碼33開頭之折讓紀錄。
客戶若需更換折讓對應之發票,必須先完成原折讓單上傳流程後方可進行作廢。
2.3 註銷申請與重送作業 SOP
發票已上傳大平台且涉及品名、備註或地址變更時,需先發信給關網 Support 進行註銷。
當發票已上傳大平台且涉及品名、備註或地址變更時,需先發信給關網 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 請協助註銷下列發票: 賣方統編/賣方公司名稱/買方統編/買方公司名稱/發票日期/發票號碼/註銷原因
關網 Support 回覆註銷完成後,在 NetSuite 開啟 GW Voucher Main,改備註/品名,最後把上傳狀態改為 A 觸發重拋。畫面步驟來自《IZG - 如何修改發票內容,重新上傳》。
voucherUploadStatus 從 C 改成 A。步驟 1:用發票號碼搜尋並開啟 GW Voucher Main
將發票號碼貼入 NetSuite 上方 Search Bar。在 Global Search 結果中點選 GW Voucher Main(不要點 Invoice 或 Voucher Details)。
NE10090000,選 GW Voucher Main: 18159 VoucherMainRecord。同一關鍵字也會列出 Invoice 與多筆 Voucher Details,改主檔備註/上傳狀態請走 Voucher Main。步驟 2:修改總備註 mainRemark
進入 GW Voucher Main 後按 Edit。總備註請改頁面中央的 MAINREMARK(mainRemark)欄位,改完先 Save。
MAINREMARK。右側可見 VOUCHERUPLOADSTATUS 目前為 C——請先改完備註與品名再動這個欄位。細項備註若需要,在對應 Voucher Detail 的 ITEM REMARK。步驟 3:修改品名 description
- 捲到頁面最下方,開啟 Custom 子標籤。
- 點進對應的
voucherMainInternalID/GW Voucher Details 品項紀錄。 - 修改
description(DESCRIPTION)欄位後務必 Save。
步驟 4:確認內容後將上傳狀態改為 A
- 回到 GW Voucher Main,確認備註與品名都已儲存。
- 將
voucherUploadStatus(畫面欄位VOUCHERUPLOADSTATUS)由C改為A並 Save。 - 背景排程約 30–60 分鐘內自動重新上傳大平台。完成後狀態應回到
C。
mainRemark、description、voucherUploadStatus;NetSuite 畫面常顯示為 MAINREMARK、DESCRIPTION、VOUCHERUPLOADSTATUS,是同一組欄位。Sales Order 建立時帶入客戶主檔舊地址。
發信申請註銷,同步更新 Sales Order/Customer 地址資訊後,照 2.3.2 畫面 SOP 將 voucherUploadStatus 改為 A 重新上傳。
對於作廢狀態顯示空白或上傳失敗之單據,整理 Internal ID 匯入 CSV 批次更新。
| Mapping | 更新值 |
|---|---|
| Internal ID → 開立狀態 | 憑證作廢上傳已成功 |
2.4 PDF 發票下載與列印設定
合開逾時、補印水印、B2C 兌獎限制下的重印。
過多筆 Invoice 合開一張發票,導致標準下載頁面逾時失敗。
- 路徑:
關網電子發票 > 基本管理 > 營業人基本資料。 - 找到對應公司名稱,點選「發票寄送人」。
- 切換至
CommunicationTAB,即可直接下載該筆發票之 PDF 檔案。
已列印過的 PDF 會帶「補印」水印,客戶需要乾淨檔時取消列印註記。
- 搜尋發票號碼進入對應之 GW Voucher Main 頁面。
- 點選 Edit,取消勾選
IS PRINTED PDF並儲存。 - 重新至 PDF 下載作業匯出,檔案即不會顯示「補印」水印。
B2C 發票具兌獎限制,預設僅允許下載一次。若客戶需重印,需解除列印註記。
進入 Voucher Main 編輯,取消勾選 is printed PDF 後儲存,即可再次下載。
2.5 營業稅申報與進銷項憑證管理
報稅檔 TXT、憑證格式代號、進項刪除與關聯、空白發票補救。
下載營業稅申報檔失敗時,先拆分進項/銷項,再用 Saved Search 找異常列。
- 進入
關網營業稅申報 > 營業稅申報 > 營業稅申報檔下載。 - 拆分下載判斷:將進項檔與銷項檔分別下載。若銷項成功而進項失敗,確定為進項資料異常。
- 利用 Saved Search 排查:使用預設之 Saved Search「會計-進項發票或憑證(VB、VC)」檢視資料。
- 觀察資料列底色,標示異常底色者即為錯誤資料(例如:漏填「憑證格式代號」)。補齊資料後即可正常產檔。
大平台格式正確但 NetSuite 格式代號異常時,以 Invoice CSV Import 批次更正。
| Field Mapping | 值 |
|---|---|
| ID → Internal ID | — |
| 憑證格式代號 | Default Value = 35. 一般稅額電子發票 |
從應付帳單的電子發票分頁刪除指定進項憑證。
- 路徑:
Transactions > Payables > Enter Bills > List。 - 進入該筆 Vendor Bill,切換至「電子發票」分頁。
- 點擊欲刪除之進項憑證編輯,執行
Actions > Delete。
使用 Saved CSV Import 範本把進項發票關聯到 Vendor Bill。
將 Vendor Bill 之 Internal ID 填入 CSV 檔之 Transaction No 欄位,即可完成關聯。
系統及大平台皆無此發票紀錄,確認為未使用之空白發票號碼。
於營業稅申報時,指示會計人員以人工手動方式補列入空白發票申報檔中。
2.6 系統設定、字軌管理與載具捐贈
Sandbox 測試字軌、載具/捐贈判讀,以及營業人基本資料與 Role。
正式區資料覆蓋 SB 後,需重新設定測試字軌,並關閉從正式區帶過來的字軌。
- 準備 CSV 字軌檔案(欄位包含期別、字軌、起號、迄號;發票類別代碼需為文字格式如
07)。範例:11505-11506, JB, 21000000, 21000099 - 路徑:
關網電子發票 > 基本管理 > 字軌管理→ 點選「匯入電子發票字軌」。 - 關閉舊字軌:將從正式區覆蓋過來的字軌全選(Mark All),將狀態手動調整為 已使用完畢 並儲存,防範測試環境誤用正式字軌。
開立頁面載具與捐贈欄位的系統判讀,與是否勾選「捐贈發票」無關的陷阱。
| 設定項目 | 系統操作與設定方式 | 系統判讀邏輯/注意事項 |
|---|---|---|
| 共通性載具 | 載具類型選擇 手機條碼 或 自然人憑證,填入 載具號碼-1 與 載具號碼-2 |
系統帶入 XML 送至加值中心與財政部 |
| 捐贈發票 | 於開立頁面填入受贈團體之 捐贈碼(3–7 碼數字) |
只要「捐贈碼」有填值,即使未勾選「捐贈發票」,系統仍會判定為捐贈 |
| 關網會員載具 | 下拉選單項目之一 | 屬關網發行之會員載具,未額外付費訂閱該服務之客戶不可選用 |
新客戶上線時建立營業人主檔並指定處理/審核 Role。
- 路徑:
關網電子發票 > 基本管理 > 營業人基本資料 > New。 - 依照客戶 Excel 提供之公司資訊填寫。
- Role 權限設定:處理 Role
SS2C-ADM;審核作廢 RoleSS2C-fiancial(文件原文拼法)。
3.1 營業稅法核心要點
排查開立、課稅別與兌獎爭議時可對照的法規重點。
- 加值型營業稅:應納稅額 = 銷項稅額 − 進項稅額(稅率 5%)。
- 零稅率 vs. 免稅
- 零稅率(0%):旨在鼓勵外銷及保稅區交易(如科學園區、自由貿易港區、海關管理保稅工廠/倉庫)。零稅率發票不可參加中獎領獎。
- 免稅:適用於生鮮水果、醫療教育、農漁業等。免稅發票之中獎發票可以領獎。
- 代收轉付原則:符合「收轉無差額」且「最終憑證抬頭為消費者/委託人」者,不計入代收商家營收,免開立統一發票。
3.2 中獎發票與兌獎規範
| 項目 | 說明 |
|---|---|
| 發票保存 | 營業人對消費者發票資料需保存 5 年。 |
| 可兌獎 | 非營業人/扣繳單位(如機關團體、執行業務事務所、私立機構等)。 |
| 不可兌獎 | 一般營業人(公司行號、股份有限公司等)。 |
3.3 申報檔與電子發票 MIG 檔規範
關網/大平台訊息代號與 401 申報檔長度。
MIG訊息代號與財政部電子發票訊息交換格式對照
| 代號 | 意義 | 對應單據 |
|---|---|---|
| F0401 | 發票開立 | Invoice |
| F0501 | 發票作廢 | — |
| F0701 | 發票註銷 | — |
| D0401 | 折讓單開立 | Credit Memo |