Buchhaltungssoftware mit einer API

Jeder Teil von Nordlet ist über eine einzige JSON-API verfügbar, inklusive SDKs, Webhooks, idempotenten Wiederholungen und einem MCP-Server für KI-Assistenten.

Eine API (Schnittstelle zur Anwendungsprogrammierung) ermöglicht die Kommunikation zwischen verschiedenen Programmen. Mit einer Buchhaltungs-API kann Ihre eigene Software Rechnungen erstellen, Zahlungen erfassen und Berichte abrufen, ohne dass ein Mensch durch Bildschirmmasken klicken muss.

Nordlet ist eine Buchhaltungssoftware, bei der die API den primären Zugang darstellt. Alles, was die Web-App leistet, ist über dieselbe JSON-API verfügbar. Diese Seite richtet sich an Entwicklerinnen und Entwickler sowie an alle, die entscheiden, womit ihr Produkt verknüpft wird.

Was Nordlet leistet

Einheitliche Struktur der Aufrufe. Jeder Aufruf erfolgt als POST /v1/{module}/{resource}/{action} mit einem JSON-Body, beispielsweise sales/invoices/create oder bank/transactions/match.
API-Schlüssel mit Berechtigungen (Scopes). Jeder Schlüssel gehört zu einem Unternehmen und verfügt über bestimmte Berechtigungen wie sales:read oder bank:write. Ein Schlüssel ohne die erforderliche Berechtigung erhält die Antwort 403.
Beträge als Text. Geldbeträge sind Dezimalstrings mit bis zu 4 Dezimalstellen und niemals Gleitkommazahlen, sodass keine Cent-Beträge durch Rundungsfehler verloren gehen.
Einheitliches Fehlerformat. Jeder Fehler weist dieselbe Struktur auf, bestehend aus einem Fehlercode, einer Nachricht und einer Request-ID.
Einheitliche Listenabfragen. Jeder list-Aufruf nutzt dieselben Felder für Paginierung, Sortierung und Filterung und kann Summen zurückgeben.
Echte Buchhaltungsregeln. Buchungssätze müssen ausgeglichen sein, Belegnummern dürfen keine Lücken aufweisen, und eine gesperrte Buchungsperiode weist neue Buchungen mit dem Fehlercode 409 zurück. Jede Änderung wird in einem Audit-Log protokolliert.

Sichere Wiederholungen durch Idempotenz

Ein Netzwerk kann ausfallen, nachdem Ihre Anfrage verarbeitet wurde, aber bevor Sie die Antwort erhalten haben. Ein erneuter Versuch könnte in diesem Fall dazu führen, dass dieselbe Rechnung doppelt erstellt wird. Idempotenz bedeutet, dass eine wiederholte Anfrage dieselbe Auswirkung hat wie die erste.

Senden Sie bei jedem datenändernden Aufruf den Header Idempotency-Key mit.
Ein erneuter Versuch mit demselben Schlüssel und demselben Request-Body liefert die gespeicherte Antwort zurück, ergänzt um den Header x-idempotent-replay: true.
Derselbe Schlüssel mit einem anderen Request-Body wird abgelehnt.
Schlüssel werden für 24 Stunden vorgehalten.

Webhooks

Ein Webhook ist eine Nachricht, die Nordlet an Ihren Server sendet, sobald ein Ereignis eintritt, wie zum Beispiel sale_invoice.paid.

Ereignisse werden in derselben Datenbanktransaktion geschrieben wie die zugrundeliegende Änderung, sodass eine rückgängig gemachte Transaktion kein Ereignis auslöst.
Jede Zustellung wird mittels HMAC-SHA256 unter Verwendung Ihres Signaturgeheimnisses (Secret) signiert, damit Sie überprüfen können, ob sie von Nordlet stammt.
Fehlgeschlagene Zustellungen werden etwa 24 Stunden lang wiederholt. Sie können diese auch manuell erneut versenden.
Abonnements lassen sich unter Konto → Webhooks oder über die API verwalten.

Werkzeuge für Entwicklerinnen und Entwickler

API-Referenz. Eine interaktive API-Referenz, die aus der OpenAPI-Beschreibung generiert wurde, sowie eine Postman-Collection.
SDKs. Typisierte Clients für TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift und Rust, generiert aus derselben Beschreibung. Weitere Informationen finden Sie im Leitfaden zu SDKs.
MCP-Server. KI-Assistenten wie Claude können mithilfe Ihres API-Schlüssels die API durchsuchen und aufrufen. Siehe dazu den Leitfaden zum MCP-Server.
Testmandanten (Sandbox). Ein Testunternehmen verhält sich wie ein echtes Unternehmen, ist als Testdaten gekennzeichnet und sendet Meldungen und E-Invoices ausschließlich an die Testendpunkte der Behörden.
Ratenbegrenzung (Rate Limit). 300 Anfragen pro Minute und API-Schlüssel, begleitet von Headern, die das verbleibende Kontingent anzeigen.

FAQ

Was kann ich über die API erledigen?

Alles, was das Produkt bietet: Rechnungsstellung, Einkauf, Hauptbuch, Bankabgleich, Lagerhaltung, Anlagenbuchhaltung, Lohnbuchhaltung, Berichte und behördliche Meldungen. Der Einführungsleitfaden führt Sie Schritt für Schritt durch einen vollständigen Zyklus von der Rechnung bis zu den Umsatzsteuerzahlen.

Kann ich eine Buchhaltung in mein eigenes Produkt integrieren?

Ja. Jedes Unternehmen in Nordlet verfügt über ein eigenes Zahlenwerk, auf das Ihre Software über den jeweiligen API-Schlüssel zugreift. Die API enthält keinen Aufruf, mit dem ein bereits gebuchter Buchungssatz bearbeitet oder gelöscht werden kann. Eine Korrektur erfolgt stets durch einen neuen Buchungssatz, wodurch die Unveränderbarkeit des Kassenbuchs bzw. Journals gewahrt bleibt.