Qué es el agente local de YoFacturo y cómo conecta el hardware con el sistema
Qué es el agente local de YoFacturo, en qué PC corre, qué hardware reconoce (balanzas, impresoras, lectores, cajón, cámaras, biométrico) y qué pasa si se corta internet.
El agente local de YoFacturo es un programa de escritorio que se instala en una PC del comercio y conecta el hardware físico del mostrador —balanza, impresora, lector de código de barras, cajón de dinero, cámaras, biométrico— con el sistema en la nube. Corre en segundo plano, no depende de que alguien lo abra a mano, y sigue haciendo funcionar el hardware aunque en ese momento no haya internet. Es la pieza que hace que un lector USB, una balanza vieja por puerto serie o una cámara IP funcionen con el sistema sin que el comercio tenga que cambiar el hardware que ya tiene.
Qué es el agente local y qué hace
Es una aplicación construida sobre Electron que corre en segundo plano en la PC, la notebook o la mini PC del mostrador. Habla directamente con el hardware por USB, puerto serie o red, y le acerca esa información a la aplicación web que usa el comercio para vender: el peso que marca la balanza, la lectura del scanner, el comando para abrir el cajón o para imprimir un ticket. Sin el agente, esos equipos físicos quedarían aislados de la aplicación web, que corre en el navegador y no puede hablar directo con un puerto USB o serie.
En qué sistema operativo corre y cómo se instala
Windows es la plataforma real de uso; también existe una versión para Linux, empaquetada como AppImage o como paquete .deb. No hay versión para macOS: es una decisión tomada a propósito, no algo pendiente de resolver. En Windows, el instalador se agrega al perfil del usuario que lo ejecuta, sin pedir permisos de administrador — por eso las actualizaciones se aplican solas, sin ventanas de permisos de por medio. La contrapartida es que el instalador no tiene firma digital comprada: la primera vez que se ejecuta, Windows muestra el aviso de "editor desconocido" una única vez, y de ahí en más el agente confirma la integridad de cada actualización comparando su huella digital contra el archivo de versión publicado, aunque el instalador en sí no esté firmado.
El agente revisa si hay una versión nueva al arrancar y, después, cada varias horas, contra un archivo de actualizaciones publicado por YoFacturo. No hace falta que nadie reinstale nada a mano cuando sale una versión nueva.
Qué hardware reconoce el agente
| Hardware | Cómo se conecta | Qué hace el agente |
|---|---|---|
| Lector de código de barras | USB, en modo teclado (HID) | Lo identifica como scanner, arma el código completo y reconoce el tipo (EAN-13, Code-128, QR, entre otros) |
| Impresora térmica | USB, puerto serie o red | Habla el protocolo ESC/POS: imprime el ticket, corta el papel y dispara la apertura del cajón conectado a la impresora |
| Balanza | USB-serie (con adaptador) o IP en la red | Reconoce el protocolo según la marca (Toledo, CAS, Systel, Kretz o un modo genérico) y decide cuándo el peso quedó estable |
| Cajón de dinero | RJ11, a través de la impresora | Lo abre con el comando estándar de apertura; un cajón por USB directo todavía no está soportado |
| Cámaras IP | Red local (RTSP y ONVIF) | Las descubre sin necesitar la contraseña, graba localmente y avisa si una cámara wifi deja de mandar video |
| Biométrico | Cámara web (facial) o lector USB de huella | Hace el fichaje reconociendo caras aunque no haya internet; el lector de huella hoy sólo se detecta, no matchea todavía |
Qué pasa si se corta internet o se corta la luz
Son dos problemas distintos. Si se corta internet, el puente con el hardware físico sigue funcionando igual: la balanza, la impresora, el lector y el cajón son locales y no dependen de la nube para responder. El fichaje biométrico va un paso más allá: sigue reconociendo caras contra las plantillas que ya tiene descargadas, guarda las marcaciones firmadas en una cola local y las sincroniza apenas vuelve la conexión, sin perder ni duplicar la hora real del fichaje. El control de acceso de puertas por relé también decide de forma local, sin esperar respuesta del sistema, precisamente para que un corte de conexión no deje a nadie afuera. Distinto es un corte de luz: ahí la PC se apaga y con ella el agente, así que la única forma de sostener el punto de venta un rato es con una batería de respaldo en la PC y en el router.
Seguridad: qué expone a la red del local y qué no
Por diseño, el agente sólo se comunica hacia afuera con la nube de YoFacturo y, hacia adentro, con el hardware conectado a esa misma PC. No queda accesible desde otros equipos de la red local salvo que alguien active esa opción a propósito —algo que hace falta, por ejemplo, para usar la app de cámaras desde un celular conectado al wifi del comercio—. Las acciones sensibles, como abrir el cajón o enrolar una huella o una cara nueva, quedan protegidas cada una por su cuenta en vez de depender de un único candado general, así que activar el acceso desde la red no deja el resto del sistema expuesto de por sí.
Lo que vimos en instalaciones
La actualización automática del agente, en el papel, siempre estuvo lista: revisa versiones nuevas solo, sin que nadie tenga que reinstalar nada. En la práctica, esa cadena no funcionó en la calle durante bastante tiempo, y el motivo fue una combinación de tres fallas independientes que por separado parecían no tener nada que ver entre sí: una verificación de integridad mal configurada rechazaba la descarga recién después de bajar el instalador entero, un servicio de distribución de contenido guardaba en caché el archivo de versión durante mucho más tiempo del debido, y una regla de firewall bloqueaba ese mismo archivo por su extensión. Ninguno de los tres problemas se veía desde afuera: cada panel de estado daba por buena la actualización. Se resolvió recién cuando se revisó la cadena completa, tramo por tramo, en vez de confiar en que cada pieza por separado estuviera bien.
Cómo lo maneja YoFacturo
El agente se descarga como instalador de Windows o paquete de Linux y se vincula al comercio con un código y un token de dispositivo que se genera una sola vez desde el panel de administración; a partir de ahí reconoce solo el hardware conectado a esa PC y lo deja disponible para el resto del sistema. Un mismo equipo puede combinar varias funciones a la vez —por ejemplo, fichaje biométrico y consulta de precios— según lo que se le asigne desde el panel. Podés descargarlo y ver el detalle del hardware compatible en la página de descargas del agente.
Preguntas frecuentes
¿Qué es el agente local de YoFacturo?
Es un programa de escritorio que se instala en una PC, notebook o mini PC del comercio y que hace de puente entre el hardware físico del mostrador —balanza, impresora, lector, cajón, cámaras, biométrico— y el sistema en la nube. Corre en segundo plano, sin que nadie tenga que abrirlo a mano, y sigue funcionando aunque se corte la conexión a internet.
¿En qué sistemas operativos funciona el agente?
Windows es la plataforma real de uso, y también existe una versión para Linux (AppImage y paquete .deb). No hay versión para macOS: es una decisión tomada a propósito y no una limitación pendiente, así que un comercio con equipos Apple necesita otra PC para el hardware físico.
¿El agente necesita instalarse como administrador?
No: en Windows se instala en el perfil del usuario, sin pedir permisos de administrador, lo que también hace que las actualizaciones corran solas sin ventanas de permisos. Como contrapartida, el instalador sale sin firma digital comprada, así que Windows muestra una vez el aviso de "editor desconocido" la primera vez que se ejecuta.
¿Qué pasa si se corta internet mientras el agente está funcionando?
El puente con el hardware físico —balanza, impresora, lector, cajón— es local y no depende de la nube para seguir funcionando. El fichaje biométrico, además, sigue reconociendo caras contra lo que ya tiene descargado y guarda las marcaciones firmadas en una cola local hasta que vuelve la conexión, sin perder ni duplicar la hora real.
¿El agente expone algo a la red del local?
Por defecto no: sólo se comunica con la nube de YoFacturo y escucha únicamente en la propia PC donde está instalado, sin quedar accesible desde otros equipos de la red. Habilitar el acceso desde la red local —por ejemplo, para usar la app de cámaras desde un celular— es una opción explícita que hay que activar a propósito.
Guías relacionadas
Mirá cómo se hace en YoFacturo
Tutorial oficial del canal de YoFacturo. Guía escrita: Punto de Venta en YoFacturo.
