Aller au contenu

L'agent d'impression

En bref. Un petit programme installé sur un ordinateur du restaurant, qui envoie les tickets et les bons de préparation aux imprimantes réseau (ESC/POS). Il se télécharge depuis Odoo, avec son fichier de configuration déjà rempli.

À quoi ça sert

Un navigateur ne sait pas parler directement à une imprimante de tickets. Les caisses et les tablettes envoient leurs tickets à Odoo ; l'agent, installé sur un ordinateur toujours allumé du restaurant (la caisse principale, un mini-PC), les récupère et les imprime. Il n'a besoin que d'Internet : ni port à ouvrir, ni adresse fixe.

Où le trouver

Configuration → Configuration, carte Caisse → Agents d'impression. Il faut d'abord cocher Imprimantes ESC/POS dans Configuration → Paramètres.

Étape par étape

  1. Créez l'agent (par exemple « Caisse principale »), puis Générer une clé d'API.
  2. Dans la fenêtre qui s'ouvre, téléchargez le fichier de configuration (nickel-printer-agent.yaml) : il contient déjà l'adresse de votre Odoo, la clé et la base. La clé n'est affichée qu'une fois : téléchargez le fichier tout de suite.
  3. Sur la fiche de l'agent, téléchargez l'agent pour l'ordinateur qui va l'accueillir : Windows, Linux, ou Linux (ARM) (Raspberry Pi).
  4. Mettez les deux fichiers dans le même dossier, par exemple C:\Program Files\Nickel\ sous Windows ou /opt/nickel/ sous Linux.
  5. Installez et démarrez le service, en administrateur :
    • Windows (PowerShell administrateur) : .\nickel-printer-agent-windows-amd64.exe install puis .\nickel-printer-agent-windows-amd64.exe start ;
    • Linux : chmod +x nickel-printer-agent-linux-amd64, puis sudo ./nickel-printer-agent-linux-amd64 install et sudo ./nickel-printer-agent-linux-amd64 start.
  6. La fiche de l'agent passe en ligne. Rattachez-y vos imprimantes (type ESC/POS (réseau), connexion Via Odoo, adresse IP de l'imprimante), puis testez-les.

📸 Capture à réaliser — caisse/agent-impression

La fiche de l'agent avec les boutons de téléchargement, et la fenêtre de la clé avec le fichier de configuration.

Déposer le fichier dans assets/captures/caisse/agent-impression.png puis remplacer ce bloc par : ![L'agent d'impression](../assets/captures/caisse/agent-impression.png)

Bon à savoir

  • Windows peut afficher « Windows a protégé votre ordinateur » au premier lancement : l'agent n'est pas signé numériquement. Cliquez Informations complémentaires, puis Exécuter quand même.
  • Vérifier un téléchargement : les empreintes SHA-256 des exécutables sont dans le fichier SHA256SUMS, à côté d'eux.
  • Remplacer la clé (ordinateur changé, clé perdue) rend l'ancienne inutilisable : téléchargez le nouveau fichier de configuration et remplacez l'ancien, puis redémarrez le service (stop puis start).
  • Aperçu des tickets : sur l'ordinateur de l'agent, l'adresse http://127.0.0.1:8899/ montre les derniers tickets tels que l'imprimante les reçoit.
  • Agent arrêté ou ordinateur éteint : la caisse affiche « agent hors ligne » et propose de réessayer ; rien ne s'imprime plus tard par surprise.