Häufige Fragen
Antworten zur Umsatzsteuer-Umrechnungskurse-API: Datenherkunft, Aktualisierungsfrequenz, Zugang, Limits und Verwendung in Buchhaltungs- und Steuerprozessen.
Antworten
Was ist die Umsatzsteuer-Umrechnungskurse-API?
Eine REST/JSON-Schnittstelle, die die vom Bundesfinanzministerium monatlich veröffentlichten Euro-Referenzkurse zur Umrechnung in Fremdwährung gestellter Rechnungen für die Umsatzsteuer (§ 16 Abs. 6 UStG) maschinenlesbar bereitstellt.
Woher stammen die Kurse?
Direkt aus den Originalveröffentlichungen des Bundesfinanzministeriums (BMF). Die monatlichen und jährlichen PDFs werden automatisch importiert und in einer Postgres-Datenbank vorgehalten.
Wie häufig werden die Daten aktualisiert?
Monatlich, kurz nachdem das BMF die neuen Kurse veröffentlicht. Ein geplanter Job am 5. jedes Monats prüft auf neue Veröffentlichungen und importiert sie idempotent.
Wie bekomme ich einen API-Schlüssel?
Schreiben Sie eine kurze E-Mail an dimitri.missoh+uuk@gmail.com mit einer Beschreibung Ihres Anwendungsfalls. Tokens werden manuell ausgestellt, um Missbrauch zu verhindern.
Was kostet die Nutzung?
Die API ist für faire Nutzung kostenfrei. Wer die Bereitstellung unterstützen möchte, kann das über den Buy-me-a-coffee-Link auf der Startseite tun.
Welche Rate-Limits gelten?
60 Anfragen pro Minute pro API-Schlüssel mit gleitendem Zeitfenster. Antworten enthalten X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset; bei Überschreitung folgt 429 mit Retry-After.
Gibt es Jahresdurchschnittskurse?
Ja. Sobald das BMF die jährliche Gesamtübersicht veröffentlicht und alle zwölf Monate als final bestätigt sind, wird der Jahresdurchschnitt automatisch berechnet und über /api/v1/rates/yearly bereitgestellt.
Darf ich die Kurse für meine Umsatzsteuererklärung verwenden?
Ja. Es handelt sich um die offiziellen BMF-Kurse, die für USt-Zwecke vorgesehen sind. Diese API stellt sie lediglich strukturiert bereit. Für die rechtliche Verbindlichkeit gilt die Originalveröffentlichung des BMF.
Kann ich die Antworten cachen?
Ja. Antworten enthalten passende Cache-Control-Header. Da die Kurse pro Monat unverändert bleiben, sind Caches mit Stunden- oder Tagesgranularität sinnvoll.
Was passiert, wenn das BMF das PDF-Format ändert?
Der Importer wird nachgezogen, sobald die Änderung bekannt ist. In der Zwischenzeit bleiben bereits geladene Monate unverändert verfügbar; lediglich neue Monate fehlen, bis der Import angepasst wurde.