Cloud-Druck
Cloud-Druck ermöglicht es WCPOS, Belege an einen Drucker zu senden, der nicht direkt mit dem Gerät verbunden ist, auf dem die Kasse läuft. Richten Sie ihn einmal in WP Admin ein, und Ihre Bestellungen werden auf einem Küchendrucker, einem Backoffice-Drucker oder einem Drucker in einem anderen Raum gedruckt — ohne dass jedes Gerät die Hardware selbst erkennen und mit ihr koppeln muss.
Was ist Cloud-Druck?
Beim lokalen Druck kommuniziert das Gerät, auf dem das POS läuft, direkt mit dem Drucker über USB, Bluetooth oder das lokale Netzwerk. Das ist die richtige Wahl, wenn der Drucker direkt neben der Kasse steht — siehe Druckereinrichtung zum Anschließen von USB-, Bluetooth- und Netzwerkdruckern auf demselben Gerät.
Cloud-Druck ist für alles andere gedacht: ein Drucker an einem anderen Standort, in einem anderen Netzwerk oder einen, den jedes Gerät gemeinsam nutzen soll, ohne ihn auf jedem einzelnen konfigurieren zu müssen. Es gibt zwei Zustellmodelle:
- Abfragende Drucker (Polling). Der Drucker kontaktiert WCPOS in regelmäßigen Abständen über das Internet, fragt „Haben Sie etwas für mich?" und holt sich alle wartenden Aufträge ab. WCPOS verbindet sich nie mit dem Drucker — der Drucker beginnt die Kommunikation immer selbst. So funktionieren Star CloudPRNT und Epson Server Direct Print.
- Gehostete Relay-Anbieter. WCPOS übermittelt den Druckauftrag an einen gehosteten Dienst, und dieser Dienst stellt ihn an den Drucker zu. So funktionieren Star Online und PrintNode. Star Online stellt an Star-CloudPRNT-Drucker zu, die in Ihrem stario.online-Konto registriert sind; PrintNode stellt über seinen Desktop-Client an nahezu jeden Drucker zu, auf dem dieser Computer bereits drucken kann.
Ein abfragender Drucker benötigt keinen offenen Port, keine statische IP-Adresse und keine Firewall-Änderungen — er stellt immer nur ausgehende Anfragen. Das macht ihn ideal für einen Drucker an einem entfernten Standort oder hinter einem Router, den Sie nicht kontrollieren. Der Nachteil ist eine kurze Verzögerung: Der Drucker druckt erst, wenn seine nächste Abfrage ansteht.
Einen Anbieter auswählen
Wählen Sie den Anbieter, der zu Ihrer Hardware passt.
Star CloudPRNT
Für Star-Thermodrucker mit der CloudPRNT-Firmware. Der Drucker fragt WCPOS ab und holt sich Aufträge. Belege werden in die nativen Befehle des Druckers umgewandelt. Benötigt eine Thermovorlage.
Star Online
Für Star-Drucker, die in einem stario.online-Konto registriert sind. WCPOS übermittelt Star Document Markup an den gehosteten Dienst von Star, und der Drucker holt es von Star Online ab. Benötigt eine Thermovorlage.
Epson Server Direct Print
Für Epson-ePOS-Drucker, die Server Direct Print unterstützen. Der Drucker fragt WCPOS ab und holt sich Aufträge als ePOS-Print-XML. Benötigt eine Thermovorlage.
PrintNode
Funktioniert mit praktisch jedem Drucker, auf dem Ihr Computer drucken kann, auf jedem Betriebssystem, über den PrintNode-Desktop-Client. WCPOS übermittelt ein PDF, sodass Sie jede Vorlage verwenden können — einschließlich ganzseitiger HTML-Rechnungen.
| Anbieter | Hardware | Wie die Aufträge fließen | Vorlagen |
|---|---|---|---|
| Star CloudPRNT | Star-Thermodrucker mit CloudPRNT-Firmware | Drucker fragt WCPOS ab | Nur Thermo |
| Star Online | Star-Drucker, registriert in stario.online | WCPOS übermittelt Star Document Markup an Star Online | Nur Thermo |
| Epson Server Direct Print | Epson-ePOS-Drucker mit Server Direct Print | Drucker fragt WCPOS ab | Nur Thermo |
| PrintNode | Jeder über das Betriebssystem verbundene Drucker + PrintNode-Client | WCPOS übermittelt ein PDF an PrintNode | Jede Vorlage |
Einen Cloud-Drucker einrichten
Cloud-Drucker werden einmal in WP Admin konfiguriert und über alle Geräte hinweg gemeinsam genutzt — anders als lokale Drucker, die pro Gerät gespeichert werden.
Gehen Sie zu WP Admin > POS > Einstellungen > Cloud-Druck und klicken Sie auf Drucker hinzufügen. Geben Sie ihm einen Namen (zum Beispiel „Küche" oder „Backoffice"). WCPOS leitet automatisch eine stabile Drucker-ID vom Drucker ab — sie ändert sich nie, sodass sie sicher aus der Firmware-Konfiguration eines Druckers referenziert werden kann.
Nachdem der Drucker angelegt wurde, konfigurieren Sie die Anbieterseite.
Star oder Epson (abfragende Drucker)
Den Drucker in WCPOS hinzufügen
Fügen Sie unter WP Admin > POS > Einstellungen > Cloud-Druck einen Drucker hinzu und wählen Sie Star CloudPRNT oder Epson Server Direct Print als Anbieter. WCPOS generiert für diesen Drucker eine Abfrage-URL und einen Einmal-Token.
Die Abfrage-URL und den Token kopieren
Kopieren Sie die generierte Abfrage-URL und den Token. Der Token wird nur einmal angezeigt — wenn Sie ihn verlieren, generieren Sie über die Druckerkarte einen neuen und aktualisieren Sie den Drucker mit dem neuen Wert.
Sie in die Konfiguration des Druckers eintragen
Öffnen Sie die Konfigurationsseite des Druckers — die CloudPRNT-Einstellungen für Star oder die Server Direct Print-Einstellungen für Epson — und fügen Sie die Abfrage-URL und den Token ein. Stellen Sie das Abfrageintervall ein, falls der Drucker eines verlangt (einige Sekunden sind üblich). Speichern Sie und starten Sie den Drucker bei Bedarf neu.
Innerhalb eines Abfragezyklus meldet sich der Drucker, und sein Status in WCPOS wechselt von Wartend zu Verbunden.
PrintNode
Den PrintNode-Desktop-Client installieren
Installieren Sie auf einem Computer, der bereits auf Ihrem Zieldrucker drucken kann, den PrintNode-Client und melden Sie sich an. Der Client muss laufen und online bleiben, damit Aufträge gedruckt werden.
Einen PrintNode-API-Schlüssel erhalten
Erstellen Sie in Ihrem PrintNode-Konto einen API-Schlüssel. Damit kann WCPOS Aufträge an Ihr PrintNode-Konto übermitteln.
Den API-Schlüssel in WCPOS eintragen
Fügen Sie unter WP Admin > POS > Einstellungen > Cloud-Druck einen Drucker hinzu, wählen Sie PrintNode als Anbieter und fügen Sie den API-Schlüssel ein. WCPOS verwendet ihn, um die Liste der in Ihrem PrintNode-Konto registrierten Drucker abzurufen.
Den Drucker auswählen
Wählen Sie den Zieldrucker aus der Liste der vom PrintNode-Client gemeldeten Drucker und speichern Sie. WCPOS übermittelt Aufträge für diesen Drucker an PrintNode, und der Client druckt sie.
Star Online
Verwenden Sie Star Online, wenn Ihr Star-Drucker bereits in einem stario.online-Konto registriert ist und Sie möchten, dass der gehostete Dienst von Star die Zustellung übernimmt.
Die CloudPRNT-URL erhalten
Öffnen Sie in stario.online die Device Groups und kopieren Sie die CloudPRNT-URL der Gruppe. Sie sollte wie https://device.stario.online/cloudprnt/... oder https://eu-device.stario.online/cloudprnt/... aussehen.
Einen API-Schlüssel mit Berechtigungen erstellen
Erstellen Sie in stario.online einen API-Schlüssel für WCPOS. Der Schlüssel muss die Berechtigung haben, Geräte aufzulisten und auf ihnen zu drucken. Aktivieren Sie mindestens:
- EnumDevices — erforderlich, wenn WCPOS die Geräteliste abruft
- ViewDevice — wird für Gerätestatusprüfungen verwendet
- PrintToDevice — erforderlich zum Übermitteln von Druckaufträgen
- ViewDeviceGroups — empfohlen für Gruppensuche und Diagnose
Ein API-Schlüssel kann existieren und dennoch fehlschlagen, wenn diese Berechtigungen nicht aktiviert sind.
Die URL und den API-Schlüssel in WCPOS eintragen
Fügen Sie unter WP Admin > POS > Einstellungen > Cloud-Druck einen Drucker hinzu, wählen Sie Star Online als Anbieter und fügen Sie dann die CloudPRNT-URL und den API-Schlüssel ein. Klicken Sie auf Meine Geräte abrufen.
Das Star-Gerät auswählen
Wählen Sie den Drucker aus der Geräteliste und speichern Sie. WCPOS speichert den API-Schlüssel serverseitig und verwendet die Zugriffskennung des ausgewählten Geräts beim Übermitteln von Aufträgen an Star Online.
Automatische Druckregeln
Automatische Druckregeln entscheiden, was wo gedruckt wird — automatisch und als einfache Sätze formuliert. Eine Regel ist Geltungsbereich × Drucker × Vorlage, zum Beispiel:
Drucke jede Bestellung auf Küche mit Küchenbon.
Wenn eine passende Bestellung abgeschlossen wird, rendert WCPOS die gewählte Vorlage serverseitig in das vom Drucker benötigte Format und reiht sie in die Warteschlange ein — der Kassierer muss nichts tun.
Star- und Epson-Drucker können nur Thermo-Vorlagen verwenden, weil der Auftrag in die native Befehlssprache des Druckers gerendert werden muss (Star Document Markup oder ESC/POS für Star, ePOS-Print für Epson). PrintNode kann jede Vorlage verwenden — Thermo oder ganzseitiges HTML — weil der Auftrag in ein PDF gerendert wird. Wenn eine Vorlage für einen Drucker nicht als Option erscheint, liegt das daran, dass der Drucker dieses Format nicht rendern kann. Siehe Thermovorlagen zum Erstellen von Thermo-Layouts.
Druckerregeln pro Filiale (Pro)
Druckweiterleitung pro Filiale erfordert WCPOS Pro und eine Multi-Store-Einrichtung.
Standardmäßig sind automatische Druckregeln global — jede Filiale teilt sie sich. Mit Pro können Sie einer einzelnen Filiale ihre eigenen Cloud-Druckregeln geben, sodass ihre Bestellungen auf ihren eigenen Druckern gedruckt werden (ein Küchenbon an einem Standort sollte nicht an einem anderen gedruckt werden).
Bearbeiten Sie eine Filiale unter POS → Filialen, öffnen Sie deren Abschnitt Cloud-Druck und Regel hinzufügen. Jede Regel besteht aus:
- Drucker-ID — die stabile ID des Cloud-Druckers, an den gesendet werden soll
- Geltungsbereich — Nur POS-Bestellungen (Standard), Nur Online-Bestellungen oder Jede Bestellung
- Format — StarPRNT (Standard), ESC/POS, Epson ePOS-Print oder HTML
Wenn eine Bestellung zu einer Filiale gehört, die ihre eigenen Regeln hat, leitet WCPOS sie an die Drucker dieser Filiale weiter. Wenn eine Filiale keine eigenen Regeln hat, greift sie auf die globalen automatischen Druckregeln zurück — Sie müssen also nur die Filialen konfigurieren, die abweichen.
Manueller Druck
Sie müssen nicht auf eine automatische Druckregel warten. Vom Checkout-/Belegbildschirm aus kann ein Kassierer bei Bedarf einen Beleg an einen Cloud-Drucker senden — praktisch für Nachdrucke oder um einen einmaligen Bon an einen bestimmten Drucker weiterzuleiten.
Wie der Beleg erzeugt wird, hängt vom Drucker ab:
- Star CloudPRNT — der Beleg wird auf dem Gerät gerendert und über CloudPRNT an den Drucker übergeben.
- Star Online, Epson und PrintNode — der Beleg wird auf dem Server aus der ausgewählten Bestellung und Vorlage gerendert und dann an den Drucker oder das gehostete Relay zugestellt.
Testdruck & Verbindungsstatus
Jede Druckerkarte hat eine Schaltfläche Testdruck, die eine kurze Diagnose sendet, damit Sie bestätigen können, dass der Drucker erreichbar ist und das Format stimmt, bevor Sie sich für echte Bestellungen darauf verlassen.
Die Karte zeigt außerdem einen Live-Status:
| Anbieter | Status | Bedeutung |
|---|---|---|
| Star CloudPRNT / Epson | Wartend | Der Drucker hat sich noch nicht gemeldet — WCPOS wartet auf seine erste Abfrage. |
| Star CloudPRNT / Epson | Verbunden | Der Drucker hat WCPOS kürzlich abgefragt und holt Aufträge ab. |
| Star Online | Online | Star Online meldet, dass das ausgewählte Gerät verfügbar ist. |
| Star Online | Offline | Star Online meldet, dass das ausgewählte Gerät nicht verfügbar ist. |
| Star Online | Unbekannt | WCPOS konnte den Gerätestatus von Star Online nicht bestätigen. |
| PrintNode | Online | Der PrintNode-Dienst meldet, dass Client und Drucker verfügbar sind. |
| PrintNode | Offline | PrintNode meldet, dass der Client oder Drucker nicht verfügbar ist. |
Fehlerbehebung
Drucker bleibt bei Wartend hängen
Ein abfragender Drucker, der Wartend nie verlässt, hat WCPOS nie erfolgreich erreicht. Überprüfen Sie:
- Die Abfrage-URL und der Token in der Firmware des Druckers stimmen genau mit dem überein, was WCPOS generiert hat. Ein einziges falsches Zeichen führt dazu, dass jede Abfrage abgelehnt wird — generieren Sie den Token in WCPOS neu und geben Sie ihn erneut ein, wenn Sie unsicher sind.
- Der Drucker kann Ihre Website tatsächlich über das Internet erreichen (korrektes DNS, keine Firewall, die ausgehendes HTTPS blockiert, gültiges SSL-Zertifikat auf Ihrem Shop).
- Das Abfragen ist aktiviert in der CloudPRNT-/Server-Direct-Print-Konfiguration des Druckers, mit einem sinnvollen Intervall. Starten Sie den Drucker nach dem Ändern seiner Einstellungen neu.
Star Online meldet, dass der API-Schlüssel nicht autorisiert oder verboten ist
Star Online trennt Authentifizierung von Berechtigungen:
- 401 / Authentifizierung fehlgeschlagen bedeutet, dass der API-Schlüssel selbst nicht akzeptiert wurde. Prüfen Sie, ob der Schlüssel korrekt kopiert wurde, nicht widerrufen wurde und zum erwarteten Star-Online-Konto/zur erwarteten Region gehört.
- 403 / verboten bedeutet, dass der API-Schlüssel akzeptiert, aber für die angeforderte Aktion nicht autorisiert wurde. Bearbeiten Sie den Schlüssel in stario.online und aktivieren Sie die erforderlichen Berechtigungen, insbesondere EnumDevices für Meine Geräte abrufen und PrintToDevice zum Drucken.
Wenn Meine Geräte abrufen erfolgreich ist, aber keine Drucker erscheinen, prüfen Sie die Seite Device Groups in stario.online. Die Gruppe muss mindestens ein verbundenes Gerät enthalten, und die CloudPRNT-URL in WCPOS muss auf dieselbe Gruppe verweisen.
PrintNode-Auftrag wird nie gedruckt
Der Auftrag hat PrintNode erreicht, kam aber nicht aus dem Drucker heraus. Überprüfen Sie:
- Der PrintNode-Desktop-Client läuft und ist online auf dem Computer, der mit dem Drucker verbunden ist. Wenn der Computer im Ruhezustand ist oder der Client geschlossen wurde, wird nichts gedruckt.
- Sie haben in WCPOS den richtigen Drucker ausgewählt — der Name muss mit dem Drucker übereinstimmen, den der Client meldet.
- Der API-Schlüssel ist gültig und wurde nicht widerrufen. Geben Sie ihn erneut ein, wenn PrintNode den Drucker als Offline anzeigt.
Meine Vorlage ist für einen Star- oder Epson-Drucker nicht auswählbar
Nur Thermo-Vorlagen funktionieren auf Star- und Epson-Cloud-Druckern, weil der Beleg in ESC/POS- oder ePOS-Print-Befehle gerendert werden muss. HTML- und ganzseitige Vorlagen lassen sich in diesen Formaten nicht ausdrücken, daher werden sie für diese Drucker ausgeblendet.
Wählen Sie entweder eine Thermovorlage oder verwenden Sie einen PrintNode-Drucker — PrintNode rendert in PDF und kann daher jede Vorlage drucken.