Schnittstellenvorgaben Lohnaustauschdatenservice (eAU)

Die Online API für die elektronische Arbeitsunfähigkeitsbescheinigung ermöglicht die Abfrage elektronischer Arbeitsunfähigkeitsbescheinigungen bei der zuständigen Krankenkasse eines Arbeitnehmers. Nachfolgend wird der (reguläre) API Workflow aufgezeigt und welche Online-APIs & Endpunkte im Zusammenhang mit dem Datenservice verwendet werden müssen/sollten. 

 

API WORKFLOW

  1. Prüfung der Berechtigungen für den Datenservice
  2. Übertragung einzelner Anfragen - manuell (per Klick über 3rd-Party App) oder automatisiert (regelbasiert)
MUST: Übermittelte Anfragen (POST) und lesende API-Requests (GET) sollten in einem gesunden Verhältnis sein. Auf eine erfolgreich übermittelte Anfrage weitere 30 GET-Requests zu produzieren, zeugt nicht von einer effizienten Integration.


 

ONLINE API & ENDPUNKTE für SANDBOX

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

Berechtigungen prüfen

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

Hier können die Datenbestände abgefragt werden, auf die der Kunde die nötigen Berechtigungen hat. Die 3rd-Party App muss diesen Endpunkt nutzen. Hier muss der Kunde eine Eingabemöglichkeit in der 3rd-Party-App für die Berater- und Mandantennummer bekommen.

MUST: Es muss der Endpunkt genutzt werden. Hier muss aufgezeigt werden, wo der Kunde seine Angaben für den Datenbestand macht. Zeigen Sie danach den Aufruf des Endpunktes mit einer Erfolgsmeldung. Ebenfalls muss ein Fehler reproduziert werden, indem eine Berater-und Mandantennummer verwendet wird, für die der Kunde keine Berechtigung hat. Hier muss eine entsprechende Fehlermeldung an der Oberfläche angezeigt werden.



Challenges:

  • Berater trägt eine korrekte Berater- und Mandantennummer ein und zeigt die Erfolgsmeldung
  • Berater trägt eine ungültige Berater- und Mandantennummer ein und zeigt eine Fehlermeldung


 

Übertragung von eAU-Anfragen

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

Nutzen Sie diesen Endpunkt, um die Anfrage an das DATEV Rechenzentrum / Krankenkasse zu übermitteln. Sie erhalten eine uuid zurück, mit der Sie im nächsten Schritt weiterarbeiten können.     

MUST: Zeigen Sie eine erfolgreiche Anfrage an das DATEV-Rechenzentrum / Krankenkasse.


Wichtiger Hinweis: In der Sandbox erhalten Sie nur Mockup-Daten zurück.

Krankenkassen-Feedback abfragen
GET https://eau-api.../clients/{consultantNumber}-{clientNumber}{personalNumber}/eau-requests/feedbacks

    

MUST: Zeigen Sie die übermittelten Daten an der Oberfläche an.
eAU-Anfrage zurückziehen
DELETE https://eau-api.../clients/{consultantNumber}-{clientNumber}{personalNumber}/eau-requests/

Mit diesem Request können zuvor gesendete eAU-Anfragen gelöscht werden.

SHOULD: Zeigen Sie eine erfolgreiche Löschung einer eAU-Anfrage.


 

ONLINE API & ENDPUNKTE für PRODUKTION

(Base URL: https://api-name.api.datev.de/platform/) Eine Schnittstellenprüfung auf der Produktionsebene ist seitens DATEV nicht vorgesehen. Grund: Schnittstellenprüfungen werden nur mit Musterdaten durchgeführt. Dies ist bei der eAU-API in der Produktionsumgebung nicht möglich. 
Bitte beachten Sie auch zwingend unsere [technischen Schnittstellenvorgaben](https://developer.datev.de/datev/platform/de/product/36401/api/29463/docs/32492)