Support

Erste Schritte

Für wen ist das DATEV Developer Portal geeignet?: Das DATEV Developer Portal ist der zentrale Einstiegspunkt zu allen Schnittstellen der DATEV. Hier finden Sie alle Informationen, die für die Umsetzung einer DATEV-Schnittstelle notwendig sind. Die Inhalte und Features des Portals sind nicht nur für unsere DATEV Mitglieder(Mitglieder? Weitere Informationen zur DATEV eG) zugänglich sondern für jedes Unternehmen mit einem Interesse an DATEV-Schnittstellen.
Wie kann ich mich auf dem DATEV Developer Portal registrieren?: Für den Login wird ein DATEV-Konto benötigt. Die Registrierung kann über den Anmeldedialog vorgenommen werden. Einfach in der Anmeldemaske "Noch kein DATEV-Konto? Zur Registrierung" auswählen.

Allgemein

Wie kann ich weitere Mitarbeiter zu meiner Enterprise Organisation hinzufügen?

Als Admin einer Enterprise Organisation ist es möglich weitere Nutzer über "Organisation" -> "Gewählte Enterprise Organisation" hinzuzufügen.

Voraussetzung: Der einzuladende Nutzer muss sich zuvor mindestens einmal im DATEV Developer Portal erfolgreich eingeloggt haben. Anschließend kann die E-Mail Adresse, die dem Medium hinterlegt ist, zur Organisation hinzugefügt werden.

Bitte beachten Sie, dass maximal 20 Nutzer einer Organisation hinzugefügt werden können.

Wie finde ich den Eigentümer meiner Enterprise Organisation heraus?

In der Benutzerverwaltung (siehe oben rechts, unter dem Organisation, Menüpunkt "Gewählte Enterprise Organisation") werden alle Benutzer der ausgewählten Organisation aufgelistet. Sowohl der Eigner als auch die Nutzer mit der Rolle Administrator können weitere Nutzer einladen.

Was ist der DATEV Marktplatz?

Auf dem DATEV Marktplatz werden die Lösungen der DATEV-Marktplatz Premium Partner und DATEV-Marktplatz Schnittstellen Partner dargestellt, die das DATEV-Produktportfolio ergänzen.

Weitere Informationen zum DATEV-Marktplatz und zu Partnerschaften mit DATEV befinden sich hier.

Was bedeuten die verschiedenen Stufen der Servicequalität?

Servicequalität	Supportzeit
PLATIN GOLD	7 Tage, 0-24 Uhr
SILBER BRONZE	Mo. bis Fr., 6-20 Uhr, ohne Feiertage

Servicequalität

Supportzeit

PLATIN

GOLD

7 Tage,

0-24 Uhr

SILBER

BRONZE

Mo. bis Fr.,

6-20 Uhr,

ohne Feiertage

< BRONZE Die Servicequalität „unterhalb Bronze“ beschreibt eine in Bezug zu den anderen Servicequalitäten nach unten abweichende Supportzeit.

Für eine interne weitergehende Abstufung erfolgt trotz identischer Supportzeiten noch eine weitere Unterteilung.

Online APIs

Wie kann ich die Online APIs nutzen?

Für die Nutzung der Online APIs wird ein API Client benötigt. Diesen bekommt man im Rahmen der App Erstellung.
Voraussetzung für die Erstellung einer App ist die Mitgliedschaft mit entsprechenden Rechten in einer Enterprise Organisation.

Eine App kann dann in der App Übersicht erstellt werden. Dafür unter "Organisation" auf "Apps verwalten" gehen und den Prozess mit "neue App erstellen" anstoßen.

Wie erfolgt die Kommunikation mit dem DATEV-Rechenzentrum?

DATEV hat für die Kommunikation mit dem DATEV-Rechenzentrum die Webstandards OAuth 2.0 und OpenID Connect für die Online APIs implementiert.

Für den Datenaustausch sind im wesentlichen zwei Komponenten erforderlich:

1. Ein API Client bzw. eine Client App

2. Eine DATEV-Identität (Person) mit einem DATEV-Loginmedium (SmartCard/SmartLogin)

DATEVconnect online

Der API Client ist die Identifizierung der Client App gegenüber dem DATEV Rechenzentrum. Jeder API Client bekommt eine eigene Client-ID und ein Client-Secret. Mit diesen Daten authentifiziert sich die Client App.

Wichtiger Hinweis: Solche API Clients werden derzeit nur im Rahmen einer Partnerschaft mit DATEV vergeben. Im Laufe des 2. Halbjahres in 2021 möchten wir unsere Webservices allen Interessenten zugänglich machen. API Clients können dann direkt über das Developer Portal selbst registriert werden. Sobald wir unsere Online APIs veröffentlichen können, werden wir über den Blog informieren. Interessenten sollten also jetzt schon die Möglichkeit nutzen und im Blog das #Online API abonnieren.

In einem weiteren Schritt muss eine DATEV-Identität mit einem DATEV-Authentifizierungsmedium (SmartCard/SmartLogin) der Client App den Zugriff auf die Webservices im DATEV-Rechenzentrum erlauben. Wenn der Benutzer die Berechtigung erteilt, erhält die Client App ein Token für die Kommunikation mit dem DATEV-Rechenzentrum.

Was bedeutet Online API abonnieren?

Nach erfolgreicher Erstellung einer App (API Client) müssen noch die gewünschten Online APIs abonniert werden. Durch den Klick auf "Abonnieren" werden der App die jeweiligen APIs zugeteilt und dadurch können sie von der App verwendet werden.

Online APIs, DATEV-Datenservices, DATEVconnect online?

Unsere Online APIs können grundsätzlich in zwei Typen von APIs unterteilt werden:

1. DATEV-Datenservices ist der Begriff für unsere APIs im DATEV-Rechenzentrum mit einer Benutzerauthentifizierung. Die Authentifizierung & Autorisierung wird über die Webstandards OAuth 2.0 & OpenID Connect abgewickelt. Es lassen sich die verschiedensten Datenservices der DATEV nutzen. Jeder einzelne Datenservice kann aus ein oder mehreren APIs bestehen. Manche APIs werden von vielen Datenservices genutzt. Diese Ebene der APIs ist hier im Developer Portal im Bereich Dokumentation > Online APIs abgebildet. Welche Datenservices welche Online APIs nutzen, wird ebenfalls hier in den FAQs erläutert.

DATEVconnect online ist der ursprüngliche Obergriff. Im Mai 2021 erfolgte die Umbenennung in DATEV-Datenservices

OA-DCO-DS

2. APIs im DATEV-Rechenzentrum ohne Benutzerauthentifizierung. Diese APIs ermöglichen den Zugriff auf nicht vertrauliche Daten (weder personen- noch unternehmensbezogen). Dies kann bspw. der Zugriff auf Wissensdatenbanken sein. Derzeit gibt es noch keine veröffentliche API von diesem Typ im Developer Portal.

Buchungsdatenservice

Dieser Datenservice ermöglicht es die CSV-Dateien im DATEV-Format (siehe auch Dokumentation > Dateiformate) direkt an das DATEV-Rechenzentrum zu übermitteln. Da hier als Datenbasis das bekannte DATEV-Format dient, können umfangreiche Bewegungs- und Stammdaten für DATEV Rechnungswesen übermittelt werden. Neben den CSV-Dateien können hier auch direkt dazugehörige Belege an das DATEV-Rechenzentrum übermittelt werden. So ist sichergestellt, dass bspw. Rechnungsbuchungen auch direkt mit einem Beleglink ausgestattet sind.

Für den Buchungsdatenservice sind folgende Online APIs umzusetzen:

accounting:extf-files: Übertragung der CSV-Datei
accounting:documents: Übertragung der Belegbilder
accounting:clients: Abfrage der Benutzerrechte & Metadaten für Rechnungswesen