Drucker einrichten
Die Druckereinstellungen befinden sich im POS unter Einstellungen > Drucker. Jedes Gerät verwaltet seine eigene Druckerkonfiguration — Drucker werden lokal gespeichert und nicht zwischen Geräten synchronisiert.
Diese Seite behandelt Drucker, die per USB, Bluetooth oder über das lokale Netzwerk mit der Kasse verbunden sind. Für einen Drucker in einem anderen Raum oder an einem anderen Standort — oder einen Drucker, den alle Geräte gemeinsam nutzen sollen — siehe Cloud-Druck. Cloud-Drucker, die für Ihre Filiale eingerichtet wurden, erscheinen automatisch in der Druckerliste jedes Geräts — sie müssen hier nicht hinzugefügt werden.
Unterstützte Drucker nach Plattform
Das Formular Drucker hinzufügen passt sich der verwendeten App an — jede Plattform zeigt nur die Verbindungen und Optionen an, die tatsächlich verfügbar sind.
| Plattform | Unterstützte Drucker | Verbindungen |
|---|---|---|
| Web-App | Epson- und Star-Drucker mit integriertem Webserver (Netzwerk); Epson- und Star-Drucker über WebUSB/Web Bluetooth (USB/Bluetooth, nur Chrome/Edge) | Netzwerk (HTTP), USB, Bluetooth |
| Desktop-App | Alle Netzwerk-Bondrucker | Netzwerk (Raw-TCP), USB, Bluetooth |
| iOS-App | Epson und Star | Netzwerk, Bluetooth |
| Android-App | Epson und Star | Netzwerk, Bluetooth, USB |
Webbrowser können keine direkten TCP-Verbindungen öffnen. Bon-Drucker von Epson und Star verfügen über einen integrierten Webserver, der Druckaufträge über HTTP entgegennimmt — dies ist die einzige Möglichkeit, ESC/POS-Befehle von einem Browser an einen Netzwerk-Drucker zu senden. Die Desktop-App unterliegt dieser Einschränkung nicht, da sie sich direkt über TCP verbinden kann.
USB- und Bluetooth-Druck im Browser funktionieren ebenfalls, jedoch nur in Chrome oder Microsoft Edge (diese verwenden die WebUSB- und Web-Bluetooth-APIs) — Safari und Firefox unterstützen dies nicht.
In den mobilen Apps erfolgt der Bluetooth- und USB-Druck über die offiziellen SDKs von Epson und Star, sodass für diese Verbindungen ein Epson- oder Star-Drucker erforderlich ist. Generische Drucker funktionieren nur über das Netzwerk.
Drucker hinzufügen
Druckereinstellungen öffnen
Navigieren Sie zu Einstellungen > Drucker im POS. Wenn noch keine Drucker konfiguriert sind, wird ein leerer Bereich mit einer Schaltfläche Drucker hinzufügen angezeigt. Jeder Drucker erhält einen Druckernamen — lediglich eine Bezeichnung, die automatisch als „Receipt Printer" ausgefüllt wird (dann „Receipt Printer 2" usw.) — die beliebig geändert werden kann, um die Drucker leichter unterscheiden zu können.
Verbindungsart des Druckers wählen
Jede Plattform beginnt mit derselben Frage — Verbindungstyp — und zeigt nur die Optionen an, die diese Plattform unterstützt. Die folgenden Felder werden entsprechend der Auswahl aktualisiert.
- Web-App — Netzwerk, USB oder Bluetooth (USB und Bluetooth erfordern Chrome oder Edge). Bei einem Netzwerk-Drucker wird anschließend der Hersteller ausgewählt — Epson oder Star — da der Browser einen Netzwerkdrucker über den integrierten Webserver der jeweiligen Marke anspricht.
- Desktop-App — Netzwerk, USB oder Bluetooth.
- Mobile-Apps — Netzwerk oder Bluetooth, sowie USB unter Android (iOS unterstützt kein USB).
Drucker identifizieren
Netzwerkdrucker — geben Sie die IP-Adresse ein (zum Beispiel 192.168.1.100). WCPOS prüft die Adresse, um zu erkennen, ob es sich um ein Epson- oder Star-Gerät handelt, und füllt den Port, die Befehlssprache und den Hersteller automatisch aus. Nach Abschluss der Erkennung wird das Label „Erkannt: Epson“ oder „Erkannt: Star“ angezeigt. In der Web-App wird außerdem die genaue Endpunkt-URL angezeigt, mit der die Verbindung hergestellt wird.
Bluetooth- oder USB-Drucker (mobil) — den Drucker aus der Liste der erkannten Geräte auswählen. Bei Auswahl eines Geräts werden Name und Hersteller automatisch eingetragen. Auf Nach Druckern suchen (Bluetooth) oder Aktualisieren (USB) tippen, wenn der Drucker noch nicht aufgeführt ist.
Falls die automatische Erkennung nicht alles korrekt erfasst, können alle Einstellungen unter Erweiterte Einstellungen angepasst werden.
Speichern und Testen
Klicken Sie auf Speichern. WCPOS sendet zuerst einen Testdruck und speichert den Drucker nur, wenn dieser erfolgreich ist.
Der Testdruck ist eine kurze Diagnose — ein nummeriertes Spaltenlineal, zentrierter Text in normaler und doppelter Größe, eine links/rechts-ausgerichtete Zeile und ein Papierschnitt. Er ist so konzipiert, dass die korrekte Konfiguration von Papierbreite, Ausrichtung, Textgröße und Schnitt überprüft werden kann — nicht nur, ob der Drucker erreichbar ist.
Wenn der Test fehlschlägt, wird der Fehler zusammen mit einer Option Ohne Test speichern angezeigt, um das Profil trotzdem zu speichern.
Verbindungsarten
Zunächst wird der Verbindungstyp oben im Formular „Drucker hinzufügen" ausgewählt. Die Verbindungsfelder passen sich entsprechend an. Die verfügbaren Typen hängen von der Plattform ab (siehe Tabelle oben).
Netzwerk
Der Drucker befindet sich im selben WLAN-Netzwerk wie Ihr Gerät. In der Desktop- und Mobil-App können Sie auf Netzwerk scannen tippen, um Drucker automatisch zu erkennen, oder die IP-Adresse manuell eingeben — siehe IP-Adresse Ihres Druckers ermitteln. Die Web-App unterstützt ausschließlich die manuelle IP-Eingabe. In der Desktop- und Mobil-App kann ein Netzwerkdrucker vom Typ Epson, Star oder Generisch sein; in der Web-App muss es Epson oder Star sein, und die Auswahl erfolgt unter der Netzwerkverbindung.
Bluetooth
Der Drucker wird über Bluetooth mit dem Gerät gekoppelt. Wählen Sie Ihren Drucker aus der Liste — Name und Hersteller werden automatisch eingetragen. Auf Mobilgeräten nutzt der Bluetooth-Druck die nativen SDKs von Epson und Star, daher muss es ein Epson- oder Star-Modell sein; im Web funktioniert Bluetooth in Chrome oder Edge über die Web Bluetooth API.
USB
Der Drucker wird über ein USB-Kabel verbunden. Wählen Sie ihn aus der Liste der angeschlossenen Geräte aus. USB ist im Web (Chrome oder Edge, über WebUSB), in der Desktop-App und unter Android verfügbar — jedoch nicht unter iOS, da iOS keine allgemeine USB-Peripherieunterstützung bietet. Auf Mobilgeräten erfordert der USB-Druck einen Epson- oder Star-Drucker.
Die Einstellung Port gilt nur für Netzwerkdrucker — bei Bluetooth- und USB-Verbindungen wird sie ausgeblendet.
Erweiterte Einstellungen
Klappen Sie Erweiterte Einstellungen auf, um die Druckerkonfiguration anzupassen. Die meisten Felder werden automatisch ausgefüllt, sobald der Hersteller erkannt wurde.
Diese Einstellungen gelten auf allen Plattformen:
| Einstellung | Optionen | Beschreibung |
|---|---|---|
| Sprache | ESC/POS, StarPRNT, Star Line Mode | Das Befehlsprotokoll, das der Drucker verwendet. Wird automatisch anhand des erkannten Herstellers ausgefüllt. |
| Druckertextbreite | 58mm (32 Zeichen), 80mm Standard (42 Zeichen), 80mm breit (48 Zeichen) | Wie viele Zeichen in eine Zeile passen. Passen Sie diesen Wert an Ihr Papier und Ihren Drucker an — die meisten 80mm-Drucker verwenden 42 Zeichen pro Zeile, einige 48. |
| Vollständiger Bon als Rasterbild | Aus / Ein | Den gesamten Bon als Bild statt als Text drucken — siehe Vollständiger Bon als Rasterbild weiter unten. |
Diese beiden Einstellungen verhalten sich je nach Plattform und Verbindungstyp unterschiedlich:
| Einstellung | Optionen | Gilt für |
|---|---|---|
| Hersteller | Epson, Star, Generisch | Druckerhersteller. In der Web-App wird der Hersteller direkt unter der Netzwerk-Verbindung ausgewählt (nur Epson oder Star), nicht als erweiterte Einstellung. Generisch ist für Netzwerk-Drucker in den Desktop- und Mobil-Apps verfügbar, jedoch nicht für Bluetooth- oder USB-Verbindungen. |
| Anschluss | Automatisch ausgefüllt | Netzwerkport des Druckers, wird neben der IP-Adresse angezeigt. Nur Netzwerk — bei Bluetooth und USB ausgeblendet. Der Anschluss wird automatisch anhand des Herstellers ausgefüllt (und in der Web-App zusätzlich danach, ob Ihr POS über HTTP oder HTTPS bereitgestellt wird); ändern Sie ihn nur, wenn Ihr Netzwerk ihn umleitet. |
Druckeroptionen
Diese Optionen befinden sich am unteren Rand des Formulars „Drucker hinzufügen“:
| Einstellung | Beschreibung |
|---|---|
| Papier automatisch schneiden | Das Papier nach jedem Beleg automatisch abschneiden |
| Kassenschublade automatisch öffnen | Sendet einen Öffnungsbefehl an eine angeschlossene Kassenschublade nach dem Drucken |
| Als Standard festlegen | Diesen Drucker als Standarddrucker festlegen – wird für alle Belege verwendet, die keinem bestimmten Drucker zugewiesen sind |
Das automatische Drucken eines Belegs nach Abschluss eines Verkaufs ist eine Warenkorb-Einstellung, keine Druckereinstellung – aktivieren Sie Beleg automatisch drucken in den POS-Warenkorb-Einstellungen. Welcher Drucker verwendet wird, hängt von Ihrem Standarddrucker und der druckerspezifischen Vorlagenzuweisung ab.
Druckweiterleitung
Wenn mehr als eine Vorlage verwendet wird — beispielsweise ein Thermobon und eine A4-Rechnung — bestimmt das Druck-Routing, an welchen Drucker jede Vorlage gesendet wird. Das Routing hat drei Ebenen, die in dieser Reihenfolge geprüft werden:
- Überschreibung pro Druckauftrag. Auf dem Belegbildschirm befindet sich neben dem Vorlagenumschalter ein Drucker-Dropdown. Die Auswahl eines Druckers überschreibt alle Einstellungen für diesen einen Druckauftrag. Beim Wechsel der Vorlage wird die Auswahl auf Auto zurückgesetzt.
- Einstellungsüberschreibung. Unter Einstellungen → Druckerzuweisung kann jeder Vorlage ein bestimmter Drucker zugewiesen werden. So lässt sich beispielsweise der thermische Kassenbon an den Epson-Netzwerkdrucker und die HTML-Rechnung an den Systemdruckdialog weiterleiten. Um die Zuweisung aufzuheben, wird die Vorlage auf Automatisch zurückgesetzt.
- Automatische Zuordnung. Wenn keine manuelle Zuweisung festgelegt ist, ordnet WCPOS automatisch zu:
- Thermovorlagen werden an Thermodrucker weitergeleitet, deren Zeichenbreite übereinstimmt. Eine 58mm-Thermovorlage bevorzugt 32-Spalten-Drucker; eine 80mm-Vorlage bevorzugt 42- oder 48-Spalten-Drucker.
- HTML-Vorlagen werden an den Systemdruckdialog weitergeleitet.
- Wenn mehrere Drucker übereinstimmen, wird der Standarddrucker verwendet.
Wenn eine Vorlage manuell an einen inkompatiblen Drucker gesendet wird — beispielsweise eine Thermovorlage an den Systemdialog — erscheint auf dem Belegbildschirm eine gelbe Inkompatibilitätswarnung. Der Druck wird trotzdem ausgeführt, die Ausgabe wird jedoch möglicherweise nicht korrekt dargestellt.
Routing-Zuweisungen werden pro Gerät gespeichert. Jedes iPad, Smartphone oder jeder Computer verwaltet seine eigene Zuordnung — es gibt keine serverseitige Synchronisation.
Die Seite für Druckrouting-Einstellungen wird erst angezeigt, wenn mindestens ein Drucker hinzugefügt wurde. Ohne konfigurierte Drucker verwenden alle Vorlagen implizit den Systemdruckdialog. Cloud-Drucker, die für die Filiale eingerichtet wurden, zählen ebenfalls — sie erscheinen automatisch als Routing-Ziele, ohne auf dem Gerät hinzugefügt werden zu müssen.
Vollständige Belegrastergrafik
Standardmäßig sendet WCPOS Belege als Text an Thermodrucker — schnell, kompakt und gestochen scharf, unter Verwendung der integrierten Druckerschriftarten. Der Nachteil: Thermodrucker-Schriftarten decken nur einen begrenzten Zeichensatz ab. Schriftsysteme, für die der Drucker keine Schriftart besitzt — viele nicht-lateinische Alphabete, Rechts-nach-links-Schrift, einige Sonderzeichen — können als leere Kästchen oder fehlerhafte Zeichen ausgegeben werden.
Die vollständige Belegrastergrafik behebt dieses Problem. Wenn diese Option aktiviert ist, rendert WCPOS den gesamten Beleg als Bild und sendet dieses Bild an den Drucker, sodass der Ausdruck exakt dem entspricht, was auf dem Bildschirm angezeigt wird — in jeder Sprache und jedem Schriftsystem.
Aktivieren Sie es pro Drucker unter Erweiterte Einstellungen. Wichtige Hinweise:
- Es ist langsamer. Ein Bild ist wesentlich größer als eine Textzeile, sodass der Bon länger zum Senden und Drucken benötigt.
- Nur bei Bedarf verwenden. Wenn Ihre Bons als Text einwandfrei gedruckt werden, lassen Sie es deaktiviert.
- Dies gilt für Thermodrucker über jede Verbindung (Netzwerk, Bluetooth, USB). Es gilt nicht für den Systemdruckdialog, der bereits aus einem ganzseitigen Rendering druckt.
Drucker erkennen
Wie ein Drucker gefunden wird, hängt von der Verbindungsart ab:
- Bluetooth und USB — In den mobilen Apps tippen Sie auf Nach Druckern suchen (Bluetooth) oder Aktualisieren (USB) und wählen Ihren Drucker aus der Liste aus; Name und Hersteller werden automatisch eingetragen. Im Web (Chrome oder Edge) klicken Sie auf Verbinden und wählen den Drucker aus dem Geräteauswahldialog des Browsers.
- Netzwerk — In der Desktop- und den mobilen Apps tippen Sie auf Netzwerk durchsuchen, um Drucker in Ihrem lokalen Netzwerk automatisch zu finden (die Desktop-App erkennt sie über mDNS/Bonjour; die mobilen Apps verwenden die Epson- und Star-SDKs), und wählen dann Ihren Drucker aus der Liste. Sie können die IP-Adresse auch direkt eingeben — siehe IP-Adresse Ihres Druckers ermitteln weiter unten. Browser können keine Netzwerke durchsuchen, daher verwendet die Web-App immer die manuelle IP-Eingabe.
IP-Adresse Ihres Druckers ermitteln
Die meisten Bondrucker können eine Selbsttestseite drucken, die die IP-Adresse enthält:
- Epson: Halten Sie die Vorschubtaste gedrückt, während Sie den Drucker einschalten
- Star: Halten Sie die Vorschubtaste 5 Sekunden lang gedrückt, während der Drucker eingeschaltet ist
Alternativ können Sie die Liste der verbundenen Geräte in Ihrem Router oder das Konfigurationsprogramm Ihres Druckers überprüfen.
Statische IP empfohlen
Bondrucker sollten eine statische IP-Adresse verwenden, damit sich die Adresse beim Neustart des Druckers nicht ändert. Diese kann auf zwei Arten konfiguriert werden:
- Über die integrierte Weboberfläche des Druckers (in der Regel erreichbar unter
http://<printer-ip>) - Über die DHCP-Einstellungen Ihres Routers (weisen Sie der MAC-Adresse des Druckers eine reservierte IP zu)
Epson-Drucker
Epson-Drucker mit ePOS-Unterstützung kommunizieren über HTTP. WCPOS sendet SOAP/XML-Anfragen an den integrierten Webserver des Druckers.
Verbindungsdetails:
- Anschluss
8008(HTTP) oder8043(HTTPS) — wird automatisch ausgefüllt, je nachdem, ob Ihr POS über HTTP oder HTTPS bereitgestellt wird - Endpunkt:
/cgi-bin/epos/service.cgi
Bestätigte funktionierende Modelle:
- Epson TM-T70-i 2 (Netzwerk)
- Epson TM-m30iii (mit Printus-Middleware)
Stellen Sie sicher, dass ePOS in der Konfiguration Ihres Epson-Druckers aktiviert ist. Rufen Sie die Weboberfläche des Druckers unter http://<printer-ip> auf, um die ePOS-Einstellungen zu überprüfen und zu aktivieren.
In den mobilen Apps können Epson-Drucker auch über Bluetooth oder USB mit dem nativen SDK von Epson verbunden werden — keine IP-Adresse oder ePOS-Webserver erforderlich.
Star-Drucker
Star-Drucker mit WebPRNT-Unterstützung kommunizieren über HTTP. WCPOS sendet Befehle an den Star-WebPRNT-Endpunkt.
Verbindungsdetails:
- Anschluss
80(HTTP) oder443(HTTPS) — wird automatisch ausgefüllt, je nachdem ob das POS über HTTP oder HTTPS bereitgestellt wird - Endpunkt:
/StarWebPRNT/SendMessage
In den mobilen Apps können Star-Drucker auch über Bluetooth oder USB mittels Stars nativem SDK verbunden werden.
Generische Drucker
Die Desktop-App unterstützt jeden Netzwerk-Bondrucker über Raw-TCP. Geben Sie die IP-Adresse und den Anschluss des Druckers ein (in der Regel 9100). Dies funktioniert mit den meisten Thermodruckern unabhängig vom Hersteller, solange diese ESC/POS-Befehle akzeptieren.
In den mobilen Apps werden generische Drucker ebenfalls unterstützt — allerdings nur über Netzwerk-Verbindungen, nicht über Bluetooth oder USB (dafür wird ein Epson- oder Star-Drucker benötigt). Die Web-App unterstützt keine generischen Drucker.
Kassenschubladen
An einen Bondrucker angeschlossene Kassenschubladen können nach jedem Verkauf automatisch ausgelöst werden:
- Aktivieren Sie Kassenschublade automatisch öffnen in den Druckeroptionen
- Das POS sendet nach dem Drucken einen ESC/POS-Kick-Befehl
Die Steuerung der Kassenschublade erfordert ein Thermodrucker-Profil — der Browser-Druckdialog kann keine Kassenschubladen auslösen.
Fehlerbehebung
Drucker wird bei der Einrichtung nicht erkannt
- Stellen Sie sicher, dass der Drucker eingeschaltet und mit demselben Netzwerk wie Ihr Gerät verbunden ist
- Für Netzwerkdrucker: Verwenden Sie in der Desktop- oder Mobil-App Netzwerk scannen, um den Drucker automatisch zu finden. Andernfalls überprüfen Sie, ob die IP-Adresse korrekt ist (drucken Sie eine Selbsttestseite).
- Für die Web-App: Bestätigen Sie, dass der Drucker ein Epson- oder Star-Modell mit ePOS-/WebPRNT-Unterstützung ist
- Für die Desktop-App: Versuchen Sie die Option „Generic" als Hersteller mit Anschluss 9100
- Für Bluetooth: Koppeln Sie den Drucker zunächst in den Bluetooth-Einstellungen Ihres Geräts und tippen Sie dann auf Nach Druckern suchen
- Für USB (Android): Überprüfen Sie das Kabel und bestätigen Sie die USB-Berechtigungsaufforderung, falls eine erscheint
- Überprüfen Sie, dass keine Firewall die Verbindung blockiert
Drucker erkannt, aber es wird nichts gedruckt
- Papierrolle überprüfen — sie könnte leer oder verklemmt sein
- Überprüfen Sie, ob die Einstellung Druckertextbreite zu Ihrem Papier passt (58 mm oder 80 mm)
- Versuchen Sie, einen Selbsttest direkt vom Drucker aus zu drucken, um die Funktionsfähigkeit zu bestätigen
- Überprüfen Sie, ob die Befehlssprache zu Ihrem Drucker passt (ESC/POS für Epson, StarPRNT oder Star Line Mode für Star)
Bon ist verstümmelt oder enthält falsche Zeichen
- Die Einstellung der Befehlssprache ist möglicherweise falsch — versuchen Sie, zwischen ESC/POS, StarPRNT und Star Line Mode zu wechseln
- Stellen Sie sicher, dass die Einstellung Druckertextbreite korrekt ist
- Wenn der Bon in einer nicht-lateinischen Schrift oder einer Rechts-nach-links-Sprache verfasst ist, aktivieren Sie Vollständiger Bon als Rasterbild in den erweiterten Einstellungen — der Bon wird dann als Bild gedruckt, sodass jede Sprache korrekt dargestellt wird
Kassenschublade öffnet sich nicht
- Vergewissern Sie sich, dass Kassenschublade automatisch öffnen in den Druckeroptionen aktiviert ist
- Überprüfen Sie, ob die Schublade am DK-Anschluss des Druckers angeschlossen ist (nicht an einer separaten Stromquelle)
- Nicht alle Drucker unterstützen den Schubladenöffnungsbefehl — ziehen Sie die Dokumentation Ihres Druckers zu Rate
Verbindung über die Web-App nicht möglich
- Über das Netzwerk erreicht die Web-App nur Epson- und Star-Drucker (über deren integrierte Webserver) — generische Raw-Netzwerkdrucker werden im Browser nicht unterstützt; verwenden Sie die Desktop- oder Mobil-App oder einen Cloud-Drucker
- USB- und Bluetooth-Drucker funktionieren im Web, jedoch nur in Chrome oder Microsoft Edge (Safari und Firefox unterstützen die WebUSB-/Web-Bluetooth-APIs nicht)
- Wenn Ihre Website HTTPS verwendet, der Drucker jedoch nur HTTP unterstützt, blockiert der Browser die Verbindung möglicherweise als Mixed Content — der Drucker muss dasselbe Protokoll (HTTP/HTTPS) wie Ihr POS verwenden
Bluetooth-Drucker verbindet sich nicht (Mobilgerät)
- Koppeln Sie den Drucker zunächst in den Bluetooth-Einstellungen Ihres Geräts, bevor Sie ihn in WCPOS hinzufügen
- Bluetooth-Druck unterstützt ausschließlich Epson- und Star-Drucker — generische Bluetooth-Drucker werden nicht unterstützt
- Falls der Drucker nicht in der Liste erscheint, tippen Sie erneut auf Nach Druckern suchen und stellen Sie sicher, dass er eingeschaltet und in Reichweite ist