DATEVconnect Integration mit Klardaten

2024-10-01

Praxisnahe DATEV-Integration mit der Klardaten API

Die Integration von DATEV in Ihre Systeme sollte nicht mühsam sein. Wir bei Klardaten kennen die Herausforderungen bei der Arbeit mit herkömmlichen DATEVconnect-Setups - Ratenbeschränkungen, komplizierte Einstellungen und die fehlende Internetanbindung können Sie ausbremsen. Deshalb haben wir unsere API entwickelt, um den Datenaustausch zwischen DATEV und Ihren Anwendungen schneller, einfacher und sicherer zu machen.

Was ist DATEVconnect?

DATEVconnect ist eine Schnittstelle, die einen automatischen, bidirektionalen Datenaustausch zwischen DATEV-Programmen und externen Anwendungen ermöglicht. Diese Integration ist in den Bereichen Buchhaltung, Lohnabrechnung und Dokumentenmanagement unerlässlich. Allerdings ist die Einrichtung und Pflege von DATEVconnect nicht ganz einfach. Sie ist nicht standardmäßig über das Internet zugänglich, und bestehende Lösungen haben strenge Rate-Limits, die zu Verzögerungen führen können. Wir von Klardaten lösen diese Probleme mit einer leistungsfähigen API, die DATEV flexibler, skalierbarer und effizienter macht.

Einfaches Setup mit dem Klardaten API-Connector

Um DATEV mit der Klardaten API zu integrieren, müssen Sie nur diese einfachen Schritte befolgen:

Registrieren Sie Ihren Benutzer: Melden Sie sich auf der Klardaten-Plattform an, indem Sie ein Benutzerkonto erstellen.
Registrieren Sie eine DATEV-Client-Instanz: Sobald Ihr Konto registriert ist, erstellen Sie eine DATEV-Client-Instanz, indem Sie Ihre Beraternummer angeben. Dieser Schritt verbindet das DATEV-System mit unserer Plattform.
Installieren Sie den API-Connector: Installieren Sie abschließend den Klardaten API-Connector auf dem Windows-Client, auf dem DATEVconnect installiert ist. Die Installation ist einfach und wird von einem leicht verständlichen Einrichtungsassistenten geleitet.

Sollten Sie während der Einrichtung auf Probleme stoßen, steht Ihnen unser Support-Team jederzeit zur Verfügung.

Anwendungsbeispiele mit API-Anfragen

Schauen wir uns an, wie Sie unsere API in der Praxis nutzen können.

Anforderungen an Zugriffstoken und Instanz-ID

Bevor Sie die folgenden Beispiele ausführen, müssen Sie ein Zugriffstoken durch Registrierung oder Login erhalten. Dieses Token wird für die Authentifizierung in den API-Anfragen verwendet. Außerdem erhalten Sie 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

curl -X POST "https://api.klardaten.com/api/auth/register" \
     -H "Content-Type: application/json" \
     -d '{
           "email": "test@user.com",
           "password": "!Not-Too-Secure-Password-123"
         }'

Die Antwort enthält ein Zugriffstoken.

Instanz erstellen

curl -X POST "https://api.klardaten.com/api/client-instances" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer {{accessToken}}" \
     -d '{
           "name": "Meine DATEV-Instanz",
           "beraternummer": "1234567"
         }'

Beispiel einer JSON-Antwort:

{
  "id": "c11197b0-b7e3-47da-a8ea-c14ff4407b30",
  "name": "Meine DATEV-Instanz",
  "beraternummer": "1234567",
  "status": "UP"
}

Jetzt, da Sie sowohl das Zugriffstoken als auch die Client-Instanz-ID haben, können Sie mit den folgenden Beispielen fortfahren, um mit der Klardaten API zu interagieren. Stellen Sie 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 finden Sie 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:

curl -X GET "https://api.klardaten.com/datevconnect/master-data/v1/clients" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer {{accessToken}}" \
     -H "x-client-instance-id: c11197b0-b7e3-47da-a8ea-c14ff4407b30"

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

[
  {
    "id": "d13f9c3c-380c-494e-97c8-d12fff738189",
    "client_since": "1999-04-15T00:00:00.000",
    "client_to": "2019-03-31T00:00:00.000",
    "differing_name": "Abweichender Mustermeier",
    "legal_person_id": "fd3b2877-7505-4811-a53f-cd1c28ef627c",
    "name": "Mustermeier GmbH",
    "note": "Notiz zu Mandant 10000",
    "number": 10000,
    "status": "active",
    "timestamp": "2017-03-31T10:03:11.107",
    "type": "legal_person",
    "organization_id": "f43f9c3g-380c-494e-97c8-d12fff738180",
    "organization_name": "Musterkanzlei",
    "organization_number": "1",
    "establishment_id": "h63f9c3g-380c-494e-97c8-d12fff738180",
    "establishment_name": "Musterkanzlei - Hauptsitz",
    "establishment_number": "1",
    "establishment_short_name": "Hauptsitz",
    "functional_area_id": "g93e8c3g-380c-494e-97c8-d12fff738371",
    "functional_area_name": "Gesamtunternehmen",
    "functional_area_short_name": "999"
  }
]

Beispiel 2: Abrufen von Dokumenten

Müssen Sie Dokumente von DATEV abrufen? Hier erfahren Sie, wie Sie dies mit unserer API erledigen können:

curl -X GET "https://api.klardaten.com/datevconnect/dms/v2/documents" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer {{accessToken}}" \
     -H "x-client-instance-id: c11197b0-b7e3-47da-a8ea-c14ff4407b30"

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

[
  {
    "id": "e602ddcb-e479-4cee-b268-e53bbecf6dc9",
    "amount": "150,95",
    "cost_quantity": 1.25,
    "extension": "docx",
    "number": 3001,
    "year": 2021,
    "application": "KARE",
    "case_number": -2147483648,
    "change_date_time": "2021-04-28T14:03:58.310",
    "checked_out": false,
    "class": {
      "name": "Dokument",
      "id": 1
    },
    "correspondence_partner_guid": "e602ddcb-e479-4cee-b268-e53bbecf6dc9",
    "cost_date": "2020-12-10T00:00:00",
    "cost_number1": 1000,
    "cost_number2": 2000,
    "create_date_time": "2021-04-28T14:03:58.310",
    "description": "Eingangsrechnung 19.01.2021",
    "employee": {
      "name": "Mustermann, Max",
      "is_active": true,
      "id": 11
    },
    "folder": {
      "name": "Stammakte",
      "id": "3"
    },
    "keywords": "These, are, keywords",
    "state": {
      "name": "offen",
      "id": "5"
    },
    "acknowledge_by": [
      {
        "name": "Mustermann, Bob",
        "removed_acknowledgement": "2021-03-04T14:03:58.310",
        "acknowledged": "2021-03-04T14:03:58.310",
        "is_deleted": false,
        "id": "35e98168-01dd-4104-a273-79e38b3c3b22"
      }
    ]
  }
]

Diese Beispiele zeigen, wie einfach der Abruf von DATEV-Daten und -Dokumenten mit unserer API ist. Unsere API gibt Ihnen die Möglichkeit, verschiedene steuerliche Aufgaben zu automatisieren und Daten effizient zu verwalten.

Support und Dokumentation

Eines der häufigsten Anliegen bei der Implementierung neuer Systeme ist die Einfachheit der Einrichtung und des Supports. Bei Klardaten legen wir großen Wert darauf, dass unsere Integration so einfach wie möglich ist. Unser Einrichtungsassistent sorgt dafür, dass die Installation schnell und einfach vonstatten geht, aber unser Support-Team ist immer zur Stelle, wenn Sie Probleme haben.

Außerdem stellen wir eine detaillierte, schrittweise Dokumentation zur Verfügung, die Sie durch die Installation, die API-Nutzung und die Fehlerbehebung führt. Egal, ob Sie ein technischer Experte sind oder gerade erst mit APIs anfangen, unsere Anleitungen decken alles ab, was Sie wissen müssen, damit Ihre Integration reibungslos funktioniert.

Warum die Klardaten API verwenden?

Unsere API löst häufige Probleme, die viele Unternehmen mit DATEVconnect haben. Lassen Sie uns in die wichtigsten Verbesserungen eintauchen, die wir anbieten:

Optimierte Rate-Limits: Wir haben unsere API so konzipiert, dass sie größere Mengen an Anfragen bewältigen kann, ohne dass Sie an Rate-Limits stoßen, die Ihre Prozesse verlangsamen. Ob Sie Finanzdaten importieren oder Gehaltsabrechnungen bearbeiten, Sie können sich auf eine gleichbleibende Leistung verlassen.
Schnelle Antwortzeiten: Langsame Datenabrufe können die Produktivität stark beeinträchtigen. Mit Klardaten fließen Ihre Daten schneller und die Wartezeit auf Serverantworten wird minimiert.
Sicherer internetbasierter Zugriff: DATEVconnect ist standardmäßig nicht über das Internet zugänglich, was den Remote-Zugriff oder Cloud-basierte Operationen erschweren kann. Mit Klardaten bieten wir Ihnen einen sicheren, internetbasierten Zugriff auf Ihre DATEV-Daten, der Ihnen mehr Flexibilität verschafft.
Fokus auf das Wesentliche: Statt sich mit technischen Herausforderungen herumzuschlagen, vereinfacht unsere API die DATEV-Integration, so dass Sie sich darauf konzentrieren können, Ihren Mandanten einen Mehrwert zu bieten.

Bereit loszulegen?

Die Integration von DATEV in Ihre Systeme ist jetzt so einfach wie nie. Mit nur wenigen Schritten können Sie die Klardaten-API in Betrieb nehmen, um Ihre Arbeitsabläufe zu optimieren und Ihre Prozesse effizienter zu gestalten. Bleiben Sie in der sich ständig weiterentwickelnden Steuertechnologie-Landschaft an der Spitze mit einer Lösung, die auf Skalierbarkeit und langfristigen Erfolg ausgelegt ist.

Kontaktieren Sie uns, um herauszufinden, wie Klardaten Ihre DATEV-Integration transformieren kann.