Zum Inhalt springen

KI-Agent an DATEV anbinden: DATEVconnect, APIs und Export

In vielen deutschen Unternehmen liegt die Buchhaltung in DATEV, entweder im eigenen Haus oder bei der Steuerkanzlei. Wer einen KI-Agenten für Belege, offene Posten oder Auswertungen einsetzen will, kommt an der Frage nicht vorbei, wie dieser Agent an die DATEV-Daten kommt und wie er etwas zurückschreibt. Anders als bei vielen Cloud-Systemen gibt es dafür nicht eine Schnittstelle, sondern drei grundverschiedene Wege. Alle Angaben in diesem Artikel haben den Stand November 2026.

Was bedeutet es, einen KI-Agenten an DATEV anzubinden?

Einen KI-Agenten an DATEV anzubinden heißt, ihm kontrollierte Werkzeuge zu geben, mit denen er Buchhaltungsdaten lesen, Belege übergeben oder Buchungsvorschläge erzeugen kann. Das Sprachmodell selbst spricht nie direkt mit DATEV. Dazwischen steht immer eine Schicht aus Programmcode, die Rechte, Formate und Protokollierung regelt.

In der Praxis sieht das so aus: Das Modell entscheidet per Tool Use, dass es zum Beispiel die offenen Posten eines Kreditors braucht. Die Werkzeugschicht ruft dafür die passende DATEV-Schnittstelle auf, filtert die Antwort und gibt nur das zurück, was der Agent für die Aufgabe benötigt. Ob diese Werkzeuge als eigener MCP-Server gebaut werden oder fest im Agenten stecken, ist eine Architekturfrage. Die DATEV-Seite bleibt davon unberührt.

Typische Aufgaben für einen solchen Agenten:

  • Belege vorbereiten: Eingangsrechnungen aus einem Postfach erkennen, Pflichtangaben prüfen und als Beleg an DATEV übergeben.
  • Buchungsvorschläge erzeugen: Aus Rechnungsdaten einen Buchungsstapel mit Konto, Gegenkonto, Belegdatum und Buchungstext vorbereiten.
  • Auswertungen erklären: Summen- und Saldenlisten oder offene Posten lesen und in Klartext zusammenfassen, etwa für die Geschäftsführung.
  • Rückfragen bündeln: Fehlende Belege oder unklare Buchungen sammeln und als Liste an die Kanzlei geben.

Welche drei Wege gibt es zu DATEV?

DATEV bietet lokal installierte Desktop-APIs (DATEVconnect), Online-APIs im DATEV-Rechenzentrum (Datenservices) und dateibasierte Formate wie das DATEV-Format. Sie unterscheiden sich darin, wo sie laufen, wie sie sich authentifizieren, welchen Freigabeprozess sie verlangen und ob die Steuerkanzlei die Daten aktiv übernehmen muss.

KriteriumDATEVconnect (Desktop-APIs)Online-APIs (Datenservices)DATEV-Format (EXTF)
Erreichbarkeitnur im lokalen Netzwerküber das Internet, DATEV-RechenzentrumDatei, Import in DATEV Rechnungswesen
Anmeldunglokal, im DATEV-UmfeldOpenID Connect mit PKCEkeine, Datei wird importiert
Freigabe durch DATEVkein Abonnement nötig, Nutzungsbedingungen geltenOnboarding mit technischer Abnahmekeine für die Datei selbst
Lesen und Schreibenbeidesje nach Datenservicenur Schreiben (Import)
Passt, wennDATEV im eigenen Haus läuftdie Kanzlei DATEV führtwenig Aufwand, Kanzlei importiert

DATEVconnect: die lokalen Desktop-APIs

DATEV beschreibt die Desktop-APIs im Developer Portal als Schnittstellen, die „nicht über das Internet, sondern nur im lokalen Netzwerk verfügbar“ sind. Sie eignen sich also für Unternehmen und Kanzleien, die DATEV-Programme selbst betreiben, zum Beispiel auf einem eigenen Server.

Das Portal listet unter anderem folgende Module (Stand November 2026):

  • Accounting (Version 1.7.4): automatischer Austausch von Stamm- und Bewegungsdaten sowie Lesen von Auswertungen der Buchführung.
  • Client Master Data (Version 1.7.0): Lesen und Schreiben der Zentralen Stammdaten, zum Beispiel Mandanten und Adressaten.
  • Document Management (Version 2.4.0): Dokumente in DATEV DMS ablegen, abfragen und bearbeiten.
  • Payroll (Version 3.1.4): Bewegungs- und Stammdaten der Mitarbeiter mit DATEV Lohn und Gehalt austauschen.
  • Identity and Access Management (Version 1.1.0): Zugriff auf DATEV-Benutzer und -Gruppen.
  • Diagnostics and Functional Tests (Version 1.1.0): einfacher Funktionstest für die Entwicklung.

Für einen KI-Agenten ist DATEVconnect der direkteste Weg: Lesen und Schreiben ohne Umweg über das Rechenzentrum. Der Haken liegt in der Netzwerkgrenze. Läuft der Agent in einer Cloud, braucht er eine Komponente im lokalen Netz, die die Aufrufe entgegennimmt und weiterreicht. Laut FAQ des Developer Portals ist für Desktop-APIs kein Abonnement nötig; die Nutzungsbedingungen für DATEV-Schnittstellen gelten trotzdem.

Online-APIs: die DATEV-Datenservices

DATEV bezeichnet seine APIs im Rechenzentrum mit Benutzeranmeldung als Datenservices. Die Anmeldung läuft laut FAQ über OAuth 2.0 und OpenID Connect. Für Rechnungswesen nennt das Produktverzeichnis unter anderem:

  • accounting:documents (Version 2.0): digitale Belege über das DATEV-Rechenzentrum an den Steuerberater übertragen.
  • accounting:dxso-jobs (Version 2.0): Dokumentenbilder sowie strukturierte Rechnungs- und Kassendaten übertragen.
  • accounting:extf-files (Version 2.0): Bewegungs- und Stammdaten im DATEV-Format ins Rechenzentrum übertragen, zum Abruf in DATEV Rechnungswesen.
  • accounting:clients (Version 2.0): verfügbare Rechnungswesen-Datenservices je Bestand abrufen.
  • accounting:dataexchange (Version 1): buchhalterische Daten aus DATEV Rechnungswesen abfragen; als kostenpflichtige API mit besonderen Nutzungsbedingungen gekennzeichnet.

Der Unterschied zu DATEVconnect: Die meisten dieser Dienste sind darauf ausgelegt, Daten in Richtung Kanzlei zu liefern. Der Agent legt einen Beleg oder einen Buchungsstapel ab, die Kanzlei verarbeitet ihn in ihrem DATEV. Lesender Zugriff auf Buchhaltungsdaten ist online nur über ausgewählte, teils kostenpflichtige Dienste möglich.

DATEV-Format: der Weg über Dateien

Das DATEV-Format ist laut DATEV-Dokumentation eine CSV-Datei mit dem festen Präfix EXTF_ und festem Satzaufbau. Zeile 1 ist ein Kopf mit Metadaten, Zeile 2 die Spaltenüberschriften, ab Zeile 3 folgen die Nutzdaten. Felder werden durch Semikolon getrennt, Textfelder stehen in Anführungszeichen, Dezimalzahlen nutzen das Komma.

Die Musterdatei für einen Buchungsstapel beginnt in der DATEV-Dokumentation so:

"EXTF";700;21;"Buchungsstapel";13;20240130140440439;;"RE";"";"";29098;55003;20240101;4;20240101;20240831;...
Umsatz (ohne Soll/Haben-Kz);Soll/Haben-Kennzeichen;WKZ Umsatz;Kurs;Basis-Umsatz;...

Für einen KI-Agenten ist das der Weg mit dem geringsten Integrationsaufwand: Er erzeugt eine Datei, ein Mensch prüft sie, die Buchhaltung oder Kanzlei importiert sie. Lesen kann der Agent auf diesem Weg nichts. Die Datei lässt sich auch über den Online-Dienst accounting:extf-files übertragen, dann gelten wieder die Regeln der Online-APIs.

Welche Rolle spielt die Steuerkanzlei?

Bei DATEV ist die Steuerkanzlei fast immer Teil der Anbindung, weil sie häufig die Bestände führt und die gelieferten Daten übernimmt. Ein KI-Agent im Unternehmen liefert deshalb meist zu, statt selbst zu buchen. Klären Sie früh, welche Daten die Kanzlei in welcher Form übernehmen will.

DATEV selbst empfiehlt in der FAQ des Developer Portals, einen Steuerberater als potenziellen Anwender in die Schnittstellenentwicklung einzubeziehen. Eine Pflicht ist das nicht, aber die fachliche Qualität profitiere davon. Für die Praxis heißt das:

  • Wer führt den Bestand? Führt die Kanzlei die Finanzbuchhaltung, entscheidet sie, ob Belege über DATEV Unternehmen online, als Buchungsstapel oder anders ankommen sollen.
  • Wer gibt Zugriff frei? Für die Online-APIs meldet sich ein DATEV-Benutzer an. Bei langlebigem Zugriff ist das Token laut DATEV-Authentifizierungsleitfaden an genau eine Berater- und Mandantennummer gebunden.
  • Wer trägt laufende Kosten? Laufende Kosten pro Aufruf entstehen nach Angaben von DATEV in der Regel beim Endanwender, also beim Steuerberater oder Mandanten.
  • Wer schreibt fest? Buchungen festzuschreiben bleibt eine Entscheidung von Menschen in Buchhaltung oder Kanzlei, nicht des Agenten.

Läuft DATEV dagegen vollständig im eigenen Haus, etwa in einer Konzernbuchhaltung, ist DATEVconnect oft der naheliegende Weg, und die Kanzlei ist nur für Abschluss und Steuererklärungen beteiligt.

Welche Voraussetzungen braucht eine DATEV-Anbindung?

Sie brauchen Klarheit über die DATEV-Installation, einen Testbestand, saubere Rechte und eine Werkzeugschicht, die der Agent aufrufen darf. Für Online-APIs kommen ein Konto im DATEV Developer Portal, eine Organisation, eine App und das begleitete Onboarding hinzu. Ohne Testsystem lässt sich keine der drei Varianten verantwortungsvoll bauen.

Technisch:

  • Installationsort: Läuft DATEV lokal, bei einem Hosting-Partner oder nur bei der Kanzlei? Davon hängt ab, ob DATEVconnect überhaupt erreichbar ist.
  • Testumgebung: Laut DATEV-FAQ bieten mehrere Solution Partner Test- und Entwicklungsumgebungen mit aktuellen DATEV-Programmversionen an. Für das Onboarding der Online-APIs ist ein DATEV-Testsystem nötig.
  • Netzwerk: Für einen Cloud-Agenten mit DATEVconnect brauchen Sie eine abgesicherte Verbindung ins lokale Netz. DATEV weist außerdem darauf hin, dass APIs über DNS-Namen adressiert werden und sich IP-Adressen ändern können.
  • Authentifizierung: Online-APIs verlangen laut Leitfaden den Authorization Code Flow mit PKCE (Methode S256). Access-Tokens gelten 15 Minuten, Refresh-Tokens ohne Offline-Zugriff höchstens 11 Stunden. Mit dem Scope offline_access gibt es ein Refresh-Token mit zwei Jahren Laufzeit, das an einen einzelnen Mandanten gebunden ist.

Organisatorisch:

  • Rollen und Rechte: Der Agent bekommt nur die Rechte, die seine Aufgabe braucht. Ein Belegagent braucht keinen Zugriff auf Lohndaten.
  • Freigabeprozess: Wer prüft Buchungsvorschläge, wer importiert, wer schreibt fest?
  • Datenschutz: Buchhaltungs- und Lohndaten sind sensibel. Ein Agent mit DATEV-Zugriff ist datenschutzkonform betreibbar, wenn Modellwahl, Speicherort und Auftragsverarbeitung geklärt sind. Wer die Daten nicht an einen Cloud-Modellanbieter geben will, findet Varianten unter souveräne KI.

Wie gehen Sie bei der Anbindung Schritt für Schritt vor?

Beginnen Sie mit einem eng umrissenen Ablauf, wählen Sie danach den DATEV-Weg und bauen Sie zuerst lesend oder mit Vorschlägen statt mit direkten Buchungen. Die Reihenfolge Prozess, Zugang, Werkzeug, Test, Freigabe verhindert, dass ein technisch funktionierender Agent fachlich falsche Daten liefert.

  1. Prozess festlegen. Ein Ablauf, ein messbares Ergebnis: zum Beispiel „Eingangsrechnungen aus dem Rechnungspostfach als Beleg mit Buchungsvorschlag an die Kanzlei übergeben“.
  2. Datenfluss mit der Kanzlei klären. Welcher Weg wird akzeptiert? Welche Felder des Buchungsstapels sollen gefüllt sein, welche nicht?
  3. DATEV-Weg wählen. DATEV im Haus und Lesebedarf: DATEVconnect. Kanzlei führt DATEV: Online-Datenservice wie accounting:documents oder accounting:extf-files. Geringer Aufwand, wenige Vorgänge: Datei im DATEV-Format.
  4. Zugang einrichten. Für Online-APIs folgen Sie dem Ablauf des Developer Portals: Registrieren, Organisation anlegen, App erstellen, API-Produkte abonnieren und in der Sandbox entwickeln, danach Upgrade auf Produktion mit technischer Prüfung.
  5. Werkzeuge bauen. Je Aufgabe ein schmales Werkzeug, etwa „offene Posten eines Kreditors lesen“ oder „Belegstapel vorschlagen“. Das Werkzeug validiert Eingaben, bevor etwas an DATEV geht.
  6. Mensch einplanen. Schreibende Schritte laufen über eine Freigabe (Human in the Loop). Der Agent zeigt Vorschlag und Begründung, ein Mensch bestätigt.
  7. Im Testbestand prüfen. Mit echten, aber unkritischen Vorgängen. Jede Abweichung zwischen Vorschlag und tatsächlicher Buchung wird protokolliert.
  8. Abnahme und Betrieb. Für Online-APIs findet die Abnahme durch DATEV statt. Danach: Monitoring, Token-Verwaltung und ein klarer Ansprechpartner für Fehler.

Zum Onboarding der Online-APIs nennt DATEV in der FAQ einmalig 1.500 Euro zzgl. USt für den ersten Datenservice einschließlich vier Stunden Beratung; weitere Beratung rechnet DATEV mit 210 Euro zzgl. USt je angefangene Stunde ab. Ein vereinfachtes Verfahren für rein interne Nutzung gibt es laut DATEV nicht.

Wo liegen Grenzen und Risiken?

Die größten Risiken sind falsche Buchungsvorschläge, zu breite Rechte und eine unterschätzte Freigabestrecke. Ein Sprachmodell kann Konten verwechseln oder Steuerschlüssel falsch ableiten. Deshalb gehört jede schreibende Aktion hinter eine menschliche Prüfung, und der Agent erhält nur die Daten, die er für seinen Ablauf braucht.

  • Fachliche Fehler: Kontierung und Steuerschlüssel hängen vom Kontenrahmen und vom Einzelfall ab. Ein Agent kann einen plausiblen, aber falschen Vorschlag machen. Lassen Sie Vorschläge immer prüfen und messen Sie die Abweichungsquote.
  • Prompt Injection über Belege: Rechnungen und E-Mails kommen von außen. Ein manipuliertes Dokument kann versuchen, den Agenten zu anderen Aktionen zu bewegen. Werkzeuge mit Schreibrechten dürfen nicht allein auf Grundlage von Dokumententext handeln.
  • Format-Feinheiten: Das DATEV-Format verlangt exakte Schreibweisen, etwa verdoppelte Anführungszeichen in Textfeldern und keine Zeilenumbrüche innerhalb von Feldern. Fehler zeigen sich oft erst beim Import.
  • Tokens und Bindung: Der langlebige Offline-Zugriff ist an einen einzelnen Mandanten gebunden und funktioniert nur mit APIs, bei denen die Mandanten-ID Teil des Pfads ist. Ein Agent für viele Mandanten braucht also eine saubere Token-Verwaltung und einen Widerrufsweg, den DATEV verlangt.
  • Aufwand der Freigabe: Das Onboarding der Online-APIs ist ein begleiteter Prozess mit Termin und Abnahme. Planen Sie dafür Zeit ein, auch wenn die Integration nur intern genutzt wird.
  • Abhängigkeit von der Kanzlei: Passt der gewählte Weg nicht zu den Abläufen der Kanzlei, entsteht doppelte Arbeit statt Entlastung.

Wann der Ansatz nicht passt: Wenn nur wenige Belege im Monat anfallen und die Kanzlei bereits mit DATEV Unternehmen online arbeitet, lohnt ein eigener Agent mit DATEV-Anbindung selten. Dann reicht oft ein Agent, der Belege vorsortiert und benennt, ohne DATEV selbst zu berühren. Ähnliche Abwägungen gelten bei anderen ERP- und Buchhaltungssystemen; für SAP finden Sie sie im Artikel zur Anbindung an SAP S/4HANA. Der wesentliche Unterschied zu DATEV: Bei SAP liegt das System in der Regel vollständig im Unternehmen, bei DATEV ist die Kanzlei fast immer mit im Datenfluss.

Wie fangen Sie an?

Starten Sie mit einem Gespräch mit Ihrer Steuerkanzlei und einer Bestandsaufnahme: Wo läuft DATEV, welche Daten gehen heute wie hin und her, wo entsteht der meiste Handaufwand? Daraus ergibt sich fast immer von selbst, welcher der drei Wege passt und welcher Ablauf sich als erster Agent eignet.

Eine praktikable Reihenfolge für den Einstieg:

  1. Bestandsaufnahme in einer Stunde: DATEV-Installationsort, beteiligte Kanzlei, heutige Belegwege, Volumen pro Monat.
  2. Einen Ablauf wählen: Belegübergabe oder Buchungsvorschläge sind gute erste Kandidaten, weil sie gut prüfbar sind.
  3. Mit dem einfachsten Weg prototypisch beginnen: oft eine Datei im DATEV-Format, die ein Mensch prüft und importiert.
  4. Auf API umstellen, wenn es trägt: Erst wenn Qualität und Volumen stimmen, lohnt der Aufwand für DATEVconnect oder ein Online-Onboarding.

Welche Agententypen sich in Buchhaltung und angrenzenden Bereichen bewährt haben und wie sie aufgebaut sind, zeigt die Übersicht zu KI-Agenten für Fachbereiche. Wie Sie einen Agenten über einen standardisierten Server an mehrere Systeme gleichzeitig anbinden, beschreibt der Artikel zu MCP-Servern.

Hinweis: Dieser Artikel beschreibt technische Wege zur Orientierung und ersetzt keine steuerliche oder rechtliche Beratung.

Häufige Fragen

Braucht man für DATEVconnect eine Freigabe durch DATEV?

Für die Desktop-APIs ist laut DATEV-FAQ kein Abonnement im Developer Portal nötig; es gelten aber die Nutzungsbedingungen für DATEV-Schnittstellen. Die Online-APIs dagegen durchlaufen ein begleitetes Onboarding mit technischer Abnahme.

Gibt es ein vereinfachtes Verfahren, wenn die Online-API nur intern genutzt wird?

Nein. DATEV schreibt in der FAQ des Developer Portals, dass es einen einheitlichen Onboarding-Prozess für alle Integrationen gibt, auch ohne kommerzielle Absicht.

Kann ein KI-Agent direkt Buchungen in DATEV festschreiben?

Technisch lassen sich Bewegungsdaten über DATEVconnect oder als Buchungsstapel übertragen. Sinnvoll ist, dass der Agent nur Vorschläge erzeugt und ein Mensch in Buchhaltung oder Kanzlei prüft und festschreibt.

Wer trägt die laufenden Kosten der DATEV-Datenservices?

Nach Angaben von DATEV entstehen die laufenden Kosten pro API-Aufruf in der Regel beim DATEV-Endanwender, also beim Steuerberater oder Mandanten. Die genauen Beträge stehen in der DATEV-Preisliste.

Ist dieser Artikel eine steuerliche oder rechtliche Beratung?

Nein. Er beschreibt technische Wege und Abläufe zur Orientierung. Fragen zu Buchungslogik, Aufbewahrung und Haftung klären Sie mit Ihrer Steuerkanzlei.

Quellen

  1. DATEV Developer Portal: API-Produkte (Online APIs und Desktop APIs) developer.datev.de
  2. DATEV Developer Portal: FAQ zu Onboarding, Freigabeprozess und Kosten developer.datev.de
  3. DATEV Developer Portal: Authentifizierung Cloud Integration (OpenID Connect) developer.datev.de
  4. DATEV Developer Portal: DATEV-Format, Einstieg developer.datev.de
  5. DATEV Developer Portal: Ablauf bis zur Anbindung developer.datev.de
  6. DATEV: DATEV Schnittstellen-Anbieter datev.de