Tax Exchange Rates

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

Use the TaxExchangeRate element to model this information.

Elements

ElementDescription
Invoice/TaxExchangeRate/SourceCurrencyCodeTo indicate the source or transaction currency. This is the same as the currency specified in the DocumentCurrencyCode.
Invoice/TaxExchangeRate/TargetCurrencyCodeTo indicate the destination currency.
Invoice/TaxExchangeRate/CalculationRateThe exchange rate. The rate is used to calculate the exchange. If the source currency is USD, then the USD amount equals this rate multiplied by the target currency.

Country Specific Configurations

Example

In this example, the DocumentCurrencyCode is 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 2 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>