VRBL: Tax Categories and Schemes
Read about how to categorize tax and specify tax schemes in your documents.
Tax Categories
Tax Category is the name for the group of tax categorization information. You can use the Tax Category Group (Invoice/TaxTotal/TaxSubtotal/TaxCategory
) and (Invoice/InvoiceLine/TaxTotal/TaxSubtotal/TaxCategory
) subelements of the TaxTotal element to model this information.
Some countries, like Malaysia, require that you use specific values for the Tax Category. This is explained in each country's documentation, like in the Malaysia B2B/B2G: Tax Categories topic.
In addition. other formats may require specific codes. For example, for EN 16931, you must use the codes listed in the EN 16931: Tax Categories topic.
Countries who use VRBL and do not have this requirement can use values from the UNCL5305 list. This code is listed with all the standard values for VRBL in the VRBL: Standard Values topic.
Tax Schemes
A Tax Scheme is the name used to refer to tax programs such as Value Added Tax (VAT).
You use the TaxScheme element to model these.
If a party such as a Supplier or Customer is registered as a participant in the Tax Scheme, you must specify their Tax Scheme ID and the Scheme itself such as VAT.
VAT
The following example shows how to model VAT as the Tax Scheme:
<cac:TaxScheme>
<!-- Default value: VAT -->
<!-- MY tax type in "cac:ClassifiedTaxCategory\cbc:ID" -->
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
Elements
The TaxCategory element contains the following subelements, including the TaxScheme element:
Name (Path) | Cardinality | Description |
---|---|---|
Tax Category Group (Invoice/TaxTotal/TaxSubtotal/TaxCategory ) and (Invoice/InvoiceLine/TaxTotal/TaxSubtotal/TaxCategory ) | Groups information about the Tax Category. | |
Tax Category ID (Invoice/TaxTotal/TaxSubtotal/TaxCategory/ID ) and (Invoice/InvoiceLine/TaxTotal/TaxSubtotal/TaxCategory/ID ) | 1..1 | The Tax Category ID. Use one of the allowed values. |
Tax Category Percent (Invoice/TaxTotal/TaxSubtotal/TaxCategory/Percent ) and (Invoice/InvoiceLine/TaxTotal/TaxSubtotal/TaxCategory/Percent ) | 0..1 | The tax rate for the category. |
Tax Exemption Reason Code (Invoice/TaxTotal/TaxSubtotal/TaxCategory/TaxExemptionReasonCode ) and (Invoice/TaxTotal/TaxSubtotal/TaxCategory/TaxExemptionReasonCode ) | Code that represents the reason for tax exemption. | |
Tax Exemption Reason Description (Invoice/InvoiceLine/TaxTotal/TaxSubtotal/TaxCategory/TaxExemptionReason ) | A description of the reason for the exemption. | |
Tax Exemption Tax Scheme ID (Invoice/TaxTotal/TaxSubtotal/TaxCategory/TaxScheme/ID ) and (Invoice/InvoiceLine/TaxTotal/TaxSubtotal/TaxCategory/TaxScheme/ID ) | 1..1 | The ID of the Tax Scheme. Use VAT . |
Country-Specific configurations
Country specific variations are explained in the following topics:
- Malaysia: Tax Categories
- Sweden: Tax Categories (Line Level)
- Sweden: Tax Categories (Document Level)
Example
The following example is from a Malaysian credit note:
<cac:TaxTotal>
<cbc:TaxAmount currencyID="MYR">0.00</cbc:TaxAmount>
<cac:TaxSubtotal>
<cbc:TaxableAmount currencyID="MYR">6000.00</cbc:TaxableAmount>
<cbc:TaxAmount currencyID="MYR">0.00</cbc:TaxAmount>
<cac:TaxCategory>
<!-- MY Tax types code list: https://sdk.myinvois.hasil.gov.my/codes/tax-types/ (not UNCL5305 compliant) -->
<!-- MY original code: E - Tax exemption -->
<!-- expected code: MY:E - Tax exemption -->
<cbc:ID>VRBL:MY:E</cbc:ID>
<cbc:Percent>0.00</cbc:Percent>
<cbc:TaxExemptionReason>tax exemption reason free text description</cbc:TaxExemptionReason>
<cac:TaxScheme>
<!-- Default value: VAT -->
<!-- MY tax type in "cac:ClassifiedTaxCategory\cbc:ID" -->
<cbc:ID>VAT</cbc:ID>
</cac:TaxScheme>
</cac:TaxCategory>
</cac:TaxSubtotal>
</cac:TaxTotal>
Updated 12 days ago