Guide de configuration et de dépannage pour l'imprimante de tickets, le tiroir-caisse, le scanner de codes-barres, la balance électronique, l'impression des QR codes et le serveur mobile.
Accessible par👑Administrateur
🖨️
🖨️Imprimante de tickets
SwiftUP imprime via les imprimantes Windows : toute imprimante thermique (58 ou 80 mm) installée avec son pilote Windows apparaît dans la liste. En impression directe, le ticket est rastérisé puis envoyé en ESC/POS à l'imprimante, sans Zadig ni SDK constructeur.
Imprimantes compatibles :
Epson TM-T88 (série)
Star TSP100 (série)
Imprimantes thermiques ESC/POS génériques 58 mm ou 80 mm installées dans Windows
Configuration :
1Branchez l'imprimante et installez le pilote Windows du fabricant ; vérifiez qu'elle apparaît dans Paramètres Windows → Imprimantes.
3Mode d'impression : « Impression directe » (envoi silencieux via le pilote Windows) ou « Choisir à chaque ticket » (la boîte d'impression SwiftUP s'ouvre pour chaque ticket, vous y choisissez l'imprimante).
4Format du papier : « Thermique 80 mm » ou « Thermique 58 mm ».
5Imprimante par défaut : choisissez l'imprimante Windows, ou « Automatique / imprimante système » pour utiliser l'imprimante par défaut de Windows (bouton d'actualisation de la liste).
6Cliquez sur « Enregistrer », puis sur « Test Ticket » : un ticket de test est envoyé à l'imprimante (« Ticket test envoyé à … »).
7Le bouton « Aperçu » ouvre un aperçu du ticket de test dans le lecteur PDF du poste, sans rien imprimer.
Si l'impression est coupée, trop petite ou décalée, vérifiez que le format (58/80 mm) choisi correspond au papier installé et que le pilote Windows est réglé sur la même largeur.
💰Tiroir-caisse
Carte « Tiroir-caisse » (Config. application → Périphériques). Deux modes de connexion :
USB — le tiroir est branché sur le port « DK » (RJ11) de l'imprimante de tickets ; SwiftUP l'ouvre à travers l'imprimante.
RJ11 / Port COM — le tiroir est piloté directement par un port série : choisissez le port COM (bouton Actualiser la liste des ports), la vitesse (baud, 9600 par défaut) et la broche (Pin tiroir 0 ou 1).
1Choisissez le MODE DE CONNEXION (USB ou RJ11 / Port COM) et, en COM, le port, la vitesse et la broche.
2Sauvegardez d'abord la configuration.
3Cliquez sur « Ouvrir le tiroir » — le tiroir doit s'ouvrir (« Tiroir ouvert avec succès ! »).
4Si le tiroir ne s'ouvre pas, essayez l'autre broche (0 → 1 ou 1 → 0).
Code PIN pour le tiroir : l'option « Exiger le code PIN pour ouvrir le tiroir » se règle par utilisateur, dans le formulaire Équipe → Utilisateurs (et non dans Config. application). L'utilisateur concerné devra saisir son code PIN à 4 chiffres avant chaque ouverture.
📷Scanner de codes-barres
Les scanners USB HID fonctionnent en plug-and-play (pas de pilote nécessaire). Ils émulent un clavier.
1Branchez le scanner USB.
2Ouvrez SwiftUP et accédez à l'écran POS.
3Assurez-vous que la fenêtre POS a le focus (cliquez dessus si nécessaire).
4Scannez un code-barres → le produit correspondant est ajouté au panier.
Tout code que le scanner transmet comme une saisie clavier est accepté (EAN-13, EAN-8, Code128, QR Code…).
Si le scanner ne réagit pas, cliquez sur la barre de recherche du POS pour placer le focus clavier au bon endroit, puis rescannez.
⚖️Balance électronique
La balance sert aux produits « vendus au poids » (modes Épicerie, Mini Market…). Carte « Balance électronique » dans Config. application → Périphériques.
1Connexion : « Port série (COM / RS-232) », « USB », « TCP/IP réseau » (adresse IP:port, ex. 192.168.1.50:4001) ou « Simulateur (développement) ».
2Renseignez la Marque (optionnel), le Port COM, la vitesse (baud, 9600 par défaut) et l'Unité (kg ou g).
3Activez « Activer la balance » pour afficher le panneau de pesée dans l'écran de vente, puis « Sauvegarder la balance ».
4Cliquez sur « Connecter » : le statut passe à « Connectée » et une pastille affiche le poids lu en direct. « Déconnecter » ferme la connexion.
5Créez un produit avec l'option « Vendu au poids » activée.
6Dans le POS, cliquez sur ce produit → la fenêtre « Pesée — produit » s'ouvre avec le prix au kg et le poids en direct.
Dans la fenêtre de pesée : « Tare » enregistre le poids actuel comme tare (affichage Tare / Brut, le poids net est utilisé), « Lire le poids » actualise la lecture, « Saisie manuelle » permet de taper le poids si la balance ne répond pas, puis « Confirmer ».
Lecture du poids : SwiftUP lit la sortie ASCII de la balance de façon générique — le premier nombre de chaque ligne, suivi éventuellement de kg ou g (kg par défaut).
Les options USB et TCP/IP apparaissent dans la liste, mais seuls le port série (COM / RS-232, y compris adaptateur USB-série qui crée un port COM) et le simulateur ouvrent réellement une connexion. Utilisez le port série pour une balance en production.
Balance générique à sortie ASCII sur port série
Mettler Toledo, Ohaus… dès lors qu'ils envoient le poids en ASCII
Tout adaptateur USB-série exposant un port COM
🔳Impression des QR codes
Depuis la page Liens serveur & QR, SwiftUP imprime :
Une affiche par lien (Application serveur, Commande client, Écran cuisine, Panneau admin) avec le QR code, l'adresse et la consigne « Scannez ce code avec l'appareil photo de votre téléphone ».
Une planche « Imprimer toutes les tables » avec un QR par table (/client?tid=…), étiquetés « Table N ».
Le QR d'appairage de la tablette Backup POS (bouton d'agrandissement pour le scanner à l'écran).
🧪Page de test d'imprimante Windows
Une page technique cachée (route /SPRTPrinterControl, sans entrée de menu) permet de tester une imprimante Windows : choix de l'imprimante, nom affiché sur le ticket, largeur papier (58/80 mm), nombre de copies (1 à 5), aperçu du ticket et impression de test. Elle est destinée au support et aux techniciens ; pour un usage courant, utilisez « Test Ticket » et « Aperçu » dans Config. application.
📱Serveur mobile (tablettes / téléphones)
SwiftUP héberge un serveur HTTP local (port 3002 par défaut) permettant à votre équipe d'utiliser des tablettes et téléphones comme terminaux secondaires (prise de commande en salle, écran cuisine…).
1Le serveur démarre automatiquement au lancement ; vous pouvez le démarrer/arrêter et changer le port dans Config. application (carte « Serveur Mobile Waiter ») ou sur la page Liens serveur & QR.
2Ouvrez la page Liens serveur & QR et notez l'URL affichée (ex : http://192.168.1.5:3002/mobile).
3Sur la tablette, ouvrez le navigateur et accédez à cette URL.
4Ou scannez le QR code affiché sur la page Liens serveur & QR.
5Connectez-vous avec l'identifiant et le mot de passe d'un utilisateur de rôle Serveur (waiter) ou Caissier (cashier).
L'ordinateur principal et les tablettes doivent être sur le même réseau Wi-Fi/LAN. Si le PC a plusieurs cartes réseau, choisissez la bonne interface sur la page Liens serveur & QR.