23a

Berichte und Auswertungen

1. Wozu dient das?#

Die Berichts- und Auswertungsmodule im Backoffice bieten dem Schichtleiter und Betriebsinhaber jederzeit volle Transparenz über Umsätze, Kasseneinnahmen, Gästezahlen, Stornierungen und Warengruppenverkäufe. Der Schichtbericht fungiert als operative Tagesabrechnung (Z-Bericht) bei Schichtende, während das Inhaber-Dashboard langfristige Vergleiche über Tage, Wochen und Monate ermöglicht.

2. Rollen und Berechtigungen#

• Bediener / Servicekraft (waiter): Kann den Status der eigenen aktiven Schicht einsehen und den Kassensturz am Kassenplatz durchführen. Keinen Zugriff auf Standortberichte anderer Schichten oder das Inhaber-Dashboard.
• Manager (manager): Einsicht in alle Schichtberichte des zugewiesenen Standorts, Durchführung des Schichtabschlusses sowie Zugriff auf das Inhaber-Dashboard und den CSV-Export.
• Inhaber (admin): Uneingeschränkter Zugriff auf sämtliche Schichtberichte, Standortvergleiche, Erlösauswertungen und Exporte über alle Standorte des Mandanten.
• Betriebsprüfer (auditor): Schreibgeschützter Lesezugriff auf historische Schichtberichte und Inhaber-Dashboards zur Prüfung der Einnahmenstrukturen.

3. Voraussetzungen#

• Für Schichtberichte: Eine im Kassensystem aktiv geöffnete oder vor kurzem geschlossene Standortschicht (→ Kapitel 12).
• Für das Inhaber-Dashboard: Eine angemeldete Benutzerrolle mit Führungsrechten (manager oder admin).

4. Bildschirm für Bildschirm#

4.1. Schichtbericht (modules/backoffice/ShiftReportView.tsx)#

• 1 Bericht exportieren speichert den Bericht als CSV-Datei.
• 2 Die vier Kennzahlen Bruttoumsatz, Gedecke gesamt, Durchschn. Bon und Personalkosten (zeigt —, solange keine Kosten erfasst sind).
• 3 STÜNDLICHER UMSATZ mit Verteilung nach Stunde und der Kennzeichnung Live-Performance: ein Balken je Stunde, die letzten zehn.
• 4 BARGELD IN LADE zeigt — und Erwartet: —. Der Bericht nennt keinen Soll-Barbestand, damit die Zählung beim Schichtabschluss blind bleibt (→ Kapitel 12).
• 5 STORNIERTER UMSATZ mit der Zahl der Artikel und den Öffnungen der Lade ohne Verkauf.
• 6 TOP-KATEGORIEN mit Umsatz und Balken je Warengruppe.

Bietet die detaillierte Tages- und Schichtabrechnung (Z-Bericht):

• Kopfzeile: Titel **Schichtbericht** und Statuszeile **Geöffnet: [Datum, Uhrzeit] | Status: [OPEN/CLOSED]**. Auf der rechten Seite befindet sich der Button **Bericht exportieren**.
• Kennzahlen-Grid (4 StatCards):
  • **Bruttoumsatz**: Erzielter Gesamtumsatz (inkl. MwSt.) in Euro.
  • **Gedecke gesamt**: Erfasste Gästeanzahl (PAX-Tracking).
  • **Durchschn. Bon**: Durschnittlicher Bonbetrag in Euro.
  • **Personalkosten**: Arbeitsstunden-Zuordnung (falls erfasst).
• Hauptbereich (Linke Spalte):
  • Diagramm Stündlicher Umsatz: Zeigt die **Verteilung nach Stunde** mit der Kennzeichnung **Live-Performance**. Beim Bewegen über die Balken wird der exakte Umsatz pro Stunde angezeigt.
  • Bento-Kacheln:
    • **Bargeld in Lade**: zeigt derzeit nur — und Erwartet: —, keinen Betrag.
    • **Stornierter Umsatz**: Gesamtsumme aller Stornierungen und Anzahl stornierter Artikel (**{{count}} Artikel**).
• Seitenbereich (Rechte Spalte):
  • Kachel Top-Kategorien: Liste der umsatzstärksten Warengruppen mit Betrag in Euro und prozentualem Anteil als Fortschrittsbalken.
  • Kachel Schichtfortschritt: Anzeige des bisherigen Schichtumsatzes mit Fortschrittsbalken zur geschätzten Zielerreichung (**Geschätzte Zielerreichung**).

4.2. Inhaber-Dashboard (modules/backoffice/OwnerDashboard.tsx)#

Dient der strategischen Umsatz- und Betriebssteuerung:

• Kopfzeile: Titel **Inhaber-Dashboard**, Standortname (**Betriebliche Erkenntnisse für [Name]**), Datumsbereich-Filter (**Startdatum** bis **Enddatum**) und Button **CSV exportieren**.
• Tages-Schnellansicht (Obere 3 Kacheln):
  • **Bruttoumsatz heute**: Tagesumsatz mit prozentualer Abweichung und Vorwert (**im Vgl. zu gestern: [Betrag]**).
  • **Bestellungen gesamt**: Anzahl der getätigten Bestellungen heute mit Vortagsvergleich.
  • **Durchschn. Bon**: Bon-Durchschnitt heute mit Vortagsvergleich.
• Mittlerer Analyse-Bereich:
  • Kachel Wöchentlicher Umsatz: Diagramm **Tägliche Verteilung** der aktuellen Woche (**Diese Woche**).
  • Kachel Zahlungsarten-Mix: Aufschlüsselung der Einnahmen nach **Bar**, **Karte** und **Sonstiges** mit Prozentangaben.
• Unterer Analyse-Bereich:
  • Tabelle Top-Produkte (diesen Monat): Liste der verkauften Artikel mit Spalten **Produkt**, **Menge** (Qty) und **Umsatz**.
  • Kachel Kategorie-Performance: Rangliste der Warengruppen im aktuellen Monat mit Monatsumsatz.

5. Schritt für Schritt (mit Verzweigungen)#

Verzweigung A: Schichtbericht bei Schichtende aufrufen und prüfen#

1. Öffnen Sie im Backoffice den Menüpunkt **Schichtbericht**.
2. Falls keine Schicht aktiv ist: Das System zeigt die Hinweismeldung **Keine aktive Schicht** ("Schichtberichte sind nur verfügbar, wenn eine Standortschicht aktuell geöffnet oder vor kurzem geschlossen wurde."). Öffnen Sie zuerst eine Schicht am Terminal (→ Kapitel 12).
3. Falls eine Schicht aktiv oder geschlossen ist:
   • Kontrollieren Sie die Gesamtsummen **Bruttoumsatz**, **Gedecke gesamt** und **Durchschn. Bon**.
   • Prüfen Sie den **Stornierter Umsatz**. Bei auffällig hohen Stornos vergleichen Sie die Angaben mit den Stornoprotokollen (→ Kapitel 14b).
4. Klicken Sie oben rechts auf **Bericht exportieren**.
5. Das System generiert die Datei shift_report_[id].csv und startet den Download.

Verzweigung B: Bargeldvergleich (Kassensturz) im Schichtbericht durchführen#

1. Lesen Sie im Schichtbericht den Betrag unter **Bargeld in Lade** ab.
2. Zählen Sie den physischen Bargeldbestand in der Kassenlade.
3. Führen Sie am Terminal den Kassensturz durch (→ Kapitel 12).
4. Das System vergleicht den gezählten Ist-Bestand mit dem rechnerischen Soll-Bestand:
   • Bei Übereinstimmung: Der Schichtabschluss wird ohne Abweichung gebucht.
   • Bei Abweichung: Das System verbucht die Differenz automatisch als DifferenzSollist im Kassenbuch und weist diese im Bericht aus.

Verzweigung C: Erlöse und Trends im Inhaber-Dashboard analysieren#

1. Öffnen Sie das **Inhaber-Dashboard**.
2. Wählen Sie oben im Datumsfilter ein Startdatum und ein Enddatum.
3. Überprüfen Sie den **Zahlungsarten-Mix**:
   • Prüfen Sie das Verhältnis zwischen **Bar** und **Karte**.
4. Analysieren Sie die Tabelle **Top-Produkte (diesen Monat)**:
   • Identifizieren Sie Ladenhüter und Bestseller für Ihre Speisekartengestaltung (→ Kapitel 21).
5. Klicken Sie auf **CSV exportieren**.
6. Das System lädt die Datei analytics_report_[start]_to_[end].csv herunter.

6. Was passiert im Hintergrund#

Bei jeder abgeschlossenen Bestellung akkumuliert das System im Hintergrund die Umsätze in Echtzeit. Dabei werden die Beträge strikt nach Steuersätzen (z. B. 19 % Regelsteuersatz und 7 % ermäßigter Satz) aufgeteilt.

• Ausschluss von Trainingsbuchungen: Bestellungen, die im Trainingsmodus gebucht wurden (training_mode = True), fließen nicht in den Schichtbericht oder das Inhaber-Dashboard ein. Sie werden im DSFinV-K Export separat als AVTraining ausgewiesen.
• Kassenbuch-Integration: Bargeldeinlagen, Entnahmen und Kassensturzdifferenzen werden als eigene Bewegungstypen (Anfangsbestand, DifferenzSollist, Geldtransit) erfasst.

7. Häufige Probleme & Fehlerbehebung#

Hier finden Sie exakte Fehlermeldungen des Backends, deren Ursachen und passende Lösungen:

1. No open shift for this location#

• Ursache: Es wurde versucht, einen Schichtbericht abzurufen oder einen Kassensturz auszuführen, ohne dass eine aktive Schicht für diesen Standort geöffnet ist.
• Lösung: Öffnen Sie am Kassenterminal eine neue Standortschicht (→ Kapitel 12).

2. Start date must be before or equal to end date#

• Ursache: Im Datumsfilter des Inhaber-Dashboards wurde ein Startdatum gewählt, das nach dem Enddatum liegt.
• Lösung: Korrigieren Sie die Datumseingabe im Kalenderfilter, sodass das Startdatum vor oder auf dem Enddatum liegt.

3. Compare start date must be before or equal to compare end date#

• Ursache: Bei Vergleichenden Auswertungen wurde ein ungültiger Vergleichszeitraum angegeben.
• Lösung: Überprüfen Sie die Datumsangaben des Vergleichszeitraums.

4. Comparison period must have the same duration as the target period#

• Ursache: Der gewählte Vergleichszeitraum unterscheidet sich in der Anzahl der Tage vom Hauptzeitraum (z. B. 7 Tage Hauptzeitraum vs. 10 Tage Vergleichszeitraum).
• Lösung: Passen Sie die Zeiträume an, sodass beide exakt dieselbe Anzahl an Tagen umfassen.

5. Unsupported format#

• Ursache: Beim Anfordern des Schichtbericht-Exports wurde ein ungültiges Exportformat im API-Aufruf übergeben.
• Lösung: Nutzen Sie den Standard-Exportbutton in der Benutzeroberfläche (erzeugt valides CSV).

6. Cannot modify a finalized order#

• Ursache: Es wurde versucht, eine bereits geschlossene Bestellung nachträglich im Schichtbericht zu bearbeiten.
• Lösung: Abgeschlossene Bestellungen sind unveränderbar. Nutzen Sie die Stornofunktion (→ Kapitel 14b), um Fehleingaben zu korrigieren.

7. Order has unpaid balance of {due - paid} cents#

• Ursache: Eine Bestellung weist noch einen offenen Restbetrag auf und kann daher nicht in den Schichtbericht übernommen werden.
• Lösung: Schließen Sie die Zahlung der Bestellung vollständig ab oder stornieren Sie den offenen Restbetrag.

8. Location not found or access denied#

• Ursache: Der angemeldete Benutzer besitzt keine Berechtigung für den ausgewählten Standort oder der Standort existiert nicht mehr.
• Lösung: Überprüfen Sie die Standortzuordnung des Benutzers in den Benutzereinstellungen (→ Kapitel 22b).

8. Grenzen#

• Das Inhaber-Dashboard ist ein betriebliches Umsatz-Analysetool und kein Buchhaltungsprogramm. Wareneinkaufspreise, Fixkosten und Personallöhne werden nicht gegen gerechnet.
• Das Kassensystem übermittelt Z-Berichte nicht automatisch an die Finanzbehörde; die Aufbewahrung erfolgt im Rahmen der GoBD im Kassensystem und im Kassenbuch.

Dieses Kapitel gehört zum Merkuron-Handbuch für Inhaber und Servicepersonal.