Support

Frequently Asked Questions

Only show frequently asked questions containing specific keywords

First Steps

For whom is the Developer Portal intended?

Our Developer Portal is for all companies that want to develop an interface to DATEV software (whether coding or designing). The content and features of the portal are therefore not only accessible for our DATEV members (members?! More information here).

How can I register on the portal?

The registration on the portal takes place automatically with the first login. A DATEV login medium (SmartCard/SmartLogin/Benutzerkonto) is required for the login. If you already own such a medium, you can directly log in from the start page.

No DATEV login medium yet? Then you can order a medium directly via the start page (see button "Order DATEV Benutzerkonto"). Please note that this is associated with a processing time of up to 3 days.

Login problems?

1. You cannot log in with the desired DATEV login medium?

Here it helps to empty the browser cache and/or to explicitly define the login medium here.

2. You receive the following error message when logging in?

"Die E-Mail-Adresse <your e-mail address> wird bereits verwendet. Die Anmeldung über DATEV konnte aufgrund eines Fehlers nicht abgeschlossen werden."

In principle, it is possible to log in using different DATEV login media with identical e-mail addresses. There are problems if you have different DATEV login media with identical e-mail addresses on different Beraternummern (customer number from DATEV). The registration of a user at the Developer Portal is automatically done with the first login. If, after the first registration, you try to log in with a different medium using the same e-mail address but a different Beraternummer, this error occurs.

Remedy: Either you use the medium from the first registration or you write to developerportal@datev.de with subject "New registration for <your e-mail address>".  We will then delete your first registration and as soon as you receive a reply from us, you can re-register/login with the desired medium.

You have another error/problem constellation? Just write us: developerportal@datev.de

General

How can I add more people to my developer organization?

The admin of the organization can add further users via the "User administration" (see top right corner > at the user name > menu item "My organization").

Precondition: The new user must already have registered on the Developer Portal (registration takes place automatically when logging in for the first time). This user can then be added to the organization using his e-mail address.

Please note that a maximum of 20 users can be added to an organization.

How do I find out the admin of my developer organization? Can the admin be changed?

Via the user administration (see top right, at the user name, menu item "My Organization") all users of the organization are listed. The admin has the role "Organization Owner". The admin role cannot currently be changed by the user. The admin of the organisation can request a change by e-mail: developerportal@datev.de.

Online APIs

How can I use the Online APIs?

An API client is required to use the Online APIs. These API clients are currently only provided as part of a partnership with DATEV. More information on this can be found here.


During the 2nd half of the year in 2021, we would like to make our web services available to all interested parties. API clients can then be registered directly through the Developer Portal. As soon as we can publish our Online APIs, we will inform via the blog. Interested parties should already take the opportunity and subscribe to the Blog the #Online API.

How does communication with the DATEV data center work?

DATEV has implemented the web standards OAuth 2.0 and OpenID Connect for communication with the DATEV data center.

Two main components are required for data exchange:

1. An API client (Client app)

2. An DATEV identity (person) with a DATEV login medium (SmartCard/SmartLogin)


DATEVconnect online


The API Client is the identification of the client app to the DATEV data center. Each API client receives its own client ID and a client secret. With this data, the client app authenticates itself to the DATEV data center.

Important note: Such API clients are currently only assigned as part of a partnership with DATEV. During the 2nd half of the year in 2021, we would like to make our web services available to all interested parties. API Clients can then be registered directly via the Developer Portal itself. As soon as we can publish our online APIs, we will inform via the blog. So interested parties should take the opportunity now and subscribe to the #Online API on the blog.

In a further step, a DATEV identity with a DATEV authentication medium (SmartCard/SmartLogin) must allow the client app to access the web services in the DATEV data center. When the user grants authorization, the client app receives a token for communicating with the DATEV data center.

What does subscription mean?

***Note: This feature is not available yet***

After successful registration of a new app you have to subscribe your whised Online APIs. Within the click on "Subscribe" the scopes of the API will be enabled for your app.

Online APIs, DATEVconnect online, Datenservices?

Our online APIs can basically be divided into two types:


1. DATEVconnect onlineis the term for our APIs in the DATEV data center with a user authentication. Authentication & authorization is handled via the web standards OAuth 2.0 & OpenID Connect. With DATEVconnect online, a wide variety of DATEV data services can be used. Each individual data service can consist of one or more APIs. Some APIs are used by many data services. This level of APIs is published here in the Developer Portal in section Documentation > Online APIs. Which data services use which online APIs is also explained here in the FAQs.


OA-DCO-DS


2. APIs in the DATEV data center without user authentication. These APIs allow access to non-confidential data (neither personal nor company-related). This can be, for example, access to knowledge databases. Currently there is no published API of this type in the Developer Portal.

DATEVconnect online: Buchungsdatenservice

This data service makes it possible to transmit the CSV files in DATEV-Format (see also documentation > file interfaces) directly to the DATEV data center. Since the familiar DATEV-Format serves as the data basis here, extensive transaction and master data for DATEV Rechnungswesen can be transmitted. In addition to the CSV files, associated documents can also be transmitted directly to the DATEV data center. This ensures that, for example, invoice dataset are also directly linked with the documents.

For the Buchungsdatenservice, the following online APIs are to be implemented:

  • accounting:extf-files: transfer of CSV file
  • accounting:documents: transfer of the document/images
  • accounting:clients: query user rights & metadata for accounting

More information about the data service is here.


DATEVconnect online: Rechnungsdatenservice 1.0

This data service enables the XML files in the format DATEV XML-Schnittstelle online (see also documentation > file interfaces) to be transmitted directly to the DATEV data center. Accordingly, the same use cases can be realized with the data service as with the DATEV XML-Schnittstelle online. This includes, above all, the transmission of invoice and cash data for DATEV Unternehmen online (data and documents).

For the Rechnungsdatenservice 1.0, the following online APIs are to be implemented:

  • accounting:dxso-jobs: transfer of XML file
  • accounting:clients: query user rights & metadata for companies online

More information about the data service is here.

DATEVconnect online: Belegbilderservice

This data service enables the transmission of documents directly to DATEV Unternehmen online or Belege online.

The following online APIs are to be implemented for the Belegbilderservice:

  • accounting:documents: transfer of documents (PDF, TIFF, PNG, etc.)
  • accounting:clients: query user rights & metadata for Belege online

More information about the data service is here.

Desktop APIs

Where can I find further information regarding "DATEVconnect"?

More Information about DATEVconnect can be found here.

How can I set up DATEVconnect?

DATEVconnect can be set up using the detailed description.

How can I test the Desktop APIs?

The desktop APIs can be tested in two ways:

  • Own DATEV software installed on a PC/server or cooperation with a customer who has installed the DATEV software (recommended)
  • Desktop Sandbox: DATEV provides three virtual machines via the Developer Portal for first tests of the desktop APIs. The access data can be generated via Organization > My Organization > "Desktop Sandbox". Detailed login instructions can be found there as well.

  • Please note:
    • The login data is reseted every 90 days. After the reset, new login data can be easily requested.
    • There are only three virtual machines available in total. If all three machines are in use, you should try again at a later time.