# Impression dans le cloud

L'impression dans le cloud permet à WCPOS d'envoyer des reçus à une imprimante qui n'est pas directement connectée à l'appareil sur lequel tourne la caisse. Configurez-la une seule fois dans WP Admin et vos commandes s'impriment sur une imprimante de cuisine, une imprimante de back-office ou une imprimante située dans une autre pièce — sans que chaque appareil ait à découvrir et à appairer le matériel lui-même.

## Qu'est-ce que l'impression dans le cloud ?[​](#what-is-cloud-printing "Lien direct vers Qu'est-ce que l'impression dans le cloud ?")

Avec l'**impression locale**, l'appareil exécutant le POS communique directement avec l'imprimante via USB, Bluetooth ou le réseau local. C'est le bon choix lorsque l'imprimante se trouve à côté de la caisse — voir [Configuration de l'imprimante](/fr/hardware/printers.md) pour connecter des imprimantes USB, Bluetooth et réseau sur le même appareil.

L'**impression dans le cloud** est destinée à tout le reste : une imprimante située dans un autre lieu, sur un autre réseau, ou que vous souhaitez partager entre tous les appareils sans la configurer sur chacun. Il existe deux modèles de distribution :

* **Imprimantes interrogeant le serveur (polling).** L'imprimante contacte WCPOS via Internet à intervalles réguliers, demande « avez-vous quelque chose pour moi ? » et récupère les travaux en attente. WCPOS ne se connecte jamais à l'imprimante — c'est toujours l'imprimante qui initie la conversation. C'est ainsi que fonctionnent **Star CloudPRNT** et **Epson Server Direct Print**.
* **Fournisseurs de relais hébergés.** WCPOS soumet le travail d'impression à un service hébergé, et ce service le délivre à l'imprimante. C'est ainsi que fonctionnent **Star Online** et **PrintNode**. Star Online délivre aux imprimantes Star CloudPRNT enregistrées dans votre compte stario.online ; PrintNode délivre via son client de bureau à presque toutes les imprimantes sur lesquelles cet ordinateur peut déjà imprimer.

Pourquoi une imprimante qui interroge le serveur ?

Une imprimante qui interroge le serveur n'a besoin ni de port ouvert, ni d'IP statique, ni de modification de pare-feu — elle ne fait jamais que des requêtes sortantes. Cela la rend idéale pour une imprimante située sur un site distant ou derrière un routeur que vous ne contrôlez pas. Le compromis est un léger délai : l'imprimante n'imprime que lorsque sa prochaine interrogation arrive.

## Choisir un fournisseur[​](#providers "Lien direct vers Choisir un fournisseur")

Choisissez le fournisseur qui correspond à votre matériel.

#### Star CloudPRNT

Pour les imprimantes thermiques Star exécutant le firmware **CloudPRNT**. L'imprimante interroge WCPOS et récupère les travaux. Les reçus sont rendus dans les commandes natives de l'imprimante. Nécessite un modèle thermique.

#### Star Online

Pour les imprimantes Star enregistrées dans un compte **stario.online**. WCPOS soumet du Star Document Markup au service hébergé de Star, et l'imprimante le récupère depuis Star Online. Nécessite un modèle thermique.

#### Epson Server Direct Print

Pour les imprimantes Epson ePOS qui prennent en charge **Server Direct Print**. L'imprimante interroge WCPOS et récupère les travaux au format ePOS-Print XML. Nécessite un modèle thermique.

#### PrintNode

Fonctionne avec pratiquement toute imprimante sur laquelle votre ordinateur peut imprimer, sur n'importe quel OS, via le **client de bureau PrintNode**. WCPOS soumet un PDF, vous pouvez donc utiliser n'importe quel modèle — y compris des factures HTML pleine page.

| Fournisseur                   | Matériel                                             | Circulation des travaux                            | Modèles              |
| ----------------------------- | ---------------------------------------------------- | -------------------------------------------------- | -------------------- |
| **Star CloudPRNT**            | Imprimante thermique Star avec firmware CloudPRNT    | L'imprimante interroge WCPOS                       | Thermique uniquement |
| **Star Online**               | Imprimante Star enregistrée dans stario.online       | WCPOS soumet du Star Document Markup à Star Online | Thermique uniquement |
| **Epson Server Direct Print** | Imprimante Epson ePOS avec Server Direct Print       | L'imprimante interroge WCPOS                       | Thermique uniquement |
| **PrintNode**                 | Toute imprimante connectée à l'OS + client PrintNode | WCPOS soumet un PDF à PrintNode                    | Tout modèle          |

## Configurer une imprimante cloud[​](#setup "Lien direct vers Configurer une imprimante cloud")

Les imprimantes cloud sont configurées une seule fois dans WP Admin et partagées entre tous les appareils — contrairement aux imprimantes locales, qui sont stockées par appareil.

Allez dans **WP Admin > POS > Settings > Cloud Print** et cliquez sur **Add printer**. Donnez-lui un **nom** (par exemple « Cuisine » ou « Back-office »). WCPOS dérive automatiquement un **ID d'imprimante** stable à partir de l'imprimante — il ne change jamais, vous pouvez donc le référencer en toute sécurité dans la configuration du firmware d'une imprimante.

Une fois l'imprimante créée, configurez le côté fournisseur.

### Star ou Epson (imprimantes interrogeant le serveur)[​](#setup-polling "Lien direct vers Star ou Epson (imprimantes interrogeant le serveur)")

1

#### Ajouter l'imprimante dans WCPOS

Dans **WP Admin > POS > Settings > Cloud Print**, ajoutez une imprimante et choisissez **Star CloudPRNT** ou **Epson Server Direct Print** comme fournisseur. WCPOS génère une **URL d'interrogation** et un **jeton à usage unique** pour cette imprimante.

2

#### Copier l'URL d'interrogation et le jeton

Copiez l'URL d'interrogation et le jeton générés. Le **jeton n'est affiché qu'une seule fois** — si vous le perdez, régénérez-en un nouveau depuis la carte de l'imprimante et mettez à jour l'imprimante avec la nouvelle valeur.

3

#### Les saisir dans la configuration de l'imprimante

Ouvrez la page de configuration de l'imprimante — les paramètres **CloudPRNT** pour Star, ou les paramètres **Server Direct Print** pour Epson — et collez-y l'URL d'interrogation et le jeton. Définissez l'intervalle d'interrogation si l'imprimante en demande un (quelques secondes en général). Enregistrez et redémarrez l'imprimante si nécessaire.

En l'espace d'un cycle d'interrogation, l'imprimante se signale, et son statut dans WCPOS passe de **En attente** à **Connectée**.

### PrintNode[​](#setup-printnode "Lien direct vers PrintNode")

1

#### Installer le client de bureau PrintNode

Sur un ordinateur qui peut déjà imprimer sur votre imprimante cible, installez le **client PrintNode** et connectez-vous. Le client doit rester en cours d'exécution et en ligne pour que les travaux s'impriment.

2

#### Obtenir une clé API PrintNode

Dans votre compte PrintNode, créez une **clé API**. C'est elle qui permet à WCPOS de soumettre des travaux à votre compte PrintNode.

3

#### Saisir la clé API dans WCPOS

Ajoutez une imprimante dans **WP Admin > POS > Settings > Cloud Print**, choisissez **PrintNode** comme fournisseur et collez la clé API. WCPOS l'utilise pour récupérer la liste des imprimantes enregistrées dans votre compte PrintNode.

4

#### Sélectionner l'imprimante

Choisissez l'imprimante cible dans la liste des imprimantes signalées par le client PrintNode, puis enregistrez. WCPOS soumettra les travaux de cette imprimante à PrintNode, et le client les imprimera.

### Star Online[​](#setup-star-online "Lien direct vers Star Online")

Utilisez Star Online lorsque votre imprimante Star est déjà enregistrée dans un compte **stario.online** et que vous souhaitez que le service hébergé de Star gère la distribution.

1

#### Obtenir l'URL CloudPRNT

Dans stario.online, ouvrez **Device Groups** et copiez l'**URL CloudPRNT** du groupe. Elle devrait ressembler à `https://device.stario.online/cloudprnt/...` ou `https://eu-device.stario.online/cloudprnt/...`.

2

#### Créer une clé API avec les autorisations

Dans stario.online, créez une clé API pour WCPOS. La clé doit avoir l'autorisation de lister les appareils et d'imprimer dessus. Au minimum, activez :

* **EnumDevices** — requis lorsque WCPOS récupère la liste des appareils
* **ViewDevice** — utilisé pour les vérifications de statut des appareils
* **PrintToDevice** — requis pour soumettre des travaux d'impression
* **ViewDeviceGroups** — recommandé pour la recherche de groupes et les diagnostics

Une clé API peut exister et néanmoins échouer si ces autorisations ne sont pas activées.

3

#### Saisir l'URL et la clé API dans WCPOS

Ajoutez une imprimante dans **WP Admin > POS > Settings > Cloud Print**, choisissez **Star Online** comme fournisseur, puis collez l'URL CloudPRNT et la clé API. Cliquez sur **Fetch my devices**.

4

#### Sélectionner l'appareil Star

Choisissez l'imprimante dans la liste des appareils et enregistrez. WCPOS stocke la clé API côté serveur et utilise l'identifiant d'accès de l'appareil sélectionné lors de la soumission des travaux à Star Online.

## Règles d'impression automatique[​](#auto-print "Lien direct vers Règles d'impression automatique")

Les règles d'impression automatique décident automatiquement de ce qui s'imprime où — rédigées sous forme de phrases simples. Une règle est **portée × imprimante × modèle**, par exemple :

> Imprimer **chaque commande** sur **Cuisine** en utilisant **Ticket de cuisine**.

Lorsqu'une commande correspondante est finalisée, WCPOS rend le **modèle** choisi côté serveur dans le format dont l'imprimante a besoin et le met en file d'attente — le caissier n'a rien à faire.

La compatibilité des modèles est importante

Les imprimantes Star et Epson ne peuvent utiliser que des modèles **thermiques**, car le travail doit être rendu dans le langage de commande natif de l'imprimante (Star Document Markup ou ESC/POS pour Star, ePOS-Print pour Epson). PrintNode peut utiliser **n'importe quel** modèle — thermique ou HTML pleine page — car le travail est rendu en **PDF**. Si un modèle n'apparaît pas comme option pour une imprimante, c'est parce que l'imprimante ne peut pas rendre ce format. Voir [Modèles thermiques](/fr/receipts/thermal-templates.md) pour créer des mises en page thermiques.

## Imprimantes par boutique (Pro)[​](#per-store-printers "Lien direct vers Imprimantes par boutique (Pro)")

Fonctionnalité Pro

Le routage d'impression par boutique nécessite [WCPOS Pro](/fr/getting-started/pro-license.md) et une configuration [multi-boutiques](/fr/stores/.md).

Par défaut, les règles d'impression automatique sont globales — chaque boutique les partage. Avec Pro, vous pouvez attribuer à une boutique individuelle ses **propres** règles d'impression cloud afin que ses commandes s'impriment sur ses propres imprimantes (un ticket de cuisine à un emplacement ne devrait pas s'imprimer à un autre).

Modifiez une boutique sous **POS → Stores**, ouvrez sa section **Cloud Printing** et cliquez sur **Add rule**. Chaque règle comprend :

* **Printer ID** — l'ID stable de l'imprimante cloud vers laquelle envoyer
* **Scope** — **POS orders only** (par défaut), **Online orders only**, ou **Every order**
* **Format** — **StarPRNT** (par défaut), **ESC/POS**, **Epson ePOS-Print**, ou **HTML**

Lorsqu'une commande appartient à une boutique qui possède ses propres règles, WCPOS la route vers les imprimantes de cette boutique. Si une boutique n'a **aucune** règle propre, elle **revient aux** règles d'impression automatique **globales** — vous n'avez donc à configurer que les boutiques qui diffèrent.

## Impression manuelle[​](#manual "Lien direct vers Impression manuelle")

Vous n'avez pas à attendre une règle d'impression automatique. Depuis l'**écran de paiement / de reçu**, un caissier peut envoyer un reçu vers une imprimante cloud à la demande — pratique pour les réimpressions ou pour router un ticket ponctuel vers une imprimante spécifique.

La façon dont le reçu est produit dépend de l'imprimante :

* **Star CloudPRNT** — le reçu est rendu **sur l'appareil** et transmis à l'imprimante via CloudPRNT.
* **Star Online, Epson et PrintNode** — le reçu est rendu **sur le serveur** à partir de la commande et du modèle sélectionnés, puis délivré à l'imprimante ou au relais hébergé.

## Impression de test et statut de connexion[​](#status "Lien direct vers Impression de test et statut de connexion")

Chaque carte d'imprimante dispose d'un bouton **Test print** qui envoie un court diagnostic afin que vous puissiez confirmer que l'imprimante est accessible et que le format est correct avant de vous y fier pour de vraies commandes.

La carte affiche également un statut en direct :

| Fournisseur                | Statut         | Signification                                                                       |
| -------------------------- | -------------- | ----------------------------------------------------------------------------------- |
| **Star CloudPRNT / Epson** | **En attente** | L'imprimante ne s'est pas encore signalée — WCPOS attend sa première interrogation. |
| **Star CloudPRNT / Epson** | **Connectée**  | L'imprimante a interrogé WCPOS récemment et récupère les travaux.                   |
| **Star Online**            | **En ligne**   | Star Online indique que l'appareil sélectionné est disponible.                      |
| **Star Online**            | **Hors ligne** | Star Online indique que l'appareil sélectionné n'est pas disponible.                |
| **Star Online**            | **Inconnu**    | WCPOS n'a pas pu confirmer le statut de l'appareil auprès de Star Online.           |
| **PrintNode**              | **En ligne**   | Le service PrintNode indique que le client et l'imprimante sont disponibles.        |
| **PrintNode**              | **Hors ligne** | PrintNode indique que le client ou l'imprimante est indisponible.                   |

## Dépannage[​](#troubleshooting "Lien direct vers Dépannage")

L'imprimante reste bloquée sur En attente

Une imprimante interrogeant le serveur qui ne quitte jamais l'état **En attente** n'a jamais réussi à atteindre WCPOS. Vérifiez :

* Que l'**URL d'interrogation et le jeton** dans le firmware de l'imprimante correspondent exactement à ce que WCPOS a généré. Un seul caractère erroné fait que chaque interrogation est rejetée — régénérez le jeton dans WCPOS et ressaisissez-le en cas de doute.
* Que l'imprimante peut réellement **atteindre votre site** via Internet (DNS correct, aucun pare-feu ne bloquant le HTTPS sortant, certificat SSL valide sur votre boutique).
* Que **l'interrogation est activée** dans la configuration CloudPRNT / Server Direct Print de l'imprimante, avec un intervalle raisonnable. Redémarrez l'imprimante après avoir modifié ses paramètres.

Star Online indique que la clé API est non autorisée ou interdite

Star Online sépare l'**authentification** des **autorisations** :

* **401 / authentification échouée** signifie que la clé API elle-même n'a pas été acceptée. Vérifiez que la clé a été copiée correctement, qu'elle n'a pas été révoquée et qu'elle appartient au compte/à la région Star Online attendus.
* **403 / interdit** signifie que la clé API a été acceptée mais n'est pas autorisée pour l'action demandée. Modifiez la clé dans stario.online et activez les autorisations requises, en particulier **EnumDevices** pour **Fetch my devices** et **PrintToDevice** pour l'impression.

Si **Fetch my devices** réussit mais qu'aucune imprimante n'apparaît, vérifiez la page **Device Groups** de stario.online. Le groupe doit contenir au moins un appareil connecté, et l'URL CloudPRNT dans WCPOS doit pointer vers ce même groupe.

Le travail PrintNode ne s'imprime jamais

Le travail a atteint PrintNode mais n'est pas sorti de l'imprimante. Vérifiez :

* Que le **client de bureau PrintNode est en cours d'exécution et en ligne** sur l'ordinateur connecté à l'imprimante. Si l'ordinateur est en veille ou le client fermé, rien ne s'imprime.
* Que vous avez sélectionné la **bonne imprimante** dans WCPOS — le nom doit correspondre à l'imprimante signalée par le client.
* Que la **clé API est valide** et n'a pas été révoquée. Ressaisissez-la si PrintNode affiche l'imprimante comme Hors ligne.

Mon modèle n'est pas sélectionnable pour une imprimante Star ou Epson

Seuls les modèles **thermiques** fonctionnent sur les imprimantes cloud Star et Epson, car le reçu doit être rendu en commandes ESC/POS ou ePOS-Print. Les modèles HTML et pleine page ne peuvent pas être exprimés dans ces formats, ils sont donc masqués pour ces imprimantes.

Choisissez soit un [modèle thermique](/fr/receipts/thermal-templates.md), soit une imprimante **PrintNode** — PrintNode rend en PDF, elle peut donc imprimer n'importe quel modèle.

## Documentation associée[​](#related-documentation "Lien direct vers Documentation associée")

[Configuration de l'imprimanteConnecter une imprimante sur le même appareil ou réseau](/fr/hardware/printers.md)

[ModèlesLe système de modèles de reçus](/fr/receipts/.md)

[Modèles thermiquesCréer des mises en page ESC/POS pour les imprimantes Star et Epson](/fr/receipts/thermal-templates.md)