VRBL: Tax Exchange Rates

If your Documents use foreign currency exchanges, you can capture this information.

Elements

Use the TaxExchangeRate element to model this information:

ElementCardinalityDescription
Tax Exchange Rate (Invoice/TaxExchangeRate/)0..1A group of elements that specify the tax exchange rate that is applied to the Document amounts.
Source Currency Code (Invoice/TaxExchangeRate/SourceCurrencyCode)1..1Indicates the source or transaction currency. This is the same as the currency specified in the DocumentCurrencyCode element.
Target Currency Code (Invoice/TaxExchangeRate/TargetCurrencyCode)1..1To indicate the destination currency.
Calculation Rate (Invoice/TaxExchangeRate/CalculationRate)1..1The exchange rate. The rate is used to calculate the exchange. If the source currency is in USD, then the USD amount equals this rate multiplied by the target currency.

Country-Specific Configurations

Example

In this example, the DocumentCurrencyCode is the US Dollar and it has to be converted to MYR. The details are specified in the following example:


<ubl:Invoice>
    <!-- Code omitted for clarity -->
    <cac:TaxExchangeRate>
        <cbc:SourceCurrencyCode>USD</cbc:SourceCurrencyCode>
        <cbc:TargetCurrencyCode>MYR</cbc:TargetCurrencyCode>
        <cbc:CalculationRate>4.733</cbc:CalculationRate>
    </cac:TaxExchangeRate>
     <!-- Code omitted for clarity -->
</ubl:Invoice>

The following example shows two groups: the first for USD and the second for MYR:

<ubl:Invoice>
    <!-- Code omitted for clarity -->
    
    <!-- first tax total group in document (foreign) currency (example: USD) -->
    <cac:TaxTotal>
        <cbc:TaxAmount currencyID="USD">285</cbc:TaxAmount>
        <cac:TaxSubtotal>
            <cbc:TaxableAmount currencyID="USD">1900</cbc:TaxableAmount>
            <cbc:TaxAmount currencyID="USD">285</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>
    </cac:TaxTotal>
    
    <!-- second tax total group in tax currency (MYR) -->
    <cac:TaxTotal>
        <cbc:TaxAmount currencyID="MYR">1348.91</cbc:TaxAmount>
        <cac:TaxSubtotal>
            <cbc:TaxableAmount currencyID="MYR">8992.70</cbc:TaxableAmount>
            <cbc:TaxAmount currencyID="MYR">1348.91</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>
    </cac:TaxTotal>
     <!-- Code omitted for clarity -->
</ubl:Invoice>