Connectoren und Verbindungen prüfen
Integrationen öffnen, Verbindungsstatus prüfen und Fehler sicher eingrenzen
Connectoren verbinden SimpliServ mit externen Diensten. Der Status zeigt nur, ob die technische Verbindung funktioniert; er bestätigt nicht automatisch, dass Daten fachlich richtig synchronisiert wurden.
Vor dem Test
- Welcher Connector ist betroffen?
- Welche Richtung ist betroffen: Import, Export oder beides?
- Seit wann tritt der Fehler auf?
- Gibt es eine konkrete externe ID oder einen Datensatz, an dem du prüfen kannst?
- Hat sich ein Token, Passwort, Webhook oder die Berechtigung geändert?
Verbindung prüfen
Connector öffnen
Öffne Administration → Daten & Geräte → Integrationen. Aktive Verbindungen stehen unter Aktiv mit dem Status Verbunden; mit Nur aktive blendest du alle anderen aus. Öffne den betroffenen Konnektor über Verwalten. Nicht mehrere Verbindungen gleichzeitig ändern.
Status und letzten Lauf lesen
Der Tab Übersicht zeigt je nach Konnektor Kennzahlen wie Letzte Synchronisierung, Zuletzt verwendet, Token läuft ab und einen Status (Aktiv, Ausstehend, Fehler oder Nicht konfiguriert). Zugangsdaten und Optionen liegen im Tab Konfiguration.
Test ohne Fachdatenänderung
Verwende zuerst die vorhandene Test- oder Verbindungsprüfung. Starte keinen Vollimport, wenn nur die Authentifizierung unklar ist.
Einen Datensatz vergleichen
Suche eine externe ID und vergleiche Name, Status, Preis, Steuer und Zeitstempel in beiden Systemen. Abweichungen notieren, bevor du erneut synchronisierst.
Häufige Ursachen
| Symptom | Wahrscheinliche Ursache | Nächster Check |
|---|---|---|
| Verbindung abgelaufen | Token oder OAuth-Zustimmung abgelaufen | Konnektor trennen und neu Verbinden |
| Test grün, Daten fehlen | Filter, Mapping oder fehlender Trigger | letzten Lauf und Filter prüfen |
| Doppelte Datensätze | wiederholter Import ohne stabile externe ID | Importregeln und Idempotenz prüfen |
| Nur einzelne Felder falsch | Mapping oder Custom-Field geändert | Beispiel-Datensatz vergleichen |
Zugangsdaten nie in Tickets, Screenshots oder Freitext speichern. Nach einer Autorisierungsänderung zuerst einen einzelnen Testdatensatz prüfen.
Nach einem Fehler
Exportiere oder kopiere die technische Fehlermeldung, notiere Connector, Zeitpunkt und externe ID und verlinke den Eintrag im Admin-Log. Wiederholte Vollimporte ohne Ursachenprüfung können Duplikate und Überschreibungen erzeugen.
How is this guide?