Le RestaurantManage Print Agent est un service Windows léger qui reçoit des commandes d'impression depuis le cloud et les envoie à votre imprimante thermique de reçus — permettant l'impression automatique des reçus lors du paiement des commandes ou quand les tickets de cuisine doivent être imprimés. L'agent prend en charge les imprimantes réseau (port TCP 9100), les imprimantes USB et les connexions Windows Spooler. Ce guide couvre l'installation, la configuration, la connexion de l'imprimante et le dépannage.
Comment fonctionne l'impression de reçus ?
Le flux de travail d'impression est entièrement automatisé. Quand un caissier confirme le paiement ou qu'un ticket de cuisine est déclenché, le backend de RestaurantManage génère le reçu complet sous forme de commandes d'octets ESC/POS — incluant le nom du restaurant, le numéro de table, la commande détaillée, les prix, la ventilation des taxes, le total et le mode de paiement. Ces octets sont envoyés via une connexion WebSocket sécurisée (PrintHub) au Print Agent fonctionnant sur un PC Windows dans votre restaurant. L'agent décode les données et les transmet directement à l'imprimante thermique connectée. Tout le processus prend moins de deux secondes de la confirmation du paiement au reçu imprimé.
Comment installer le Print Agent ?
- Téléchargement : Obtenez le dernier installateur du Print Agent depuis votre tableau de bord admin ou contactez le support.
- Installation : Exécutez l'installateur sur un PC Windows qui restera allumé pendant les heures de service.
- Configuration : Ouvrez config.json et saisissez votre URL de base de l'API, l'ID de votre restaurant et la clé secrète de l'agent (fournie par votre administrateur).
- Connexion de l'imprimante : Branchez votre imprimante thermique via USB ou connectez-la au même réseau que le PC.
- Démarrage du service : Lancez le Print Agent — il se connecte automatiquement au PrintHub et affiche un indicateur de statut vert.
- Impression de test : Traitez un paiement test depuis le panel caisse et vérifiez que le reçu s'imprime correctement.
Quels types de connexion d'imprimante sont pris en charge ?
Le Print Agent prend en charge trois méthodes de connexion, avec basculement automatique entre elles. Les imprimantes réseau se connectent via TCP sur le port 9100 — saisissez l'adresse IP de l'imprimante dans la configuration. C'est la méthode recommandée pour les restaurants avec plusieurs imprimantes. Les imprimantes USB se connectent directement au PC et sont accessibles via Windows Spooler ou l'adressage direct du port USB. Le Windows Spooler utilise le pilote d'impression Windows standard, qui fonctionne avec toute imprimante reconnue par Windows. L'agent essaie d'abord le Spooler, puis bascule sur l'USB direct et tente finalement les partages réseau UNC.
Comment configurer le Print Agent ?
Le Print Agent utilise un fichier config.json avec trois paramètres obligatoires : ApiBaseUrl (l'URL du serveur RestaurantManage), RestaurantId (l'ID unique de votre restaurant depuis le tableau de bord admin), et AgentSecretKey (une clé secrète générée dans le panel admin qui authentifie l'agent d'impression sans nécessiter de compte utilisateur). L'agent s'authentifie auprès du PrintHub en utilisant cette clé secrète via WebSocket. Pour les imprimantes réseau, ajoutez l'IP et le port de l'imprimante à la configuration. L'agent enregistre toute l'activité dans le dossier logs/ pour le dépannage.
Comment fonctionne la mise à jour automatique ?
Le Print Agent vérifie les mises à jour environ toutes les 2,5 heures en appelant le endpoint de mise à jour sur le serveur RestaurantManage. Si une nouvelle version est disponible, il télécharge le paquet de mise à jour sous forme de fichier ZIP dans un dossier de mises à jour en attente, exécute le script d'installation et redémarre le service automatiquement. Cela signifie que votre restaurant exécute toujours la dernière version sans intervention manuelle. Les vérifications de mise à jour incluent un décalage temporel par restaurant pour éviter que tous les agents se mettent à jour simultanément. Vous pouvez voir la version actuelle de l'agent dans le tableau de bord admin.
Résolution des problèmes courants
- L'agent ne se connecte pas : Vérifiez que ApiBaseUrl et AgentSecretKey dans config.json sont corrects. Vérifiez l'accès internet sur le PC.
- Le reçu ne s'imprime pas : Confirmez que l'imprimante est allumée et connectée. Vérifiez le dossier logs/ pour les détails d'erreur.
- Texte illisible sur le reçu : Assurez-vous que votre imprimante prend en charge les commandes ESC/POS. La plupart des imprimantes thermiques 80 mm sont compatibles.
- La connexion se coupe fréquemment : L'agent se reconnecte automatiquement, mais vérifiez la stabilité de votre réseau. Une connexion Ethernet filaire est plus fiable que le Wi-Fi.
- L'agent ne démarre pas comme service : Exécutez install-service.bat en tant qu'Administrateur pour enregistrer correctement le service Windows.
Guides connexes
- Panel caisse : Comment traiter les paiements qui déclenchent l'impression de reçus
- Écran de cuisine : Comment l'impression des tickets de cuisine s'intègre dans le flux de commandes
- Premiers pas : Guide de configuration complet de l'inscription à la première commande
Ready to Digitize Your Restaurant?
Set up your free QR menu with RestaurantManage in under 10 minutes.
Start Free →