Was ist eine Accounting-API? Ein Praxisleitfaden für Plattform-Entwickler

Eine praxisnahe Definition der Accounting-API, die Abgrenzung zu einer Steuer- oder Zahlungs-API und worauf Sie vor der Integration achten sollten.

Eine Accounting-API ist eine Schnittstelle, mit der ein Programm die Buchhaltung eines anderen Programms führen kann. Ihre Software sendet einen finanziellen Vorfall über HTTP. Die API wandelt diesen Vorfall in ausgeglichene Buchungssätze der doppelten Buchführung (double-entry) auf Konten des Kontenplans um, speichert sie so, dass sie nicht unbemerkt verändert werden können, wendet die korrekte steuerliche Behandlung an und gibt Ihnen über dieselbe Schnittstelle Berichte, Dokumente und Exporte zurück.

Diese Definition deckt den größten Teil ab. Alles andere in diesem Artikel ergibt sich logisch daraus.

In einem Satz

Eine Accounting-API nimmt finanzielle Vorfälle von Ihrer Anwendung entgegen, konvertiert jeden Einzelnen in einen ausgeglichenen Buchungssatz, speichert ihn unveränderlich (immutable) samt steuerlicher Behandlung und Belegen und stellt das resultierende Hauptbuch (ledger), Dokumente und Berichte als programmierbare Endpunkte bereit.

Wenn sich ein Produkt als Accounting-API bezeichnet, aber keine Buchungssätze erzeugt, handelt es sich um etwas anderes mit einem guten Namen. Das muss nicht unbedingt schlecht sein. Es bedeutet lediglich, dass dieses Tool nicht die Aufgabe übernimmt, für die Sie es einsetzen möchten.

Was eine Accounting-API nicht ist

Vier benachbarte Produktkategorien werden, meist im fortgeschrittenen Stadium eines Projekts, häufig mit Accounting-APIs verwechselt.

Kategorie	Was sie tut	Was sie nicht tut
Steuerberechnungs-API (Tax calculation API)	Liefert den korrekten Steuersatz oder Steuerbetrag für eine Transaktion	Ihre Bücher führen oder die Nachweise hinter der Entscheidung für die gesetzliche Aufbewahrungsfrist speichern
Zahlungs-API (Payments API)	Bewegt Geld zwischen Parteien und berichtet über diese Bewegungen	ErfassteProvisionen, geschuldete Mehrwertsteuer oder Verbindlichkeiten gegenüber Verkäufern zwischen Zahlung und Auszahlung verbuchen
Unified- oder Aggregator-API	Liest und schreibt Daten in der bestehenden Buchhaltungssoftware Ihrer Kunden	Als führendes System (System of Record) fungieren; Ihre Bücher befinden sich in dem Tool, das der jeweilige Kunde bereits nutzt
Reporting- oder BI-API	Liest Kennzahlen aus einem bestehenden Hauptbuch aus und visualisiert sie	Die Buchungssätze erstellen, aus denen die Kennzahlen abgeleitet werden

Jede dieser Lösungen hat ihren berechtigten Einsatzbereich. Eine Plattform, die als führendes System fungieren muss, benötigt die Accounting-API jedoch als Fundament im Hintergrund und nicht als Ersatz.

Die fünf Kernaufgaben einer Accounting-API

1. Ausgeglichene Buchungen erfassen. Jeder Vorfall wird in Soll und Haben aufgeteilt, die exakt denselben Betrag ergeben. Wenn ein Käufer auf einem Marktplatz 100 EUR bezahlt, der eine Provision von 15 EUR einbehält, lautet die Buchung: Soll Verrechnungskonto 100 EUR, Haben Verbindlichkeit gegenüber Verkäufer 85 EUR und Haben Provisionserlöse 15 EUR. Das ist kein bürokratisches Ritual, sondern eine strukturelle Prüfung, die ganze Klassen von Integrationsfehlern abfängt, bevor sie in einem Bericht landen.

2. Historie bewahren. Ein festgeschriebener (posted) Beleg wird nicht mehr bearbeitet. Ein Fehler wird durch eine Stornierung plus eine korrigierte Buchung behoben, wobei beide mit dem Original verknüpft sind. Abgeschlossene Monate werden gesperrt, sodass keine neuen Buchungen mehr hineindatiert werden können.

3. Steuern ermitteln. Bei EU-Geschäften bedeutet dies: Bestimmung des Leistungsorts (place of supply), Steuerschuldnerschaft des Leistungsempfängers (reverse charge), Validierung von Umsatzsteuer-Identifikationsnummern gegen das offizielle Register sowie Speicherung der Nachweise für die steuerliche Einstufung direkt an der Transaktion, anstatt diese nach der Berechnung zu verwerfen.

4. Mit externem Geld abstimmen. Bücher, die niemals mit einem Kontoauszug abgeglichen werden, beruhen auf Vermutungen. Die API muss Kontoauszüge oder Auszahlungsberichte von Zahlungsdienstleistern einlesen und diese mit den erfassten Daten abgleichen (Reconciliation).

5. Exportieren. Berichte, Dokumente und Prüfdateien in Formaten, die von Wirtschaftsprüfern, Buchhaltern und Finanzbehörden akzeptiert werden.

Ein Produkt, das die ersten drei Punkte erfüllt, die letzten beiden jedoch nicht, führt dazu, dass Mitarbeiter am Monatsende dennoch manuell in Tabellenkalkulationen arbeiten müssen.

Wie ein API-Aufruf in der Praxis aussieht

Die technische Mechanik ist unkomplizierter als das Rechnungswesen. In der API von Nordlet ist jede Operation ein RPC-ähnlicher POST-Request mit einer vorhersehbaren Struktur:

POST /v1/{module}/{resource}/{action}
Authorization: Bearer <api key>
Idempotency-Key: <your event id>

Sie erstellen eine Ausgangsrechnung und geben diese anschließend frei (issue). Die Freigabe ist der Moment, in dem die Buchhaltung stattfindet: Das Dokument erhält seine lückenlose Nummer, der ausgeglichene Buchungssatz wird erstellt und die Mehrwertsteuerzeilen werden mitdokumentiert. Ihre Plattform muss Soll und Haben zu keinem Zeitpunkt manuell zusammenstellen.

Drei Details in diesem Code-Snippet sind wichtiger als der Name des Endpunkts:

Der Gültigkeitsbereich des Schlüssels (Scope). Ein Schlüssel besitzt gezielte Berechtigungen wie sales:write, sodass eine Integration nur den Zugriff erhält, den sie tatsächlich benötigt.
Der Idempotenz-Schlüssel (Idempotency-Key). Wenn Sie dieselbe Anfrage mit demselben Payload wiederholen, erhalten Sie die gespeicherte Antwort zurück und keine zweite Rechnung. Senden Sie denselben Schlüssel mit einem anderen Payload, wird die Anfrage mit idempotency_key_reuse abgelehnt, anstatt sie stillschweigend zu verarbeiten.
Geldbeträge als Strings. Beträge werden als dezimale Zeichenketten und nicht als Gleitkommazahlen (Floats) übergeben, da Gleitkommazahlen bei Rundungen Cent-Beträge verlieren können, was spätestens beim Jahresabschluss auffällt.

Die Einbindung in Ihre Architektur

Ihre Anwendung bleibt das Frontend und die Quelle der Geschäftsvorfälle. Die Accounting-API fungiert dahinter als das finanzielle Hauptbuch (System of Record). Der Ablauf sieht in der Regel so aus:

In Ihrem Produkt findet ein Ereignis statt: eine Bestellung, eine Rückerstattung, eine Auszahlung oder die Verlängerung eines Abonnements.
Ihr Backend ruft die Accounting-API mit dem Ereignis und einem Idempotenz-Schlüssel auf.
Die API erstellt den Buchungssatz, wendet die Mehrwertsteuer an und gibt IDs zurück, die Sie in Ihren eigenen Datensätzen speichern.
Ein Webhook wie sale_invoice.paid informiert Ihr System über Statusänderungen, sodass Sie direkt auf Ereignisse reagieren können, anstatt diese abzufragen (Polling).
Banktransaktionen gehen über einen Bank-Feed oder einen Kontoauszugsimport ein und werden mit den erfassten Belegen abgeglichen.
Zum Periodenende werden Berichte und Steuerregister aus denselben Daten generiert und der abgeschlossene Monat wird gesperrt.

Nichts in dieser Liste erfordert, dass ein Mensch eine Buchhaltungssoftware öffnen muss. Genau das ist der Zweck dieser Produktkategorie.

Vergleich mit alternativen Ansätzen

Ansatz	Aufwand zum Start	Prüfungssicherheit (Audit)	Skalierbarkeit bei hohem Transaktionsvolumen
Tabellenkalkulation und manuelle Erfassung	Sehr gering	Gering; Historie ist veränderbar	Nein
Buchhaltungssoftware plus CSV-Exporte	Gering	Hängt vollständig von interner Disziplin ab	Schlecht; Personen müssen Dateien importieren
Aggregator-API in die Bücher jedes Kunden	Mittel	Entspricht dem Standard des Kundentools	Ja, aber Sie besitzen die Datenbasis nicht selbst
Embedded Accounting-API	Mittel	Hoch, wenn das Hauptbuch unveränderlich ist und Perioden sperrbar sind	Ja
Eigenentwicklung eines Hauptbuchs	Sehr hoch	Nur hoch, wenn Sie die Kontrollen selbst implementieren	Ja, und Sie müssen es dauerhaft warten

Die Eigenentwicklung kann für bestimmte Teams eine sinnvolle Entscheidung sein. Dies wird in unserem Leitfaden zur Entscheidung zwischen Eigenentwicklung und Kauf für Marktplätze genauer erläutert.

Worauf Sie vor der Integration achten sollten

Wird der Kontostand berechnet oder fest gespeichert? Fragen Sie nach, ob ein Kundensaldo dynamisch aus Buchungszeilen abgefragt oder in einer Spalte fortgeschrieben wird. Nur eine dieser Varianten hält einer Betriebsprüfung stand.
Wie verhält sich das System bei einer Wiederholung (Retry)? Senden Sie dieselbe Anfrage zweimal und zählen Sie die erzeugten Buchungen.
Können festgeschriebene Buchungen bearbeitet werden? Die Antwort sollte Nein lauten, flankiert von einem dokumentierten Korrekturprozess.
Lehnt eine gesperrte Periode Buchungen tatsächlich ab? Testen Sie dies in einer Sandbox. Nordlet gibt für Buchungen in einer gesperrten Periode den HTTP-Status 409 zurück.
Wie werden Geldbeträge dargestellt? Als Dezimal-Strings oder ganzzahlige kleinste Währungseinheiten (Minor Units). Niemals als Floats.
Was enthält das Auditsystem? Akteur, Aktion, Entität und die Änderung selbst – über Abfragen auffindbar, anstatt in Logdateien begraben zu sein.
Wie lauten die Rate Limits? Nordlet erlaubt 300 Anfragen pro Minute und API-Schlüssel und meldet das verbleibende Kontingent in den Antwort-Headern. Unabhängig vom konkreten Wert sollten Sie diesen kennen, bevor Sie Ihre Synchronisation entwerfen.
Wie gelangen Sie an Ihre Daten? Berichte, Dokumente und Journale in Formaten, die Sie an einen Steuerberater übergeben können.

Jeder dieser Punkte lässt sich innerhalb eines Nachmittags in einer Sandbox-Umgebung testen. Marketing-Funktionslisten der Anbieter sind kein Beweis, ein reproduzierbarer Test schon.

FAQ

Ist eine Accounting-API dasselbe wie eine Buchhaltungssoftware?

Es ist eine Buchhaltungssoftware mit einer verlagerten Schnittstelle. Herkömmliche Buchhaltungssoftware stellt einen Menschen vor das Hauptbuch; eine Accounting-API platziert stattdessen Ihren Code dort. Die zugrundeliegenden Pflichten, die doppelte Buchführung und die Berichte bleiben exakt dieselben.

Benötige ich weiterhin einen Steuerberater, wenn ich eine solche API nutze?

Ja. Eine API automatisiert die Erfassung, Berechnung und Berichterstattung. Sie trifft jedoch keine Ermessensentscheidungen über Bilanzierungsfragen, Rückstellungen oder die steuerliche Würdigung spezieller Verträge und unterzeichnet oder übermittelt in den meisten Ländern auch nicht Ihre gesetzlichen Abschlüsse.

Kann ich eine Accounting-API verwenden, ohne die doppelte Buchführung zu verstehen?

Teilweise. Eine gute API erstellt die Buchungssätze automatisch aus einem Geschäftsdokument wie einer Rechnung. Dennoch müssen Sie verstehen, was die Konten bedeuten, wenn Sie einen Bericht lesen oder einem Prüfer einen Saldo erklären.

Was ist der Unterschied zwischen einer Accounting-API und einer Ledger-API?

Eine Ledger-API erfasst ausgeglichene Bewegungen zwischen Konten. Eine Accounting-API tut dies ebenfalls und ergänzt die gesetzliche und steuerliche Ebene: Dokumente mit fortlaufenden Nummern, Mehrwertsteuerbehandlung, Steuerbücher, Anlagenbuchhaltung, Periodenabschluss und die von den Behörden geforderten Berichte. Jede Accounting-API enthält ein Ledger, aber nicht jedes Ledger ist ein vollständiges Buchhaltungssystem.

Wie lange dauert die Integration?

Für einen ersten funktionierenden Ablauf – Kunde anlegen, Rechnung ausstellen, Zahlung empfangen, Buchungssatz einsehen – sollten Sie mit typisierten SDKs und einer Sandbox wenige Tage statt Wochen einplanen. Eine produktive Integration, die Rückerstattungen, Korrekturen, Fremdwährungen, Zahlungsabgleich und Periodenabschluss abdeckt, ist aufwendiger. Der realistische Aufwand hängt davon ab, wie viele dieser Szenarien Ihr Geschäftsmodell tatsächlich erfordert.