> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://support.robaws.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 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**](https://support.robaws.com/de/article/datev-datevconnect-via-localagent-1ngvfsd/). ## 📋 Ü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](https://www.datev.de/web/de/shop/produkt-details/datevconnect-95280) 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://: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? 👇 1. Gehe zur DUO-Login-Seite 2. Klicke auf **Show document overview** 3. 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. 🎉 🕺