DATEV (via API Schnittstelle)
Dieser Guide erklärt dir, wie du deine Verbindung zu DATEV über die lokale DATEVConnect API aktivierst.
Wenn dein DATEV-Integrator die lokalen DATEVConnect-API-Endpoints nicht extern verfügbar machen kann, musst du die Local-Agent-Verbindungsmethode verwenden. Diese funktioniert, ohne dass du eine URL nach außen freigeben musst.
Die Local-Agent-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.
⏱ Geschätzte Dauer:
👉 Du musst deinen DATEV-EDV-Dienstleister oder Integrator kontaktieren und darum bitten, dass er die DATEV-API-URL extern verfügbar macht (Details dazu findest du im Abschnitt Network & Server Access in den Voraussetzungen). Wenn er zustimmt, dauert dieser Schritt in der Regel nur etwa 2 Minuten.
2 Minuten, um die Aktivierungsseite aufzurufen und auszufüllen. (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. |
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. Network & Server Access
Für diesen Teil musst du deinen DATEV-EDV-Dienstleister oder DATEV-Integrator einbeziehen.
Damit Chift über die DATEVConnect API mit DATEV kommunizieren kann, muss der DATEV-Server extern über einen sicheren HTTPS-Endpoint erreichbar sein.
1. DATEVConnect API URL extern verfügbar machen
Dein DATEV-Administrator oder EDV-Dienstleister muss einen externen HTTPS-Endpoint konfigurieren, der den Traffic an deinen DATEVConnect-Service weiterleitet.
Typische interne Endpoints: https://<local-server>:58452
Der freigegebene Endpoint muss für Chift-Systeme remote via HTTPS erreichbar sein.
2. Erforderliche Netzwerk-Konfiguration
- Externen Zugriff auf Port 58452 öffnen und weiterleiten
- NAT-/Firewall-Regeln konfigurieren, um eingehenden HTTPS-Traffic an den internen DATEV-Server zu routen
- Idealerweise den Zugriff über einen dedizierten Request-Header (Chift) einschränken
Wenn dein DATEV-Servicepartner die URL aus Sicherheitsgründen oder aufgrund von DATEV-Richtlinien nicht freigibt, musst du die Local-Agent-Methode verwenden. Diese verbindet sich mit DATEV, ohne eine API extern zu öffnen.
3. 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
Schritt 1: Wähle einen Namen für deine Verbindung. (Wenn das Feld für den Verbindungsnamen nicht sichtbar ist, überspringe diesen Schritt und mache einfach weiter.)
Schritt 2: Wähle aus, ob du Anhänge senden willst.
Wenn du diese Option nicht siehst, bedeutet das, dass dein Softwareanbieter diese Einstellung für dich vorgegeben hat.
- 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: [Nur wenn Anhänge aktiviert / DUO ausgewählt] 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 Settings:
- Erste Nummer = Beraternummer (5696507 im Beispiel)
- Zweite Nummer = Mandantennummer (55003 im Beispiel)
Schritt 4: Gib die remote erreichbare DATEVConnect API URL (HTTPS) ein.
Schritt 5: 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 6: Klicke auf „Authorise“, um die Verbindung abzuschließen.
AUTHENTIFIZIERUNG - [Nur wenn Anhänge aktiviert / DUO ausgewählt]
Du wirst zur DUO-Login-Seite weitergeleitet, um dich zu authentifizieren und die Verbindung zu autorisieren.
Du kannst dich mit SmartLogin oder mit SmartCard/mIDentity anmelden.
KONFIGURIEREN
Wähle dein Unternehmen aus und klicke auf „Submit“.
Danach ist deine Verbindung zu DATEV vollständig aktiv. 🎉 🕺
Aktualisiert am: 04/02/2026
Danke!