# 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?[​](#what-is-cloud-printing "Direkter Link zu 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](/de/hardware/printers.md) 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.

Warum ein abfragender Drucker?

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[​](#providers "Direkter Link zu 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[​](#setup "Direkter Link zu 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)[​](#setup-polling "Direkter Link zu Star oder Epson (abfragende Drucker)")

1

#### 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**.

2

#### 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.

3

#### 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[​](#setup-printnode "Direkter Link zu PrintNode")

1

#### 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.

2

#### 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.

3

#### 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.

4

#### 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[​](#setup-star-online "Direkter Link zu 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.

1

#### 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.

2

#### 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.

3

#### 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**.

4

#### 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[​](#auto-print "Direkter Link zu 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.

Die Vorlagenkompatibilität ist wichtig

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](/de/receipts/thermal-templates.md) zum Erstellen von Thermo-Layouts.

## Druckerregeln pro Filiale (Pro)[​](#per-store-printers "Direkter Link zu Druckerregeln pro Filiale (Pro)")

Pro-Funktion

Druckweiterleitung pro Filiale erfordert [WCPOS Pro](/de/getting-started/pro-license.md) und eine [Multi-Store](/de/stores/.md)-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[​](#manual "Direkter Link zu 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[​](#status "Direkter Link zu 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[​](#troubleshooting "Direkter Link zu 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](/de/receipts/thermal-templates.md) oder verwenden Sie einen **PrintNode**-Drucker — PrintNode rendert in PDF und kann daher jede Vorlage drucken.

## Verwandte Dokumentation[​](#related-documentation "Direkter Link zu Verwandte Dokumentation")

[DruckereinrichtungEinen Drucker auf demselben Gerät oder im Netzwerk anschließen](/de/hardware/printers.md)

[VorlagenDas Belegvorlagensystem](/de/receipts/.md)

[ThermovorlagenESC/POS-Layouts für Star- und Epson-Drucker erstellen](/de/receipts/thermal-templates.md)