Other currency than EUR

Using another currency than EUR in France

Scenario

When you are sending from a French company, you might need to issue the invoice in another currency than EUR.

This can apply to:

invoices to customers outside France
Invoices to customers in France

In that case, additional information is required : the tax totals must be in the foreign currency and in EUR. In order to reach this goal

2 scenario's :

If you do not include in the API body the foreign currency rate, Billit will add the current foreign currency rate.
If you include your foreign currency rate in the API-body, Billit will use this one. This does allow you to stay in line with the amounts in your invoicing/ERP-software.

In the outgoing file, the VAT amount will be expressed in 2 currencies:

Total VAT amount in the currency of the invoice including details.
Total VAT amount in EUR (total amount only).

Example below:

Tab 1 : API content with foreign currency (USD).
Tab 2 : UBL output, the Tax totals (USD and EUR).

{
  "OrderNumber": "4098999",
  "Reference": "45123456789",
  "Currency": "USD",  //Foreign currency
  "OrderDate": "2026-10-23",
  "ExpiryDate": "2026-12-30",
  "OrderType": "Invoice",
  "Comments": "Additional text info on header ",
  "OrderDirection": "Income",
  "FXRateToForeign": 1.12670,  //Conversion rate foreign currency if you want to use your currency, otherwise Billit adds 
   "Customer": {
        "Name": "TESTCOMPANY FRANCE",
        "Addresses": [
            {
                "AddressType": "InvoiceAddress",
                "Name": "TESTCOMPANY FRANCE",
                "Street": "Teststreet",
                "StreetNumber": "1",
                "Zipcode": "59000",
                "City": "Paris",
                "CountryCode": "BE"
            }
        ],
        "VATNumber": "FR99227010068",
        "PartyType": "Customer",
        "VATLiable": true,
        "Language": "EN",
        "VATDeductable": true,
    "Identifiers": [
            {
                "IdentifierType": "CTC",
                "Identifier": "227010068_545525",
            },
            {
                "IdentifierType": "SIREN",
                "Identifier": "227010068",
                       }
        ]
},
	"OrderLines": [
		{
			"Quantity": 1.0,
			"UnitPriceExcl": 1.00,
			"Description": "test", 
			"VATPercentage": 20.00
		},
	]
}

 <cac:TaxTotal>
    <cbc:TaxAmount currencyID="USD">0.20</cbc:TaxAmount>
    <cac:TaxSubtotal>
      <cbc:TaxableAmount currencyID="USD">1.00</cbc:TaxableAmount>
      <cbc:TaxAmount currencyID="USD">0.20</cbc:TaxAmount>
      <cac:TaxCategory>
        <cbc:ID>S</cbc:ID>
        <cbc:Percent>20.00</cbc:Percent>
        <cac:TaxScheme>
          <cbc:ID>VAT</cbc:ID>
        </cac:TaxScheme>
      </cac:TaxCategory>
    </cac:TaxSubtotal>
  </cac:TaxTotal>
  <cac:TaxTotal>

Updated about 22 hours ago

Did this page help you?