Printer Setup

Printer settings are found in the POS under Settings > Printer. Each device manages its own printer configuration — printers are stored locally and not synced between devices.

Supported Printers by Platform

The Add Printer form adapts to the app you're using — each platform shows only the connections and options it can actually use.

Platform	Supported Printers	Connections
Web app	Epson and Star printers with a built-in web server	Network (HTTP)
Desktop app	Any network receipt printer	Network (raw TCP)
iOS app	Epson and Star	Network, Bluetooth
Android app	Epson and Star	Network, Bluetooth, USB

Pourquoi uniquement Epson et Star 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 depuis un navigateur. L'application de bureau n'a pas cette limitation, car elle peut se connecter directement via TCP.

Sur les applications mobiles, l'impression Bluetooth et USB passe par les SDK officiels d'Epson et de Star, ces connexions nécessitent donc également 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 à Paramètres > Imprimante dans le PDV. 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

Cette étape varie selon la plateforme :

• Web app — pick the Vendor: Epson or Star. This is the first choice on the web, because browsers can only reach these two brands' built-in web servers.
• Desktop app — printers connect over the network; there's nothing extra to pick here.
• Mobile apps — pick a Connection Type: Network, Bluetooth, or USB (USB is Android only). The fields below change to match your choice.

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 de papier. Elle est conçue pour vérifier que la largeur du papier, l'alignement, le dimensionnement et la coupe sont correctement configurés, et pas seulement que l'imprimante est accessible.

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 (applications mobiles)

Sur les applications iOS et Android, une imprimante peut se connecter de trois façons. Sélectionnez le Type de connexion en haut du formulaire d'ajout d'imprimante ; les champs de connexion s'adaptent automatiquement.

Réseau

L'imprimante est connectée au même réseau Wi-Fi que votre appareil. Saisissez son adresse IP — voir Trouver l'adresse IP de votre imprimante. Les imprimantes réseau peuvent être Epson, Star ou génériques.

Bluetooth

L'imprimante est appairée à votre appareil via Bluetooth. Appuyez sur Rechercher des imprimantes et choisissez la vôtre dans la liste — son nom et son fabricant sont renseignés automatiquement. L'impression Bluetooth utilise les SDK natifs d'Epson et de Star ; l'imprimante doit donc être un modèle Epson ou Star.

USB (Android uniquement)

L'imprimante est connectée par un câble USB. Appuyez sur Actualiser et sélectionnez-la dans la liste des appareils connectés. Comme pour le Bluetooth, l'impression USB nécessite une imprimante Epson ou Star. iOS ne prend pas en charge les périphériques USB généraux, cette option n'apparaît donc que sur Android.

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

Paramètre	Options	Description
Fabricant	Epson, Star, Générique	Fabricant de l'imprimante. Sur l'application web, le fabricant est le choix principal en haut du formulaire (Epson ou Star uniquement) plutôt qu'un 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. Réseau uniquement — masqué pour le Bluetooth et l'USB.
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.

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 l'imprimante par défaut et du routage d'imprimante 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 Paramètres → Routage d'impression 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

La page Routage d'impression n'apparaît 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.

Reçu complet en image raster

By default, WCPOS sends receipts to thermal printers as text — fast, compact, and crisp, using the printer's built-in fonts. The catch: thermal printer fonts only cover a limited set of characters. Scripts the printer has no font for — many non-Latin alphabets, right-to-left text, some symbols — can come out as blank boxes or garbled characters.

Full receipt raster fixes this. When it's on, WCPOS renders the whole receipt as an image and sends that image to the printer, so the printout matches exactly what's on screen — in any language or script.

Turn it on per-printer under Advanced Settings. Things to know:

• It's slower. An image is much larger than a line of text, so the receipt takes longer to send and print.
• Use it only when you need it. If your receipts print fine as text, leave it off.
• It applies to thermal printers on any connection (network, Bluetooth, USB). It doesn't apply to the system print dialog, which already prints from a full-page rendering.

Discovering Printers

On the mobile apps, the Add Printer form lists nearby printers for Bluetooth (iOS and Android) and USB (Android only) connections — tap Scan for printers or Refresh and pick yours from the list. Its name and vendor fill in automatically.

For network printers on any platform, enter the IP address directly — see Finding Your Printer's IP Address below. The web app has no network discovery (browsers can't scan networks), so it always uses manual IP entry.

Finding Your Printer's IP Address

Most receipt printers can print a self-test page that includes the IP address:

• Epson: Hold the feed button while powering on
• Star : Maintenir 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)
• Point d'accès : /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 :

• HTTPS ou HTTP
• Point d'accès : /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

Printer not detected during setup

• Vérifiez que l'imprimante est allumée et connectée au même réseau que votre appareil
• Pour les imprimantes réseau : vérifiez que l'adresse IP est correcte (imprimez une page de 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

Printer detected but nothing prints

• Vérifiez le rouleau de papier — il est peut-être vide ou coincé
• Vérifiez que le paramètre Largeur du texte de l'imprimante correspond à votre papier (58 mm ou 80 mm)
• Essayez d'imprimer une page de 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)

Receipt is garbled or has wrong characters

• Le paramètre de langage de commande est peut-être incorrect — essayez de basculer entre ESC/POS, StarPRNT et Star Line Mode
• Vérifiez que le paramètre Largeur du texte de l'imprimante est correct
• Si le reçu est dans un script non latin ou une langue s'écrivant de droite à gauche, activez Rastérisation complète du reçu dans les paramètres avancés — le reçu est alors imprimé sous forme d'image afin que toute langue s'affiche correctement

Cash drawer doesn't open

• 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

Cannot connect from the web app

• L'application web ne peut se connecter qu'aux imprimantes Epson et Star disposant d'un serveur web intégré
• Les imprimantes génériques et USB ne sont pas prises en charge sur le web — utilisez l'application de bureau ou mobile à la place
• 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

Bluetooth printer won't connect (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