Support

Häufig gestellte Fragen

Nur häufig gestellte Fragen mit bestimmten Schlüsselwörtern anzeigen

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ätSupportzeit

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


Weitere Informationen zum Datenservice befinden sich hier.


Rechnungsdatenservice 1.0

Dieser Datenservice ermöglicht es die XML-Dateien im Format DATEV XML-Schnittstelle online (siehe auch Dokumentation > Dateiformate) direkt an das DATEV-Rechenzentrum zu übermitteln. Mit dem Datenservice lassen sich dementsprechend auch die gleichen Usecases realisieren, wie mit der DATEV XML-Schnittstelle online. Hierzu zählt vor allem die Übermittlung von Rechnungs- und Kassendaten für DATEV Unternehmen online (Daten und Belege).

Für den Rechnungsdatenservice 1.0 sind folgende Online APIs umzusetzen:

  • accounting:dxso-jobs: Übertragung der XML-Datei

 Weitere Informationen zum Datenservice befinden sich hier.

Belegbilderservice

Dieser Datenservice ermöglicht die Übermittlung von Belegen direkt an Unternehmen online bzw. Belege online.

Für den Belegbilderservice sind folgende Online APIs umzusetzen:

  • accounting:documents: Übertragung der Belegdateien (PDF, TIFF, PNG, usw.)
  • accounting:clients: Abfrage der Benutzerrechte & Metadaten für Belege online

 Weitere Informationen zum Datenservice befinden sich hier.

Lohnimportdatenservice

Dieser Datenservice ermöglicht ASCII-Importdateien für die DATEV Lohnabrechnungsprogramme (Lohn und Gehalt bzw. LODAS) bereitzustellen..

Für den Lohnimportdatenservice sind folgende Online APIs umzusetzen:

  • hr:files: Übertragung der ASCII-Importdateien

 Weitere Informationen zum Datenservice befinden sich hier.

Lohnauswertungsdatenservice

Dieser Datenservice ermöglicht es, Lohnauswertungen auf sicherem Weg in sein HR-System zu laden.

Für den Lohnauswertungsdatenservice sind folgende Online APIs umzusetzen:

  • hr:payrollreports: Übertragung der Lohnauswertungen

 Weitere Informationen zum Datenservice befinden sich hier.

Desktop APIs

Wo finde ich weitere Informationen zu "DATEVconnect"?

In der ausführlichen Beschreibung zu "DATEVconnect" erhalten Sie sämtliche Informationen die Sie benötigen. 

Wie kann ich DATEVconnect einrichten?

Anhand der detaillierten Beschreibung kann DATEVconnect problemlos eingerichtet werden. 

Wie kann ich die Desktop APIs testen?

Mehrere DATEV Solution Partner bieten Testsysteme mit den benötigten DATEV-Anwendungen an. Diese Test- und Entwicklungsumgebungen sind speziell für die Bedürfnisse von Software-Entwickler konzipiert und stehen online zur Verfügung. So können Sie ohne großen Aufwand Ihre API-Integration mit den stets aktuellen DATEV-Programmversionen testen. Folgende Solution Partner bieten entsprechende Lösungen an:

Dieses Angebot ist aktuell im Aufbau und die Übersicht wird regelmäßig ergänzt.