Zero-rated charge must have a zero VAT rate

Error BR-Z-07 EN 16931

In a Document level charge (BG-21) where the Document level charge VAT category code (BT-102) is "Zero rated" the Document level charge VAT rate (BT-103) shall be 0 (zero).

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

The VAT rate of the zero-rated document-level charge is not zero. For VAT category Z, ram:RateApplicablePercent must have a value of zero.

What the rule means

VAT category Z identifies a zero-rated charge; its specified VAT rate must therefore be exactly zero.

Affected fields BG-21 BT-102 BT-103
Please set the zero-rated charge VAT rate to zero

The VAT rate for the document-level charge with VAT category Z is not zero. Set the rate for this charge to zero.

What to do
  1. Check the value of ram:RateApplicablePercent for the relevant charge.
  2. Check the VAT rate in AddTradeCharge(...).
  3. Generate the invoice again and validate it.
What it looks like
✗ Triggers the message 
<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator>
    <udt:Indicator>true</udt:Indicator>
  </ram:ChargeIndicator>
  <ram:CategoryTradeTax>
    <ram:CategoryCode>Z</ram:CategoryCode>
    <ram:RateApplicablePercent>5</ram:RateApplicablePercent>
  </ram:CategoryTradeTax>
</ram:SpecifiedTradeAllowanceCharge>
✓ Correct 
<ram:SpecifiedTradeAllowanceCharge>
  <ram:ChargeIndicator>
    <udt:Indicator>true</udt:Indicator>
  </ram:ChargeIndicator>
  <ram:CategoryTradeTax>
    <ram:CategoryCode>Z</ram:CategoryCode>
    <ram:RateApplicablePercent>0</ram:RateApplicablePercent>
  </ram:CategoryTradeTax>
</ram:SpecifiedTradeAllowanceCharge>
Check in FactoorSharp
  • TaxCategoryCodes (BT-102)
  • FacturXInvoice.AddTradeCharge(basisAmount, currency, actualAmount, chargePercentage, reason, taxTypeCode, taxCategoryCode, taxPercent, reasonCode) (BG-21)
  • FacturXInvoice.AddTradeeCharge(basisAmount, currency, actualAmount, chargePercentage, reason, taxTypeCode, taxCategoryCode, taxPercent, reasonCode) (BG-21)
  • FacturXInvoice.GetTradeCharges() (BG-21)
  • AbstractTradeAllowanceCharge (Document level charge: BG-21)
Technical details

The XPath compares ram:RateApplicablePercent numerically with zero.

Where the rule applies

The rule applies to ram:RateApplicablePercent of a document-level charge in ram:SpecifiedTradeAllowanceCharge with VAT category Z.

Context (rule/@context)
//ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator='true']/ ram:CategoryTradeTax[ram:CategoryCode = 'Z']
Test expression (assert/@test)
ram:RateApplicablePercent = 0