Überwachen und Fehler beheben
Häufige Sync-Fehler
Was die üblichen Fehlschläge bedeuten, an welchem Ende Sie sie beheben, und wie Sie erneut ausführen, ohne es schlimmer zu machen.
Die meisten Integrationsfehler sind einer von etwa einem Dutzend Fällen. Das hier ist diese Liste, mit Ursache und dem Ende, an dem Sie den Fehler beheben. Der Reflex, Daten hier im Cockpit zu korrigieren, ist meist der falsche: Ein Wert, der hier und nicht an der Quelle korrigiert wird, bleibt bis zum nächsten Lauf korrigiert.
Verbindung und Authentifizierung
| Meldung | Ursache | Behebung |
|---|---|---|
| 401 / 403 | Zugangsdaten rotiert, abgelaufen, oder das technische Konto wurde deaktiviert | Zugangsdaten auf der Verbindung erneuern. Die Gegenseite bitten, technische Konten von der Passwortrotation auszunehmen |
| Verbindung abgelehnt / Timeout | Deren System ist down, in Wartung, oder Ihre Adressen stehen nicht auf der Allowlist | Erst deren Wartungsfenster bestätigen, dann die Firewall |
| TLS-/Zertifikatsfehler | Abgelaufenes Zertifikat, oder eine interne CA, der hier nicht vertraut wird | Deren Seite erneuert; bei einer internen CA muss das Zertifikat geliefert werden |
| HTML statt erwartetem JSON | Eine Login- oder Fehlerseite kam mit HTTP 200 zurück | Deren Seite. Nicht parsen; jeden HTML-Body als gescheiterten Lauf behandeln |
Identität und Zuordnung
| Symptom | Ursache | Behebung |
|---|---|---|
| Alles wird angelegt, nichts aktualisiert | Das Kennungsformat weicht ab: führende Nullen, ein Präfix oder Groß-/Kleinschreibung | Im Mapping normalisieren. Dann die bereits angelegten Dubletten zusammenführen oder entfernen |
| Null Aktualisierungen bei einem erneuten Import | Dieselbe Ursache | Dieselbe Behebung |
| Doppelte Produkte mit fast identischen SKUs | Zwei Quellen vergeben Schlüssel, oder ein Formatwechsel mitten im Projekt | Den einen Herausgeber festlegen, dann zusammenführen. Tragen die Dubletten schon Bestellhistorie, ist das eine sorgfältige Handarbeit |
| Bestellungen vom ERP abgelehnt: unbekannter Kunde | Die Organisation hier hat keine ERP-Kundennummer, oder eine veraltete | Das Mapping der Kundenstammdaten korrigieren. Bis dahin bleiben diese Bestellungen liegen |
Dubletten aus einer nicht passenden Kennung sind der teuerste Fehler auf dieser
Seite. In der ersten Stunde sind sie billig zu beheben, nach einer Woche teuer,
weil bis dahin einige davon bestellt, bepreist und referenziert wurden. Stoppen
Sie einen Lauf, der unerwartete Anlagen meldet, statt ihn zu Ende laufen zu
lassen.
Daten und Validierung
| Meldung | Ursache | Behebung |
|---|---|---|
| Unbekanntes Attribut | Spalte auf eine Bezeichnung statt auf einen Attributcode gemappt | Den Code verwenden |
| Ungültige Option | Der Quellwert hat keine passende Option, V4A gegen 1.4571 | Die Option anlegen, oder die Varianten auf einen Code mappen |
| Validierung fehlgeschlagen | Der Wert verletzt eine Regel am Attribut | An der Quelle korrigieren, oder eine falsche Regel lockern |
| Unbekannter Datensatz | Ein Referenzwert (Hersteller, Werkstoff) existiert noch nicht | Referenzdaten vor den Produkten laden. Die Reihenfolge zählt, siehe Produkte in Masse importieren |
| Pflichtfeld fehlt | Ein Pflichtattribut ist in der Quelle leer | Vorgelagert füllen, oder prüfen, ob es für diesen Kanal wirklich Pflicht sein muss |
| Zahl außerhalb des Bereichs / um Faktor 1000 daneben | Dezimaltrennzeichen als Tausendertrennzeichen gelesen | Das Quell-Locale im Mapping explizit setzen |
| Kaputte Umlaute | Encoding-Konflikt, meist ISO-8859-1 als UTF-8 gelesen | Das Encoding auf der Verbindung setzen und erneut ausführen. Den Text nicht von Hand korrigieren |
Volumen und Timing
| Symptom | Ursache | Behebung |
|---|---|---|
| Lauf erfolgreich, null Datensätze | Leerer Export, falscher Pfad, oder die Quelle lief zu spät | Zuerst die Quelldatei prüfen. Bei leeren Ergebnissen alarmieren, damit das nie ein Käufer entdeckt |
| Laufzeit wächst jede Woche | Volllauf auf einem wachsenden Katalog, oder eine ungefilterte Abfrage | Auf Deltas mit wöchentlichem Volllauf umstellen, oder die Auswahl eingrenzen |
| Nachtlauf reicht in den Morgen hinein | Er startet zu spät, oder der eigene Job der Quelle ist gewandert | Den Zeitplan verschieben, nicht den Timeout |
| Rate Limit erreicht | Zu viele Aufrufe, meist durch Live-Abfragen auf einer Kategorieseite | Cachen, Aufrufe bündeln, oder weniger live abrufen |
Ausgehend und Webhooks
| Symptom | Ursache | Behebung |
|---|---|---|
| Wiederholte 5xx auf einem Webhook | Der Empfänger scheitert oder ist zu langsam | Deren Seite. Bestätigen lassen, dass vor der Verarbeitung quittiert wird |
| Doppelte Bestellungen im ERP | Wiederholung nach einem Timeout, und der Empfänger dedupliziert nicht | Auf die Nachrichten-ID deduplizieren. Bis dahin braucht jeder Timeout eine manuelle Prüfung |
| Events in der Warteschlange der Fehlschläge | Wiederholungen aufgebraucht, während der Empfänger down war | Den Empfänger reparieren, dann gezielt erneut senden; vorher prüfen, was der Abgleichlauf bereits erfasst hat |
Punchout
| Symptom | Ursache |
|---|---|
| Der Einkäufer landet auf einer Anmeldemaske | Zugangsdaten falsch, oder die Sitzung wurde keinem Kunden zugeordnet |
| Der Einkäufer sieht das falsche Sortiment | Kanalsichtbarkeit offen gelassen, oder der falsche Kanal mit der Verbindung verknüpft |
| Der Einkäufer sieht Listenpreise | Die Konditionen des Kunden werden für diesen Kanal nicht aufgelöst |
| Warenkorbübergabe scheitert oder Positionen fehlen | Fehlende Mengeneinheit, fehlende Herstellerteilenummer, oder eine Beschreibung über deren Längenlimit |
| Warenkorb wird übergeben, aber es kommt nie eine Bestellung an | Die Bestellübertragung wurde nie eingerichtet; sie ist eine eigene Nachricht, getrennt vom Punchout |
Sicher erneut ausführen
- Die Quelle korrigieren, nicht den Datensatz. Ein hier korrigierter Wert bleibt bis zum nächsten Lauf korrigiert.
- Denselben Umfang erneut ausführen, eingegrenzt. Fünfzig Datensätze, dann der Rest.
- Null Anlagen erwarten. Legt ein erneuter Lauf Datensätze an, ist die Kennung noch falsch. Stoppen.
- Einen Datensatz von Hand prüfen, bevor Sie den Umfang ausweiten.
- Aufschreiben, was es war. Derselbe Feed geht in achtzehn Monaten auf dieselbe Weise kaputt, und die Person im Dienst werden nicht Sie sein.
Weiter
- Syncs überwachen: diese Fehler früher erwischen.
- Das führende System festlegen: die Lösung für die Fehler, die immer wiederkommen.