Google Sheets
Google Sheets biedt al GOOGLEFINANCE, en voor snelle omrekeningen werken beide methoden. Beide leveren een marktkoers, en de onderstaande formules passen overal waar je normaal GOOGLEFINANCE zou gebruiken. Het verschil zit in de bron. GOOGLEFINANCE noemt geen bronnen en kan niet worden aangepast. Frankfurter is transparant. Als de bron bindend moet zijn, kies je een vaste instelling: de ECB-referentiekoers voor btw, de Poolse NBP of de Braziliaanse PTAX. Bovendien blijven historische koersen stabiel.
Snel aan de slag
Geen installatie of API-sleutel nodig. Plaats een actuele koers met IMPORTDATA en het CSV-endpoint in een cel:
=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd"es=eur") Google Sheets vult een tabel met date,base,quote,rate. De kolom date verschijnt in eerste instantie als serieel getal. Selecteer de kolom en kies Opmaak, Getal, Datum om deze leesbaar weer te geven. Meerdere doelvaluta's vraag je tegelijk op met een door komma's gescheiden lijst:
=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd"es=eur,gbp,jpy")Bedrag omrekenen
IMPORTDATA levert de koers, niet het totale bedrag. Vermenigvuldig je bedrag met de cel van de geïmporteerde koers, of gebruik de aangepaste functie hieronder.
Aangepaste functie
Voor een herbruikbare functie =FRANKFURTER() volstaat een kort Apps Script. Open in je spreadsheet Extensies, Apps Script, plak deze code en sla op:
function FRANKFURTER(amount, from, to, date) {
let url = `https://api.frankfurter.dev/v2/rate/${from}/${to}`;
if (date) url += `?date=${Utilities.formatDate(date, "UTC", "yyyy-MM-dd")}`;
const data = JSON.parse(UrlFetchApp.fetch(url).getContentText());
return amount * data.rate;
}Roep de functie vervolgens aan vanuit elke gewenste cel:
=FRANKFURTER(100, "usd", "eur")Geef een datum mee voor een historische koers:
=FRANKFURTER(100, "usd", "eur", DATE(2020, 1, 2))Officiële bron vastleggen
Standaard ontvang je de samengestelde koers van alle bronnen. Voeg providers toe om een specifieke instelling vast te leggen. Dit is van belang voor belastingen en administratie: veel landen vereisen de koers van hun eigen centrale bank bij het omrekenen van buitenlandse valuta.
=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd"es=eur&providers=ecb")ECB- Referentiekoers van de Europese Centrale Bank, de norm voor EU-btw en douane.
NBP- Narodowy Bank Polski. Poolse btw- en vennootschapsbelasting rekenen om tegen de NBP-koers.
CNB- Tsjechische Nationale Bank, referentie voor Tsjechische boekhouding en belastingen.
BCB- Banco Central do Brasil PTAX, referentie voor Braziliaanse contracten en belastingen.
BANXICO- Banco de México FIX-koers voor het vereffenen van verplichtingen in Amerikaanse dollars.
Bekijk alle bronnen. Een vaste bron volgt haar eigen publicatieschema, waardoor de nieuwste koers een dag kan achterlopen op de samengestelde marktkoers.
Historische tijdreeksen
Gebruik from voor een periode en group=month om deze te comprimeren tot 1 rij per maand, klaar voor grafieken. Hier bewijst Frankfurter zijn waarde: lange, betrouwbare tijdreeksen die nooit achteraf worden aangepast.
=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?from=1949-12-01&base=usd"es=gbp&providers=bbk&group=month") Dit haalt de wisselkoers van de Amerikaanse dollar tegenover het Britse pond op tot 1949 uit het archief van de Deutsche Bundesbank. De fixings van de Bundesbank dekken de dollar tegenover de D-mark vanaf 1948 en de meeste andere dollarkoersen van 1949 tot 1970. Vanaf 1999 neemt de Europese Centrale Bank het over; een doorlopende moderne reeks gebruikt de standaard samengestelde koers of providers=ecb.