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 ?
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 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.
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
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
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)
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.
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.
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
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.
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.
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.
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
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.
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/....
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.
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.
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
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.
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 pour créer des mises en page thermiques.
Imprimantes par boutique (Pro)
Le routage d'impression par boutique nécessite WCPOS Pro et une configuration multi-boutiques.
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
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
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
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, soit une imprimante PrintNode — PrintNode rend en PDF, elle peut donc imprimer n'importe quel modèle.