Zum Inhalt springen

Für Entwickler & Software-Anbieter

Die Lohnabrechnung-API für Deutschland

Lösen Sie die komplette deutsche Entgeltabrechnung per REST-API aus — rechtssicher, zertifiziert, ohne eigenes Lohnprogramm. Mandant anlegen, Mitarbeiter melden, Lohnlauf starten, Dokumente abrufen.

Was die API kann

Stammdaten & Mandanten

Mandanten und Mitarbeiter programmatisch verwalten — Steuermerkmale, Krankenkasse, Beitragsgruppen, Verträge. Zeitscheiben-historisiert.

Lohnlauf

Probelauf und Festschreibung je Abrechnungsmonat, idempotent. Bewegungsdaten (Stunden, Zuschläge, Einmalzahlungen) einspielen, Summen zurückerhalten.

Dokumente

Entgeltabrechnung (PDF), DATEV-Buchungsstapel, SEPA-Zahldatei und die Prüfungs-Exporte — direkt herunterladbar.

Meldungen

Lohnsteuer-Anmeldung und die Sozialversicherungs-Verfahren elektronisch — die Pflichtmeldungen entstehen aus dem Lohnlauf.

Webhooks

HMAC-signierte Ereignisse (Lauf fertig, Dokument bereit, Meldung bestätigt) — mit Retry-Queue für verlässliche Zustellung.

Multi-Mandanten

Als Partner verwalten Sie beliebig viele Mandanten unter einem Zugang — mandantengetrennt, gebaut für SaaS.

Ein Aufruf, ein Lohnlauf

Klar, idempotent, in Cent

Die API ist gebaut wie eine gute Zahlungs-API: eindeutige Ressourcen, Idempotenz-Schlüssel für sichere Wiederholung, Beträge als Ganzzahl in Cent. Kein Rätselraten, kein Rundungsfehler.

  • Bearer-Token mit fein granularen Scopes
  • Idempotenz über einen Ledger (24 h Replay-Schutz)
  • Versionierte, stabile Ressourcen
# Mitarbeiter für einen Mandanten anlegen
POST /v1/mandanten/42/mitarbeiter
{
  "vorname": "Maria",
  "nachname": "Beispiel",
  "eintritt": "2026-08-01",
  "vertrag": "gehalt",
  "grundgehalt_cent": 320000
}

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 Ergebnisse abrufen kann — ohne eigenes Abrechnungsprogramm. Sie senden Stammdaten und Bewegungsdaten (Stunden, Gehälter) und erhalten Abrechnung, Meldungen und Buchungsdaten zurück.

Für wen ist die Lohn-API von Lohnfluss gedacht?

Für Software-Anbieter (HR-, Zeiterfassungs-, Branchen-Software), die ihren Kunden Lohnabrechnung anbieten wollen, ohne sie selbst zu bauen — und für größere Arbeitgeber, die ihre Abrechnung automatisieren.

Muss ich die ITSG-Zertifizierung selbst durchlaufen?

Nein. Genau das ist der Sinn: Lohnfluss durchläuft die ITSG-Systemuntersuchung, Sie nutzen das Ergebnis über die API. Sie sparen sich Jahre Aufwand und die jährliche Re-Qualifizierung.

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.

API-Zugang sichern

Wir vergeben API-Zugänge zuerst an Partner der Warteliste und stimmen die Schnittstelle gemeinsam ab.