Interface requirements Lohnaustauschdatenservice (eAU)

The online API for the electronic certificate of incapacity for work enables electronic certificates of incapacity for work to be requested from an employee's health insurance fund. The (regular) API workflow is shown below and which online APIs & endpoints must/should be used in connection with the data service. 

 

API WORKFLOW

  1. Check the authorizations for the data service
  2. Transmission of individual requests - manual (by click via 3rd party app) or automated (rule-based)
MUST: Transmitted requests (POST) and read API requests (GET) should be in a healthy ratio. Producing another 30 GET requests for a successfully submitted request is not a sign of efficient integration.

ONLINE API & ENDPOINTS for SANDBOX

(Base URL: https://api-name.api.datev.de/platform-sandbox/)

Check authorizations

GET https://eau.api.../clients/{client-id}

The databases to which the customer has the necessary authorizations can be queried here. The 3rd party app must use this endpoint. The customer must be given an input option in the 3rd party app for the consultant and client number.

MUST: The endpoint must be used. Here it must be shown where the client makes their entries for the dataset. Then show the call to the endpoint with a success message. An error must also be reproduced by using a consultant and client number for which the customer has no authorization. A corresponding error message must be displayed on the interface.



Challenges:

  • Consultant enters a correct consultant and client number and shows the success message
  • Consultant enters an invalid consultant and client number and shows an error message


 

Transmission of eAU requests

POST https://eau.api.../clients/{consultantNumber}-{clientNumber}{personalNumber}/eau-request

Use this endpoint to transmit the request to the DATEV datacenter / health insurance company. You will receive a uuid back, which you can continue working with in the next step.

MUST: Show a successful request to the DATEV datacenter / health insurance company.


Important note: In the sandbox, you will only receive mockup data.

Query health insurance feedback
GET https://eau-api.../clients/{consultantNumber}-{clientNumber}{personalNumber}/eau-requests/feedbacks
MUST: Display the submitted data on the interface
Withdraw eAU request
DELETE https://eau-api.../clients/{consultantNumber}-{clientNumber}{personalNumber}/eau-requests/

This request can be used to delete previously sent eAU requests.

SHOULD: Show a successful deletion of an eAU request.


 

ONLINE API & END POINTS for PRODUCTION

(Base URL: https://api-name.api.datev.de/platform/) An interface check at the production level is not provided by DATEV. Reason: Interface checks are only carried out with sample data. This is not possible with the eAU API in the production environment. 
Please also take note of our [technical interface requirements](https://developer.datev.de/datev/platform/de/product/36401/api/29463/docs/32492)