AP voucher validation rules

A failure blocks the save or write. A tax difference inside the tolerance is a warning only; the save still succeeds. On the API, warnings come back in warnings.

Formats 21 and 25 must first resolve to one format master row via invCatCode or docFormatName. A miss is a lookup error, not one of the field rules below.

These fields are not in this validation: total, file business tax, already filed, source transaction, clientRef.

Traditional Chinese: 進項憑證檢核規則.

1. Document formats

Document format is required. If it is missing, nothing else is checked. Code DocTypeRequired.

2. Fields checked on every row

Deduction codes: 1 deductible purchases and expenses, 2 deductible fixed assets, 3 non-deductible purchases and expenses, 4 non-deductible fixed assets.

The tax-type list may also contain F (void) and D (blank / unused). This validation still accepts only 1, 2, and 3.

3. Number fields: required, one-of, or forbidden

A row follows one number path. Filling both, or filling neither when one is required, is rejected.

One-of failures: invoice vs other doc is GuiNumberCommonNumberConflict; format 25 invoice vs carrier is GuiNumberUtilityConflict. Forbidden-field codes: GuiNumberMustNotHave, CommonNumberMustNotHave, UtilityCarrierMustNotHave, CustomsAuthCodeMustNotHave. Format 22 summary with an invoice number: GuiNumberMustNotHaveOnSummary. Format 22 summary without an other-doc number: SummaryMarkRequiresOtherDoc.

3.1 Invoice number format, track, and duplicates

When an invoice number is present:

1. It must be 1–2 uppercase letters plus 8 digits. Zero letters, or lowercase, is rejected. Codes GuiFormatError, GuiTrackRequired.
2. The track must be on the MOF track table. The period prefers the bi-monthly period of the document date (an odd month rolls forward; 11507 and 11508 are both period 11508). If there is no date, the document period is used. Format 23 is checked against tracks for 21 and 25. Format 24 is checked against tracks for 22. Other formats use their own code. Codes GuiTrackPeriodRequired, GuiTrackDocTypeRequired, GuiTrackNotAllowed.
3. The number must be unique on the same format master row (the lookup row selected). Format 21 triplicate and format 21 computer GUI are two master rows and do not collide with each other. The search covers active PCE AP invoices (the current record is excluded on edit). If the account has API intake rows, pending and failed rows are included; rejected and posted rows are not. In one API call or one CSV file, a later row also treats a number that already passed validation as a duplicate. Formats 23 and 24 skip the duplicate check. Code GuiNumberDuplicated.

3.2 Other document number

On formats 22, 24, and 27, an other-doc number may not look like an invoice track (leading letters plus 8 digits). Code CommonNumberSimilarToGuiNumber.

3.3 Utility carrier serial

Format 25 only, and only on the carrier path:

• Length 10. Code UtilityCarrierLength.
• Must start with BB (the value is uppercased before the check). Code UtilityCarrierPrefix.
• Must not duplicate an existing AP invoice (the current record is excluded on edit). Code UtilityCarrierDuplicated.

3.4 Customs certificate

Formats 28 and 29 only:

• Required, length 14. Codes CustomsAuthCodeRequired, CustomsAuthCodeLength.
• Character 1 may not be blank. Code CustomsAuthCodePos1.
• Character 3 may not be 1. Code CustomsAuthCodePos3.

4. Seller tax ID

Missing when required: SellerTaxIdRequired. A value must be 8 digits with a valid checksum: SellerTaxIdLengthError, SellerTaxIdValueError.

Format 22 on the other-doc path, without summary A, may leave the seller tax ID blank.

5. Sales amount

After removing decimal points, more than 12 characters is rejected (the minus sign counts). Code SalesAmtLengthError.

Formats 28 and 29 do not use the “taxable amount must be greater than 0” rule. Zero-rated and exempt rows have no “greater than 0” rule.

6. Tax amount

Tax type 2 or 3: tax must be 0. Code TaxAmtShouldBeZero.

If the tax type is not 1, 2, or 3, the tax formula is skipped (the tax type itself is rejected first).

If format 22, 24, 27, or 25 has not chosen exactly one number path, tax is not checked yet, so the one-of error is not repeated.

When the path is chosen and the tax type is taxable:

× 5% difference: 0 passes; 1–5 is a warning and the save still succeeds; more than 5 is rejected. Default path code TaxAmtNotEqual (warning TaxAmtToleranceWarning). The 22/27 other-doc path uses TaxAmtOtherDocInvalid (warning TaxAmtOtherDocToleranceWarning).

6.1 Average tax per summarized document

Formats 26 and 27, when taxable and the summary quantity is greater than 0: average tax per document may not exceed 500. Code SummaryTaxPerDocExceed.

• Format 26: entered tax ÷ summary quantity.
• Format 27 with tax 0 (tax-inclusive): implied tax is sales × 5% ÷ 1.05, rounded, then divided by the quantity.
• Format 27 with non-zero tax: entered tax ÷ quantity.

7. Tax type by format

8. Summary mark and quantity

Summary mark: A summary, B allocation.

9. Document period and filing period

After both values are valid YYYMM:

Formats 23, 24, and 29 do not also run the 10-year check. They are already limited to the same bi-monthly period.

10. Error codes