Zum Inhalt

DATEV-Lohnexport

Soll rechnet keinen Lohn. Es gibt dem Lohnbüro (der Steuerberatung oder der eigenen Lohnabteilung) für jeden abgeschlossenen Monat eine Datei, die das Lohnprogramm einliest, statt dass jemand Stunden und Zuschläge abtippt:

Lohnprogramm Datei Name
DATEV LODAS ASCII-Import mit [Allgemein], [Satzbeschreibung] und [Bewegungsdaten] DATEV_LODAS_JJJJ-MM.txt
DATEV Lohn und Gehalt Spaltendatei für den ASCII-Import-Assistenten DATEV_LuG_JJJJ-MM.txt

Beide Dateien sind Text in Windows-1252 (ANSI) mit CR LF am Ende jeder Zeile, Strichpunkt als Feldtrenner und Komma als Dezimalzeichen.

Nur abgeschlossene Monate

Die Datei entsteht aus dem Inhalt, mit dem der Betrieb den Monat abgeschlossen hat, also aus den Stempelungen, für die der Prüfwert jeder Person steht. Was danach geschieht, ändert sie nicht: Ein Gegeneintrag zu einem abgeschlossenen Tag zählt im Monat, in dem er gebucht wird, und erscheint in dessen Datei. Ein zweiter Export desselben Monats gibt dieselbe Datei.

Solange eine Person mit Arbeitszeitmodell den Monat nicht abgeschlossen hat, gibt es keine Datei: Ihre Zahlen könnten sich noch ändern, und eine Datei ohne sie wäre unvollständig. Das gilt auch für jemanden, der den Betrieb inzwischen verlassen, im Monat aber gestempelt hat, auch ohne Arbeitszeitmodell; Inhaber schließen seinen Monat mit einem Grund ab. Fehlt ihm das Modell, ist es danach „nicht hinterlegt“, mit den Tagen, an denen er gearbeitet hat.

Was in der Datei steht

Je Person und Monat ein Posten je Art, der vorkommt; Posten mit null fallen weg.

Posten Einheit Woher
Stunden (Stundenlohn) Stunden gearbeitete Minuten der Tage mit einem Modell „je Stunde“, dazu die Gegeneinträge des Monats
Stunden (Minijob mit Stundenlohn) Stunden ebenso für ein Minijob-Modell „je Stunde“
Feiertagsstunden Stunden für Stundenlohn das Soll des Modells an einem gesetzlichen Feiertag am Standort, abzüglich der an ihm gearbeiteten Minuten (§ 2 Abs. 1 EntgFG: bezahlt wird die Zeit, die „infolge eines gesetzlichen Feiertages ausfällt“)
Urlaub, Krank, Kind krank, Sonderurlaub Stunden die Gutschrift der Abwesenheit (siehe Konten); folgt mit den Abwesenheiten (S-401)
Ausgezahlte Überstunden Stunden eine Auszahlung aus dem Überstundenkonto; folgt mit den Anpassungen des Kontos
Nachtzuschlag, steuerfrei und steuerpflichtig Euro Zuschläge nach § 3b EStG
Sonntagszuschlag, steuerfrei und steuerpflichtig Euro ebenso
Feiertagszuschlag, steuerfrei und steuerpflichtig Euro ebenso, mit 24.12. und 31.12. ab 14 Uhr und dem Satz von 150 %
  • Monatslohn ist kein Posten: Gehalt und Festbezüge pflegt das Lohnbüro in den Stammdaten des Lohnprogramms. Für Personen mit Monatslohn stehen nur Zuschläge und Abwesenheiten in der Datei.
  • Zuschläge als Betrag: Soll rechnet sie mit dem Grundlohn und den Sätzen des Arbeitszeitmodells auf den Cent, getrennt in den steuerfreien Teil und den steuerpflichtigen Rest. Das Lohnprogramm übernimmt die Beträge mit den Lohnarten des Betriebs, statt sie aus Stunden noch einmal selbst zu rechnen.
  • Stunden mit zwei Stellen: Soll zählt ganze Minuten und rundet erst die Summe eines Postens auf Hundertstel, und zwar auf, nie zulasten der Person: 487 Minuten sind 8,1166… Stunden, in der Datei 8,12.
  • Ein Tag, ein Modell: Wechselt das Modell im Monat (etwa von Stundenlohn auf Monatslohn ab dem 16.), zählt jeder Tag nach seinem Modell, auch für die Sätze der Zuschläge.

Die Sätze der Zuschläge stehen am Arbeitszeitmodell in Prozent des Stundenlohns (in der Einrichtung unter „Zuschläge (§ 3b EStG)“: Nacht, Sonntag, Feiertag; 0 bis 4 Uhr gilt wie Nacht, der 25. und 26.12. und der 1.5. wie Feiertag). Ohne Satz wird kein Zuschlag gezahlt.

Einrichten

Unter Einstellungen → DATEV-Lohnexport, für Inhaber und Lohnbüro:

Angabe Form Wofür
Beraternummer 4 bis 7 Ziffern Kopf der LODAS-Datei
Mandantennummer 1 bis 5 Ziffern Kopf der LODAS-Datei
Personalnummer je Person 1 bis 5 Ziffern, im Betrieb nur einmal (als Zahl: 7 und 07 sind dieselbe) jede Zeile
Lohnart je Posten bis 4 Ziffern jede Zeile

Eine Personalnummer bekommt jedes Mitglied, das im Betrieb arbeitet, und jeder, der ihn mit einem abgeschlossenen Monat verlassen hat: Auch dessen Monat geht noch an die Lohnabrechnung.

Welche Lohnart welcher Posten bekommt, legt der Betrieb mit dem Lohnbüro fest; Soll schlägt keine Nummern vor, denn sie hängen von den Lohnarten des Mandanten ab. Die Lohnarten der Zuschläge legt das Lohnbüro im Lohnprogramm als steuerfreie und als steuerpflichtige Bezüge an. Jede Änderung der Zuordnung steht in der Audit-Kette.

Herunterladen

Unter Auswertungen → DATEV-Lohnexport Monat und Lohnprogramm wählen und Datei herunterladen. Fehlt etwas, nennt Soll alles auf einmal, statt etwas anzunehmen:

  • ein Monat, der für eine Person mit Modell nicht abgeschlossen ist;
  • Berater- oder Mandantennummer (nur LODAS, die Datei für Lohn und Gehalt hat keinen Kopf);
  • die Personalnummer einer Person, die einen Posten hat;
  • die Lohnart eines Postens, der im Monat vorkommt;
  • ein Arbeitszeitmodell an einem gearbeiteten Tag, der Lohn eines Modells mit Zuschlägen, die Feiertage am Standort oder eine Regelversion für die Zuschläge („nicht hinterlegt“);
  • Stunden, die durch Gegeneinträge unter null fielen.

Die API dazu (Rolle Inhaber oder Lohnbüro, Modul Arbeitszeit eingeschaltet):

Aufruf Was
GET /api/v1/arbeitszeit/datev Zuordnung, Posten und Personen mit Personalnummer
PUT /api/v1/arbeitszeit/datev Zuordnung setzen; eine Personalnummer null entfernt sie
GET /api/v1/arbeitszeit/datev/export?monat=JJJJ-MM&ziel=lodas die Datei (ziel=lug für Lohn und Gehalt) oder 409 mit fehlend

LODAS

[Allgemein]
Ziel=LODAS
Version_SST=1.0
BeraterNr=1234567
MandantenNr=10001
Feldtrennzeichen=;
Zahlenkomma=,
Datumsformat=TT.MM.JJJJ

[Satzbeschreibung]
1;u_lod_bwd_buchung_standard;abrechnung_zeitraum#bwd;pnr#bwd;la_eigene#bwd;bs_nr#bwd;bs_wert_butab#bwd;

[Bewegungsdaten]
1;01.12.2026;11;1000;1;24,00;
1;01.12.2026;11;1310;2;64,00;

Jede Zeile der Bewegungsdaten bucht in die Erfassungstabelle „Standard“ des Abrechnungsmonats (u_lod_bwd_buchung_standard, nicht in die Nachberechnung): Abrechnungsmonat (sein erster Tag), Personalnummer, Lohnart, Bearbeitungsschlüssel (1 Stunden, 2 Betrag) und Wert. Import in LODAS unter Datenübernahme → ASCII-Daten importieren, mit Prüflauf.

Lohn und Gehalt

Elf Felder je Zeile, ohne Kopf: Personalnummer, Kalendertag, Ausfallschlüssel, Lohnartennummer, Stundenanzahl, Tagesanzahl, Wert, abweichender Faktor, abweichende Lohnveränderung, Kostenstellennummer, Kostenträger. Soll füllt Personalnummer, Lohnart und Stunden oder Wert:

11;;;1000;24,00;;;;;;
11;;;1310;;;64,00;;;;

Die Satzbeschreibung legt das Lohnbüro einmal im ASCII-Import-Assistenten an: Trennzeichen Strichpunkt, Satztrenner Zeilenende, Zahlenkomma, die elf Felder in dieser Reihenfolge.

Quellen

Die Feldregeln stehen mit ihrer Quelle im Code (packages/export/src/datev/). Erreichbar waren beim Bau (November 2026):

  • developer.datev.de, über die Inhalte des Portals: „Lohnimportdatenservice“, „Interface requirements“ und „Interface requirements ASCII-Format“ (hr:imports 2.0.0, Fassung 1.1 vom 16.04.2025). Sie beschreiben den Weg der Dateien und verlangen einen Testimport in der DATEV-Anwendung; für Lohn und Gehalt gilt der Aufbau der Standard.ini. Die Felder selbst verweisen dort auf das Schnittstellenhandbuch im DATEV Help-Center.
  • Nicht erreichbar aus der Bauumgebung: das DATEV Help-Center (apps.datev.de, unter anderem Dok.-Nr. 0906285, 1080789 und 9226266) und die DATEV-Community.

Deshalb folgt das Format öffentlichen Dateien, die LODAS und Lohn und Gehalt einlesen:

  • JeffreyL26/admin, docs/datev-lohnexport.md und payrollExport/lodas.ts (nennt das Schnittstellenhandbuch LODAS, Fach 3 und 4): Kopf, Tabelle, Feldnamen, Bearbeitungsschlüssel, Zeichensatz, CR LF, die elf Felder für Lohn und Gehalt, die Formen der Nummern;
  • spaeth/docassemble-onboarding, templates/lodas.txt: Tabelle, Feldnamen, Bearbeitungsschlüssel 1 und 2, Strichpunkt am Satzende;
  • huskycare/odoo_german_wage_supplements, hr_attendance_export.py: Kopf und Tabelle;
  • replikativ/kontor, payroll_de_datev/emit.clj: CR LF, Feldtrennzeichen.

Ein Testimport bei einer Steuerberatung steht unter den Schritten für Menschen in der Bauliste; bis dahin ist der Export gegen diese Quellen gebaut, nicht gegen das Handbuch selbst.