Zum Hauptinhalt springen
Version: 1.x

SYNC999: Unerwarteter Synchronisierungsfehler

Was dies bedeutet

Bei der Synchronisierung ist ein unerwartetes Problem aufgetreten.

Ihre Verkäufe sind auf diesem Gerät sicher. Warten Sie den automatischen Wiederholungsversuch ab; wenn dieser Code weiterhin auftritt, exportieren Sie Diagnosedaten und wenden Sie sich an den Support.

Was zu tun ist

Versuchen Sie die Aktion erneut. WCPOS wiederholt dies automatisch.

Ihre Daten

Die Änderung ist auf diesem Gerät gespeichert, hat Ihren Shop aber nicht erreicht. Wenn dies weiterhin auftritt, exportieren Sie Diagnosedaten und wenden Sie sich an den WCPOS-Support.

Fehlerbehebung

  1. Gehen Sie nicht davon aus, dass dieser Code automatisch wiederholt wird. Klappen Sie zuerst den Protokolleintrag auf: Bestätigt er, dass die Änderung bereits eingereiht war, wiederholt WCPOS sie automatisch — lassen Sie sie also offen und die Warteschlange abarbeiten.
  2. Wenn der Fehler besagt, dass der Engine-Resident fehlt oder der Schreibvorgang fehlschlug, bevor eine Mutations-ID zurückgegeben wurde, wurde nichts eingereiht — kehren Sie zu diesem Datensatz oder dieser Bestellung zurück und speichern Sie ihn bzw. sie erneut.
  3. Klappen Sie den Protokolleintrag auf und notieren Sie den Ereigniscode sowie einen etwaigen serverCode: Ein 999er-Code bedeutet, dass die konkrete Ursache noch keinen eigenen Code hat, daher ist genau dieser Kontext das, was der Support benötigt.
  4. Wenn der Code weiterhin auftritt, verwenden Sie Debug-Infos kopieren und wenden Sie sich an den Support — nur durch solche Meldungen wird ein eigener Code ergänzt.

Wo Sie nachsehen können

Wenn WCPOS diesen Fehler speichern kann, wird er auf dem Gerät aufgezeichnet, das ihn ausgelöst hat. Öffnen Sie Shop-Zustand → Protokolle (das Herzschlagsymbol unten im Navigationsmenü), suchen Sie den mit diesem Code gekennzeichneten Eintrag und klappen Sie ihn auf: Die aufgeklappte Zeile zeigt die Ursache in verständlicher Sprache sowie den Kontext, der im Moment des Fehlers erfasst wurde. Bei einer Shop-Anfrage kann dieser Kontext den eigenen Fehlercode des Servers (serverCode), den HTTP-status oder den endpoint enthalten; welche Felder angezeigt werden, hängt davon ab, wo der Fehler aufgetreten ist. Verwenden Sie beim Melden eines Problems Debug-Infos kopieren oben im Protokollbildschirm (Debug-Infos teilen auf Smartphones und Tablets) statt Screenshots: Damit werden App-Version, Verbindungsstatus und die neuesten Fehler zusammengefasst. Protokolle werden höchstens 30 Tage aufbewahrt — sammeln Sie sie daher, solange das Problem frisch ist. Kopieren Sie außerdem jede Fehlermeldung aus der Browser-Konsole, die erschienen ist, bevor das POS seinen eigenen Protokolleintrag schreiben konnte.

Über das Protokoll in der App hinaus kann dieser Fehler an folgenden Stellen Spuren hinterlassen:

  • Netzwerk-Inspektor (Web und Desktop): Öffnen Sie die Entwicklertools — drücken Sie F12 im Browser oder wählen Sie Erweitert → Entwicklertools umschalten im Menü der Desktop-App — und wechseln Sie zum Tab Netzwerk. Befolgen Sie zuerst die Hinweise zum erneuten Versuch auf dieser Seite; wiederholen Sie die Aktion nur, wenn diese Schritte sie als unbedenklich bezeichnen. Eine fehlgeschlagene Anfrage zeigt den HTTP-Status und den unbearbeiteten Antworttext, einschließlich Fehlerseiten, die nie im POS-Protokoll ankommen.

Details

  • Code: SYNC999 (SYNC_UNEXPECTED)
  • Schweregrad: error
  • Eingeführt in: WCPOS 1.10.0