Lohnabrechnung per API automatisieren — so funktioniert es
Die monatliche Lohnabrechnung ist Routine — und genau deshalb ein guter Kandidat für Automatisierung. Statt Stunden aus der Zeiterfassung abzutippen, Zuschläge von Hand zu prüfen und Meldungen einzeln zu verschicken, kann eine API den ganzen Ablauf übernehmen. Der Monatslauf wird von Kopfarbeit zu einem Knopfdruck.
Auf einen Blick: Eine Payroll-API automatisiert die Entgeltabrechnung in vier Schritten: Bewegungsdaten liefern, Probelauf rechnen, festschreiben, melden. Die Berechnung folgt dem amtlichen Lohnsteuer-Programmablaufplan und den SV-Regeln; die Pflichtmeldungen gehen über die zertifizierten Meldeverfahren elektronisch raus. Voraussetzung ist ein systemgeprüftes Programm.
1. Bewegungsdaten liefern
Ihre Software — Zeiterfassung, Dienstplan oder HR-Tool — sendet die Bewegungsdaten des Monats an die API: geleistete Stunden, Zuschläge, Abwesenheiten, Einmalzahlungen. Ein Aufruf pro Mandant und Monat genügt.
PUT /v1/mandanten/42/bewegungen/2026-07Wichtig ist Idempotenz: Wird derselbe Monat versehentlich zweimal gesendet, darf er nicht doppelt
abgerechnet werden. Deshalb adressiert der Aufruf den Zeitraum eindeutig (.../2026-07) statt eine
neue Buchung anzuhängen.
2. Probelauf rechnen
Die API berechnet die Abrechnung: Lohnsteuer nach dem amtlichen Programmablaufplan des Bundesfinanzministeriums, Sozialversicherung, steuer- und beitragsfreie Zuschläge nach § 3b Einkommensteuergesetz, betriebliche Altersversorgung. Sie erhalten die Summen zurück und können sie prüfen, bevor etwas festgeschrieben wird. Ein Probelauf ist folgenlos — er verändert keine Meldedaten.
3. Festschreiben
Passt alles, wird der Lauf festgeschrieben. Dabei entstehen automatisch die Dokumente:
- die Entgeltabrechnung als PDF — in Textform Pflicht nach § 108 Gewerbeordnung, mit dem in der Entgeltbescheinigungsverordnung festgelegten Mindestinhalt,
- der DATEV-Buchungsstapel für die Finanzbuchhaltung,
- die SEPA-Zahldatei (pain.001) für die Überweisung der Netto-Beträge.
Festschreiben ist der Punkt, ab dem der Lauf verbindlich ist — davor ist alles Vorschau.
4. Melden
Aus dem festgeschriebenen Lauf werden die Pflichtmeldungen erzeugt und elektronisch übermittelt: die Lohnsteuer-Anmeldung ans Finanzamt sowie die SV-Meldungen (DEÜV, Beitragsnachweise) an die Sozialversicherung. Dieser Datenaustausch ist nur mit einem zertifizierten Programm zulässig, wie die Deutsche Rentenversicherung zum automatisierten Meldeverfahren beschreibt. Ein Webhook informiert Ihre Software, sobald eine Meldung bestätigt ist — Sie müssen keinen Status pollen.
Der Gewinn
Kein manuelles Übertragen, keine vergessenen Zuschläge, keine Fristen-Panik. Die immer gleichen Handgriffe erledigt die Schnittstelle; Ihr Team schaut nur noch auf den Probelauf und gibt frei. Aus einem halben Arbeitstag pro Monat wird ein kurzer Kontrollblick — und bei Bedarf ein vollständig automatischer Job.
Eine ehrliche Einordnung: Lohnfluss steht in der ITSG-Zertifizierung. Der beschriebene Ablauf ist gebaut und getestet; produktiv gemeldet wird nach Abschluss der Zertifizierung.
Was die Automatisierung nicht abnimmt
Automatisierung ersetzt die Fleißarbeit, nicht das Urteil. Ein paar Dinge bleiben bewusst in Menschenhand:
- Der Blick auf den Probelauf. Die API rechnet, was sie an Daten bekommt. Fehlt eine Abwesenheit oder ist ein Stundensatz falsch hinterlegt, rechnet sie das mit — sichtbar wird es im Probelauf. Die kurze Kontrolle vor dem Festschreiben bleibt sinnvoll.
- Neue Fälle und Sonderfälle. Ein neuer Mitarbeiter, ein Wechsel der Steuerklasse, eine Pfändung oder eine Einmalzahlung wollen einmal korrekt angelegt sein. Ab dann läuft es automatisch.
- Korrekturläufe. Kommt eine Meldung zu spät oder ändert sich rückwirkend etwas, braucht es einen sauberen Korrektur- oder Stornolauf — auch den bildet die API ab, aber die Entscheidung dazu trifft die Sachbearbeitung.
Der Gewinn liegt also nicht darin, niemanden mehr hinschauen zu lassen, sondern darin, das Hinschauen auf die Stellen zu konzentrieren, an denen es zählt.
Häufige Fragen
Kann ich einen Lohnlauf vor dem Festschreiben testen?
Ja. Der Probelauf rechnet die vollständige Abrechnung und gibt die Summen zurück, ohne etwas verbindlich zu machen oder Meldungen auszulösen. Erst das Festschreiben ist verbindlich.
Welche Dokumente entstehen automatisch?
Aus einem festgeschriebenen Lauf entstehen die Entgeltabrechnung (PDF), der DATEV-Buchungsstapel für die Buchhaltung und die SEPA-Zahldatei für die Überweisung — ohne separaten Export-Schritt.
Wie erfahre ich, ob eine Meldung angekommen ist?
Über Webhooks. Ihre Software wird benachrichtigt, sobald eine Meldung übermittelt und bestätigt wurde — Sie müssen den Status nicht aktiv abfragen.
Weiterführend
- Lohnabrechnung automatisieren — der Nutzen im Überblick
- API-Dokumentation für Entwickler — Ressourcen und Beispiele
- Payroll API — das vollständige Schnittstellen-Konzept
- Loslegen? Auf die Warteliste eintragen.