DATEV Rechnungswesen Schnittstelle und API-Integration
DATEV Rechnungswesen ist der Ort, an dem eine deutsche Buchung endgültig erfasst wird, von einem Steuerberater oder von einem Unternehmen, das selbst bucht. Es ist keine der Online-Anwendungen von DATEV: Es läuft auf dem Server eines Anbieters oder auf dem des Kunden selbst. Maesn erreicht es über dieselbe REST API und dasselbe Datenmodell wie jedes andere unterstützte System.
Das Rechnungswesen-Hauptbuch, in beide Richtungen erreichbar
Rechnungswesen ist das Ende der Kette, und das Ende einer Kette zu erreichen, die teilweise auf fremden Servern läuft, verlangt drei Dinge. Hier stehen sie, und hier steht der Teil, den Maesn Ihnen abnimmt.
Ein direkter Weg, einer über das Portal
Weil es eine lokal installierte Anwendung ist und keine Online-Anwendung, überträgt genau ein Datenservice Daten direkt hinein. Alles andere läuft über Unternehmen Online, wo der Steuerberater es zuerst prüft. Maesn deckt beide Wege auf einer Schnittstelle ab, welchen eine Nutzlast nimmt, ist also ein Parameter und kein zweites Projekt.
Eine Anmeldung, zwei Jahre, Lesen inbegriffen
Schreiben und Lesen laufen über dieselbe Verbindung, einmal authentifiziert mit einem Token, das zwei Jahre gültig ist. Maesn stellt die Client-Zugangsdaten mit dem Export-Datenservice bereits darin aus. Das Hauptbuch antwortet also auf der Verbindung, die Ihr Kunde schon freigegeben hat, und nicht auf einer zweiten.
Was Sie senden, können Sie abfragen
Buchungssätze gehen hinein und kommen wieder heraus. Die Summen- und Saldenliste, die Zahlungsbedingungen und die Wirtschaftsjahre kommen nur heraus, und jedes dieser drei ist in diesem Katalog auf genau einem weiteren System lesbar, und deshalb landet ein Produkt für Reporting oder Abstimmung hier und nicht weiter vorne.
In Ihrem Code kommen ein REST-Aufruf und ein Account-Key an. Teams gehen in Tagen live, und das System nach diesem ist ein Konfigurationsschritt und kein zweites Projekt.
Der Weg, der nicht direkt ist, läuft über DATEV Unternehmen Online, wo der Steuerberater Ihres Kunden einen Beleg prüft, bevor er hier eingereicht wird. Die meisten Produkte nutzen am Ende beide, und deshalb teilen sie sich einen Partnerstatus und eine gemeinsame Anbindung. Die DATEV-Übersicht stellt die beiden Systeme und die vier Datenservices nebeneinander, damit diese Seite bei dem bleiben kann, auf dem die Buchung landet.
Ein kurzes Gespräch genügt meist, um zu klären, ob Maesn zu Ihrem Anwendungsfall passt.
Tipalti bucht nach Rechnungswesen, GoBD-konform
Tipalti automatisiert die Kreditorenbuchhaltung in ganz Europa, und ihre Case Study nennt dieses System: Buchungen und Belege gehen direkt nach DATEV Rechnungswesen, im Einklang mit den lokalen Rechnungslegungsvorschriften und den GoBD-Anforderungen.
“Mit Maesn haben wir unsere europäische Expansion beschleunigt, weil komplexe ERP-Integrationen über Benelux und DACH hinweg reibungslos laufen. Für eine AP-Plattform ist verlässlicher Zugang zu den wichtigen lokalen ERP-Systemen entscheidend, und genau den gibt uns Maesn.”
Drei Gründe, die DATEV Rechnungswesen Schnittstelle über Maesn anzubinden
Eine Buchung, die im falschen Format landet, ist kein Fehler, den Ihr Kunde verzeiht, und DATEV hat mehr als ein Format. Was sich auszulagern lohnt, ist der Teil zwischen Ihren Soll- und Habenzeilen und dem, was Rechnungswesen annimmt.
Die DATEV-Hälfte bleibt hier
Der Status als Schnittstellenanbieter, der OAuth-Client, die Sandbox und die Freigabe Ihrer Integration sind der Eintrittspreis, und auf dem Maesn-Client erben Sie unseren, Sie starten also, ohne dafür zu zahlen oder zu warten. Später auf einen eigenen Client zu wechseln, ist ein Verfahren, das wir mit Ihnen führen und dessen DATEV-Gebühren Sie tragen.
Die Objekte, die eine Abstimmung braucht, aus dem Hauptbuch
Konten, Buchungssätze, eine Summen- und Saldenliste, Wirtschaftsjahre und Steuersätze kommen über dieselbe Verbindung zurück, über die Ihre Buchungen hineingehen, in der Form, in der jedes andere unterstützte System sie liefert. Sagen Sie uns, mit welchen Objekten Ihr Anwendungsfall arbeitet, und wir bestätigen sie.
Das nächste System kostet nichts
Sobald das läuft, antwortet jedes andere unterstützte Buchhaltungs- und ERP-System auf derselben Schnittstelle. Ihre zweite Integration ist ein Konfigurationsschritt, und das Portal vor diesem System gehört schon dazu.
Eine Rechnungswesen-Verbindung, lesend und schreibend
DATEV authentifiziert über seine eigene Anmeldung mit SmartCard oder SmartLogin, und was Ihr Kunde einmal freigibt, deckt beide Richtungen ab. Eine Buchung zu senden und das Hauptbuch zurückzulesen laufen über dieselbe Verbindung und dasselbe lange Token. Die Verbindung, die Ihr Produkt baut, ist also eine Verbindung.
- Langes Zugriffstoken
- Lesen und Schreiben, zwei Jahre, an eine Firma gebunden
- SmartCard oder SmartLogin
- Die DATEV-eigene Anmeldung, auf dem DATEV-Bildschirm
Eine Verbindung auf unserer Seite, eine Form des Account-Key auf Ihrer. Lesen und Schreiben sind dieselbe Authentifizierung und nicht zwei.
- Ein langes Token, zwei Jahre
- Zwei Jahre gültig und an den Mandanten gebunden, für den es ausgestellt wurde. Ihr Kunde wählt diesen Mandanten im Ablauf, und die ID wird an der Verbindung gespeichert, nachgelagert trägt sie also nichts mit.
- Lesen auf derselben Freigabe
- Buchungssätze, die Summen- und Saldenliste, Zahlungsbedingungen und Wirtschaftsjahre abzufragen läuft über die Verbindung, die Ihr Kunde bereits freigegeben hat. Maesn stellt die Client-Zugangsdaten mit dem Export-Datenservice darin aus, auf Ihrer Seite schaltet also nichts zwischen einem Schreibweg und einem Leseweg um.
Ein Ablauf ist einzuplanen, zwei Jahre im Voraus. Er liegt weit genug weg, um sich anzufühlen, als käme er nie, und genau deshalb gehört die Erinnerung daran in Ihr Produkt, während Sie die Verbindung bauen, und nicht in das Quartal, in dem sie ausläuft.
- 1
Ihr Kunde meldet sich bei DATEV an
Mit seiner SmartCard oder seinem SmartLogin, auf dem Bildschirm von DATEV selbst. Vom Zugangsmedium erreicht nichts Ihr Produkt, und nichts daran ist Maesn-eigen.
- 2
Er wählt die Firma
Eine DATEV-Anmeldung kann mehr als einen Mandanten erreichen, und die Verbindung ist an den gewählten gebunden. Zwei Mandanten heißt zwei Verbindungen, und das sollten Sie abbilden, bevor Ihr erster Kunde mit mehreren Gesellschaften kommt.
- 3
Sie arbeiten mit einem Account-Key
Maesn speichert die Verbindung und gibt einen Account-Key zurück. Ab da trägt jede Anfrage Ihren API-Schlüssel und diesen Account-Key, dieselben zwei Header, die Sie für jedes andere System im Katalog ohnehin schon senden.
Die Authentifizierung ist die Stelle, an der ein einzelnes System still zu einer Implementierung je System wird, mit eigener Refresh-Logik und eigenem Ausfallmuster nach einem Zeitplan, den niemand in den Kalender geschrieben hat. Hier gibt es eine Zustimmung, ein Token und einen Ablauf: Unified Authentication speichert die eine Verbindung, die Ihr Kunde freigegeben hat, und derselbe Account-Key erreicht das Hauptbuch und den Buchungsendpunkt gleichermaßen.
Keine Rechnungswesen-Events, dafür ein Hauptbuch, das sich lesen lohnt
Events werden bei diesem System je Objekt freigeschaltet, und bei einem Hauptbuch zählt das weniger, als es klingt. Was heute läuft, ist ein geplanter Lesezugriff, und bei diesem System ist der etwas wert.
Nichts. Kein Objekt trägt ein natives Event. Eine Buchung, die der Steuerberater Ihres Kunden erfasst, bleibt für Ihr Produkt also unsichtbar, bis etwas sie liest. Die acht Zellen auf Anfrage sind alle Webhooks, und dort fängt dieses Gespräch an.
Ein geplanter Lesezugriff gegen ein Hauptbuch, das tatsächlich antwortet. Buchungssätze, die Summen- und Saldenliste und die Konten kommen über das Export-System zurück, gefiltert und seitenweise genauso wie bei jedem anderen System, das Sie schon angebunden haben.
Ein Abruf ist hier das richtige Werkzeug und kein Trostpreis: Buchungen werden korrigiert und neu erfasst, und ein Lesezugriff nach Ihrem Zeitplan sieht den korrigierten Zustand statt einer Folge von Zwischenständen. Der Preis ist das Intervall, und das Intervall wählen Sie.
Beim Schwestersystem findet ein Lesezugriff nach Zeitplan wenig vor, denn ein Zustellportal hält keinen Zustand, den Sie wollen. Hier findet er viel vor: Dies ist die eine Stelle im DATEV-Bereich, an der ein Produkt fragen kann, was gebucht wurde und was die Summen- und Saldenliste sagt. Ein Weg, zu filtern und zu paginieren gibt diesem Lesezugriff dieselbe Form wie jedem anderen, den Sie fahren, eine Auswertungsfunktion, die gegen ein System geschrieben ist, funktioniert also weiter gegen das nächste.
Was Rechnungswesen braucht, vor der ersten Buchung
Ihr Kunde hostet dieses Ziel möglicherweise selbst, was vor dem ersten Aufruf vorhanden sein muss, ist also teilweise Infrastruktur und nicht nur Einstellungen.
- Eine Instanz, gehostet von einem Anbieter oder von Ihrem Kunden
- Rechnungswesen ist kein Cloud-Produkt, für das man sich anmeldet. Ihr Kunde betreibt es, oder jemand betreibt es für ihn, und die Datenservices, von denen Ihr Anwendungsfall abhängt, müssen auf dieser Instanz liegen.
- Der Datenservice für die Richtung, die Sie brauchen
- Buchungen zu schreiben und sie zurückzulesen sind zwei verschiedene DATEV-Datenservices, die getrennt bestellt werden. Maesn dokumentiert die Konfiguration von beiden, und welchen der zwei Sie brauchen, folgt aus Ihrem Anwendungsfall und nicht aus der Einrichtung.
- Ein Zugangsmedium, und dazu passende Rechte
- Eine SmartCard oder ein SmartLogin, dazu die Zugriffsrechte, eingestellt in der DATEV Rechteverwaltung Online. Dieses Werkzeug gehört dem Steuerberater. Dieser Schritt ist also ein Gespräch mit Ihrem Kunden und keine Aufgabe in Ihrem Backlog.
Bringen Sie Ihren Anwendungsfall mit, und wir sagen Ihnen, welchen der beiden Datenservices er braucht.
Welches DATEV-System die Daten hält, die Sie brauchen
Rechnungswesen ist das Hauptbuch unter den drei DATEV-Zielsystemen, und was daraus kommt, ist genau das, was eine Abstimmung braucht.
Was Sie lesen, kommt im gemeinsamen Common Data Model an, ein Buchungssatz aus Rechnungswesen hat also dieselben Felder wie ein Buchungssatz aus einem Cloud-System mit eigener REST API, und die Abstimmung, die Sie einmal schreiben, übersteht die nächste Integration.
Belege nehmen absichtlich einen anderen Weg, und die Dokumentation sagt deutlich, warum: Sie laufen über das Portal, damit der Steuerberater sie zuerst prüfen kann. DATEV betreibt außerdem eine E-Rechnungs-Plattform, ein eigenes Zielsystem, für das es einen eigenen Integrationsleitfaden gibt. Früh zu entscheiden, welches der drei die Daten hält, um die es in Ihrem Anwendungsfall geht, spart mehr Zeit als jede Menge Endpunkt-Lektüre.
Sagen Sie uns, welche Objekte Ihr Anwendungsfall braucht, und wir bestätigen, was möglich ist.
