> ## Documentation Index > Fetch the complete documentation index at: https://docs.chift.eu/llms.txt > Use this file to discover all available pages before exploring further. # DATEV Diese Anleitung erklärt, wie Sie Ihre Verbindung zu DATEV über die lokale DATEVconnect-API aktivieren. Nachfolgend werden zwei verschiedene Möglichkeiten beschrieben, die lokale DATEVconnect-API bereitzustellen. Sollte keine dieser Methoden für Ihr Setup funktionieren, müssen Sie die **Verbindungsmethode über den Local Agent** verwenden. Wenden Sie sich in diesem Fall an Ihren Softwareanbieter, damit dieser Sie zur alternativen Einrichtung weiterleitet. Die Local-Agent-Methode wird in einem separaten Artikel [**hier**](/de/help/connectors/accounting/datev-localagent) erläutert. *** ## 📋 Überblick Diese Integration verbindet sich mit zwei DATEV-Komponenten: * **DATEV Rechnungswesen** – On-Premise-Buchhaltungssoftware (Hauptdatenquelle) * **DATEV Unternehmen Online (DUO)** – Cloud-Portal, das ausschließlich zum Senden von Anhängen wie Dokumenten, Rechnungen oder Belegen verwendet wird Wenn Sie keine Anhänge senden möchten, ist DUO nicht erforderlich. ⏱ **Geschätzte Dauer:** > 👉 Sie müssen Ihren DATEV-IT-Dienstleister oder Integrator kontaktieren und darum bitten, die DATEV-API-URL bereitzustellen (ausführlich beschrieben im Abschnitt **Netzwerk- & Serverzugriff** der Voraussetzungen). Wenn er zustimmt, **dauert dieser Schritt in der Regel nur etwa 2 Minuten** 😉. **2 Minuten**, um die Aktivierungsseite abzurufen und auszufüllen. (*Stellen Sie sicher, dass Ihr System alle Bedingungen erfüllt, die im Abschnitt* ***Voraussetzungen*** *unten aufgeführt sind*.) *** ## 🚨VORAUSSETZUNGEN **(Bedingungen, die** vor der Verbindung **erfüllt sein müssen)** ### 1. Lizenzen | | | | ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Lizenzen | Beschreibung der Anforderungen | | **DATEV Rechnungswesen-Lizenz** | Zwingend erforderlich. Entweder im Besitz Ihres Unternehmens oder über Ihren Buchhalter/Steuerberater bereitgestellt. | | **DATEVconnect-Lizenz** | Zwingend erforderlich. Ermöglicht den API-Zugriff. In DATEV-Installationen normalerweise bereits enthalten, muss aber aktiviert werden. Falls sie fehlt, können Sie sie (kostenlos) über den [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. | **So überprüfen Sie Ihre Lizenzen:** * Gehen Sie im DATEV Arbeitsplatz zur **Lizenzverwaltung**, um die installierten Lizenzen anzuzeigen. * Oder lassen Sie sich dies von Ihrem DATEV-Administrator, Ihrem Steuerberater oder Ihrem DATEV-Servicepartner bestätigen. *** ### 2. Netzwerk- & Serverzugriff Für diesen Teil ist die Einbeziehung Ihres DATEV-IT-Dienstleisters oder DATEV-Integrators erforderlich. Damit Chift über die DATEVconnect-API mit DATEV kommunizieren kann, muss der DATEV-Server extern über einen sicheren HTTPS-Endpunkt erreichbar sein. Dies können Sie auf zwei verschiedene Arten erreichen: #### 1. Die DATEVconnect-API-URL bereitstellen Ihr DATEV-Administrator oder IT-Dienstleister muss einen externen HTTPS-Endpunkt konfigurieren, der den Datenverkehr an Ihren DATEVconnect-Dienst weiterleitet. Typische interne Endpunkte: `https://:58452` Der bereitgestellte Endpunkt muss von Chift-Systemen aus per HTTPS remote erreichbar sein. ### Erforderliche Netzwerkkonfiguration * Externen Zugriff auf Port **58452** öffnen und weiterleiten * NAT-/Firewall-Regeln konfigurieren, um eingehenden HTTPS-Verkehr an den internen DATEV-Server zu routen * Idealerweise den Zugriff über einen dedizierten Request-Header (Chift) einschränken Wenn Ihr DATEV-Dienstleister die Bereitstellung der URL aufgrund von Sicherheitsvorschriften oder DATEV-Richtlinien ablehnt, müssen Sie die **unten beschriebene zweite Methode** oder die **Local-Agent-Methode** verwenden. ### Anforderungen an das Benutzerkonto Sie müssen den **Windows-Benutzernamen und das Passwort** eines Windows-Benutzerkontos angeben, das **mit einem DATEV-Benutzer verknüpft** ist und über folgende Berechtigungen verfügt: ✔ Zugriff auf das entsprechende **Mandat/Unternehmen** in DATEV Rechnungswesen\ ✔ Rechte zur Nutzung des **DATEVConnect-Dienstes**\ ✔ Ausreichende Rechte zum Lesen/Schreiben von Buchhaltungsdaten (abhängig vom Umfang der Integration) DATEV verlangt, dass die API-Authentifizierung über einen Windows-Login erfolgt, der einem DATEV-Benutzerkonto zugeordnet ist. Diese Zuordnung wird in der DATEV Benutzerverwaltung konfiguriert. #### 2. Riecken Cloud Gateway verwenden Riecken bietet ein Cloud Gateway an, um extern auf Ihre lokale DATEVconnect-API zuzugreifen. Um diesen Dienst zu nutzen, müssen Sie Riecken kontaktieren und direkt einen Vertrag mit ihnen abschließen. Weitere Informationen zu dieser Möglichkeit finden Sie hier: [https://cloudgateway.riecken.io/index.html](https://cloudgateway.riecken.io/index.html) # ⚡️ VERBINDUNG image.png **Schritt 1:** Wählen Sie einen Namen für Ihre Verbindung. (Wenn das Feld für den Verbindungsnamen nicht sichtbar ist, überspringen Sie diesen Schritt einfach und fahren Sie fort.) image.png **Schritt 2:** Wählen Sie, ob Sie Anhänge senden möchten Wenn Sie diese Option nicht sehen, hat Ihr Softwareanbieter diese Einstellung für Sie voreingestellt. image.png * Wenn Ihre Integration PDF-Rechnungen, Belege oder Nachweisdokumente an DATEV senden muss, wählen Sie **Ja**, um Anhänge zu aktivieren. * Dies erfordert eine gültige **DATEV Unternehmen Online**-Lizenz (siehe oben im Abschnitt Voraussetzungen) **Schritt 3**: \[**Nur wenn Anhänge aktiviert / DUO ausgewählt**] Geben Sie Ihre **Beraternummer** und **Mandantennummer** ein. image.png Geben Sie Ihre **Beraternummer** und **Mandantennummer** ein. Wo finden Sie diese? 👇 * Gehen Sie zur Anmeldeseite von DUO * Klicken Sie auf **Belegübersicht anzeigen** * Die Nummern werden rechts unterhalb von *Einstellungen* angezeigt: * Erste Nummer = Beraternummer (im Beispiel 5696507) * Zweite Nummer = Mandantennummer (im Beispiel 55003) image.png **Schritt 4**: Geben Sie die remote erreichbare DATEVConnect-API-URL (HTTPS) ein SCR-20251121-jonc.png Schritt 5: Geben Sie Ihren Windows-Benutzer und das Passwort ein, die mit dem DATEV-Konto verknüpft sind image.png Geben Sie den Windows-Benutzernamen und das Passwort **des mit dem DATEV-Konto verknüpften Benutzers** ein, wie in den Voraussetzungen beschrieben. Wenn Sie sich für die Nutzung des **Riecken Cloud Gateway** entscheiden, müssen Sie anstelle eines Windows-Benutzernamens und -Passworts die von Riecken bereitgestellten Informationen eingeben. Riecken stellt Ihnen 2 Informationen zur Verfügung: * Client ID: diese Information kann im Feld **Windows-Benutzer** eingetragen werden * Client Secret: diese Information kann im Feld **Passwort des** **Windows-Benutzers** eingetragen werden **Schritt 6:** Klicken Sie auf „Autorisieren“, um die Verbindung abzuschließen. # AUTHENTIFIZIERUNG - **\[Nur wenn Anhänge aktiviert / DUO ausgewählt]** Sie werden zur Anmeldeseite von DUO weitergeleitet, um sich zu authentifizieren und die Verbindung zu autorisieren. Sie können sich mit Ihrem SmartLogin oder Ihrer SmartCard/mIDentity anmelden. image.png # KONFIGURIEREN image.png Wählen Sie Ihr Unternehmen aus und klicken Sie auf „Senden“. Sobald dies erledigt ist, ist Ihre Verbindung zu DATEV vollständig aktiv. 🎉 🕺