Fehlerbehebung

Prüfungen nach dem Setup und typische Probleme beim Betrieb des Klardaten DATEV Connectors.

Grundlegende Prüfungen nach der Installation

Nach der Installation sollten mindestens die folgenden Prüfungen durchgeführt werden:

  1. Windows-Dienst prüfen: Stelle sicher, dass Klardaten DATEV Connector installiert ist, läuft und auf automatischen Start gesetzt wurde.
  2. Logs prüfen: Kontrolliere die Anwendungslogs auf Warnungen oder Fehler. Wenn die Installation fehlgeschlagen ist, prüfe zusätzlich C:\klardaten_install_log.txt und die Windows-Ereignisanzeige.

Typische Probleme

Backend-Verbindung funktioniert nicht

Wenn der Connector das Backend nicht erreicht, prüfe zuerst die Konnektivität zu nats.klardaten.com:443.

Einige Firewalls erwarten auf Port 443 HTTPS-Traffic oder führen Deep Packet Inspection (DPI) durch. Das führt hier zu Problemen, weil der Dienst NATS-Traffic über TLS verwendet und kein HTTP.

Wenn du eines der folgenden Systeme einsetzt, wende die jeweilige Hersteller-Empfehlung an:

  1. Sophos SG: Lege eine Transparenzmodus-Ausnahme für den DNS-Namen nats.klardaten.com und die IP-Adresse 35.159.179.234 an.
  2. Kaspersky Webschutz: Füge nats.klardaten.com zur Whitelist hinzu.
  3. Securepoint Firewall: Lege eine Regel für nats.klardaten.com an und aktiviere in den erweiterten Einstellungen Disable DPI.

Leere Antwort oder HTTP-500 auf Master-Data-Endpunkten

Wenn Requests auf Master-Data-Endpunkte leer zurückkommen oder einen 500-Fehler liefern:

  1. Starte Arbeitsplatz.exe einmal mit dem Benutzer klardaten.
  2. Starte den DATEVconnect-Windows-Dienst neu.

Kein DMS-Zugriff

Stelle sicher, dass der konfigurierte Benutzer der richtigen DMS-Datenumgebung zugeordnet ist.

Berechtigungsprobleme

Prüfe, dass:

  • die Installation mit Administratorrechten durchgeführt wurde und
  • der konfigurierte Benutzer die nötigen Rechte auf DATEV-Netzlaufwerk und Datenumgebung besitzt.

Falsche oder fehlende Daten

Stelle sicher, dass der Benutzer der richtigen Datenumgebung (Datenumgebungen) zugeordnet ist. Zusätzliche Informationen stellt DATEV hier bereit:

https://apps.datev.de/help-center/documents/1007899

Was du für den Support mitschicken solltest

Wenn ein Problem nicht direkt gelöst werden kann, helfen diese Informationen bei der Analyse:

  • relevante Ausschnitte aus dem Installer-Log oder Service-Log
  • die genaue Fehlermeldung
  • ein Screenshot der betroffenen Stelle
  • eine kurze Beschreibung der Umgebung und des betroffenen Schritts