Zum Inhalt
v26.3

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)

„Zur Kasse" flackert und tut nichts (nach Update oder Neustart)

Mit einem aktuellen Box-Update startet die Box die gewählte Kasse beim Hochfahren selbst, wenn nach einem unterbrochenen Update keine Kasse mehr lief. Nicht gestartet wird sie, wenn die Box noch gar nicht als Kasse eingerichtet ist (Einrichtung, abgebrochene Installation). Bleibt die Kasse trotzdem aus:

  • Umstellung auf DiKAS Next begonnen? Solange eine Migration angefangen und nicht abgeschlossen ist, startet die Box die alte Kasse bewusst nicht wieder — eine halb umgestellte Kasse darf nicht weiterbuchen. Support anrufen; er setzt die Migration fort.
  • Box gerade von Ubuntu auf Arch umgebaut? Die Kasse startet erst, wenn die Datenbank-Indizes aufgebaut sind — bei großen Datenbeständen kann das 30–45 Minuten dauern. Abwarten.
  • Sonst: Support anrufen. Er sieht im Box-Protokoll den Grund („Beide Kassen aus … kein Selbststart: …").

Drucker

Bondrucker druckt nicht

  1. Netzwerk prüfen: Ist der Drucker erreichbar? ping [Drucker-IP]
  2. Port prüfen: Standard ESC/POS-Port ist 9100
  3. Druckertest: Admin → Einstellungen → Hardware → Drucker → „Testdruck" Meldet der Testdruck „Kein Hardware-Agent verbunden", läuft die Kasse in der Cloud und erreicht den Drucker im Laden nicht direkt — siehe Hardware-Agent.
  4. 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

  1. 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).
  2. Hardware-Agent bzw. Appliance aktualisieren, Reißleine in der Vorlage erhöhen oder Dichte „Kompakt" wählen.
  3. 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

  1. Verbindung prüfen: ping [Terminal-IP]
  2. Port prüfen: Standard-ZVT-Port ist 20007 — arbeitet Ihr Terminal auf einem anderen Port, muss dieser am Terminal-Eintrag stehen
  3. Terminal neu starten: Aus- und wieder einschalten
  4. 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"

  1. Läuft CouchDB? systemctl status couchdb prüfen
  2. URL korrekt? http://localhost:5984 aufrufen → sollte JSON zeigen
  3. 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.

  1. Kurz warten und die Seite neu laden. Der Index wird beim nächsten Zugriff selbst angelegt; der Aufruf gelingt dann.
  2. Bleibt die Meldung, den Server einmal neu starten — die Einrichtung läuft beim Start erneut.
  3. 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.

Alte Belege aus DiKAS Classic stehen ein bis zwei Stunden zu spät

Betrifft nur Betriebe, die von DiKAS Classic auf DiKAS umgestellt wurden, und nur die übernommenen Altdaten (Belege, Kassenschichten, Tagesabschlüsse aus der Classic-Zeit). Classic speicherte Uhrzeiten als Ortszeit; bei frühen Umstellungen wurden sie als Weltzeit übernommen. Ein Bon von 22:06 Uhr erschien dann um 00:06 Uhr am Folgetag (Sommerzeit +2 Stunden, Winterzeit +1 Stunde).

  • Neue Belege sind nie betroffen. Beträge, Belegnummern, Geschäftstage der Abschlüsse und TSE-Signaturen stimmen.
  • Mit dem Update, das diese Seite mitbringt, übernimmt die Umstellung die Uhrzeiten richtig. Für schon umgestellte Betriebe zieht der Support die Uhrzeiten nach (Bonzeit, TSE-Start/-Ende, Schicht- und Abschlusszeiten); der Geschäftstag bleibt dabei unverändert.
  • Bons kurz nach Mitternacht (0 bis 2 Uhr) behalten als Geschäftstag den Tag, an dem Classic sie gebucht hat — auch wenn Sie einen solchen Altbeleg später in DiKAS stornieren oder die Zahlart ändern.
  • Was Sie tun: Sehen Sie bei Altbelegen eine solche Verschiebung, melden Sie sich beim Support und nennen Sie einen Beispielbon.

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