DATEV API Verbindungsprüfung

1. Einführung

Standardmäßig lautet die lokale URL der DATEV Connect Schnittstelle:

http://localhost:58454

In der Praxis kann diese Adresse abweichen, zum Beispiel:

• https://kanzlei:58452

• http://servername:58454

Wichtig: Ersetzen Sie localhost durch die tatsächlich erreichbare Adresse Ihres Servers.

2. Wichtige Endpunkte zur Prüfung

Die folgenden Endpunkte können Sie im Browser oder per Tool wie Postman abrufen:

● Benutzeridentität prüfen

GET http://<adresse>:58454/datev/api/iam/v1/Users/me

• Liefert Informationen zum aktuell verbundenen Benutzer (IAM-Schnittstelle).

● Auftragsübersicht abrufen

GET http://<adresse>:58454/datev/api/order-management/v1/orders?top=10&skip=0&filter=completion_status+eq+'created/planned'&expand=suborders

• Zeigt offene/geplante Aufträge für den Import.

● Zugriff mit Service-User testen

GET http://<adresse>:58454/datev/api/master-data/v1/employees?top=1&skip=0

• Zeigt, ob der Service-Nutzer Zugriff auf Mitarbeiterdaten hat (für Zeiteinträge erforderlich).

3. Hinweise zur Adresse

• localhost sollte immer durch den tatsächlichen Servernamen oder die IP-Adresse ersetzt werden

• Falls HTTPS verwendet wird, achten Sie auf Port 58452

Beispiele:

• http://localhost:58454

• http://someserver:58454

• https://kanzlei:58452

• https://memt1234:58452

4. Hinweis zu HTTPS

Wenn Sie über HTTPS auf die Schnittstelle zugreifen wollen, muss ein gültiges SSL-Zertifikat installiert und der Port 58452 offen sein.