Sync Kasse ↔ my.apro

Zielgruppe: Chef und Büro
Typische Nutzung: Läuft permanent im Hintergrund; der Chef prüft nur bei Änderungen oder Problemen
Aufruf: my.apro → Kassenmodule → Sync → Sync-Geräte Übersicht

Zweck

Der Sync hält die Daten zwischen der Kasse (vor Ort) und my.apro (in der Cloud) im Einklang. Stammdaten (Artikel, Preise, Tischmasken, Sparten) fließen von my.apro an die Kasse; Umsätze, Bonierungen, Abschlüsse fließen von der Kasse an my.apro. So kann der Chef im Büro auf Umsatzzahlen schauen, während die Kasse weiter verkauft — und Preisänderungen im Büro landen automatisch an allen Kassen.

Was wird synchronisiert

Von my.apro an die Kasse (Stammdaten, eher Abend/Nacht):

• Artikel (Name, Preis, Beilagen, Sparten-Zuordnung)
• Artikelmasken (welcher Artikel liegt auf welcher Ebene)
• Sparten, MwSt-Sätze
• Tische, Bereiche, Raumpläne
• Bediener (Kellner) mit Rechten, Schloss, PIN
• Zahlungsmittel, Druckprofile
• Preisebenen (Happy Hour, Terrassenpreis)
• Stützungen (Aktionen, Kundengruppen-Preise)

Von der Kasse an my.apro (Umsatzdaten, laufend in kurzen Abständen):

• Bonierungen, Rechnungen, Stornos
• Kellnerabschläge, Tagesabschlüsse
• Kassabuch-Buchungen
• Fiskalisierungs-Ereignisse
• Gutschein-Einlösungen
• Sync-Status, Geräte-Heartbeats

Takte (Intervalle)

Die Kasse synchronisiert nicht alles gleich oft:

• Umsatzdaten (Kasse → my.apro): Alle paar Minuten (typischerweise 1-5 Minuten). Damit die Büro-Reports live sind.
• Stammdaten-Pull (my.apro → Kasse): Neue Artikel/Preise sind an der Kasse meist in 15-60 Minuten sichtbar, ohne dass jemand etwas drückt.
• Nächtlicher Gesamt-Abgleich: Einmal pro Nacht (meist 04:00) läuft eine vollständige Abgleich-Runde. Korrigiert, was tagsüber verpasst wurde.
• Manueller Push: Der Chef kann über Kasse → Verwaltung → Sync → Jetzt abgleichen einen Sofort-Abgleich auslösen.

Ablauf typische Änderungen

„Preis eines Artikels geändert":

1. Chef öffnet den Artikel in my.apro → Kassenmodule → Artikel → Artikel, ändert den Preis und speichert.
2. my.apro merkt sich die Änderung mit Zeitstempel.
3. Innerhalb weniger Minuten holt die Kasse die Änderung ab.
4. Ab diesem Moment gilt der neue Preis für jede neue Bonierung.
5. Schon bonierte Tische behalten den alten Preis (der Preis wird bei Bonierung eingefroren).

„Neuen Artikel anlegen":

1. Chef legt in my.apro → Kassenmodule → Artikel → Artikel einen neuen Artikel an, weist Sparte und Preis zu.
2. Artikel auf die gewünschte Artikelmaske „herauslegen" (oder automatische Zuordnung über Sparte aktiv lassen).
3. Warten oder manueller Push an der Kasse.
4. Artikel erscheint an der Kasse.

„Kellner sperren":

1. Chef setzt den Kellner in my.apro → Kassenmodule → Bediener → Bediener auf inaktiv/gesperrt.
2. Innerhalb weniger Minuten kann der Kellner sich an der Kasse nicht mehr anmelden.

Einstellungen

• Sync-Intervall — Standardwerte sind in der Regel passend; selten ändern. (Menüpfad nicht in den my.apro-Navigationsdaten belegt.)
• Automatischer Stamm-Pull aus my.apro — Ein/Aus. Normalerweise an. (Menüpfad nicht in den my.apro-Navigationsdaten belegt.)
• Sync-Mail bei Fehler — Bei Hänger > X Minuten geht eine Mail ans Büro. (Menüpfad nicht in den my.apro-Navigationsdaten belegt.)
• Bandbreite schonen — Bei schwachem Internet sinnvoll. (Menüpfad nicht in den my.apro-Navigationsdaten belegt.)

Berechtigungen

Varianten

• Online-Kasse mit dauerhaftem Internet (Standard) — Sync in kurzen Intervallen. Minimaler Verzug.
• Halb-Online (schwaches Internet) — Sync in größeren Abständen. Kompression aktiv. Stammdaten-Pull einmal pro Nacht.
• Offline-Phasen (Internet-Ausfall) — Kasse läuft weiter, speichert Änderungen lokal. Bei Wiederverbindung läuft der Nachholsync (siehe offline-nachholsync.md).
• Mehrere Kassen, eine Server-Kasse — Die Server-Kasse vor Ort synct mit my.apro, die Neben-Kassen synchronisieren über die Server-Kasse. Nur die Server-Kasse braucht das Internet.
• Multi-Filial — Pro Filiale eine Server-Kasse, jede mit eigenem my.apro-Mandant oder gemeinsamem (siehe multi-filial-sync.md).

Sync-Status erkennen

In my.apro und an der Kasse zeigt eine Statusanzeige:

• Grün: Alles synchron, letzter Abgleich vor wenigen Minuten.
• Gelb: Letzter Abgleich > 15 Minuten her. Prüfen.
• Rot: > 60 Minuten oder Dauerfehler. Mail an Chef; Handlungsbedarf.

Problembehebung

• „Artikel-Preisänderung taucht an der Kasse nicht auf" → Manuellen Sync auslösen (Kasse → Verwaltung → Sync → Jetzt abgleichen). Wenn dann okay: vorheriger Sync war zu lange her. Bei wiederkehrendem Problem siehe sync-status-fehler.md.
• „Umsatz im my.apro-Bericht fehlt" → Sync-Status der Kasse prüfen. Wenn Kasse offline: bei Wiederverbindung kommt der Umsatz nach.
• Sync-Symbol dauerhaft rot → sync-status-fehler.md konsultieren. Oft ein Queue-Problem, das der Support beheben kann.
• „Ein Kellner fehlt an der Kasse" → Bediener-Sync prüfen. Bediener-Änderungen synchronisieren manchmal nur beim nächsten Kellner-Anmelden; manueller Push hilft.
• „Änderungen an der Kasse erreichen my.apro nicht" → Selten. Typischerweise Windows-Dienste der Kasse stoppen und neu starten (macht der Techniker).
• Daten werden in my.apro doppelt angezeigt → Export-Historie hat Duplikate. Wartungsthema beim Support.

Siehe auch

• sync-status-fehler.md — Wenn der Sync hakt
• offline-nachholsync.md — Bei Internet-Ausfall
• multi-filial-sync.md — Sync in Filialbetrieben
• monatsabschluss.md — Sync abgeschlossen vor FiBu-Export
• fibu-ablauf.md — FiBu braucht aktuellen Sync