Entwickler-Dokumentation

Die Lohnfluss-API

Deutsche Entgeltabrechnung als REST-API. Diese Seite ist der Einstieg — die vollständige Referenz erhalten Partner mit dem API-Zugang.

In ITSG-Zertifizierung Zugang auf Anfrage

Grundlagen

Basis-URL: https://api.lohnfluss.de
Auth: Authorization: Bearer lf_live_…, Scopes je Zugriff
Beträge: immer Cent-Integer (kein Float)
Idempotenz: Idempotency-Key je schreibendem Aufruf
Fehler: einheitlich { fehler: { code, titel, detail } }
Mandantenmodell: Partner → beliebig viele Mandanten

Authentifizierung

curl https://api.lohnfluss.de/v1/mandanten \
  -H "Authorization: Bearer lf_live_…" \
  -H "Idempotency-Key: 8f3a…"

Kern-Ressourcen

POST /v1/mandanten Mandant (Arbeitgeber) anlegen

POST /v1/mandanten/{id}/mitarbeiter Mitarbeiter mit Zeitscheibe anlegen

PUT /v1/mandanten/{id}/bewegungen/{monat} Stunden, Zuschläge, Einmalzahlungen melden

POST /v1/mandanten/{id}/lohnlauf/{monat}/probelauf Probeabrechnung rechnen

POST /v1/mandanten/{id}/lohnlauf/{monat}/festschreiben Lauf festschreiben, Dokumente erzeugen

GET /v1/mandanten/{id}/lohnlauf/{monat}/dokumente Dokumente auflisten

GET /v1/dokumente/{id} Abrechnung, DATEV, SEPA, DLS herunterladen

POST /v1/mandanten/{id}/lsta/{zeitraum} Lohnsteuer-Anmeldung vorbereiten

Webhooks

Lohnfluss meldet Ereignisse aktiv zurück — HMAC-signiert, mit Retry-Queue. So erfährt Ihre Software, wenn ein Lauf fertig ist oder eine Meldung bestätigt wurde.

lohnlauf.berechnet
dokument.bereit
meldung.bestaetigt

Ein vollständiger Monat

# 1) Bewegungsdaten
PUT  /v1/mandanten/42/bewegungen/2026-07
# 2) Probelauf
POST /v1/mandanten/42/lohnlauf/2026-07/probelauf
# 3) Festschreiben
POST /v1/mandanten/42/lohnlauf/2026-07/festschreiben
# 4) Abrechnung laden
GET  /v1/dokumente/9981

API-Zugang & vollständige Docs

Partner der Warteliste erhalten Sandbox-Zugang und die komplette Referenz zuerst.

Zugang anfragen