Praxisnahe DATEV-Integration mit der Klardaten API

DATEVconnect ist für viele Integrationen die technische Grundlage, ist im Alltag aber nicht immer einfach zu betreiben. Rate-Limits, lokale Installation, fehlende Internet-Erreichbarkeit und unterschiedliche DATEV-Umgebungen machen den produktiven Einsatz oft aufwendiger als geplant. Die Klardaten API stellt dafür eine Verbindungsschicht bereit, über die Anwendungen DATEV-Daten kontrolliert und automatisiert abrufen können.

Was ist DATEVconnect?

DATEVconnect ist eine Schnittstelle für den Datenaustausch zwischen DATEV-Programmen und externen Anwendungen. Sie wird häufig in Bereichen wie Buchhaltung, Lohnabrechnung und Dokumentenmanagement eingesetzt. In der Praxis ist der Betrieb jedoch an lokale Voraussetzungen gebunden: DATEVconnect ist nicht standardmäßig über das Internet erreichbar, und je nach Setup können Rate-Limits oder Installationsdetails die Integration erschweren. Klardaten setzt hier mit einer API-Schicht an, die DATEVconnect für angebundene Systeme besser nutzbar macht.

Einfaches Setup mit dem Klardaten API-Connector

Für die Anbindung über die Klardaten API sind im Kern drei Schritte nötig:

1. Registriere deinen Benutzer: Melde dich auf der Klardaten-Plattform an, indem du ein Benutzerkonto erstellst.
2. Registriere eine DATEV-Client-Instanz: Sobald dein Konto registriert ist, erstellst du eine DATEV-Client-Instanz, indem du deine Beraternummer angibst. Dieser Schritt verbindet das DATEV-System mit unserer Plattform.
3. Installiere den API-Connector: Installiere abschließend den Klardaten API-Connector auf dem Windows-Client, auf dem DATEVconnect installiert ist. Die Installation wird durch einen Einrichtungsassistenten unterstützt.

Solltest du während der Einrichtung auf Probleme stoßen, steht dir unser Support-Team jederzeit zur Verfügung.

Anwendungsbeispiele mit API-Anfragen

Schauen wir uns an, wie du unsere API in der Praxis nutzen kannst.

Anforderungen an Zugriffstoken und Instanz-ID

Bevor du die folgenden Beispiele ausführst, musst du ein Zugriffstoken durch Registrierung oder Login erhalten. Dieses Token wird für die Authentifizierung in den API-Anfragen verwendet. Außerdem erhältst du bei der Erstellung einer Client-Instanz eine instance_id, die im Anfrageheader x-client-instance-id für die weitere API-Kommunikation enthalten sein muss.

Benutzer registrieren

Die Antwort enthält ein Zugriffstoken.

Instanz erstellen

Beispiel einer JSON-Antwort:

Jetzt, da du sowohl das Zugriffstoken als auch die Client-Instanz-ID hast, kannst du mit den folgenden Beispielen fortfahren, um mit der Klardaten API zu interagieren. Stelle sicher, dass der Authorization-Header das Zugriffstoken enthält und der x-client-instance-id-Header die Instanz-ID für alle Anfragen enthält.

Unten findest du zwei gängige API-Anfragen zur Interaktion mit DATEV-Daten.

Beispiel 1: Abrufen von Mandantendaten

Hier ist eine einfache curl-Anfrage, um eine Liste von Mandanten über DATEVconnect abzurufen:

Diese Anfrage ruft Mandantendaten ab, die dann zur Automatisierung von Workflows wie Buchhaltung oder Mandantenverwaltung verwendet werden können.

Beispiel 2: Abrufen von Dokumenten

Musst du Dokumente von DATEV abrufen? Hier erfährst du, wie du dies mit unserer API erledigen kannst:

Hier ist ein Beispiel für den Inhalt der JSON-Antwort für ein einzelnes Dokument:

Diese Beispiele zeigen, wie Mandanten- und Dokumentendaten über die API abgefragt werden können. Darauf aufbauend lassen sich interne Anwendungen, Auswertungen oder wiederkehrende Arbeitsschritte automatisieren.

Support und Dokumentation

Bei DATEV-Integrationen ist nicht nur die API selbst wichtig, sondern auch die Einrichtung in der konkreten Kundenumgebung. Der Connector muss dort laufen, wo DATEVconnect verfügbar ist, und die Verbindung muss im Betrieb nachvollziehbar bleiben. Klardaten unterstützt deshalb sowohl bei der Einrichtung als auch bei Fragen zum laufenden Betrieb.

Zusätzlich gibt es Dokumentation für Installation, API-Nutzung und Fehlerbehebung. Sie beschreibt die notwendigen Schritte, Header, Zugangsdaten und typische Prüfungen, damit die Integration reproduzierbar eingerichtet werden kann.

Warum die Klardaten API verwenden?

Die Klardaten API adressiert mehrere typische Hürden beim produktiven Einsatz von DATEVconnect:

• Optimierte Rate-Limits: Die API ist darauf ausgelegt, wiederkehrende Anfragen planbarer zu verarbeiten und DATEV-Systeme nicht unnötig zu belasten.

• Planbare Antwortzeiten: Datenabrufe sollen für angebundene Anwendungen zuverlässig und nachvollziehbar erfolgen.

• Sicherer internetbasierter Zugriff: DATEVconnect ist standardmäßig nicht über das Internet zugänglich. Klardaten stellt eine kontrollierte Verbindungsschicht bereit, über die angebundene Systeme auf freigegebene DATEV-Daten zugreifen können.

• Weniger Integrationsaufwand: Teams müssen die DATEVconnect-Anbindung nicht vollständig selbst betreiben und können sich stärker auf den eigentlichen Anwendungsfall konzentrieren.

Bereit loszulegen?

Wenn du DATEV-Daten in eigene Anwendungen, Auswertungen oder Automatisierungen einbinden möchtest, kann die Klardaten API die technische Anbindung deutlich vereinfachen. Entscheidend ist dabei vor allem, welche DATEV-Daten benötigt werden, wo DATEVconnect läuft und welche Prozesse darauf aufbauen sollen.

Kontaktiere uns, wenn du einen konkreten DATEVconnect-Anwendungsfall prüfen möchtest.