Für Entwickler & Software-Anbieter
Die Lohnabrechnung-API für Deutschland
Lösen Sie die komplette deutsche Entgeltabrechnung per REST-API aus — ohne eigenes Lohnprogramm und ohne eigene Systemuntersuchung. Mandant anlegen, Mitarbeiter melden, Lohnlauf starten, Dokumente abrufen.
Deutsche Lohnabrechnung ist die wohl unbequemste Software-Domäne im Land: ein amtlicher Steuer-Rechenkern, der sich jedes Jahr ändert, ein Dutzend getrennter elektronischer Meldeverfahren und eine Pflichtprüfung, die niemand umgeht. Eine Lohnabrechnung-API kapselt genau das — Ihre Software schickt Daten und bekommt fertige Abrechnungen, Meldungen und Buchungsdateien zurück, ohne dass Sie den regulatorischen Unterbau je selbst bauen.
Was die API kann
Stammdaten & Mandanten
Mandanten und Mitarbeiter programmatisch verwalten — Steuermerkmale, Krankenkasse, Beitragsgruppen, Verträge. Zeitscheiben-historisiert, damit auch Nachberechnungen alter Monate korrekt bleiben.
Lohnlauf
Probelauf und Festschreibung je Abrechnungsmonat, idempotent. Bewegungsdaten (Stunden, Zuschläge, Einmalzahlungen) einspielen, Summen je Mitarbeiter zurückerhalten.
Korrektur & Rückrechnung
Rückwirkende Änderungen laufen als eigener Korrekturlauf (Aufrollung) — so, wie es die Aufbewahrungs- und Meldepflichten verlangen, statt festgeschriebene Monate zu überschreiben.
Dokumente
Entgeltabrechnung (PDF, § 108 GewO), DATEV-Buchungsstapel, SEPA-Zahldatei und die Prüfungs-Exporte (DLS) — direkt herunterladbar.
Meldungen
Lohnsteuer-Anmeldung und die SV-Verfahren (DEÜV, Beitragsnachweis, AAG, EEL, eAU, A1, DSVV) — die Pflichtmeldungen entstehen aus dem Lohnlauf.
Webhooks & Multi-Mandant
HMAC-signierte Ereignisse (Lauf fertig, Dokument bereit) mit Retry-Queue. Ein Partner-Zugang verwaltet beliebig viele Mandanten, streng getrennt — gebaut für SaaS.
Ein Monat über die API — in fünf Aufrufen
Mehr braucht eine Abrechnung nicht. Alles dazwischen rechnet der Dienst.
1 · Bewegungsdaten
PUT …/bewegungen/2026-07 — Stunden, Zuschläge, Einmalzahlungen des Monats.
2 · Probelauf
POST …/lohnlauf/2026-07/probelauf — rechnet vollständig, schreibt nichts fest.
3 · Festschreiben
POST …/festschreiben — Monat wird unveränderlich, Dokumente entstehen.
4 · Dokumente
GET /v1/dokumente/{id} — Abrechnungen, DATEV, SEPA herunterladen.
5 · Melden
POST …/meldeanlaesse — ein Ereignis erzeugt alle fälligen Meldungen.
+ Webhook
lohnlauf.festgeschrieben meldet den fertigen Lauf aktiv an Ihr System zurück.
API, eigenes Lohnprogramm oder Outsourcing?
| Lohnfluss-API | Eigenes Lohnprogramm | Abrechnung außer Haus | |
|---|---|---|---|
| Time-to-Market | Wochen | Jahre | sofort, aber fremd |
| ITSG-Zertifizierung | bei Lohnfluss | selbst, jährlich | beim Dienstleister |
| Jahreswechsel-Pflege | inklusive | selbst | inklusive |
| Daten im eigenen Produkt | ja | ja | Medienbruch |
| Unter eigener Marke | ja (White-Label) | ja | nein |
| Laufende Kosten | pro Abrechnung | Entwicklung + Zertifizierung | pro Abrechnung, höher |
Die API verbindet den Vorteil des Eigenbaus (Daten und Marke bleiben bei Ihnen) mit dem des Outsourcings (Zertifizierung und Jahreswechsel sind fremdgepflegt) — ohne deren jeweiligen Preis.
Gebaut wie eine gute Zahlungs-API
Wer schon einmal eine Payment-API integriert hat, findet sich sofort zurecht: eindeutige, versionierte Ressourcen, ein Idempotenz-Schlüssel je schreibendem Aufruf (ein wegen Timeout wiederholter Lohnlauf wird nicht doppelt gerechnet), Beträge als Cent-Integer statt Fließkomma, und ein einheitliches Fehlerobjekt. Zugriffe sind über Scopes getrennt — ein Schlüssel, der nur Dokumente liest, kann keinen Lauf festschreiben. Den ganzen Ablauf zeigt der Entwickler-Einstieg; jeden Endpunkt mit ehrlichem Baustand die API-Referenz, die direkt aus der Spec des Dienstes erzeugt wird.
Häufige Fragen
Was ist eine Lohnabrechnung-API?
Eine Lohnabrechnung-API ist eine programmierbare Schnittstelle, über die eine Software die deutsche Entgeltabrechnung auslösen und die Ergebnisse abrufen kann — ohne eigenes Abrechnungsprogramm. Sie senden Stamm- und Bewegungsdaten (Stunden, Gehälter, Zuschläge) und erhalten Abrechnung, Meldungen und Buchungsdaten zurück.
Für wen ist die Lohn-API von Lohnfluss gedacht?
Für Software-Anbieter (HR-, Zeiterfassungs-, Branchensoftware), die ihren Kunden Lohnabrechnung anbieten wollen, ohne sie selbst zu bauen — und für größere Arbeitgeber, die ihre Abrechnung automatisieren statt sie im Steuerbüro pro Kopf abzurechnen.
Muss ich die ITSG-Systemuntersuchung selbst durchlaufen?
Nein. Genau das ist der Sinn: Lohnfluss durchläuft die ITSG-Systemuntersuchung und die jährliche Re-Qualifizierung, Sie nutzen das Ergebnis über die API. Sie sparen sich mehrere Jahre Entwicklung und einen dauerhaften Zertifizierungsaufwand.
Welche Technik nutzt die API?
REST über HTTPS, Authentifizierung per Bearer-Token mit Scopes, Idempotenz-Schlüssel für sichere Wiederholungen, HMAC-signierte Webhooks für Ereignisse. Alle Geldbeträge als Cent-Integer, um Rundungsfehler auszuschließen.
Welche deutschen Besonderheiten deckt die API ab?
Den amtlichen BMF-Programmablaufplan für die Lohnsteuer, kassenindividuelle Sozialversicherungsbeiträge, den Übergangsbereich (Midijob), Minijob-Pauschalen, steuerfreie Zuschläge nach § 3b EStG, betriebliche Altersversorgung und Pfändung. Genau der Umfang, den die ITSG-Systemuntersuchung prüft.
Wie gehe ich mit dem Jahreswechsel um?
Gar nicht — das ist unsere Aufgabe. Der Steuer-Rechenkern, die Rechengrößen und die Beitragssätze ändern sich jährlich, teils unterjährig. Diese Pflege übernimmt Lohnfluss zentral; Ihre Integration bleibt stabil.
Kann ich vorab testen?
Ja. Partner der Warteliste erhalten zuerst einen Sandbox-Zugang (Präfix lk_test_) gegen die verfügbaren Endpunkte und die vollständige Referenz. Die Produktionsschlüssel folgen mit dem Abschluss der ITSG-Systemuntersuchung.
API-Zugang sichern
Wir vergeben API-Zugänge zuerst an Partner der Warteliste und stimmen die Schnittstelle gemeinsam ab.