VAT breakdown for transactions not subject to VAT

Error BR-O-01 EN 16931

An Invoice that contains an Invoice line (BG-25), a Document level allowance (BG-20) or a Document level charge (BG-21) where the VAT category code (BT-151, BT-95 or BT-102) is "Not subject to VAT" shall contain exactly one VAT breakdown group (BG-23) with the VAT category code (BT-118) equal to "Not subject to VAT".

Mandatory rule: As long as it is violated, the invoice is invalid and will be rejected by validators.
What is wrong

If the document-level VAT breakdown contains an entry whose ram:CategoryCode is O, there must be exactly one such entry. In addition, O must occur in an invoice line or in ram:CategoryTradeTax.

What the rule means

O denotes the category “not subject to VAT”. The VAT breakdown must report the use of this category unambiguously and consistently with the invoice details.

Please align the VAT breakdown for `O`

Category O is present in the document-level VAT breakdown, but the entries do not meet the rule. You can align the number of entries and the related invoice details.

What to do
  1. Check the entries with ram:CategoryCode equal to O in the VAT breakdown.
  2. Make sure exactly one matching ram:ApplicableTradeTax entry is present there.
  3. Check that O also occurs in an invoice line or in ram:CategoryTradeTax.
  4. Generate the invoice again and validate it.
Check in FactoorSharp
  • TaxCategoryCodes (BT-151; BT-95; BT-102; BT-118)
  • FacturXInvoice.AddApplicableTradeTax(basisAmount, percent, taxAmount, typeCode, categoryCode, allowanceChargeBasisAmount, exemptionReasonCode, exemptionReason, lineTotalBasisAmount) (BG-23)
  • FacturXInvoice.AnyApplicableTradeTaxes() (BG-23)
  • FacturXInvoice.GetApplicableTradeTaxes() (BG-23)
  • FacturXInvoice.Taxes (BG-23)
Technical details

The test passes an invoice with no O under ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax. If such entries exist, it requires exactly one and at least one O entry in one of the checked detail paths.

Where the rule applies

This rule applies to the entire invoice. It checks ram:ApplicableTradeTax in the document-level VAT breakdown, as well as category entries in invoice lines and ram:CategoryTradeTax.

Context (rule/@context)
/rsm:CrossIndustryInvoice
Test expression (assert/@test)
not(//ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax[ram:CategoryCode='O']) or ( count(//ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax[ram:CategoryCode='O'])=1 and ( exists(//ram:SpecifiedLineTradeSettlement/ram:ApplicableTradeTax[ram:CategoryCode='O']) or exists(//ram:CategoryTradeTax[ram:CategoryCode='O']) ) )