Use the “Not subject to VAT” category consistently

Error BR-O-12 EN 16931

An Invoice that contains a VAT breakdown group (BG-23) with a VAT category code (BT-118) "Not subject to VAT" shall not contain an Invoice line (BG-25) where the Invoiced item VAT category code (BT-151) is not "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

The VAT breakdown uses category O for “Not subject to VAT”, but at least one ram:ApplicableTradeTax entry has a different category. As a result, the categories in the VAT breakdown and on invoice lines are inconsistent.

What the rule means

Category O identifies transactions that are not subject to VAT. When this category is used in the VAT breakdown, the corresponding invoice lines must also be marked with O.

Affected fields BG-23 BT-118 BG-25 BT-151
Please use “Not subject to VAT” for the VAT breakdown and invoice lines

The VAT breakdown indicates category O, while at least one VAT entry uses another category. You can make the VAT breakdown and invoice-line information consistent.

What to do
  1. Check the category in ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax/ram:CategoryCode.
  2. Check the category entries in ram:IncludedSupplyChainTradeLineItem/ram:SpecifiedLineTradeSettlement/ram:ApplicableTradeTax/ram:CategoryCode.
  3. Make sure the relevant entries use category O.
  4. Generate the invoice again and validate it again.
What it looks like
✗ Triggers the message
<ram:ApplicableTradeTax>
  <ram:CategoryCode>O</ram:CategoryCode>
</ram:ApplicableTradeTax>
<ram:IncludedSupplyChainTradeLineItem>
  <ram:SpecifiedLineTradeSettlement>
    <ram:ApplicableTradeTax>
      <ram:CategoryCode>S</ram:CategoryCode>
    </ram:ApplicableTradeTax>
  </ram:SpecifiedLineTradeSettlement>
</ram:IncludedSupplyChainTradeLineItem>
✓ Correct
<ram:ApplicableTradeTax>
  <ram:CategoryCode>O</ram:CategoryCode>
</ram:ApplicableTradeTax>
<ram:IncludedSupplyChainTradeLineItem>
  <ram:SpecifiedLineTradeSettlement>
    <ram:ApplicableTradeTax>
      <ram:CategoryCode>O</ram:CategoryCode>
    </ram:ApplicableTradeTax>
  </ram:SpecifiedLineTradeSettlement>
</ram:IncludedSupplyChainTradeLineItem>
Check in FactoorSharp
  • TaxCategoryCodes (BT-151; BT-118)
  • TradeLineItem.TaxCategoryCode (BT-151)
  • TradeLineItem.TaxType (BT-151-0)
  • FacturXInvoice.AddApplicableTradeTax(basisAmount, percent, taxAmount, typeCode, categoryCode, allowanceChargeBasisAmount, exemptionReasonCode, exemptionReason, lineTotalBasisAmount) (BG-23)
  • FacturXInvoice.AnyApplicableTradeTaxes() (BG-23)
Technical details

The test fails if any ram:ApplicableTradeTax in the document contains a ram:CategoryCode other than O.

Where the rule applies

This rule concerns the VAT breakdown in ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax and the VAT information on invoice lines under ram:IncludedSupplyChainTradeLineItem.

Context (rule/@context)
//rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:ApplicableTradeTax[ram:CategoryCode = 'O']
Test expression (assert/@test)
not(//ram:ApplicableTradeTax[ram:CategoryCode != 'O'])