VRBL: Withholding Taxes
Some tax can be withheld and you can model this for your Documents.
Elements
Use the WithholdingTaxTotal element to specify the total withheld tax:
| Name (Technical Name) | Cardinality | Description | 
|---|---|---|
| Withholding Total Group ( Invoice/WithholdingTaxTotal) | Groups information about withheld tax. | |
| Invoice Total Withheld Tax Amount ( TaxAmount) | 1..1 | The total withheld tax amount for the Document or line. | 
| Withheld Tax Category Taxable Amount ( TaxSubtotal/TaxableAmount) | 1..1 | Sum of all withheld taxable amounts subject to a specific tax category code and tax category rate (if the tax category rate is applicable). | 
| Withheld Tax Category Tax Amount  ( TaxSubtotal/TaxAmount) | 1..1 | The total tax amount for a given withheld tax category. | 
| Withheld Tax Category Code ( TaxSubtotal/TaxCategory/ID) | 1..1 | Category and withholding tax code applied to the respective subtotal. You must use IRF. See Tax Categories and Schemes. | 
| Withheld Tax Category Rate ( TaxSubtotal/TaxCategory/Percentage) | 0..1 | The withheld tax rate, represented as percentage that applies for the relevant tax category. | 
| Withheld Tax Exemption Reason Code ( TaxSubtotal/TaxCategory/TaxExemptionReasonCode) | 0..1 | A coded statement of the reason for why the amount is exempted from withheld tax. See Tax Exemptions. | 
| Withheld Tax Exemption Reason Text ( TaxSubtotal/TaxCategory/TaxExemptionReason) | 0..1 | A textual statement of the reason why the amount is exempted from withheld tax. See Tax Exemptions. | 
| Withheld Tax Scheme Code ( TaxSubtotal/TaxCategory/TaxScheme/ID) | 1..1 | The scheme of the withheld tax category. See Tax Categories and Schemes. | 
Country-Specific Elements
- Spain B2G: Document-Level Withheld Taxes
- Spain B2G: Line-Level Withheld Taxes
- Portugal: Withholding Tax Total
- Italy: Withholding Tax Type Code
Extensions
Example
<ubl:Invoice>
    <!-- Code omitted for clarity -->
    <cac:WithholdingTaxTotal>
        <cbc:TaxAmount currencyID="EUR">10.00</cbc:TaxAmount>
        <cac:TaxSubtotal>
            <cec:UBLExtensions>
                <cec:UBLExtension>
                    <cec:ExtensionContent>
                        <vrbl:WithholdingTaxSubtotalExtension>
                            <cbc:Description>Withholding tax description</cbc:Description>
                        </vrbl:WithholdingTaxSubtotalExtension>
                    </cec:ExtensionContent>
                </cec:UBLExtension>
            </cec:UBLExtensions>
            <cbc:TaxAmount currencyID="EUR">10.00</cbc:TaxAmount>
            <cac:TaxCategory>
                <cbc:ID>IFR</cbc:ID>
                <cac:TaxScheme>
                    <cbc:ID>VAT</cbc:ID>
                </cac:TaxScheme>
            </cac:TaxCategory>
        </cac:TaxSubtotal>
    </cac:WithholdingTaxTotal>
    <!-- Code omitted for clarity -->
</ubl:Invoice>
Updated 4 months ago
