Modeling Tax Information
Read about how tax information is modeled.
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.
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 3 days ago