Spain B2G: Document-Level Tax Exchange Rate

Read about how you can model an exchange rate at the Document level.

For Spanish B2G Documents, if the Document Currency Code (DocumentCurrencyCode) is not the same as the Tax Currency Code (TaxCurrencyCode), you need to specify the following:

  • The exchange rate in the Calculation Rate (CalculationRate) element.
  • The date that the exchange was calculated in the Date (Date) element.

Elements

The following elements are grouped in the Tax Exchange Rate (/Invoice/cac:TaxExchangeRate) element:

Name (Technical Name)CardinalityDescription
Source Currency Code (SourceCurrencyCode)1..1Specify the source currency that the amount is converted from.
Target Currency Code (TargetCurrencyCode)1..1Specify the currency that the amount is converted into.
Calculation Rate (CalculationRate)1..1The rate used to calculate the exchange. This is a multiplicative factor. For example, a rate of 1.05 represents a rate of 5%.
Date (Date)1..1Specify the date when the exchange rate was calculated.

Example

<Invoice>
    <!-- Code omitted for clarity -->
    <cac:TaxExchangeRate>
        <cbc:SourceCurrencyCode>USD</cbc:SourceCurrencyCode>
        <cbc:TargetCurrencyCode>EUR</cbc:TargetCurrencyCode>
        <cbc:CalculationRate>1.05</cbc:CalculationRate>
        <cbc:Date>2025-02-19</cbc:Date>
    </cac:TaxExchangeRate>
     <!-- Code omitted for clarity -->
</Invoice>