Stampa diretta su stampanti d'ufficio anche con Odoo in cloud e cliente dietro NAT.
Niente IP pubblico, niente port forwarding, niente VPN da configurare. Un piccolo servizio Python
(l'Agent) gira sulla macchina del cliente, parla con il CUPS locale e scambia i job di stampa
con Odoo attraverso un canale uscente WebSocket/HTTP.
Funzionalità principali
- Stampa PDF + ZPL nativi — funziona con i report standard di Odoo e con la stampa ZPL per le etichette Zebra. I byte arrivano alla coda di stampa senza alterazioni.
- Tunnel web UI CUPS — bottone Open CUPS Admin sul form del server: la pagina admin del CUPS
remoto si apre nel tuo browser passando dall'agent. Aggiungere stampanti, gestire code, ispezionare job senza SSH
né VPN. Le credenziali admin restano sulla LAN del cliente, non vengono mai memorizzate da Odoo.
- Enrollment zero-touch — generi un token di installazione su Odoo, il cliente lancia una sola riga di comando, l'agent si registra automaticamente e crea in Odoo le stampanti corrispondenti alle code CUPS rilevate.
- Multi-istanza — un solo binario sul cliente può servire più Odoo (utile per service
provider che gestiscono più tenant da una sola macchina LAN).
- Self-update — un solo comando scarica l'ultima versione dell'agent e la sostituisce automaticamente, riavviando il servizio.
- Multi-architettura — pacchetti pronti per x86_64, aarch64 (Raspberry Pi 4/5) e armhf (Raspberry Pi 2/3), senza dipendenze da installare sul dispositivo.
- Retry automatico — i job falliti vengono ritentati ogni minuto fino a 3 volte, con l'errore sempre visibile in Odoo.
- Stato dei job in tempo reale — stato CUPS mappato su disponibile / in stampa / non disponibile, con heartbeat ogni 30 secondi e data di ultimo contatto per il monitoraggio.
- Push, Pull o Direct — tre modalità di trasporto selezionabili: WebSocket persistente
(default, copre cron e queue job), browser-relay (per workstation singola), HTTP diretto (quando c'è
già VPN o IP statico).
