Seller tax identifier for a category Z allowance

Error BR-Z-03 EN 16931

An Invoice that contains a Document level allowance (BG-20) where the Document level allowance VAT category code (BT-95) is "Zero rated" shall contain the Seller VAT Identifier (BT-31), the Seller tax registration identifier (BT-32) and/or the Seller tax representative VAT identifier (BT-63).

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

The invoice contains neither a seller tax registration with schemeID VA or FC nor a tax registration for the seller’s tax representative with schemeID VA. The test requires at least one of these details.

What the rule means

For an allowance in category Z, the invoice must contain one of the seller or seller tax representative registrations allowed by the test.

Affected fields BG-20 BT-95 BT-31 BT-32 BT-63
Please add an accepted tax identifier for the seller or the seller’s tax representative

The invoice contains a category Z allowance but none of the tax identifiers checked for it. You can add the seller’s identifier or the tax representative’s identifier.

What to do
  1. Add a seller tax registration with schemeID VA or FC, or add a tax representative registration with schemeID VA.
  2. For this, check AddSellerTaxRegistration(...) and the relevant LegalOrganization.ID.
  3. Generate the invoice again and validate it once more.
Check in FactoorSharp
  • LegalOrganization.ID (SellerTradeParty: BT-31; SellerTradeParty: BT-32; SellerTaxRepresentativeTradeParty: BT-63)
  • TaxRegistration.SchemeID (For Seller VAT identifier: BT-31; For Seller tax registration identifier: BT-32)
  • FacturXInvoice.AddSellerTaxRegistration(no, schemeID) (BT-31)
  • FacturXInvoice.GetSellerTaxRegistration() (BT-31)
  • FacturXInvoice.GetSellerTaxRepresentativeTaxRegistration() (BT-63)
Good to know

For the seller registration, VA and FC are accepted schemeID values; for the tax representative, the accepted value is VA.

Technical details

At invoice level, the XPath checks two alternative paths: a seller ID with schemeID VA or FC, or a tax representative ID with schemeID VA.

Where the rule applies

The rule applies to invoices with a document-level allowance whose VAT category is Z. It checks the tax registrations of the seller and the seller’s tax representative.

Context (rule/@context)
//ram:SpecifiedTradeAllowanceCharge[ram:ChargeIndicator/udt:Indicator='false']/ ram:CategoryTradeTax[ram:CategoryCode = 'Z']
Test expression (assert/@test)
/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeAgreement/ ram:SellerTradeParty/ram:SpecifiedTaxRegistration/ram:ID[@schemeID = ('VA', 'FC')] or /rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeAgreement/ ram:SellerTaxRepresentativeTradeParty/ram:SpecifiedTaxRegistration/ram:ID[@schemeID = 'VA']