Sync-Status und Fehler beheben

Zielgruppe: Chef (erste Prüfung), Büro/APRO-Support (Tiefen-Analyse)
Typische Nutzung: Bei Sync-Alarm oder wenn etwas „fehlt" zwischen Kasse und my.apro
Aufruf: my.apro → Kassenmodule → Sync → Sync-Geräte Übersicht

Zweck

Der Sync zwischen Kasse und my.apro läuft normalerweise unauffällig im Hintergrund. Wenn er hakt, fehlen Umsätze in den Berichten, Stammdatenänderungen kommen nicht an der Kasse an, oder das Büro sieht im Dashboard rote Sync-Zeichen. Dieser Artikel zeigt, was der Chef selbst prüfen kann, welche Hinweise im System zu sehen sind und wann der APRO-Support einzubeziehen ist.

Sync-Status auf einen Blick

Drei Anzeigen, die der Chef im Alltag sieht:

• my.apro-Dashboard — Ein Symbol pro Kasse: grün (aktuell), gelb (leichter Verzug), rot (Dauerhänger).
• Kasse Statusleiste — Unten am Bildschirmrand zeigt die Kasse den letzten erfolgreichen Sync-Zeitpunkt an.
• Sync-Queue — Die Warteschlange aller noch nicht übertragenen Sätze. In Zahlen sichtbar: z.B. „237 Einträge in Queue".

Richtwerte:

• < 5 Minuten Verzug: Normalzustand.
• 5-15 Minuten: Nicht ungewöhnlich, z.B. bei schwachem Internet.
• > 15 Minuten oder stetig wachsende Queue: Prüfen.
• > 60 Minuten oder nicht mehr laufend: Handlungsbedarf.

Erst-Prüfungen durch den Chef

Bevor der Support angerufen wird — drei Minuten reichen oft:

1. Internet prüfen — Ist die Verbindung an der Kassen-Station verfügbar? Kurzer Test im Browser an der Kasse oder einem anderen Gerät im Netzwerk.
2. my.apro-Seite öffnen — Lässt sich my.apro aus dem Netzwerk der Kasse erreichen? Wenn nicht: vielleicht Firewall, DNS oder Provider.
3. Manuellen Sync auslösen — Kasse → Verwaltung → Sync → Jetzt abgleichen. Wenn er durchläuft, war der Sync nur verzögert.
4. Server-Kasse prüfen — Bei Mehrplatz-Setups synct nur die Server-Kasse mit my.apro. Läuft sie? Ist sie eingeschaltet?
5. Dienst-Status — Windows → Dienste → APRO Sync Service. Falls „gestoppt": starten.
6. Letzte Änderungen — Wurde gerade ein großes Windows-Update gemacht? Netzwerkumstellung? Das sind häufige Auslöser.

Wenn diese Schritte nichts bringen: APRO-Support informieren.

Typische Ursachen

• Internet-Ausfall — Häufigste Ursache. Siehe offline-nachholsync.md.
• APRO Sync Service gestoppt — Windows-Update hat den Dienst deaktiviert.
• Datenbank voll — Die Sync-Warteschlange hat zu viele alte Einträge, die Kasse kann nicht mehr aufräumen. Wartungs-Skript nötig.
• Zeit-/Uhrzeit-Problem — Die Kasse hat eine falsche Uhrzeit; Synchronisation schlägt fehl weil Zeitstempel nicht passen.
• my.apro-Wartung — Kurze Downtime bei APRO-Serverwartungen. Die Queue füllt sich, nach Wartung läuft der Nachholsync.
• Netzwerkänderung — Router getauscht, VPN-Konfiguration geändert, Firewall-Regel blockiert Port.

Ablauf bei rotem Sync

Wenn der Chef alles aus den Erst-Prüfungen durch hat und weiterhin rot:

1. APRO-Support anrufen oder Ticket öffnen — Mit Angabe: „Sync rot seit ca. HH:MM Uhr, Kunde XY, Standort Z."
2. Techniker analysiert — Prüft Sync-Queue, Datenbankgröße, letzte Fehlermeldungen im Logfile, Server-Erreichbarkeit.
3. Wartungsskript ausführen (wenn Datenbank voll) — Bereinigt alte Queue-Einträge. Während das Skript läuft, kann die Kasse bonieren und abrechnen; nur der Sync pausiert kurz.
4. Dienst neu starten — Falls Service hängt.
5. Queue manuell leeren — In Sonderfällen bei korrupten Einträgen.
6. Abschluss-Kontrolle — Testbuchung an der Kasse, innerhalb weniger Minuten sichtbar in my.apro.

Einstellungen

• Automatische Bereinigung der Sync-Queue — Täglich oder wöchentlich läuft ein Aufräumer über alte, bereits übertragene Einträge. (Menüpfad nicht in den my.apro-Navigationsdaten belegt.)
• Alarm-Schwellwert — Ab welchem Verzug geht eine Mail raus. (Menüpfad nicht in den my.apro-Navigationsdaten belegt.)
• Mail-Empfänger — Chef und/oder Büro. (Menüpfad nicht in den my.apro-Navigationsdaten belegt.)
• Manueller Push per Zeitplan — Zusätzlich zum Standard-Intervall ein weiterer Fixtermin (z.B. 23:55 für Tagesende-Push). (Menüpfad nicht in den my.apro-Navigationsdaten belegt.)

Berechtigungen

Varianten

• Leichter Verzug ohne Handlungsbedarf — Sync-Queue hat kurzzeitig 100-500 Einträge, läuft aber. Ein Stoßzeit-Phänomen.
• Queue-Überlauf — Tausende Einträge stauen sich. Der Sync kommt nicht hinterher. Wartungsskript nötig.
• Blockierter Eintrag — Ein einzelner korrupter Datensatz blockiert den gesamten Sync. Der Techniker isoliert und löscht den Eintrag.
• Einseitiger Sync — Nur Stammdaten-Pull funktioniert, Umsatz-Push nicht (oder umgekehrt). Deutet auf Rechte- oder API-Problem hin.

Problembehebung

• „Sync grün auf der Kasse, aber Umsatz fehlt in my.apro" → Queue ist leer, aber einzelne Datensätze sind nicht sauber importiert. Wartungsskript „fehlgeschlagene Importe neu verarbeiten" (der Support kennt das).
• „Stammdaten-Änderung kommt nicht auf der Kasse an" → Prüfen, ob der Stammdaten-Pull in my.apro aktiv ist. Manueller Push auf der Kasse hilft meist sofort.
• „Queue wächst Minute für Minute" → Netzwerk oder Service-Problem. Sofort Support.
• „Kasse zeigt 'Keine Verbindung zu my.apro'" → DNS-Problem oder my.apro-Erreichbarkeit. Browser-Test, Router-Test, Support.
• „Doppelte Umsätze in my.apro" → Seltener Fall, durch Queue-Duplikate. Support läuft Deduplikations-Skript.
• „Kasse wurde nach Ausfall neu installiert, Sync startet nicht" → Im Portal muss die neue Kassen-Instanz registriert sein. Support übernimmt.
• „Mail-Alarm nervt, kein echtes Problem" → Schwellwert anpassen oder Mail deaktivieren für Zeiten mit bekanntem schwachem Internet (Biergarten, Außenstation).

Siehe auch

• sync-kasse-myapro.md — Normalzustand und Intervalle
• offline-nachholsync.md — Bei ausgefallenem Internet
• multi-filial-sync.md — Sync in Filialstruktur
• monatsabschluss.md — Vor FiBu-Export: Sync muss sauber sein
• Technische Details: Technik-Wiki („Sync funktioniert nicht weil Datenbank voll")