maesn

DATEV-Schnittstelle und API-Integration

DATEV ist eine Familie aus Systemen und Webservices, von DATEV Unternehmen Online bis DATEV Rechnungswesen, jedes mit eigenem Datenformat und eigenem Freigabeweg. Maesn ist offizieller DATEV Schnittstellenanbieter und deckt sie alle über eine REST API ab. Eine freigegebene DATEV-Integration dauert damit Tage statt Monate.

Offizieller DATEV Schnittstellenanbieter
Offizieller
DATEV Schnittstellenanbieter
IHR PRODUKT+28
Diese Software-Teams vertrauen uns
HubSpotTipaltiPaywiseRallyQredNordhealthFindityFintoClockinHEROHolviLanes & PlanesAgicapHubSpotTipaltiPaywiseRallyQredNordhealthFindityFintoClockinHEROHolviLanes & PlanesAgicap
DATEV anbinden, neu gedacht

Die ganze DATEV-Komplexität liegt bei Maesn

Eine direkte DATEV-Integration wird dreimal gesperrt, bevor der erste Aufruf gelingt, und jede Sperre hält jemand anderes als Sie. Über Maesn sind alle drei bereits offen.

DATEV: Kein CSV/XML und keine DATEV-Formate

Eine REST API für DATEV

Jeder Datenservice darunter spricht sein eigenes Format. Maesn wandelt sie um, Sie senden und lesen also JSON auf denselben Endpunkten, die Sie für jedes andere System benutzen.

DATEV: Kein langes, teures Partner-Onboarding

Morgen starten und mit uns offizieller DATEV Schnittstellenanbieter werden

Client-Zugangsdaten, Sandbox-Zugang und die Freigabe Ihrer Integration durch DATEV werden über Maesn eingerichtet. Konzentrieren Sie sich darauf, eine Integration zu Maesn zu entwickeln, den Rest übernehmen wir.

DATEV: Keine Entwicklerkonten bereitzustellen

Kostenlose Sandboxes für DATEV

Eine sofort nutzbare Testumgebung für Unternehmen Online und für Rechnungswesen. Der Bau beginnt also am ersten Tag und nicht nach dem Ende eines DATEV-Verfahrens.

Für Ihr Team bleibt der Teil, der ihm gehören sollte: zu entscheiden, welche Daten sich wann bewegen.

Bringen Sie Ihren Anwendungsfall mit, und wir sagen Ihnen, welche DATEV-Services er braucht.

DATEV-Logik auf einen Blick

Die zwei Wege, mit DATEV zu arbeiten

Kleine Unternehmen geben die Buchhaltung meist an ihren Steuerberater, größere erledigen sie selbst. Wie sie es tun, entscheidet darüber, welches Produkt im Einsatz ist.

Buchhaltung beim Steuerberater

Die meisten kleinen und mittleren Unternehmen

Das Unternehmen arbeitet in Unternehmen Online, und eine Integration erreicht trotzdem Rechnungswesen

  1. 1

    Der Datensatz entsteht in Ihrem Produkt

    Rechnung, Eingangsrechnung oder Ausgabe entstehen dort, wo das Unternehmen ohnehin arbeitet.

  2. 2

    DATEV Unternehmen Online nimmt ihn an

    Die Plattform, die sich beide Seiten teilen. Sie ist der Austauschpunkt zwischen Unternehmen und Steuerberater und nicht der Ort, an dem gebucht wird.

  3. 3

    Der Steuerberater bucht ihn in Rechnungswesen

    Der Berater prüft und ergänzt die Datensätze und bucht sie. Das Unternehmen öffnet Rechnungswesen nie selbst, und das hindert eine Integration nicht daran, direkt in die Instanz des Beraters zu schreiben, ausgewiesen über die Berater- und Mandantennummer.

Buchhaltung im Unternehmen

Selbstbucher, meist mit eigener Finanzabteilung

Das Unternehmen arbeitet selbst in Rechnungswesen, mit Unternehmen Online davor

  1. 1

    Der Datensatz entsteht in Ihrem Produkt

    Derselbe Ausgangspunkt. An Ihrer Integration ändert die Konstellation nichts.

  2. 2

    DATEV Rechnungswesen bucht ihn

    Die Finanzabteilung bucht die Sätze im Haus. Buchungssätze und Kontakte lassen sich direkt hineinschreiben.

  3. 3

    Unternehmen Online sitzt davor

    Selbstbucher betreiben es ebenfalls, als Cloud-Plattform, über die sie ihre eigene Rechnungswesen-Instanz erreichen, und nicht als Weg zu einem Berater.

So oder so ist es dieselbe Integration. Sie schreiben über eine API nach DATEV, und ob der Steuerberater oder das Unternehmen den Buchungssatz einstellt, ist eine Einstellung auf deren Seite und kein Zweig in Ihrem Code.

DATEV Rechnungswesen ist die vollständige Suite. Es gibt sie als Variante, die ein Unternehmen selbst betreibt, und als Variante, die der Steuerberater betreibt, und in beiden Fällen ist es dasselbe Produkt: das, das jeden einzelnen steuerlichen und finanziellen Vorgang in der Form abbilden soll, die der deutsche Gesetzgeber erwartet. DATEV Unternehmen Online ist etwas anderes. Es ist in erster Linie die Cloud-Plattform für den Datenaustausch mit Rechnungswesen.

Deshalb hat ein Unternehmen, das seine Buchhaltung nicht selbst macht, Unternehmen Online und sonst nichts und tauscht Daten mit dem Berater aus, der in Rechnungswesen arbeitet, und deshalb hat ein Unternehmen, das selbst bucht, trotzdem Unternehmen Online, als Cloud-Weg zur eigenen Rechnungswesen-Instanz. In keinem der beiden Fälle hindert Sie etwas daran, direkt an Rechnungswesen anzubinden. Auch wo nur Unternehmen Online im Einsatz ist, erreicht eine Integration die Rechnungswesen-Instanz, die beim Steuerberater des Kunden läuft, ausgewiesen über Berater- und Mandantennummer.

Die Trennung zeigt sich daran, was beide annehmen. Buchungsvorschläge, Ausgaben, Transaktionen gehören zu Unternehmen Online, Kontakte, Buchungssätze zu Rechnungswesen, und Dateien ist das einzige Objekt, das beide annehmen.

Die Landschaft

Vier DATEV-Datenservices, eine Schnittstelle

Jeder DATEV-Service trägt seine eigene Nutzlast und zeigt auf eines der beiden Systeme. Maesn liegt über allen, Ihre Anwendung spricht also mit einer API statt mit vieren.

Ihre Schicht
Ihre Anwendung
SaaS-Plattform · ERP · FinTech
REST API · JSON
maesnUnified API

Eine Schnittstelle für die ganze DATEV-Landschaft, wir übersetzen zwischen Ihrer Anwendung und jedem DATEV-Datenservice.

alles vereinheitlicht in maesn
DATEV-Systemlandschaft4 Datenservices heute · 1 geplant
↓ Schreiben

Belegbilderservice

Belegbilder

Rechnungen, Eingangsrechnungen und Gutschriften als Belegbilder hochladen.

↓ Schreiben

Rechnungsdatenservice 1.0

Buchungsvorschläge

Rechnungen, Eingangsrechnungen und Gutschriften als strukturierte Buchungsvorschläge senden.

Geplant

Datenservice Kassenarchiv

Kassendaten

Kassendaten. Geplant, heute nicht verfügbar.

ZielsystemDATEV Unternehmen OnlineWo ein Unternehmen Belege an seinen Steuerberater übergibtZur Integration
↓ Schreiben

Buchungsdatenservice

BuchungssätzeBelegbilder

Abgestimmte Buchungssätze in das Buchhaltungssystem senden.

↑ Lesen

Datenservice Export Rechnungswesen

BuchungssätzeKontenrahmenZahlungsbedingungenSummen- und SaldenlistenWirtschaftsjahreOffene Posten

Buchungssätze, den Kontenrahmen, Zahlungsbedingungen, Wirtschaftsjahre und eine Summen- und Saldenliste aus DATEV abrufen.

ZielsystemDATEV RechnungswesenWo die Buchung endgültig erfasst wirdZur Integration

Alle Services liegen unter unserer Unified API.

Der Belegbilderservice stellt Belegbilder (PDF, JPG) nach DATEV Unternehmen Online ein und ermöglicht die Bereitstellung an DATEV Rechnungswesen. Er wird meist mit dem Buchungsdatenservice kombiniert, der die Buchungssätze einstellt, zu denen die Belege gehören, und selbst kein Bild trägt.

Der Rechnungsdatenservice 1.0 nimmt den Beleg zusammen mit seinen strukturierten Daten in einem Aufruf entgegen, der Berater bekommt also einen Buchungsvorschlag statt eines Scans zum Abtippen. Deshalb braucht er den Belegbilderservice nicht daneben. Der Buchungsdatenservice schreibt abgestimmte Buchungssätze direkt nach Rechnungswesen, und er ist der eine Weg, der den Prüfschritt überspringt. Der Datenservice Export Rechnungswesen ist der einzige, der liest.

Ein fünfter, der Datenservice Kassenarchiv für Kassendaten, ist geplant und heute nicht verfügbar, ohne Datum. DATEV betreibt außerdem eine E-Rechnungs-Plattform, die hier noch kein eigenes Zielsystem hat, behandelt in unserem Leitfaden zur DATEV E-Rechnungsplattform, und welchem der beiden Systeme hinter den Services ein Anwendungsfall gehört, beantwortet der Vergleich von Unternehmen Online und Rechnungswesen.

Datenabruf

Daten aus Rechnungswesen holen

Daten aus DATEV zu holen ist aufwendig. Wir haben die tiefen Integrationen dafür gebaut.

Buchungssätze
Alle Buchungssätze mit ihren zugehörigen Daten aus DATEV holen.
Kontenrahmen
Die Kontenstruktur holen, gegen die jede Buchung läuft.
Summen- und Saldenlisten
Die Summen- und Saldenlisten aus DATEV holen.

Wir haben den DATEV Datenservice Export Rechnungswesen in unserer Unified API umgesetzt, Sie holen die Daten also bequem über REST. Damit können Sie die zwei Fragen stellen, auf die es ankommt: was gebucht wurde und was noch offen ist. Die Antwort kommt aus der führenden Quelle und nicht aus einer Kopie. Sie kommt normalisiert an, über unser Common Data Model, sie hat also dieselbe Form wie bei jedem anderen System. Große Ergebnismengen paginieren und filtern nach denselben Regeln wie überall sonst. Unser Leitfaden zum Export-Service geht einen vollständigen Abruf durch.

Eine Viertelstunde genügt, um eine echte Summen- und Saldenliste aus einer DATEV-Instanz kommen zu sehen.

Beleg

Rally hat seine DATEV-Integration in Tagen gestartet

Rally ist eine Finanzplattform für Unternehmen mit Fahrzeugflotten, und DATEV lag auf dem kritischen Pfad zu ihrem Start in Deutschland.

“Maesn hat unsere Art, DATEV anzubinden, komplett verändert. Was ein langer, komplexer Prozess geworden wäre, war dank REST API, DATEV-Sandbox und Freigabeverfahren ein reibungsloser, nachvollziehbarer Ablauf.”
Thiago Peres
CTO, Rally
Warum Unternehmen sich für Maesn entscheiden

Drei Gründe, die DATEV-API über Maesn zu erreichen

Drei Gründe, warum Teams ihre DATEV-Integration über Maesn führen, statt sie direkt zu bauen.

01

Heute live gehen

Das mehrstufige Freigabeverfahren für DATEV-Schnittstellen ist der häufigste Grund, warum Integrationen sich verzögern. Maesn ist offizieller DATEV Schnittstellenanbieter. Wir begleiten Ihre Integration also unter Ihrem eigenen Namen durch das Verfahren.

02

Nur REST API, einfache Authentifizierung

CSV- und XML-Dateien, DATEV-Formate und asynchrone Endpunkte erzeugen Reibung. Wir haben das alles in unserem gemeinsamen Datenmodell vereinheitlicht. Sie arbeiten also mit einer REST-Schnittstelle.

03

Tiefe DATEV-Expertise

Wir wissen, wie DATEV wirklich arbeitet. Ohne gute Führung werden Einrichtungen schnell kompliziert, besonders wenn der Steuerberater des Unternehmens beteiligt ist. Wir begleiten Sie und Ihre Kunden bei jedem Schritt.

Marketplace und Partnerschaft

In den DATEV Marktplatz unter eigenem Namen

Ein Eintrag im DATEV Marketplace stellt Ihre Software dorthin, wo Steuerberater nach ihr suchen, unter Ihrem eigenen Namen und Ihrem eigenen Logo. Eine über Maesn gebaute Integration zählt für die Qualifizierung genau wie eine direkte.

Offizieller DATEV Schnittstellenanbieter
Offizieller
DATEV Schnittstellenanbieter
Was DATEV verlangt
Stufe 1

Mehr als 25 aktive Verbindungen

Der Eintrag folgt der Nachfrage. Er kommt also, nachdem Ihre ersten Kunden live sind. Verbindungen, die über Maesn laufen, zählen genauso wie direkte.

Stufe 2

Kundeninterviews

DATEV spricht mit den Unternehmen, die Ihre Integration nutzen. Dieses Gespräch lässt sich erst führen, wenn echte Nutzer darauf angewiesen sind.

Stufe 3

Eine strategische Passung mit DATEV

Eine Bewertung durch das DATEV-Partnerteam dazu, was Ihre Software deren Kunden bringt. Maesn führt Sie durch die Qualifizierung, statt Ihnen ein Formular zu geben.

Keine der drei lässt sich vorab kaufen. Alle drei beschreiben ein Produkt, das bereits im Einsatz ist, und das macht den Eintrag zu einem Meilenstein statt zu einer Startaufgabe.

Authentifizierung

DATEV SmartCard und SmartLogin

DATEV bietet mehr als einen Weg, wie ein Nutzer sich authentifiziert. Alle werden von Maesn unterstützt und sind in Unified Authentication eingebettet, einschließlich der Unterstützung mehrerer Firmen.

Auth-Verfahren
SmartCard
Hardwarebasierte DATEV-Anmeldung
SmartLogin
Die app-basierte DATEV-Anmeldung

Ein Account-Key, welches Verfahren Ihr Kunde auch nutzt

Die zwei DATEV-Zielsysteme
datev-uo
DATEV Unternehmen Online.
datev-rewe
DATEV Rechnungswesen.

Maesn bettet die vollständige DATEV-Anmeldung ein. Es gibt also keine zweite Implementierung zu pflegen, wenn DATEV auf seiner Seite etwas ändert.

Der interaktive Ablauf, dieselben drei Schritte für beide
  1. 1

    Den Nutzer in den Ablauf schicken

    Rufen Sie /auth für das Zielsystem mit environmentSelection=true auf. Die DATEV-Anmeldung öffnet sich, mit SmartCard oder SmartLogin, wie der Kunde es bevorzugt.

  2. 2

    Die Firma wird gewählt

    Der Kunde wählt den DATEV-Mandanten, der angebunden wird. Die ID wird für Sie verwahrt, sie muss also nicht bei jeder späteren Anfrage mitlaufen.

  3. 3

    Sie erhalten den Account-Key

    Ein Schlüssel, in derselben Form wie bei jedem anderen System auf der Plattform. Keine DATEV-eigene Verzweigung in Ihrem Code.

Welches Verfahren Ihr Kunde auch nutzt, am Ende steht ein Account-Key und kein DATEV-eigener Zweig in Ihrem Code, denn der ganze Login liegt hinter dem Ablauf der Unified Authentication.

Bevor Sie anfangen

Was der Steuerberater in DATEV freischaltet

Ein Teil einer DATEV-Integration gehört nie uns und nie Ihnen. Ihn früh zu kennen spart die Woche, die sonst ins Raten geht.

Der Steuerberater bucht die Datenservices
DATEV-Webservices werden vom Steuerberater des Kunden in dessen eigener DATEV-Instanz bestellt und freigeschaltet, und er bleibt dafür verantwortlich. Es gibt keine API, die sie von außen einschaltet.
Berechtigung zur Authentifizierung
Die Person mit dem Zugangsmedium braucht mindestens Standardzugriffsrechte für die App. Die Rechte werden über die DATEV Rechteverwaltung Online eingestellt, ein eigenes Werkzeug mit sehr vielen Einstellungen.
Wo wir ins Spiel kommen
Für jeden Anwendungsfall benennen wir genau die Datenservices und Rechte, die vorliegen müssen, und wir gehen mit in das Gespräch mit Ihrem Kunden, wenn eine Einrichtung sich trotzdem nicht so verhält, wie sie soll.

Wir gehen die Services und Rechte mit Ihnen durch, und mit Ihrem Kunden, wo es hilft.

DATEV-FAQ

DATEV-API-Fragen

Was ist der Unterschied zwischen DATEV Unternehmen Online und DATEV Rechnungswesen?

DATEV Unternehmen Online ist die Cloud-Plattform, über die ein Unternehmen Rechnungen, Eingangsrechnungen und Belege mit seinem Steuerberater teilt. DATEV Rechnungswesen ist das Buchhaltungssystem, in dem der Steuerberater oder ein Unternehmen mit eigener Buchhaltung diese Daten tatsächlich bucht. Unternehmen Online sitzt vor Rechnungswesen und nicht daneben: Es ist eine Zwischenstation, und die meisten Daten erreichen Rechnungswesen, indem sie hindurchlaufen. Maesn deckt beide über eine Schnittstelle ab.

Kann ich Daten aus DATEV lesen, oder nur hineinschreiben?

Beides. Das Schreiben läuft über den Buchungsdatenservice nach Rechnungswesen und über den Belegbilderservice und den Rechnungsdatenservice nach Unternehmen Online. Das Lesen läuft über den DATEV Datenservice Export Rechnungswesen, den Maesn als eigenen Leseweg bereitstellt und der Buchungssätze mit ihren zugehörigen Daten, Salden, Wirtschaftsjahre und offene Posten zurückgibt. Alles kommt in demselben gemeinsamen Datenmodell an wie bei jedem anderen System auf der Plattform.

Werde ich selbst DATEV Schnittstellenanbieter?

Nur wenn Sie wollen. Sie können auf dem Maesn-Client starten, dort erben Sie unseren Status als offizieller DATEV Schnittstellenanbieter. Die Client-Zugangsdaten, der Sandbox-Zugang und die Freigabe Ihrer Integration liegen also bereits vor, und vorher muss nichts beantragt werden. Selbst unter eigenem Namen Schnittstellenanbieter zu werden, ist ein Verfahren, das wir mit Ihnen führen, ohne Beratungspakete, die bei DATEV zu buchen wären, aber mit den eigenen Gebühren von DATEV auf Ihrer Seite. Ein Eintrag im DATEV Marktplatz ist ein weiterer Schritt mit eigenen Bedingungen.

Wie bekomme ich eine DATEV-Sandbox für die Entwicklung?

Über Maesn, für beide Systeme. Jeder Kunde bekommt eine sofort nutzbare Testumgebung für DATEV Unternehmen Online und für DATEV Rechnungswesen. Der Bau wartet also nicht darauf, dass zuerst ein DATEV-Verfahren fertig wird.

Welche DATEV-Authentifizierungsverfahren werden unterstützt?

Die, die DATEV anbietet, darunter SmartCard und SmartLogin. Maesn bettet die vollständige DATEV-Anmeldung hinter dieselbe vereinheitlichte Authentifizierungsschnittstelle ein, die für jedes andere System benutzt wird, auf Ihrer Seite gibt es also keine DATEV-eigene Umsetzung. Beide DATEV-Zielsysteme laufen über den interaktiven Authentifizierungsablauf.

Wer schaltet die DATEV-Datenservices für einen Kunden frei?

Der Steuerberater des Kunden, in dessen eigener DATEV-Instanz. Er bestellt und aktiviert die Datenservices und stellt die Zugriffsrechte in der DATEV Rechteverwaltung Online ein. Maesn sagt Ihnen genau, welche Einstellungen ein Anwendungsfall braucht, und geht mit in das Gespräch mit Ihrem Kunden, wenn etwas nicht zusammenpasst.

Welche DATEV-Schnittstellen gibt es, und welche davon deckt Maesn ab?

DATEV stellt seine Daten über benannte Datenservices bereit statt über eine API, und Maesn deckt sie über seine zwei DATEV-Zielsysteme ab. Nach DATEV Unternehmen Online: der Belegbilderservice für Belegbilder und der Rechnungsdatenservice 1.0 für Rechnungsdaten. Nach DATEV Rechnungswesen: der Buchungsdatenservice für Buchungssätze. Aus Rechnungswesen heraus: der Datenservice Export Rechnungswesen, der Buchungssätze mit ihren zugehörigen Daten, Salden, Wirtschaftsjahre und offene Posten zurückgibt. Das sind vier Datenservices im Produktivbetrieb, drei schreibend und einer lesend. Der Datenservice Kassenarchiv für Kassendaten ist geplant und heute nicht verfügbar.

Wie funktioniert eine DATEV-Schnittstelle in der Praxis?

Drei Beteiligte, nicht zwei. Ihre Anwendung spricht mit einem Maesn-Endpunkt im gemeinsamen Datenmodell. Maesn übersetzt das in den jeweiligen DATEV-Datenservice und erledigt die DATEV-Anmeldung, einschließlich SmartCard und SmartLogin, dazu die Bindung an den richtigen Mandanten. Auf der DATEV-Seite muss der Steuerberater des Kunden zuerst den Datenservice bestellen und die Rechte in der DATEV Rechteverwaltung Online erteilen, und dieser Schritt entscheidet, ob ein Anwendungsfall überhaupt möglich ist. Was Sie nie bauen, ist der DATEV-eigene Teil: Die Authentifizierungsfläche deckt beide DATEV-Zielsysteme ab, und sie kommen über dieselbe Schnittstelle wie jedes andere System auf der Plattform.
Jede Integration, nach der Ihre Kunden fragen. In Tagen, nicht in Monaten.