Imprimante & tiroir-caisse

Configuration d'une imprimante thermique USB par caisse pour l'impression automatique du ticket et l'ouverture du tiroir-caisse après une vente espèce. Utilise la technologie WebUSB intégrée au navigateur — sans logiciel intermédiaire à installer.

Menu : Comptoir > Imprimante & tiroir

Prérequis

Compatibilité

• Navigateur : Chrome, Edge ou Opera. Pas compatible avec Firefox ni Safari à ce jour.
• HTTPS obligatoire en production (la fonctionnalité WebUSB est désactivée par les navigateurs en HTTP, sauf localhost).
• Imprimante : modèle thermique ESC/POS (Epson TM-T20, TM-T88, TM-L90 et compatibles — environ 90 % du marché).
• Connexion : USB direct au PC (pas de partage Windows).
• Driver Windows : si l'imprimante est déjà reconnue par Windows avec son driver constructeur, il peut être nécessaire d'utiliser Zadig pour basculer le driver en mode WinUSB (libère l'imprimante pour WebUSB).

Configuration

Sélection de la caisse

Sélectionner la caisse à configurer (la configuration est par caisse — chaque PC/caisse a sa propre imprimante).

Sélection de l'imprimante (autorisation WebUSB)

1. Cliquer sur « Sélectionner l'imprimante... »
2. Un dialog navigateur s'ouvre, listant tous les périphériques USB disponibles
3. Choisir l'imprimante thermique → cliquer Se connecter
4. OMAG enregistre les identifiants USB (Vendor ID + Product ID) en base
5. Le badge passe en vert : « Imprimante configurée »

Autorisation persistante

Chrome se souvient de l'autorisation par site/origin. Plus besoin de re-sélectionner après la première fois (sauf si l'imprimante est débranchée et rebranchée sur un autre port USB).

Paramètres

Paramètre	Description
Largeur papier	58 mm (compact, 32 colonnes) ou 80 mm (standard, 48 colonnes)
Impression auto	Toggle. Si activé : à chaque validation de vente, le ticket s'imprime directement sur l'imprimante (court-circuit du dialog Stimulsoft)
Ouverture tiroir auto	Toggle. Si activé : le tiroir-caisse s'ouvre après l'impression pour les paiements espèce uniquement

Boutons de test

• « Imprimer un ticket de test » : envoie un petit ticket de validation à l'imprimante (date, heure, accents, largeur)
• « Tester ouverture tiroir » : envoie la commande ESC/POS d'ouverture du tiroir-caisse

Cas typique de test

Si l'impression test fonctionne mais pas le tiroir, vérifier le câble RJ11 entre l'imprimante et le tiroir-caisse (pas un câble réseau standard).

Utilisation au quotidien

Une fois la configuration enregistrée et activée :

1. Vente normale dans l'Interface Comptoir → saisie articles + encaissement
2. À la validation :
   • Le ticket s'imprime automatiquement (sans dialog)
   • Le tiroir-caisse s'ouvre si le paiement est en espèce
3. Le caissier rend la monnaie, ferme le tiroir, passe au client suivant

Fallback Stimulsoft

Si l'impression auto est désactivée (ou si la caisse n'a pas d'imprimante configurée), le dialog Stimulsoft historique s'ouvre à la validation (impression manuelle / PDF / email). Permet de garder une compatibilité avec les caisses non équipées.

Format du ticket imprimé

Le ticket suit le format standard du commerce de détail (80 mm ou 58 mm) :

       SOCIETE OMAG SARL
   123 rue X, Casablanca
        ICE: xxxxxxxxx
================================
Ticket N°12345   16/05/26 14:32
Caissier: Mustapha
Vendeur: Ali
Client: Comptoir
--------------------------------
Bundle Poste HP        1 x 17400
                            17400
Souris Logitech        2 x   150
                              300
--------------------------------
Total HT              14750.00
TVA                    2950.00
TOTAL TTC             17700.00
================================
Espèces               20000.00
RENDU                  2300.00

+13 points fidélité gagnés

       Merci de votre visite

Le format gère également :

• Les remises de ligne (% sur chaque article)
• Les modes de paiement multiples (multi-règlement)
• Le rendu monnaie explicite si paiement espèce supérieur au dû
• Les points fidélité gagnés (si module activé)

Cas d'usage

Caisse équipée d'une imprimante Epson TM-T20

1. Brancher l'imprimante en USB sur le PC caisse
2. Aller dans Comptoir > Imprimante & tiroir
3. Choisir la caisse → Sélectionner l'imprimante → dans le dialog Chrome, choisir « EPSON TM-T20 »
4. Largeur 80 mm + activer Impression auto + Ouverture tiroir
5. Tester avec « Imprimer un ticket de test » → vérifier la sortie papier
6. Tester avec « Tester ouverture tiroir » → le tiroir doit s'ouvrir
7. Enregistrer
8. Faire une vraie vente espèce → ticket imprimé + tiroir ouvert automatiquement ✓

Plusieurs caisses indépendantes

• Caisse 1 : imprimante Epson TM-T20 (80 mm)
• Caisse 2 : imprimante TM-L90 portable (58 mm)
• Chaque PC navigue vers Comptoir > Imprimante & tiroir, choisit sa caisse, configure son imprimante
• Pas d'interférence : les configurations sont indépendantes par caisse

Caisse sans imprimante (fallback)

• Toggle Impression auto = OFF
• À la validation : dialog Stimulsoft standard s'ouvre → caissier choisit « Imprimer » sur l'imprimante Windows par défaut (A4 ou autre)
• Comportement identique aux versions précédentes d'OMAG

Résolution des problèmes

Problème	Cause probable	Solution
L'imprimante n'apparaît pas dans le dialog	Driver Windows monopolise le périphérique	Utiliser Zadig pour basculer en driver WinUSB
Erreur « Imprimante non autorisée »	Autorisation WebUSB perdue	Re-cliquer « Sélectionner l'imprimante »
Ticket imprimé mais coupure papier ne se fait pas	Imprimante non ESC/POS standard	Vérifier le modèle → contacter le support
Tiroir ne s'ouvre pas	Câble RJ11 défectueux ou tiroir non câblé sur pin 2	Vérifier câble / utiliser bouton test pour isoler le problème
Caractères accentués bizarres	Encodage non supporté	Vérifier que l'imprimante supporte CP858 (Latin1 + €)

Aspect technique

Pour les développeurs

• Composable Vue : src/composables/useEscPos.js
• Encoding texte : CP858 (Latin1 + symbole €) — gère les accents français
• Commande ouverture tiroir : ESC p 0 25 250 (drawer pin 2, t1=25ms, t2=250ms)
• Coupe papier : GS V 1 (coupe partielle)
• Endpoint API : /ticketEscPos/:db/:nbl — renvoie les données nécessaires (entête, lignes, paiements)
• Le rendu binaire ESC/POS est généré côté frontend par buildTicketBytes() puis envoyé via device.transferOut()

Règles de gestion

• Configuration par caisse : chaque caisse a sa propre imprimante. Pas de partage.
• Impression conditionnelle : seuls les tickets validés (vente effective) déclenchent l'impression auto. Les tickets en attente / rappelés n'impriment pas tant qu'ils ne sont pas validés.
• Tiroir = espèce uniquement : le tiroir ne s'ouvre pas pour les paiements carte, chèque ou crédit (logique métier — pas besoin de manipuler des espèces).
• Encodage : les caractères non supportés par CP858 (ex. caractères arabes) sont remplacés par ? — pour les imprimer, utiliser un modèle d'imprimante supportant l'UTF-8 (non pris en charge dans cette version).
• Sécurité : WebUSB requiert HTTPS en production. La fonctionnalité est désactivée automatiquement sur les sites HTTP non-localhost.

Voir aussi

• Interface Comptoir — utilisation en vente
• Caisses — référentiel
• Touches rapides — configuration favoris (autre paramètre par caisse)