Nordlet für App-Entwickler

Integrieren Sie Rechnungsstellung, Buchhaltung und EU-Steuermeldungen über eine einzige JSON-API, typisierte SDKs, Webhooks, einen MCP-Server und Sandbox-Mandanten in Ihre Software.

Viele Anwendungen erzeugen finanzwirksame Ereignisse: Eine Bestellung wird bezahlt, ein Abonnement verlängert sich, eine Erstattung wird ausgezahlt. Jedes dieser Ereignisse muss letztlich in der Buchhaltung eines Unternehmens landen.

Nordlet ist eine von Grund auf für die API entwickelte Buchhaltungssoftware. Alles, was die Web-Anwendung leistet, ist auch über eine einzige JSON-API verfügbar. Ihre Anwendung sendet die Ereignisse, während Nordlet die Bücher führt und die Steuermeldungen vorbereitet.

Was Nordlet leistet

Stellt jede Aktion als POST /v1/{module}/{resource}/{action} mit einem JSON-Body bereit, zum Beispiel /v1/sales/invoices/create.
Authentifiziert jede Anfrage über einen API-Schlüssel, der zu genau einem Unternehmen gehört. Jeder Schlüssel verfügt über Berechtigungen (Scopes) wie sales:read oder sales:write, die seinen Funktionsumfang einschränken.
Verarbeitet Beträge als Dezimalstrings und niemals als Gleitkommazahlen, sodass durch Rundung keine Cent-Beträge verloren gehen.
Akzeptiert bei jeder Änderung den Header Idempotency-Key. Ein erneuter Versuch mit demselben Schlüssel liefert das ursprüngliche Ergebnis zurück, anstatt die Arbeit doppelt auszuführen. Idempotenz (idempotency) bedeutet, dass eine wiederholte Anfrage dieselbe Wirkung hat wie eine einzelne Anfrage.
Gibt jeden Fehler in einem einheitlichen Format zurück.
Erlaubt 300 Anfragen pro Minute und API-Schlüssel.
Zeichnet jede Änderung in einem Audit-Log auf.

Der Leitfaden zu API-Konventionen behandelt jede dieser Regeln im Detail.

Bücher, die fehlerfrei bleiben

Das Ausstellen einer Rechnung vergibt eine lückenlose Nummer, prüft, ob die Rechnungslegungsperiode (accounting period) geöffnet ist, und verbucht den Buchungssatz (journal entry) in derselben Datenbanktransaktion.
Jede Buchung muss ausgeglichen sein. Die Datenbank selbst prüft dies beim Speichern der Transaktion.
Ausgestellte und registrierte Belege können nicht gelöscht werden. Eine falsche Bankkontenzuordnung wird durch eine Stornobuchung rückgängig gemacht, nicht durch Bearbeiten des alten Belegs. Das zeichnet ein unveränderliches Hauptbuch (immutable ledger) aus.

SDKs, MCP und Webhooks

Typisierte SDKs für TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift und Rust werden aus derselben OpenAPI-Beschreibung generiert. Bis ein SDK veröffentlicht ist, installieren Sie es direkt aus seinem Quellcode-Repository. Siehe hierzu den SDKs-Leitfaden.
Eine Postman-Collection mit allen Endpunkten ist verfügbar.
Der MCP-Server ermöglicht es KI-Assistenten wie Claude Code, die API zu durchsuchen und mit Ihrem API-Schlüssel aufzurufen. Jeder Aufruf ist eine gewöhnliche API-Anfrage mit denselben Berechtigungen und Limits.
Webhooks benachrichtigen Ihre Anwendung, sobald ein Ereignis eintritt, zum Beispiel sale_invoice.issued oder sale_invoice.paid. Jede Lieferung ist mit einer HMAC-Signatur versehen, sodass Sie überprüfen können, ob sie von Nordlet stammt. Fehlgeschlagene Lieferungen werden etwa 24 Stunden lang erneut versucht.

Testen mit Sandbox-Mandanten

Erstellen Sie ein Unternehmen mit isSandbox: true, oder aktivieren Sie das Sandbox-Kontrollkästchen, wenn Sie ein Unternehmen in der Anwendung einrichten.
Ein Sandbox-Mandant funktioniert wie ein echtes Unternehmen: dieselben Module, dieselbe API.
Er ist deutlich als Testdatensatz gekennzeichnet, und ein echtes Unternehmen kann weder in eine Sandbox umgewandelt werden noch umgekehrt.
Meldungen und E-Rechnungen (e-invoice) eines Sandbox-Mandanten gehen an die Testdienste der Behörden.
Die Nutzung in einem Sandbox-Mandanten wird genau wie die Nutzung in einem echten Unternehmen gemessen und abgerechnet.

Der Einführungsleitfaden führt Sie Schritt für Schritt durch den ersten API-Schlüssel, die erste Rechnung und den gesamten Zyklus.

FAQ

Kann eine Anwendung mehrere Unternehmen bedienen?

Ja. Jeder API-Schlüssel gehört zu einem Unternehmen; Sie erstellen also pro Unternehmen einen Schlüssel. Jede Webhook-Meldung enthält die companyId des zugehörigen Unternehmens, sodass ein einzelner Empfänger mehrere Unternehmen bedienen kann.

Muss ich die Steuermeldungen selbst erstellen?

Nein. Nordlet erstellt die Meldungen direkt aus der Buchhaltung. Je nach Land wird die jeweilige Meldung entweder direkt versendet, als Datei zum Hochladen generiert oder es werden Werte angezeigt, die Sie manuell übertragen. Die Übersicht zur Meldungsunterstützung führt alle Fälle auf.