DATEV Unternehmen Online Schnittstelle und API-Integration
DATEV Unternehmen Online ist die Plattform, über die DATEV-Nutzer ihre Belege und Buchhaltungsdaten teilen, und die Plattform, um sie weiter an DATEV Rechnungswesen zu geben. Binden Sie DATEV heute über Maesn an und senden Sie Daten mit derselben REST API und demselben Datenmodell wie bei jedem anderen unterstützten System.
Belege landen in Unternehmen Online, wo der Berater arbeitet
Die meisten Systeme auf dieser Site sind eine Datenbank, aus der Ihr Produkt liest und in die es schreibt. Unternehmen Online ist ein Zustellkanal: Die Belege Ihres Kunden gehen hinein, und sein Steuerberater nimmt sie von dort. Daraus folgen drei Dinge, und Maesn fängt jedes davon ab.
Der Berater holt ihn dort ab
Was Sie senden, landet in der eigenen Unternehmen-Online-Umgebung Ihres Kunden, und dort arbeitet sein Steuerberater bereits. Das ersetzt den Export, die E-Mail und den Upload von Hand, und genau deshalb lohnt sich diese Integration überhaupt.
Das lange Token, erledigt
DATEV stellt ein kurzes Token aus, um die Mandanten aufzulisten, und ein langes, zwei Jahre gültiges, um damit zu arbeiten. Maesn betreibt beide Zielsysteme hinter einer Schnittstelle. Ihr Code sieht also einen einzigen Account-Key statt einer zweistufigen Anmeldung, die er steuern müsste.
Kein Beratungspaket zu buchen
Client-Zugangsdaten, Sandbox-Zugang und die Freigabe Ihrer Integration laufen über Maesn auf unserem Status als Schnittstellenanbieter. Es gibt also kein Beratungspaket, das Sie bei DATEV buchen müssten, und nichts zu bezahlen vor Ihrem ersten Aufruf. Später selbst Schnittstellenanbieter zu werden, ist ein Verfahren, das wir mit Ihnen führen, zu den Kosten, die DATEV Ihnen berechnet.
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.
Unternehmen Online ist eines von zwei DATEV-Systemen, die über Maesn erreichbar sind, und welches davon ein Anwendungsfall braucht, entscheidet die Richtung und nicht die Vorliebe: Belege gehen hier hinein, gebucht wird nebenan. Die DATEV-Übersicht legt die Datenservices, den Partnerstatus und den Marketplace über beide hinweg aus, damit diese Seite bei dem bleiben kann, in das Ihr Kunde tatsächlich hochlädt.
Ein kurzes Gespräch genügt meist, um zu klären, ob Maesn zu Ihrem Anwendungsfall passt.
HubSpot erreicht DATEV, ohne für DATEV zu bauen
HubSpot gleicht Kundendaten, Rechnungen und Zahlungserinnerungen in die Buchhaltungssysteme ab, die seine DACH-Kunden einsetzen, DATEV darunter, für Hunderte dieser Kunden, ohne eine einzige dieser Integrationen selbst zu bauen oder zu pflegen.
“Wir binden deutsche Buchhaltungssysteme an und verlassen uns dabei auf Maesn als verlässlichen Partner, der für reibungslosen Datenfluss, vollständige Compliance, stärkere Partnerschaften und effiziente, verlässliche Finanzprozesse sorgt, die unser Wachstum tragen.”
Drei Gründe, die DATEV Unternehmen Online Schnittstelle über Maesn anzubinden
Bei DATEV liegt fast die ganze Arbeit vor der Anfrage: alles, was wahr sein muss, damit sie erlaubt ist, und das alles deutsch, freigegeben und eingerichtet von jemandem, der nicht Sie sind.
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 Umgebung des Beraters, keine Kopie davon
Was Ihr Produkt bucht, landet in der Umgebung, in der der Steuerberater ohnehin arbeitet, nichts muss hinterher exportiert, erneut hochgeladen oder abgeglichen werden. Darum geht es bei diesem System, und deshalb braucht ein über Maesn gebuchter Beleg keinen zweiten Zustellweg.
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 Schwestersystem innerhalb von DATEV ist eines davon.
Ein Unternehmen-Online-Token, zwei Jahre, eine Firma
DATEV authentifiziert über seine eigene Anmeldung, mit SmartCard oder SmartLogin als Zugangsmedium, und Maesn stellt das Ganze hinter dieselbe Schnittstelle wie jedes andere System. Das Eigene hier ist, womit der Ablauf enden muss: einem langen Zugriffstoken, das zwei Jahre gültig ist und nur für Aufrufe, die die Firma nennen, für die es ausgestellt wurde.
- Langes Zugriffstoken
- Zwei Jahre gültig, an eine Firma gebunden
Ein Account-Key in Ihrem Code. Die zwei DATEV-Zielsysteme und die Firmenbindung bleiben auf unserer Seite.
- Der interaktive Ablauf
- Ihr Kunde meldet sich an, wählt seinen Mandanten aus der Liste, die DATEV zurückgibt, und bestätigt. Die Mandanten-ID wird an der Verbindung gespeichert, nachgelagert muss sie also nichts mittragen. Das ist der Weg, den die Dokumentation zuerst nennt.
- Der manuelle Weg
- Drei Schritte, die Sie selbst steuern: gegen das System mit dem kurzen Token authentifizieren, die Mandantenliste holen, dann erneut gegen das System mit dem langen Token authentifizieren, mit dem gewählten Mandanten. Mehr Arbeit, und mehr Kontrolle über die Oberfläche, die Ihr Kunde sieht.
Die Laufzeit von zwei Jahren ist der nützliche Teil und die Bindung der Haken: Ein langes Token authentifiziert Aufrufe für die Firma, für die es ausgestellt wurde, und für keine andere. Modellieren Sie eine Verbindung je Firma von Anfang an, dann kostet die zweite nichts; modellieren Sie sie je Kunde, ist es eine Migration.
- 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. Einer muss also gewählt werden. An diese Wahl ist das lange Token gebunden, und deshalb sind ein Kunde mit zwei Mandanten zwei Verbindungen und nicht eine mit einem Schalter.
- 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.
Ein Zugangsmedium, das Ihr Kunde in der Hand hält, und ein Token-Austausch in zwei Stufen sind genau die Art von Unterschied, aus der eine Implementierung je System wird. Unified Authentication hält das aus Ihrem Code heraus: Das Zugangsmedium, die Firmenauswahl und die Token-Laufzeit liegen auf unserer Seite, und was Ihr Produkt hält, ist derselbe Account-Key, den es für ein System mit Passwort-Anmeldung hält.
Ein asynchroner Task sagt Ihnen, dass der Beleg angekommen ist
Bei einem System, in das Sie schreiben, statt aus ihm zu lesen, zählt die Frage, ob der gesendete Beleg angekommen ist, und das ist eine Frage über Ihre eigene Anfrage. Jedes schreibbare Objekt hier beantwortet sie gleich, über einen asynchronen Endpunkt, der eine Task-ID zurückgibt.
Nichts. Auf keinem Objekt gibt es hier ein natives Event, und die Stammdaten, die Sie lesen, die Konten, die Wirtschaftsjahre, die Steuersätze und die Nutzer, ändern sich selten genug, dass ein Zeitplan dafür ohnehin das richtige Werkzeug ist.
Der asynchrone Task. Alle vier Objekte, die Sie hier anlegen können, werden über Endpunkte geschrieben, die asynchron laufen, und jeder Aufruf gibt eine taskId zurück, die Sie über GET /asyncTask zurücklesen. Das ist die Bestätigung, die ein Webhook getragen hätte, auf einem Weg, den es heute gibt.
Das ist die Form eines Zustellkanals: Ihnen gehört der Zustand, DATEV gehört das Ziel, und das Einzige, was Sie davon zurückbrauchen, ist die Bestätigung. Behandeln Sie den Task als Teil des Schreibzugriffs statt als Nachgedanken, und die Integration hat gar keine Abfrageschleife.
Ein fehlender Webhook ist normalerweise eine Lücke, die Sie füllen müssen. Hier ist es die falsche Frage, denn der Upload eines Belegs ist ein langlaufender Vorgang, und die Antwort, die Sie brauchen, betrifft Ihre eigene Anfrage und nicht die Änderung eines anderen. Wie asynchrone Arbeit modelliert wird deckt das Task-Objekt ab, den Bezeichner, über den es zurückkommt, und wie eine Teilantwort aussieht, und es ist derselbe Mechanismus auf jedem System mit langlaufenden Schreibzugriffen statt eines DATEV-Sonderfalls.
Was im DATEV Ihres Kunden zutreffen muss
Bei diesem System liegen die Bedingungen im Konto Ihres Kunden und nicht in Ihrem, und die Dokumentation benennt sie genau. Es lohnt sich, sie mit dem ersten Kunden vor dem Sprint durchzugehen statt während ihm.
- Eine DATEV-Instanz mit Wirtschaftsjahr und freigeschaltetem Unternehmen Online
- Das Wirtschaftsjahr muss existieren, und Unternehmen Online muss für diesen Mandanten freigeschaltet sein. Beides sind Einstellungen im DATEV Ihres Kunden und nichts, was ein API-Aufruf anlegen könnte.
- Belege Online in Standard oder Erweitert
- Die DATEV-App Belege Online muss aktiviert sein, und welchen der beiden Modi Sie brauchen, hängt an dem Datenservice, auf dem Ihr Anwendungsfall läuft. Eine Anfrage, die in jeder anderen Hinsicht stimmt, kommt trotzdem abgelehnt zurück, wenn der Modus nicht passt.
- Ein Zugangsmedium, mit mindestens Standardrechten
- Eine SmartCard oder ein SmartLogin für den gesicherten Zugang zum Mandanten, bei einer Person, die mindestens Standardzugriffsrechte für Belege Online hat. Die Rechte werden in der DATEV Rechteverwaltung Online eingestellt, und das ist das Werkzeug des Steuerberaters und nicht Ihres.
- Eine echte Instanz zum Testen
- Die Dokumentation nennt den Test gegen eine echte Produktivumgebung empfohlen und notwendig, bevor Sie die Funktion anbieten, und diese Instanz braucht die Datenservices, die Ihr Anwendungsfall nutzt. Maesn stellt die Sandbox zum Bauen bereit, in diesem Schritt geht es um das letzte Stück vor Ihrem ersten Kunden.
Bringen Sie Ihren Anwendungsfall mit, und wir sagen Ihnen, welche Datenservices und Rechte er braucht.
Welches DATEV-System die Daten hält, die Sie brauchen
DATEV sind drei Zielsysteme und nicht eines. Die Frage, die früh eine Antwort verdient, ist, um welches davon es in Ihrem Anwendungsfall geht.
Was Sie senden, kommt im gemeinsamen Common Data Model an, die Ausgabe, die Sie hier buchen, hat also dieselbe Form wie die Ausgabe, die Sie in ein zehnmal so großes System buchen, und der Code, den Sie einmal schreiben, ist der Code, den Sie woandershin richten.
Unternehmen Online ist der Zustellkanal: Belege und Transaktionen gehen hinein, und der Berater holt sie ab. Gebucht wird nebenan in DATEV Rechnungswesen, wo der Exportdienst Buchungssätze, Salden und offene Posten liest. DATEV betreibt außerdem eine E-Rechnungs-Plattform, ein eigenes Zielsystem, für das es einen eigenen Integrationsleitfaden gibt. Sagen Sie uns, um welche Daten es in Ihrem Anwendungsfall geht, und wir nennen Ihnen das System, in dem sie liegen.
Ein kurzes Gespräch genügt meist, um zu klären, welches der drei DATEV-Systeme Ihr Anwendungsfall braucht.
