DATEV (DATEVConnect via LocalAgent)
Dieser Guide erklärt dir, wie du deine Verbindung zu DATEV über die lokale DATEVConnect API mithilfe eines Local Agents aktivierst, der auf deinem Rechner installiert wird.
Bei dieser Methode musst du keine URL nach außen freigeben. Das kann technisch nur dein Integrator einrichten und in manchen Fällen lehnt er es ab.
Wenn du den Local Agent nicht installieren willst und dein Integrator bereit ist, die URL extern verfügbar zu machen, kannst du stattdessen die alternative Einrichtung nutzen.
Diese Methode wird in einem separaten Artikel erklärt: hier
📋 Übersicht
Diese Integration verbindet sich mit zwei DATEV-Komponenten:
- DATEV Rechnungswesen – On-Premise-Buchhaltungssoftware (Hauptdatenquelle)
- DATEV Unternehmen Online (DUO) – Cloud-Portal, das nur zum Senden von Anhängen wie Dokumenten, Rechnungen oder Belegen verwendet wird
Wenn du keine Anhänge senden willst, ist DUO nicht erforderlich.
Diese Verbindung erfordert die Installation eines Local Agents auf dem Server, auf dem DATEV läuft.
⏱ Geschätzte Dauer: 5 Minuten für eine vollständige Installation.
(Stelle sicher, dass dein System alle Bedingungen im Abschnitt Voraussetzungen unten erfüllt 👇 )
🚨 VORAUSSETZUNGEN
(Bedingungen, die vor der Verbindung erfüllt sein müssen)
1. Lizenzen
Lizenzen | Beschreibung der Anforderungen |
DATEV Rechnungswesen Lizenz | Pflicht. Entweder besitzt dein Unternehmen diese Lizenz selbst oder sie wird über deinen Steuerberater bereitgestellt. |
DATEVConnect Lizenz | Pflicht. Ermöglicht API-Zugriff. Meist bereits in DATEV-Installationen enthalten, muss aber aktiviert werden. Falls sie fehlt, kannst du sie (kostenlos) im DATEV Shop bestellen. |
DATEV Unternehmen Online (DUO) Lizenz | Nur erforderlich, wenn Anhänge (PDFs, Rechnungen, Belege) an DATEV gesendet werden sollen. |
Robaws | Aktiviere die DATEVConnect-Schnittstelle über Einstellungen > Integrationen > DATEVConnect |
So prüfst du die Lizenzen:
- In DATEV Arbeitsplatz unter Lizenzverwaltung die installierten Lizenzen ansehen.
- Oder eine Bestätigung bei deinem DATEV-Administrator, deinem Steuerberater oder deinem DATEV-Servicepartner anfragen.
2. Anforderungen an Benutzerkonten
Du musst den Windows-Benutzernamen und das Passwort eines Windows-Accounts angeben, der mit einem DATEV-Benutzer verknüpft ist und folgende Rechte hat:
✔ Zugriff auf das relevante Mandat/Unternehmen in DATEV Rechnungswesen
✔ Berechtigung, den DATEVConnect-Service zu nutzen
✔ Ausreichende Rechte zum Lesen/Schreiben von Buchhaltungsdaten (abhängig vom Integrationsumfang)
DATEV verlangt, dass die API-Authentifizierung über ein Windows-Login erfolgt, das einem DATEV-Benutzerkonto zugeordnet ist. Diese Zuordnung wird in der DATEV Benutzerverwaltung konfiguriert.
⚡️ VERBINDUNG
In Robaws:
Schritt 1: Gehe zu Einstellungen > Integrationen > DATEVConnect
Schritt 2: Klicke auf „Verbinden mit DATEV“
In DATEVConnect:
Schritt 1: Wähle einen Namen für deine Verbindung.
Schritt 2: Wähle aus, ob du Anhänge senden willst.
- Wenn deine Integration PDF-Rechnungen, Belege oder unterstützende Dokumente an DATEV senden soll, wähle Ja, um Anhänge zu aktivieren.
- Dafür brauchst du eine gültige DATEV Unternehmen Online Lizenz (siehe Voraussetzungen)
Schritt 3: Gib deine Beraternummer und Mandantennummer ein.
Wo findest du sie? 👇
- Gehe zur DUO-Login-Seite
- Klicke auf Show document overview
- Die Nummern stehen rechts unter Einstellungen:
- Erste Nummer = Beraternummer (z.B. 5696507)
- Zweite Nummer = Mandantennummer (z.B. 55003)
Schritt 4: Gib deinen Windows-Benutzer und dein Passwort ein, die mit dem DATEV-Konto verknüpft sind.
Gib den Windows-Benutzernamen und das Passwort des Benutzers ein, der mit dem DATEV-Konto verknüpft ist, wie in den Voraussetzungen beschrieben.
Schritt 5: Klicke auf „Authorise“, um die Verbindung abzuschließen.
Nachdem du geklickt hast, öffnet sich eine neue Dialogseite. Dort wählst du aus, wie du den Installer für die Installation auf deiner DATEV-Maschine erhalten möchtest. Die Installation dauert ca. 1 Minute und wird im nächsten Abschnitt erklärt.
💿 INSTALLATION
Du hast zwei Möglichkeiten, den Local Agent auf demselben Server wie deine DATEV-Instanz herunterzuladen und zu installieren:
- Wenn DATEV auf deinem Computer läuft, kannst du das Programm direkt herunterladen, indem du auf Download klickst.
- Wenn DATEV auf einem anderen Server läuft, kannst du das Programm per E-Mail senden (z. B. an die Person oder Firma, die DATEV hostet), damit sie es herunterladen und installieren kann.
Schritt 1: Du erhältst eine Datei mit dem Namen „Setup.zip“. Entpacke die Datei in einen Ordner „Setup“ (Rechtsklick > Alle extrahieren).
⚠️ Wichtig: Entpacke die ZIP-Datei zuerst, bevor du etwas doppelt anklickst.
Schritt 2: Öffne den Ordner „Setup“. Der Ordner sollte zwei Dateien enthalten:
- settings.json: Diese Datei musst du nicht bearbeiten. Sie enthält die Zugangsdaten, die für die Verbindung zu DATEV benötigt werden.
- SetupLocalAPIService.exe: Diese Datei brauchst du für die Installation.
Schritt 3: Doppelklicke auf „SetupLocalAPIService.exe“, um die Installation zu starten.
Gehe dann Schritt für Schritt durch den Installer:
- Wähle die Sprache des Installationsfensters.
- Wähle den Installationstyp: „Standardinstallation“ wird empfohlen.
- In diesem Schritt ist es wichtig, die settings.json auszuwählen, die aus dem Download entpackt wurde. Standardmäßig sollte diese Datei bereits ausgewählt sein.
Klicke dich durch die weiteren Schritte, bis du eine Meldung siehst, dass die Installation erfolgreich war.
Danach ist deine Verbindung zu DATEV vollständig aktiv. 🎉 🕺
VERIFIKATION
So prüfst du, ob der Service korrekt installiert wurde:
Schritt 1: Öffne den Explorer und suche nach „Services“ (Dienste).
Schritt 2: Öffne „Services“ (Dienste).
Schritt 3: Es öffnet sich ein Fenster mit einer Liste von Diensten. In dieser Liste solltest du einen Dienst namens „LocalAPIService“ mit dem Status „Running“ finden. Wenn das der Fall ist, hast du die Verbindung mit DATEV erfolgreich abgeschlossen.
Aktualisiert am: 05/02/2026
Danke!