VRBL: Modeling Tax Information
Read about how tax information is modeled.
General VRBL tax requirements
When modeling tax in VRBL, the following requirements exist:
- Each line item must have one Tax Category ID in the
Invoice/InvoiceLine/Item/ClassifiedTaxCategory/ID
element. - Each Tax Category ID must also have an associated tax rate in the
Invoice/InvoiceLine/Item/ClassifiedTaxCategory/Percent
element. - Each Allowance or Charge must have one Tax Category ID in the
Invoice/AllowanceCharge[ChargeIndicator='false|true']/TaxCategory/ID
element. - Each Tax Category ID must also have an associated tax rate in the
Invoice/AllowanceCharge[ChargeIndicator='false|true']/TaxCategory/Percent
element.
Other formats
EN 16931 requirements
If you are creating Documents for an EN 16931 compatible country, like France, then you also need to consider its requirements for modelling things like the Tax Category. More information is provided in the EN 16931: Tax Categories topic.
PEPPOL requirements
PEPPOL also has requirements for how you model tax exemptions. More information is provided in the PEPPOL: Tax Exemptions topic.
Country specific requirements
The following countries also have some specific requirements:
Examples
Standard rate
The following example shows a standard rate of 25%:
<Invoice>
<!-- code omitted for clarity -->
<cac:TaxTotal>
<cbc:TaxAmount currencyID="EUR">400.00</cbc:TaxAmount>
<!-- First Tax Breakdown: Standard Rate 25% -->
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="EUR">1000.00</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="EUR">250.00</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>25.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
<!-- code omitted for clarity -->
</Invoice>
Standard rate 15%
The following example shows a standard rate of 15%:
<Invoice>
<!-- code omitted for clarity -->
<cac:TaxTotal>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="EUR">1000.00</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="EUR">150.00</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID>S</cbc:ID>
<cbc:Percent>15.00</cbc:Percent>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
<!-- code omitted for clarity -->
</Invoice>
Tax exemption
The following example shows a tax exemption. Note that the rate is still required even though it is zero:
<Invoice>
<!-- code omitted for clarity -->
<cac:TaxTotal>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="EUR">1000.00</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="EUR">0.00</cbc:TaxAmount>
<cac:TaxCategory>
<cbc:ID>E</cbc:ID>
<cbc:Percent>0.00</cbc:Percent>
<cbc:TaxExemptionReasonCode>VATEX-EU-F</cbc:TaxExemptionReasonCode>
<cac:TaxScheme>
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal
</cac:TaxTotal>
<!-- code omitted for clarity -->
</Invoice>
Tax calculations
You must also model the tax calculations correctly. See Modeling Tax Calculations.
Updated 12 days ago