Wie verbinde ich DATEV mit Leapsome?
Deine Steuerberatung bereitet DATEV zuerst vor. Danach öffnet ein Admin die DATEV-Integration in Leapsome, klickt auf 'Autorisierung starten', gibt die Beraternummer und Mandantennummer in Kombo Connect ein und meldet sich mit der SmartCard der Steuerberatung an. Anschließend konfigurierst du Exporteinstellungen, Lohnarten, Abwesenheits-Codes und Personalnummern.
Leapsome verbindet sich über Kombo, unseren Integrations-Partner, mit DATEV. Leapsome sendet Stammdaten, Vergütung und Abwesenheiten an DATEV, deine Steuerberatung führt dort die Gehaltsabrechnung durch, und Leapsome ruft die fertigen Gehaltsabrechnungen anschließend ab und verteilt sie an die Mitarbeitenden.
Inhaltsverzeichnis
- Bevor du startest
- Wie autorisiere ich die DATEV-Verbindung?
- Wie konfiguriere ich die Integration
- Wie sende ich Daten an DATEV?
- Wie rufe ich Gehaltsabrechnungs-Dokumente ab?
- Wann wird eine eAU-Krankenmeldung angefordert?
- Monatlicher Ablauf
- Was Leapsome nicht tut
- FAQ
- Glossar
Bevor du startest
Die Gehaltsabrechnung mit DATEV ist eine Dreier-Konstellation: dein HR-Admin, deine Steuerberatung und Leapsome. Die Steuerberatung beginnt. Die Autorisierung kann erst abgeschlossen werden, wenn sie ihre Seite vorbereitet hat, auch wenn dein Unternehmen DATEV bereits mit einem vorherigen HR-System verbunden hatte.
Wer macht was
| Rolle | Deutsche Bezeichnung | Zuständigkeit |
|---|---|---|
| HR-Admin | Mandant (dein Unternehmen, aus Sicht deines Finanzamts) | Hält die Mitarbeitenden-Daten in Leapsome aktuell, führt Exporte durch, verteilt Dokumente |
| Steuerberatung / Steuerbüro | Steuerberater, Steuerbüro, Kanzlei | Führt die Gehaltsabrechnung in DATEV durch, verwaltet den DATEV-Zugang und die Berechtigungen |
| DATEV-Administrator | DATEV-Administrator | Vergibt DATEV-Dienstrechte, oft dieselbe Person wie die Steuerberatung |
Welches DATEV-System nutzt du?
Jeder DATEV-Mandant nutzt eines von zwei Gehaltsabrechnungs-Produkten, und einige Verhaltensweisen unterscheiden sich zwischen ihnen. Frage deine Steuerberatung, welches gilt, bevor du etwas konfigurierst.
| Lohn und Gehalt (LuG) | LODAS | |
|---|---|---|
| Wo es läuft | Lokal beim Steuerbüro | Im DATEV-Rechenzentrum |
| Typische Unternehmen | Kleinere Unternehmen | Größere Unternehmen |
| Abwesenheits-Code | Ausfallschlüssel (ein Text-Code) | Unterbrechungsgrund (eine Zahl) |
Was deine Steuerberatung zuerst abschließen muss
Sende diese fünf Punkte an deine Steuerberatung, bevor du den Termin zur Autorisierung buchst. Sie finden in DATEV statt, daher kann nur deine Steuerberatung sie bestätigen.
- Login-Gerät prüfen: Die Steuerberatung braucht eine DATEV-SmartCard (oder Äquivalent) mit den Rechten „Bestellen / Vertrags- und Personendaten verwalten“ und „Beraternummern verwalten“. Fehlt eines davon, vergibt ihr DATEV-Administrator es in RVO.
- Aktive Gehaltsabrechnung bestätigen: Der Dienst „Lohnabrechnung“ muss in DATEV Arbeitsplatz aktiv sein.
- Daten-Dienste für deinen Mandanten bestellen: Gehe in DATEV Arbeitsplatz zu Unsere Kanzlei > dein Mandant > MyDATEV > Mandantenregistrierung starten. Suche den Dienst, wähle Beraternummer und Geschäftsbeziehung aus und bestelle ihn. Dazu gehört der Lohnauswertungsdatenservice, den Leapsome zum Abruf von Gehaltsabrechnungs-Dokumenten nutzt.
- Dienste in RVO aktivieren: Aktiviere unter „Personalwirtschaft“ den Dienst, wähle die richtige Beraternummer und Mandantennummer, wähle alle Personalnummern aus und weise ihn dem Login-Gerät zu, das für die Autorisierung genutzt wird.
- Bei direkter Übermittlung (LAuDS) die Daten im DATEV-Rechenzentrum freigeben: In LuG geschieht das im Datentransfer-Cockpit. In LODAS muss ein Änderungszeichen gesetzt sein.
Empfohlene Reihenfolge: Sende der Steuerberatung zuerst die Vorbereitungsschritte aus dem Kombo-Leitfaden zur DATEV-Verbindung zu. Sobald sie bestätigt, dass alles erledigt ist, buche einen gemeinsamen Termin von etwa 30 Minuten zur Autorisierung. Deine Steuerberatung braucht für diesen Termin ihre SmartCard oder SmartLogin.
Wie autorisiere ich die DATEV-Verbindung?
- Gehe in Leapsome zu Einstellungen > Integrationen und Importe > HRIS-Integrationen > Ausgehende Bereitstellung und klicke auf 'DATEV'. Dadurch öffnet sich das Fenster mit den DATEV-Einstellungen.
- Bestätige, dass die oben genannten Voraussetzungen erfüllt sind.
- Klicke auf 'Autorisierung starten'. Kombo Connect öffnet sich in einem neuen Fenster.
- Wähle das Zielsystem (LODAS oder Lohn und Gehalt) und gib die Beraternummer und Mandantennummer ein, die dir deine Steuerberatung nennt. Diese werden in Kombo Connect eingegeben, nicht in Leapsome.
- Klicke auf 'Mit DATEV anmelden', wähle SmartCard oder mIDentity, wähle das Zertifikat aus und gib die PIN ein. Läuft der PIN-Schritt in ein Timeout, klicke auf 'Neu laden' und versuche es erneut.
- Bestätige den Einwilligungsbildschirm und schließe ab. Kombo prüft die Verbindung.
- Prüfe in Leapsome, ob System, Advisor ID und Tenant ID die richtigen Werte zeigen. Diese Felder sind in Leapsome schreibgeschützt und stammen von DATEV.
Welchen Connector hast du? Deine DATEV-Einstellungen zeigen unter der Verbindung ein Label:
- „Direkte Übermittlung (Lohnaustauschdatenservice)“: LAuDS.
- „Datei-Export (DATEV HR)“: der ältere ASCII-Connector.
Einige Verhaltensweisen in diesem Artikel unterscheiden sich zwischen beiden und sind an den entsprechenden Stellen markiert.
Wie konfiguriere ich die Integration
1. Prüfe deine Exporteinstellungen
Admins wählen per Ein- und Ausschalten, welche Attribute Leapsome an DATEV sendet. Neue Verbindungen starten mit allen aktivierten Feldern.
Wichtig: Bei der direkten Übermittlung (LAuDS) wird ein aktiviertes Feld, das in Leapsome leer ist, als leer gesendet und löscht den Wert, den deine Steuerberatung in DATEV hat. Auch Auswahlwerte wie „keine Angabe“ oder „0“ löschen den Wert. Fülle vor deiner ersten Übermittlung diese Felder in Leapsome aus oder deaktiviere sie. Deaktivierte Felder werden nicht gesendet, und DATEV behält seinen Wert.
2. Lohnartennummern zuweisen
Jede Vergütungsart, die du aktivierst, braucht eine Lohnartennummer von deiner Steuerberatung. Lohnartennummern laufen von 1 bis 9999, sowohl für LODAS als auch für LuG. Frage deine Steuerberatung nach der vollständigen Liste, schriftlich, eine Nummer pro aktivierter Vergütungsart.
Bei der direkten Übermittlung wird ein Vergütungsposten ohne Lohnart ohne Fehlermeldung übersprungen. Prüfe diese Liste daher vor deiner ersten Übermittlung.
3. Wähle aus, welche Dokumente importiert werden
Wähle die Dokumenttypen aus, die aus DATEV zurückgeholt werden: Mitarbeitenden-Dokumente (Gehaltsabrechnungen) und Arbeitgeber-Dokumente (Berichte). Mindestens ein Typ muss aktiviert sein, sonst schlägt der Abruf fehl.
eAU (elektronische Arbeitsunfähigkeitsbescheinigungen) hat einen eigenen Tab in den DATEV-Einstellungen, der separat vom Dokumentenimport gespeichert wird. Der Schalter 'Automatisierter eAU-Abruf' erscheint, sobald DATEV den eAU-Dienst als bereit meldet. Siehe unten „Wann wird eine eAU-Krankenmeldung angefordert?“.
4. Verbinde deine Gehaltsabrechnungs-Richtlinie
Gehe zu Gehaltsabrechnung > Richtlinien > wähle eine Richtlinie aus > Gehaltsabrechnungs-Integration > DATEV. Durch das Verbinden der Richtlinie werden die DATEV-spezifischen Felder zu den Persönliche-Infos-Einstellungen der Richtlinie hinzugefügt. Felder werden nur hinzugefügt, wenn ihr gesamter Unterabschnitt in deinen Exporteinstellungen aktiviert ist.
Hinweis: Fehlt später ein DATEV-Feld in einer Gehaltsabrechnungs-Richtlinie? Öffne deine DATEV-Exporteinstellungen und klicke einmal auf 'Speichern'. Dadurch werden alle aktivierten DATEV-Felder zu allen aktiven DATEV-Gehaltsabrechnungs-Richtlinien hinzugefügt, auch zu früher verbundenen. Du musst die Richtlinie nicht neu verbinden.
Die DATEV-Felder sind standardmäßig für Super-Admins und Gehaltsabrechnungs-Admins sichtbar. Passe den Zugriff unter Einstellungen > Mitarbeitende > Profilfelder und Zugriff an.
5. Ordne deine Abwesenheits-Richtlinien zu
Jede Abwesenheits-Richtlinie, die an DATEV übermittelt werden soll, braucht einen DATEV-Abwesenheits-Code. Abwesenheits-Codes werden pro Rechtsträger in den DATEV-Einstellungen festgelegt, und die Gehaltsabrechnungs-Richtlinie entscheidet, welche Abwesenheits-Richtlinien im Geltungsbereich liegen.
- LODAS: Wähle einen Unterbrechungsgrund (eine Zahl) aus der festen Liste.
- LuG: Wähle einen Ausfallschlüssel (einen Text-Code) aus der festen Liste.
- Codes: Deine Steuerberatung liefert sie. Die Einstellungen lassen sich nicht speichern, solange eine ausgewählte Abwesenheits-Richtlinie nicht zugeordnet ist.
Hinweis: Die LODAS-Code-Liste enthält keinen Code für bezahlten Urlaub. Prüfe daher Urlaubs-Zuordnungen mit deiner Steuerberatung, statt anzunehmen, dass der nächstliegende Treffer stimmt.
6. Personalnummern eingeben
Personalnummern sind das Mittel, mit dem Leapsome jede Person DATEV zuordnet. Eine falsche oder fehlende Nummer ist der häufigste Grund, warum eine Person nie in der Gehaltsabrechnung ankommt.
- Gültiger Bereich: 1 bis 99999 für alle Systeme. Bei der direkten Übermittlung machen führende Nullen keinen Unterschied: 225 und 00225 sind dieselbe Nummer.
- Abruf von Gehaltsabrechnungen: Gleicht die Nummer exakt so ab, wie sie gespeichert ist: 225 und 00225 passen beim Dokumentenimport nicht zusammen.
- Wo du sie eingibst: Pro Person auf dem DATEV-Tab des Profils oder im Massen-Update über die Spalte „DATEV ID“. Ein benutzerdefiniertes Profilfeld mit dem Namen „DATEV ID“ wird dafür nicht verwendet.
- Quelle: Bitte deine Steuerberatung um einen Export der aktuellen Personalnummern und übernimm die Nummern daraus, statt sie aus dem Gedächtnis einzutippen.
- Neue Mitarbeitende: Deine Steuerberatung legt die Person zuerst in DATEV an. Leapsome legt nie Mitarbeitende in DATEV an und schließt nie eine Personalnummer.
7. Mehrere Rechtsträger
Jeder weitere Rechtsträger kann entweder seine eigene DATEV-Konfiguration nutzen oder die des primären Rechtsträgers erben (schreibgeschützt). Exporte bleiben auf den ausgewählten Rechtsträger beschränkt. Aktivierte DATEV-Felder aus allen Verbindungen werden zu jeder DATEV-Gehaltsabrechnungs-Richtlinie hinzugefügt.
Bei der direkten Übermittlung wird eine Person ohne Rechtsträger in einem Konto mit mehreren Rechtsträgern übersprungen. Weise jeder Person im Geltungsbereich einen Rechtsträger zu.
8. Berechtigungen festlegen
| Aufgabe | Erforderliche Berechtigung |
|---|---|
| Export-Dialog öffnen, exportieren, übermitteln | Gehaltsabrechnungs-Richtlinien verwalten |
| Verbinden, autorisieren, DATEV-Einstellungen ändern | Integrationen verwalten (standardmäßig Super-Admins) |
| DATEV-Felder auf Profilen sehen und bearbeiten | Standardmäßig Super-Admins und Gehaltsabrechnungs-Admins |
Setup-Checkliste
- Steuerberatung hat bestätigt, dass ihre Vorbereitung abgeschlossen ist, einschließlich des Diensts für Gehaltsabrechnungs-Dokumente
- LuG oder LODAS bestätigt
- Beraternummer und Mandantennummer erhalten
- Autorisierung abgeschlossen und System, Advisor ID und Tenant ID in Leapsome geprüft
- Exportfelder geprüft: Alles Aktivierte wird tatsächlich in Leapsome gepflegt
- Lohnartennummern schriftlich für jede aktivierte Vergütungsart erhalten
- Gehaltsabrechnungs-Richtlinie verbunden und DATEV-Felder vorhanden (falls nicht, speichere deine Exporteinstellungen einmal)
- Abwesenheits-Richtlinien DATEV-Codes zugeordnet
- Personalnummern eingegeben und mit DATEV abgeglichen
- Gehaltsabrechnungs-Admins haben „Gehaltsabrechnungs-Richtlinien verwalten“
- Ersten Export mit der Steuerberatung geprüft
Wie sende ich Daten an DATEV?
Sobald der Gehaltsabrechnungs-Zyklus die Informationen enthält, die du senden willst, gehe in der relevanten Gehaltsabrechnungs-Richtlinie zum Zyklus und wähle Aktionen > 'Stammdaten an DATEV exportieren' (Datei-Export) oder 'Übermitteln' (direkte Übermittlung).
Wichtig: Export und Übermitteln sind für jeden Gehaltsabrechnungs-Zyklus verfügbar, der nicht in der Zukunft liegt, einschließlich offener, nicht genehmigter Zyklen. Vereinbare mit deinem Team, dass nur genehmigte Zyklen übermittelt werden.
Was gesendet wird
- Stammdaten: persönliche Informationen, Bankverbindung, Steuerdaten, Festgehalt, feste und wiederkehrende Vergütung, Arbeitszeiten.
- Bewegungsdaten: Abwesenheiten, einmalige und variable Vergütung, Stunden für Mitarbeitende mit Stundenlohn.
Datei-Export (ASCII) und direkte Übermittlung (LAuDS) im Vergleich
| Datei-Export (ASCII) | Direkte Übermittlung (LAuDS) | |
|---|---|---|
| Wie Daten übertragen werden | Eine Datei pro Zyklus und Rechtsträger, abgelegt im DATEV-Posteingang deiner Steuerberatung oder heruntergeladen und manuell gesendet | Separate API-Aufrufe pro Person, die direkt in DATEV ankommen |
| Wer sie importiert | Deine Steuerberatung, manuell in DATEV | Kein manueller Import nötig |
| Validierung | Leapsome zeigt Warnungen. Eine fehlende Personalnummer verhindert die Übertragung, ein manueller Download funktioniert dennoch | Leapsome prüft jede Person vor dem Senden. Fehler betreffen einzelne Personen und erscheinen auf dem Sync-Tab |
| Korrektur eines gesendeten Betrags | Zyklus erneut exportieren | Einmalige und variable Vergütung: eine Stornierung, dann der neue Betrag. Festgehalt und Stundenlohn werden direkt aktualisiert |
| Entfernen einer Vergütung | Erneuter Export ohne die Vergütung | Stornierung auf null |
| Aktiviertes, aber leeres Feld | Wird als leere Spalte geschrieben | Löscht den Wert in DATEV |
Bei einer Verbindung mit direkter Übermittlung ist der ASCII-Export blockiert. Gemischte Setups funktionieren pro Rechtsträger.
Welche Daten werden genutzt: genehmigter Snapshot oder Live-Daten?
| Datei-Export (ASCII) | Direkte Übermittlung (LAuDS) | |
|---|---|---|
| Vergütung (monatliche Beträge, Gehalt, Stundenlohn) | Genehmigter Zyklus: der Snapshot zum Zeitpunkt der Genehmigung. Offener oder wieder geöffneter Zyklus: aktuelle Daten | Der Snapshot zum Zeitpunkt der Genehmigung |
| Stammdaten und Abwesenheiten | Wie bei der Vergütung | Immer die aktuellen Daten im Moment des Sendens, auch bei einem genehmigten Zyklus |
Bei der direkten Übermittlung erreicht eine Profiländerung nach der Genehmigung DATEV beim nächsten Übermitteln oder 'Erneut versuchen'. Vergütungsänderungen nach der Genehmigung erfordern, dass der Zyklus wieder geöffnet wird.
Wie du den Sync-Tab prüfst
Bei der direkten Übermittlung erscheint das Ergebnis jeder Person auf dem Sync-Tab des Gehaltsabrechnungs-Zyklus. Korrigiere den dort markierten Wert und klicke auf 'Erneut versuchen', um diese Person erneut mit ihren aktuellen Daten zu senden.
Eine Person kann an einem Schritt scheitern, während andere erfolgreich sind. Prüfe daher die gesamte Liste, statt von einem sauberen Durchlauf auszugehen, nur weil die Übermittlung abgeschlossen ist.
Felder, die DATEV selbst pflegt
Fünf Felder schreibt die direkte Übermittlung nie, und dafür gibt es keinen Datei-Export als Fallback. Deine Steuerberatung pflegt sie direkt in DATEV.
| Feld | DATEV-Bezeichnung | Systeme |
|---|---|---|
| Familienstand | Familienstand | LODAS und LuG |
| Schwerbehinderungsstatus | Schwerbehinderung | Nur LODAS (das Feld gibt es für LuG nicht) |
| Kündigungsdatum | Kündigungsdatum | LODAS und LuG |
| Steuerklasse | Steuerklasse | Nur LODAS (das Feld gibt es für LuG nicht) |
| Konfession | Konfession | LODAS und LuG |
Hinweis: Zwei weitere Felder werden in den Exporteinstellungen angezeigt, bei der direkten Übermittlung aber nie gesendet: die Zahlungsart und das Eintrittsdatum des Beschäftigungszeitraums. Die Faxnummer wird bei beiden Connectors nie exportiert.
Was passiert bei unbezahlter Abwesenheit?
Der DATEV-Export enthält bei unbezahlter Abwesenheit das vollständige, unverminderte Festgehalt, und DATEV führt die Kürzung durch. Das funktioniert nur, wenn die Abwesenheit DATEV erreicht, über deine Abwesenheits-Zuordnung oder eine manuelle Eingabe. Bei einer Mischung aus festen und stundenbasierten Zeiträumen wird stattdessen ein gekürzter Betrag gesendet.
Wie rufe ich Gehaltsabrechnungs-Dokumente ab?
- Deine Steuerberatung führt die Gehaltsabrechnung in DATEV durch, und die Dokumente entstehen dort.
- Deine Steuerberatung sagt dir Bescheid, wenn sie fertig sind, oder ihr vereinbart einen festen Termin, z.B. den 25. jedes Monats.
- Gehe im Gehaltsabrechnungs-Zyklus zu Aktionen > 'Gehaltsabrechnungs-Dokumente abrufen'. Nur die in deinen Integrationseinstellungen aktivierten Dokumenttypen werden abgerufen.
- Sieh sie dir im Tab „Importierte Dokumente“ des Zyklus in der Vorschau an.
- Klicke auf 'Dokumente verteilen'. Jede Gehaltsabrechnung erscheint danach im Profil der Person unter Dokumente.
Dokumente werden nur Personen zugeordnet, die in diesem Zyklus liegen, innerhalb des Rechtsträgers des Zyklus und deren Personalnummer mit DATEV übereinstimmt.