Configuration de l'imprimante

Les paramètres d'imprimante se trouvent dans POS > Paramètres > Impression. Chaque appareil gère sa propre configuration d'imprimante — les imprimantes sont stockées localement et ne sont pas synchronisées entre les appareils.

Imprimer sur une imprimante qui n'est pas sur cet appareil ?

Cette page couvre les imprimantes connectées à la caisse par USB, Bluetooth ou réseau local. Pour une imprimante située dans une autre pièce ou un autre lieu — ou que vous souhaitez partager entre tous les appareils — consultez Impression dans le cloud. Les imprimantes cloud que vous avez configurées pour votre boutique apparaissent automatiquement dans la liste d'imprimantes de chaque appareil — vous ne les ajoutez pas ici.

Imprimantes prises en charge par plateforme

Le formulaire Ajouter une imprimante s'adapte à l'application que vous utilisez — chaque plateforme n'affiche que les connexions et les options qu'elle peut réellement utiliser.

Plateforme	Imprimantes prises en charge	Connexions
Application web	Imprimantes Epson et Star avec serveur web intégré (réseau) ; imprimantes Epson et Star via WebUSB/Web Bluetooth (USB/Bluetooth, Chrome/Edge uniquement)	Réseau (HTTP), USB, Bluetooth
Application de bureau	Toute imprimante de reçus réseau	Réseau (TCP brut), USB, Bluetooth
Application iOS	Epson et Star	Réseau, Bluetooth
Application Android	Epson et Star	Réseau, Bluetooth, USB

Pourquoi uniquement Epson et Star sur le réseau sur le web ?

Les navigateurs web ne peuvent pas ouvrir de connexions TCP brutes. Les imprimantes de reçus Epson et Star intègrent un serveur web qui accepte les travaux d'impression via HTTP — c'est le seul moyen d'envoyer des commandes ESC/POS à une imprimante réseau depuis un navigateur. L'application de bureau n'a pas cette limitation, car elle peut se connecter directement via TCP.

L'impression USB et Bluetooth fonctionne également dans le navigateur, mais uniquement dans Chrome ou Microsoft Edge (ils utilisent les API WebUSB et Web Bluetooth) — Safari et Firefox ne les prennent pas en charge.

Sur les applications mobiles, l'impression Bluetooth et USB passe par les SDK officiels d'Epson et de Star, ces connexions nécessitent donc une imprimante Epson ou Star. Les imprimantes génériques fonctionnent uniquement via le réseau.

Ajouter une imprimante

1

Ouvrir les paramètres d'impression

Accédez à POS > Paramètres > Impression. Si aucune imprimante n'est encore configurée, un état vide s'affiche avec un bouton Ajouter une imprimante. Chaque imprimante dispose d'un Nom d'imprimante — un simple libellé, pré-rempli avec « Imprimante de reçus » (puis « Imprimante de reçus 2 », etc.) — que vous pouvez modifier à votre convenance pour distinguer vos imprimantes.

2

Choisir le mode de connexion de l'imprimante

Toutes les plateformes commencent par la même question — Type de connexion — et n'affichent que les options prises en charge par la plateforme. Les champs ci-dessous s'adaptent à votre choix.

• Application web — Réseau, USB ou Bluetooth (l'USB et le Bluetooth nécessitent Chrome ou Edge). Pour une imprimante Réseau, vous choisissez ensuite le Fabricant — Epson ou Star — car le navigateur atteint une imprimante réseau via le serveur web intégré de cette marque.
• Application de bureau — Réseau, USB ou Bluetooth.
• Applications mobiles — Réseau ou Bluetooth, plus USB sur Android (iOS ne prend pas en charge l'USB).

3

Identifier l'imprimante

Imprimantes réseau — saisissez l'adresse IP (par exemple 192.168.1.100). WCPOS interroge l'adresse pour détecter s'il s'agit d'un appareil Epson ou Star, et remplit automatiquement le port, le langage de commande et le fabricant. Un libellé « Détecté : Epson » ou « Détecté : Star » s'affiche une fois la détection terminée. Sur l'application web, l'URL exacte du point de terminaison utilisé pour la connexion est également affichée.

Imprimantes Bluetooth ou USB (mobile) — sélectionnez votre imprimante dans la liste des appareils détectés. La sélection d'un appareil remplit automatiquement son nom et son fabricant. Appuyez sur Rechercher des imprimantes (Bluetooth) ou Actualiser (USB) si votre imprimante n'apparaît pas encore dans la liste.

Si la détection automatique ne donne pas un résultat parfait, vous pouvez tout ajuster dans les Paramètres avancés.

4

Enregistrer et tester

Cliquez sur Enregistrer. WCPOS envoie d'abord une impression de test et n'enregistre l'imprimante que si celle-ci réussit.

L'impression de test est un court diagnostic : une règle de colonnes numérotées, du texte centré en taille normale et en taille double, une ligne d'alignement gauche/droite et une coupe du papier. Elle est conçue pour que vous puissiez vérifier que la largeur du papier, l'alignement, le dimensionnement et la coupe sont tous correctement configurés, et pas seulement que l'imprimante est accessible.

Le test échoue ? Vous pouvez quand même enregistrer

Si le test échoue, l'erreur s'affiche accompagnée d'une option Enregistrer sans tester pour sauvegarder le profil malgré tout.

Types de connexion

Vous commencez par choisir le Type de connexion en haut du formulaire d'ajout d'imprimante, et les champs de connexion s'adaptent en conséquence. Les types disponibles dépendent de la plateforme (voir le tableau ci-dessus).

Réseau

L'imprimante est connectée au même réseau Wi-Fi que votre appareil. Sur les applications de bureau et mobiles, appuyez sur Scanner le réseau pour découvrir les imprimantes automatiquement, ou saisissez l'adresse IP manuellement — voir Trouver l'adresse IP de votre imprimante. L'application web utilise uniquement la saisie manuelle de l'IP. Sur les applications de bureau et mobiles, une imprimante réseau peut être Epson, Star ou générique ; sur le web, elle doit être Epson ou Star, et vous choisissez laquelle sous la connexion Réseau.

Bluetooth

L'imprimante est appairée à votre appareil via Bluetooth. Choisissez la vôtre dans la liste — son nom et son fabricant sont renseignés automatiquement. Sur mobile, l'impression Bluetooth utilise les SDK natifs d'Epson et de Star, l'imprimante doit donc être un modèle Epson ou Star ; sur le web, le Bluetooth fonctionne dans Chrome ou Edge via l'API Web Bluetooth.

USB

L'imprimante est connectée par un câble USB. Sélectionnez-la dans la liste des appareils connectés. L'USB est disponible sur le web (Chrome ou Edge, via WebUSB), l'application de bureau et Android — mais pas sur iOS, qui ne prend pas en charge les périphériques USB généraux. Sur mobile, l'impression USB nécessite une imprimante Epson ou Star.

note

Le paramètre Port s'applique uniquement aux imprimantes réseau — il est masqué pour les connexions Bluetooth et USB.

Paramètres avancés

Développez Paramètres avancés pour affiner la configuration de l'imprimante. La plupart de ces champs sont remplis automatiquement une fois le fabricant identifié.

Ces paramètres s'appliquent sur toutes les plateformes :

Paramètre	Options	Description
Langage	ESC/POS, StarPRNT, Star Line Mode	Le protocole de commande utilisé par l'imprimante. Rempli automatiquement à partir du fabricant détecté.
Largeur de texte de l'imprimante	58 mm (32 car.), 80 mm standard (42 car.), 80 mm large (48 car.)	Nombre de caractères par ligne. Adaptez ce paramètre à votre papier et à votre imprimante — la plupart des imprimantes 80 mm affichent 42 caractères par ligne, certaines en affichent 48.
Reçu complet en image raster	Désactivé / Activé	Imprimer le reçu entier sous forme d'image au lieu de texte — voir Reçu complet en image raster ci-dessous.

Ces deux paramètres se comportent différemment selon la plateforme et le type de connexion :

Paramètre	Options	Où il s'applique
Fabricant	Epson, Star, Générique	Fabricant de l'imprimante. Sur l'application web, vous choisissez le fabricant directement sous la connexion Réseau (Epson ou Star uniquement), et non comme paramètre avancé. Générique est disponible pour les imprimantes réseau sur les applications de bureau et mobiles, mais pas pour les connexions Bluetooth ou USB.
Port	Rempli automatiquement	Port réseau de l'imprimante, affiché à côté de l'adresse IP. Réseau uniquement — masqué pour le Bluetooth et l'USB. Il est rempli pour vous selon le fabricant (et, sur le web, selon que votre POS est servi en HTTP ou HTTPS) ; ne le modifiez que si votre réseau le remappe.

Options de l'imprimante

Ces options se trouvent en bas du formulaire d'ajout d'imprimante :

Option	Description
Coupe automatique du papier	Couper le papier automatiquement après chaque reçu
Ouverture automatique du tiroir-caisse	Envoyer une commande d'ouverture au tiroir-caisse connecté après l'impression
Définir par défaut	Définir cette imprimante par défaut — utilisée pour tout reçu qui n'est pas dirigé vers une imprimante spécifique

Vous cherchez « impression automatique après le passage en caisse » ?

L'impression automatique d'un reçu à la fin d'une vente est un paramètre du panier, et non un paramètre d'imprimante — activez Impression automatique du reçu dans les paramètres du panier du PDV. Quelle imprimante est utilisée dépend de votre imprimante par défaut et de tout routage d'impression par modèle.

Routage d'impression

Si vous utilisez plusieurs modèles — par exemple un reçu thermique et une facture A4 — le routage d'impression détermine sur quelle imprimante chaque modèle est imprimé. Le routage comporte trois niveaux, vérifiés dans cet ordre :

1. Remplacement par tâche. Sur l'écran du reçu, un menu déroulant d'imprimante se trouve à côté du sélecteur de modèle. Choisir une imprimante ici remplace tous les autres réglages pour cette tâche d'impression uniquement. Changer de modèle réinitialise ce choix sur Auto.
2. Remplacement dans les paramètres. Allez dans POS > Paramètres > Impression, puis utilisez la section Modèles de reçus pour attribuer une imprimante spécifique à chaque modèle. Par exemple, routez votre reçu thermique vers l'imprimante réseau Epson et votre facture HTML vers la boîte de dialogue d'impression du système. Repassez un modèle sur Auto pour supprimer le remplacement.
3. Correspondance automatique. Lorsqu'aucun remplacement n'est défini, WCPOS effectue automatiquement la correspondance :
   • Les modèles thermiques sont routés vers les imprimantes thermiques dont la largeur de caractères correspond. Un modèle thermique 58 mm privilégie les imprimantes 32 colonnes ; un modèle 80 mm privilégie les imprimantes 42 ou 48 colonnes.
   • Les modèles HTML sont routés vers la boîte de dialogue d'impression du système.
   • Si plusieurs imprimantes correspondent, l'imprimante par défaut l'emporte.

Si vous envoyez manuellement un modèle vers une imprimante incompatible — par exemple un modèle thermique vers la boîte de dialogue du système — un avertissement d'incompatibilité orange apparaît sur l'écran du reçu. L'impression continue, mais le rendu peut être incorrect.

Les remplacements de routage sont enregistrés par appareil. Chaque iPad, téléphone ou ordinateur gère son propre routage — il n'y a pas de synchronisation côté serveur.

note

Les contrôles d'imprimante des Modèles de reçus sous POS > Paramètres > Impression n'apparaissent qu'après l'ajout d'au moins une imprimante. Sans imprimante configurée, chaque modèle utilise implicitement la boîte de dialogue d'impression du système. Les imprimantes cloud configurées pour votre boutique comptent également ici — elles apparaissent automatiquement comme cibles de routage, sans être ajoutées sur l'appareil.

Reçu complet en image raster

Par défaut, WCPOS envoie les reçus aux imprimantes thermiques sous forme de texte — rapide, compact et net, en utilisant les polices intégrées de l'imprimante. L'inconvénient : les polices des imprimantes thermiques ne couvrent qu'un ensemble limité de caractères. Les écritures pour lesquelles l'imprimante n'a pas de police — de nombreux alphabets non latins, le texte de droite à gauche, certains symboles — peuvent apparaître sous forme de cases vides ou de caractères illisibles.

Le Reçu complet en image raster résout ce problème. Lorsqu'il est activé, WCPOS rend le reçu entier sous forme d'image et envoie cette image à l'imprimante, de sorte que l'impression corresponde exactement à ce qui s'affiche à l'écran — dans n'importe quelle langue ou écriture.

Activez-le par imprimante dans les Paramètres avancés. À savoir :

• C'est plus lent. Une image est bien plus volumineuse qu'une ligne de texte, le reçu met donc plus de temps à être envoyé et imprimé.
• Ne l'utilisez que lorsque c'est nécessaire. Si vos reçus s'impriment correctement en texte, laissez-le désactivé.
• Il s'applique aux imprimantes thermiques sur toutes les connexions (réseau, Bluetooth, USB). Il ne s'applique pas à la boîte de dialogue d'impression du système, qui imprime déjà à partir d'un rendu pleine page.

Découverte des imprimantes

La façon de trouver une imprimante dépend de la connexion :

• Bluetooth et USB — sur les applications mobiles, appuyez sur Rechercher des imprimantes (Bluetooth) ou Actualiser (USB) et choisissez la vôtre dans la liste ; son nom et son fabricant sont renseignés automatiquement. Sur le web (Chrome ou Edge), cliquez sur Connecter et choisissez l'imprimante dans le sélecteur d'appareils du navigateur.
• Réseau — sur les applications de bureau et mobiles, appuyez sur Scanner le réseau pour trouver automatiquement les imprimantes de votre réseau local (l'application de bureau les découvre via mDNS/Bonjour ; mobile utilise les SDK Epson et Star), puis choisissez la vôtre dans la liste. Vous pouvez également saisir directement l'adresse IP — voir Trouver l'adresse IP de votre imprimante ci-dessous. Les navigateurs ne peuvent pas scanner les réseaux, l'application web utilise donc toujours la saisie manuelle de l'IP.

Trouver l'adresse IP de votre imprimante

La plupart des imprimantes de reçus peuvent imprimer une page d'auto-test qui inclut l'adresse IP :

• Epson : Maintenez le bouton d'avance papier enfoncé lors de la mise sous tension
• Star : Maintenez le bouton d'avance papier enfoncé pendant 5 secondes lorsque l'imprimante est allumée

Vous pouvez également consulter la liste des appareils connectés de votre routeur ou l'utilitaire de configuration de votre imprimante.

IP statique recommandée

Les imprimantes de reçus doivent utiliser une adresse IP statique pour éviter que l'adresse ne change au redémarrage de l'imprimante. Configurez cela soit :

• Dans l'interface web intégrée de votre imprimante (généralement accessible à l'adresse http://<printer-ip>)
• Dans les paramètres DHCP de votre routeur (attribuer une IP réservée à l'adresse MAC de l'imprimante)

Imprimantes Epson

Les imprimantes Epson compatibles ePOS communiquent via HTTP. WCPOS envoie des requêtes SOAP/XML au serveur web intégré de l'imprimante.

Détails de connexion :

• Port 8008 (HTTP) ou 8043 (HTTPS) — rempli automatiquement selon que votre POS est servi en HTTP ou HTTPS
• Point de terminaison : /cgi-bin/epos/service.cgi

Modèles confirmés fonctionnels :

• Epson TM-T70-i 2 (réseau)
• Epson TM-m30iii (avec le middleware Printus)

astuce

Assurez-vous que votre imprimante Epson a ePOS activé dans sa configuration. Accédez à l'interface web de l'imprimante à l'adresse http://<printer-ip> pour vérifier et activer les paramètres ePOS.

Sur les applications mobiles, les imprimantes Epson peuvent également se connecter via Bluetooth ou USB grâce au SDK natif d'Epson — aucune adresse IP ni serveur web ePOS requis.

Imprimantes Star

Les imprimantes Star compatibles WebPRNT communiquent via HTTP. WCPOS envoie les commandes au point de terminaison WebPRNT de Star.

Détails de connexion :

• Port 80 (HTTP) ou 443 (HTTPS) — rempli automatiquement selon que votre POS est servi en HTTP ou HTTPS
• Point de terminaison : /StarWebPRNT/SendMessage

Sur les applications mobiles, les imprimantes Star peuvent également se connecter via Bluetooth ou USB grâce au SDK natif de Star.

Imprimantes génériques

L'application de bureau prend en charge toute imprimante de reçus réseau via TCP brut. Saisissez l'adresse IP et le port de l'imprimante (généralement 9100). Cela fonctionne avec la plupart des imprimantes thermiques, quel que soit le fabricant, à condition qu'elles acceptent les commandes ESC/POS.

Sur les applications mobiles, les imprimantes génériques sont également prises en charge — mais uniquement pour les connexions réseau, et non via Bluetooth ou USB (ceux-ci nécessitent une imprimante Epson ou Star). L'application web ne prend pas du tout en charge les imprimantes génériques.

Tiroirs-caisses

Les tiroirs-caisses connectés à une imprimante de reçus peuvent être déclenchés automatiquement après chaque vente :

1. Activez Ouverture automatique du tiroir-caisse dans les options de l'imprimante
2. Le PDV envoie une commande ESC/POS d'ouverture après l'impression

note

Le contrôle du tiroir-caisse nécessite un profil d'imprimante thermique — la boîte de dialogue d'impression du navigateur ne peut pas déclencher les tiroirs-caisses.

Dépannage

Imprimante non détectée lors de la configuration

• Vérifiez que l'imprimante est allumée et connectée au même réseau que votre appareil
• Pour les imprimantes réseau : sur l'application de bureau ou mobile, essayez Scanner le réseau pour la trouver automatiquement ; sinon vérifiez que l'adresse IP est correcte (imprimez une page d'auto-test)
• Pour l'application web : vérifiez que l'imprimante est un modèle Epson ou Star compatible ePOS/WebPRNT
• Pour l'application de bureau : essayez l'option de fabricant Générique avec le port 9100
• Pour le Bluetooth : appairez d'abord l'imprimante dans les paramètres Bluetooth de votre appareil, puis appuyez sur Rechercher des imprimantes
• Pour l'USB (Android) : vérifiez le câble et acceptez l'invite d'autorisation USB si elle apparaît
• Vérifiez qu'aucun pare-feu ne bloque la connexion

Imprimante détectée mais rien ne s'imprime

• Vérifiez le rouleau de papier — il est peut-être vide ou coincé
• Vérifiez que le paramètre Largeur de texte de l'imprimante correspond à votre papier (58 mm ou 80 mm)
• Essayez d'imprimer un auto-test depuis l'imprimante elle-même pour confirmer son fonctionnement
• Vérifiez que le langage de commande correspond à votre imprimante (ESC/POS pour Epson, StarPRNT ou Star Line Mode pour Star)

Le reçu est illisible ou comporte de mauvais caractères

• Le paramètre de langage de commande est peut-être incorrect — essayez de basculer entre ESC/POS, StarPRNT et Star Line Mode
• Assurez-vous que le paramètre Largeur de texte de l'imprimante est correct
• Si le reçu est dans une écriture non latine ou une langue s'écrivant de droite à gauche, activez Reçu complet en image raster dans les Paramètres avancés — il imprime le reçu sous forme d'image afin que toute langue s'affiche correctement

Le tiroir-caisse ne s'ouvre pas

• Vérifiez que l'option Ouverture automatique du tiroir-caisse est activée dans les options de l'imprimante
• Vérifiez que le tiroir est connecté au port DK de l'imprimante (et non à une source d'alimentation séparée)
• Toutes les imprimantes ne prennent pas en charge la commande d'ouverture du tiroir — consultez la documentation de votre imprimante

Impossible de se connecter depuis l'application web

• Via le réseau, l'application web n'atteint que les imprimantes Epson et Star (via leurs serveurs web intégrés) — les imprimantes réseau brutes génériques ne sont pas prises en charge dans un navigateur ; utilisez l'application de bureau ou mobile, ou une imprimante cloud
• Les imprimantes USB et Bluetooth fonctionnent bien sur le web, mais uniquement dans Chrome ou Microsoft Edge (Safari et Firefox ne prennent pas en charge les API WebUSB / Web Bluetooth)
• Si votre site utilise HTTPS mais que l'imprimante ne communique qu'en HTTP, le navigateur peut bloquer la connexion en raison du contenu mixte — l'imprimante doit utiliser le même protocole HTTP/HTTPS que votre POS

L'imprimante Bluetooth ne se connecte pas (mobile)

• Appairez l'imprimante dans les paramètres Bluetooth système de votre appareil avant de l'ajouter dans WCPOS
• L'impression Bluetooth est compatible uniquement avec les imprimantes Epson et Star — les imprimantes Bluetooth génériques ne sont pas prises en charge
• Si l'imprimante n'apparaît pas dans la liste, appuyez à nouveau sur Rechercher des imprimantes et vérifiez qu'elle est allumée et à portée