進項憑證檢核規則

沒通過會擋下存檔或寫入。差額在容許範圍內的稅額只回警告，仍可存檔。API 成功時警告在 warnings。

格式 21／25 要先用 invCatCode 或 docFormatName 對到其中一筆格式主檔。對不到是 lookup 錯誤，不是下面這些欄位規則。

下列欄位不在這套檢核：總計、申報營業稅、已申報、來源交易、clientRef。

1. 憑證格式

憑證格式代碼必填。沒選就停，不再檢其他欄。代碼 DocTypeRequired。

2. 每次都檢的共通欄位

扣抵代號：1 進項可扣抵之進貨及費用、2 進項可扣抵之固定資產、3 進項不可扣抵之進貨及費用、4 進項不可扣抵之固定資產。

課稅別主檔若還有 F（作廢）、D（空白未使用），這套檢核仍只接受 1、2、3。

3. 號碼欄：依格式必填、擇一或禁填

同一列只能走一條號碼路徑。兩個都填，或該填的都沒填，會擋下。

擇一失敗的代碼：發票與其他憑證是 GuiNumberCommonNumberConflict；格式 25 發票與載具是 GuiNumberUtilityConflict。禁填的代碼：GuiNumberMustNotHave、CommonNumberMustNotHave、UtilityCarrierMustNotHave、CustomsAuthCodeMustNotHave。格式 22 彙加卻填了發票號碼：GuiNumberMustNotHaveOnSummary。格式 22 彙加卻沒填其他憑證：SummaryMarkRequiresOtherDoc。

3.1 發票號碼格式、字軌、重複

有填發票號碼時：

1. 須為 1～2 位大寫英文＋ 8 位數字。0 位英文或小寫會擋下。代碼 GuiFormatError、GuiTrackRequired。
2. 字軌須在財政部字軌表。期別優先用憑證開立日期換算的雙月期（單月進到下一個雙月，例如 11507 與 11508 都屬 11508）；沒有日期才用資料所屬年月。格式 23 比對 21 與 25 的字軌；格式 24 比對 22 的字軌；其餘比對自己的格式代碼。代碼 GuiTrackPeriodRequired、GuiTrackDocTypeRequired、GuiTrackNotAllowed。
3. 同一筆憑證格式主檔（下拉選到的那一列）不可重複。格式 21 的三聯式與電子計算機是兩筆主檔，互不列入對方的重複檢查。比對範圍：未停用的 PCE 進項資料（編輯時排除自己）；帳上若有 API進項資料，再加待審與轉入失敗，不含退回與已轉入。同一支 API 或同一份 CSV 裡，後面的列也會把前面已通過檢核的號碼當成重複。格式 23、24 不查重複。 代碼 GuiNumberDuplicated。

3.2 其他憑證號碼

格式 22、24、27 走其他憑證時，號碼不可長得像發票字軌（前段英文、後段 8 碼數字）。代碼 CommonNumberSimilarToGuiNumber。

3.3 公用事業載具流水號

僅格式 25，且選擇載具路徑時：

• 長度 10 碼。代碼 UtilityCarrierLength。
• 須以 BB 開頭（比對前轉成大寫）。代碼 UtilityCarrierPrefix。
• 不可與既有進項資料重複（編輯時排除自己）。代碼 UtilityCarrierDuplicated。

3.4 海關代徵營業稅繳納認證碼

僅格式 28、29：

• 必填，長度 14。代碼 CustomsAuthCodeRequired、CustomsAuthCodeLength。
• 第 1 位不得空白。代碼 CustomsAuthCodePos1。
• 第 3 位不得為字元 1。代碼 CustomsAuthCodePos3。

4. 銷售人統編

必填卻空白：SellerTaxIdRequired。有填時須 8 碼且檢查碼正確：SellerTaxIdLengthError、SellerTaxIdValueError。

格式 22 走其他憑證、且未勾彙加時，銷售人統編可以空白。

5. 銷售金額

去掉小數點後超過 12 個字元就擋下（含負號）。代碼 SalesAmtLengthError。

格式 28、29 不套用「應稅須大於 0」。零稅率、免稅沒有「須大於 0」。

6. 稅額

課稅別 2 或 3：稅額必須為 0。代碼 TaxAmtShouldBeZero。

課稅別不是 1、2、3 時，稅額公式先不跑（課稅別本身會先被擋下）。

格式 22、24、27 或格式 25 的號碼欄還沒擇一，或兩個都填時，先不檢稅額，避免和「擇一」重複報錯。

號碼路徑已確定，且課稅別為應稅時：

× 5% 的差額：0 元通過；1～5 元只警告，仍可存檔；大於 5 元擋下。一般路徑代碼 TaxAmtNotEqual（警告 TaxAmtToleranceWarning）。格式 22／27 的其他憑證路徑代碼 TaxAmtOtherDocInvalid（警告 TaxAmtOtherDocToleranceWarning）。

6.1 彙加平均每張稅額

格式 26、27，且課稅別為應稅、彙總張數大於 0 時，平均每張稅額不得大於 500 元。代碼 SummaryTaxPerDocExceed。

• 格式 26：用畫面上的稅額 ÷ 彙總張數。
• 格式 27 且稅額為 0（含稅）：先把含稅銷售額還原成隱含稅額（銷售金額 × 5% ÷ 1.05，四捨五入），再除以張數。
• 格式 27 且稅額不是 0：用畫面上的稅額 ÷ 張數。

7. 課稅別與格式

8. 彙加註記與彙總張數

彙加註記：A 彙加、B 分攤。

9. 開立年月與申報期別

兩邊都是有效 YYYMM 之後：

格式 23、24、29 不另跑 10 年檢核；它們已限制在同一雙月期。

10. 錯誤代碼對照