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:
Element | Cardinality | Description |
---|---|---|
Tax Exchange Rate (Invoice/TaxExchangeRate/ ) | 0..1 | A group of elements that specify the tax exchange rate that is applied to the Document amounts. |
Source Currency Code (Invoice/TaxExchangeRate/SourceCurrencyCode ) | 1..1 | Indicates the source or transaction currency. This is the same as the currency specified in the DocumentCurrencyCode element. |
Target Currency Code (Invoice/TaxExchangeRate/TargetCurrencyCode ) | 1..1 | To indicate the destination currency. |
Calculation Rate (Invoice/TaxExchangeRate/CalculationRate ) | 1..1 | The 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
- Malaysia: Tax for Foreign Currency Transactions
- Portugal: Tax Exchange Rate
- Poland B2B: Tax Exchange Rate
- Spain B2G: Document-Level Taxes in Tax Currency
- Spain B2G: Line-Level Taxes in Document Currency
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>
Updated 15 days ago