Fehlerbehebung (für IT-Betreuer)¶

Hier finden Sie technische Lösungen für häufige Probleme — mit Server-Kommandos und Netzwerk-Diagnose.

Es brennt gerade im Betrieb?

Für den Stress-Moment an der Kasse gibt es die Notfall-Hilfe — Klartext-Schritte ohne Technik-Wissen: Drucker streikt, EC-Terminal offline, Internet weg, TSE-Symbol rot.

Anmeldung¶

„Benutzername oder Passwort falsch"¶

Standard-Login: admin / admin (nach Neuinstallation)
Passwort vergessen: Datenbank-Reset oder Backup einspielen
Caps Lock: Prüfen Sie, ob die Feststelltaste aktiv ist

„Verbindung zum Server fehlgeschlagen"¶

Ist der Server erreichbar? Testen: https://[Server-IP]/healthz
Firewall-Regeln: Die Ports 443 und 80 müssen zur Hauptkasse freigegeben sein (80 leitet nur auf HTTPS um)

Drucker¶

Bondrucker druckt nicht¶

Netzwerk prüfen: Ist der Drucker erreichbar? ping [Drucker-IP]
Port prüfen: Standard ESC/POS-Port ist 9100
Druckertest: Admin → Einstellungen → Drucker → „Testseite"
Kabelverbindung: RJ45-Kabel am Drucker prüfen

Umlaute oder Eurozeichen falsch gedruckt¶

Der Drucker druckt „ä, ö, ü" als griechische oder andere fremde Zeichen, oder statt „€" ein Kästchen.
Ursache: die Zeichentabelle des Geräts passt nicht. Ab Werk lässt DiKAS die Tabelle des Druckers unverändert — stellen Sie zuerst sicher, dass im Feld Zeichentabelle (ESC t) nichts Geratenes steht.
Lösung: Admin → Einstellungen → Drucker → Zeichentabelle (ESC t): die Nummer der Tabelle 858 aus dem Druckerhandbuch eintragen (Epson-kompatibel meist 19), danach Testdruck. Anleitung: Einstellungen → Umlaute oder € falsch.
Alternative: Rechnungsbon auf Grafik umstellen — als Bild kommen alle Zeichen auf jedem Drucker richtig an.

Grafik-Bon eingeschaltet, es kommt ein Textbon¶

In der Kasse Menü → Drucker öffnen, Abschnitt „Rückfälle auf Text": dort steht je Beleg der Grund (Drucker/Hardware-Agent zu alt, Bon länger als die Reißleine, Schrift nicht ladbar).
Hardware-Agent bzw. Appliance aktualisieren, Reißleine in der Vorlage erhöhen oder Dichte „Kompakt" wählen.
Mit „Testdruck auf Papier" im Bon-Editor prüfen.

Grafik-Bon rechts abgeschnitten¶

Fehlen rechts Preise oder Adresse, hat der 80-mm-Drucker nur 512 druckbare Punkte.
Admin → Einstellungen → Drucker → Grafikbreite auf 512 stellen.

Gutschein-Scanner liest den Gutschein nicht¶

Gutscheine tragen nur noch einen QR-Code, keinen Strichcode. Ein reiner 1D-Laserscanner kann ihn nicht lesen — 2D-Imager verwenden oder die aufgedruckte Gutschein-Nummer eintippen.

Küchendrucker druckt falsche Artikel¶

Prüfen Sie die Drucker-Zuordnung: - Admin → Artikel → Artikelgruppe → Druckeroptionen - Ist die richtige Gruppe dem richtigen Drucker zugewiesen?

Kassenlade öffnet nicht¶

Die Kassenlade wird über den Bondrucker angesteuert (RJ11-Kabel): 1. Kabel vom Drucker zur Lade prüfen 2. Admin → Einstellungen → Drucker → „Kassenlade öffnen bei Zahlung" aktivieren

EC-Terminal¶

Terminal reagiert nicht¶

Verbindung prüfen: ping [Terminal-IP]
Port prüfen: Standard-ZVT-Port ist 20007 — arbeitet Ihr Terminal auf einem anderen Port, muss dieser am Terminal-Eintrag stehen
Terminal neu starten: Aus- und wieder einschalten
Einstellungen prüfen: Admin → Einstellungen → EC-Terminal → IP und Port

„Terminal meldet Fehler"¶

Timeout: Zu langsame Verbindung → Timeout in den Einstellungen erhöhen
Betrag 0: Mindestbetrag des Acquirers nicht erreicht
Karte abgelehnt: Problem der Bank, nicht von DiKAS

Tische¶

Tisch lässt sich nicht schließen¶

Prüfen Sie, ob alle Positionen bezahlt sind
Offene Bestellungen müssen erst kassiert oder storniert werden

Tisch ist dauerhaft rot (belegt)¶

Möglicherweise offene Bestellungen aus einem abgestürzten Vorgang
Admin → Kassenbuch → Offene Bons des Tisches prüfen und ggf. stornieren

Datenbank¶

„CouchDB nicht erreichbar"¶

Läuft CouchDB? systemctl status couchdb prüfen
URL korrekt? http://localhost:5984 aufrufen → sollte JSON zeigen
Zugangsdaten korrekt?

Datenbank ist voll¶

CouchDB: Kompaktierung durchführen → Admin → System → „Datenbank kompaktieren"
SQLite: Dateigröße prüfen, alte Tagesabschlüsse archivieren

„Datenbank-Index fehlt — Initialisierung pruefen"¶

Diese Meldung erscheint, wenn eine Liste (Artikel, Kunden, Belege …) nicht beantwortet werden kann, weil der zugehörige Datenbank-Index noch nicht angelegt ist — typischerweise kurz nach dem erstmaligen Einrichten einer Datenbank oder direkt nach einer Wiederherstellung.

Kurz warten und die Seite neu laden. Der Index wird beim nächsten Zugriff selbst angelegt; der Aufruf gelingt dann.
Bleibt die Meldung, den Server einmal neu starten — die Einrichtung läuft beim Start erneut.
Kommt sie danach immer noch, den Support verständigen und die Meldung mitschicken. Sie nennt die betroffene Datenart im Klartext.

Wichtig: Es gehen dabei keine Daten verloren. DiKAS meldet in diesem Fall ausdrücklich einen Fehler, statt eine leere Liste zu zeigen — eine leere Liste wäre von „es gibt wirklich nichts" nicht zu unterscheiden.

Performance¶

System ist langsam¶

Zu viele Artikel? Nicht aktive Artikel deaktivieren statt alle laden
Alte Daten: Archivieren Sie Daten älter als 2 Jahre
Server-Ressourcen: RAM und CPU prüfen (mindestens 4 GB RAM empfohlen)
Browser-Cache: Leeren Sie den Browser-Cache (Ctrl+Shift+Delete)

Küchemonitor reagiert verzögert¶

SignalR-Verbindung prüfen: Browser-Konsole (F12) → Netzwerk-Tab → WebSocket-Verbindung
WLAN-Signal am Küchen-Bildschirm prüfen
Ethernet-Kabel statt WLAN verwenden

Backup & Restore¶

Die Datensicherung läuft automatisch über die DiKAS-Cloud — Sie müssen nichts selbst sichern. Sollten Daten wiederhergestellt werden müssen (z. B. nach einem Gerätetausch), hilft der DiKAS-Support.

Kontakt & Support¶

Wenn Sie nicht weiterkommen: - E-Mail: support@dikas.de - Telefon: (Siehe Ihren Vertrag) - Remote-Support: TeamViewer/AnyDesk-Sitzung vereinbaren