Impresora y escáner

El POS corre en el navegador, así que no necesitas software especial — solo el hardware conectado a tu computadora.

Qué comprar

• Impresora térmica de 80mm con conexión USB. Si vas a usar gaveta, que tenga puerto de gaveta (RJ11/12). La Epson TM-T20II es la que usamos para probar Recibix y funciona completa; las Epson TM-T20/T88 son de la misma familia. Las genéricas tipo XP-80 / POS-80 son más económicas y sirven para empezar.
• Gaveta de efectivo con conector RJ11/12 (se conecta a la impresora, no a la computadora).
• Escáner de código de barras USB, tipo keyboard-wedge (2D recomendado, lee barras y QR).
• Rollos de papel térmico de 80mm. No sirve el papel bond: si lo pruebas, la impresora avanza el papel y sale en blanco.

Escáner

El escáner funciona sin instalar nada: se comporta como un teclado. Al escanear, "escribe" el código en el campo que tenga el foco.

• En el POS, escanea con el foco en Buscar o escanear y el producto entra al carrito.
• Debe estar configurado para enviar Enter al final de cada lectura (casi todos lo hacen por defecto; si no, se configura escaneando un código de su manual).
• El producto debe tener su código de barras cargado en el campo Código — ver primeros pasos.

Dos formas de imprimir

Con el agente de impresión (recomendado). Un programita que corre en la computadora del mostrador y le habla a la térmica en su propio idioma. Corta el papel solo, manda el pulso a la gaveta y no muestra ningún diálogo. Es lo que quieres en un mostrador con fila.

Con la impresión del navegador. No instalas nada: Recibix le dice al navegador que la hoja mide 80mm de ancho y el alto exacto del recibo, así que no sale en papel carta. No corta el papel ni abre la gaveta, y por defecto muestra el diálogo de impresión en cada venta.

Si el agente no está corriendo, Recibix cae solo a la impresión del navegador. Una venta cobrada nunca se queda sin comprobante.

Instalar el agente en Windows

1. El driver de la impresora

Instala el driver del fabricante (en las Epson, el Advanced Printer Driver) con la impresora conectada por USB y encendida. Al terminar, manda una página de prueba para confirmar que responde.

2. Una segunda cola para impresión directa

Este paso es el que a nadie se le ocurre y sin él no imprime nada.

El driver del fabricante no deja pasar los datos que manda Recibix: los procesa a su manera y los descarta. La impresora hace ruido y no sale papel. La solución es crear una segunda cola sobre el mismo puerto, con un driver que no toque nada:

1. Abre las Propiedades de la impresora que instalaste → pestaña Puertos y anota el puerto marcado (suele ser ESDPRT001 o USB001).
2. Impresoras y escáneres → Agregar impresora → deja que falle la búsqueda → "La impresora que quiero no está en la lista" → Agregar impresora local con configuración manual.
3. Usar un puerto existente: elige el que anotaste.
4. Fabricante Generic → modelo Generic / Text Only.
5. Ponle de nombre TMT20raw.
6. Al terminar, compártela con el nombre de recurso TMT20raw. Sin espacios ni acentos.

Te quedan dos colas para la misma impresora: la del fabricante para imprimir normal desde Windows, y esta para Recibix.

Para comprobar que quedó bien, en Símbolo del sistema:

echo Prueba > prueba.txt
cmd /c copy /b prueba.txt \\localhost\TMT20raw

Si la impresora hace ruido pero no sale texto, todavía estás mandando por la cola del fabricante: revisa el nombre del recurso compartido.

3. El agente

Instala Node.js (versión LTS) desde nodejs.org. Guarda el archivo del agente en una carpeta tuya, por ejemplo C:\Users\TuUsuario\recibix, y ábrelo desde PowerShell:

cd $env:USERPROFILE\recibix
node agente-impresion.mjs --destino TMT20raw

Debe quedarse corriendo y mostrar que escucha en el puerto 9110. Esa ventana tiene que permanecer abierta mientras uses la caja. Para que arranque sola al encender, guarda esa línea en un archivo .bat dentro de la carpeta shell:startup.

Instalar el agente en Mac

La MacBook solo tiene puertos USB-C: vas a necesitar un hub/adaptador para la impresora y el escáner. Verifica que la impresora tenga driver para macOS — las Epson lo tienen, algunas genéricas no.

Instala el driver, confirma que la impresora aparece en Ajustes → Impresoras, y arranca el agente con el nombre exacto que ve el sistema:

node agente-impresion.mjs --destino "EPSON_TM_T20II"

En Mac el agente usa la cola del sistema directamente, así que no hace falta la segunda impresora del paso anterior.

El ancho del papel

Las térmicas de 80mm imprimen 48 caracteres por línea, pero algunas —y varios drivers de Windows— usan 42. Cuando el ancho no coincide, la impresora no avisa: parte la línea por donde le toca y el monto de la derecha aparece solo en el renglón siguiente.

Se arregla en un segundo: en el POS toca el ícono de impresora (en el teléfono, Más → Impresora) → Ancho del papel → elige 42. Vuelve a imprimir el recibo de prueba y comprueba que los totales quedan en su línea.

El ajuste es de esa computadora, así que si tienes dos cajas con impresoras distintas, cada una lleva el suyo.

El permiso del navegador

La primera vez que imprimas, Chrome te va a pedir permiso para que la página use la red local. Dale Permitir. Sin ese permiso el navegador no puede hablarle al agente y Recibix cae a la impresión normal.

Es una sola vez por navegador y por computadora. Si alguien lo rechaza por error, se corrige desde el candado de la barra de direcciones, en los permisos del sitio.

Impresora de red

Si tu impresora es de red en vez de USB, no necesitas driver ni cola compartida. Arranca el agente apuntando a su dirección IP:

node agente-impresion.mjs --destino 192.168.1.50

Imprimir sin el diálogo (solo sin agente)

Si usas la impresión del navegador, en el mostrador no quieres confirmar un diálogo por cada venta. Chrome imprime directo a la impresora predeterminada si lo abres con la opción --kiosk-printing. Deja antes la térmica como impresora predeterminada del sistema.

En Windows: clic derecho en el acceso directo de Chrome → Propiedades. Al final del campo Destino, después de las comillas, agrega un espacio y --kiosk-printing:

"C:\Program Files\Google\Chrome\Application\chrome.exe" --kiosk-printing

En Mac: abre Chrome desde la Terminal con este comando, o guárdalo en un archivo .command en el escritorio:

open -a "Google Chrome" --args --kiosk-printing

La opción solo afecta a las ventanas que abras así. Con el agente corriendo no hace falta: no hay diálogo que saltar.

Gaveta de efectivo

La gaveta se conecta a la impresora con el cable RJ11/12, no a la computadora, y se abre con un pulso que manda la impresora.

• Con el agente, Recibix manda ese pulso dentro del recibo: la gaveta se abre sola al cobrar en efectivo.
• Sin el agente, muchos drivers traen la opción de abrirla en cada impresión. Búscala en las preferencias de impresión, en la sección Cash Drawer, Peripherals o Cajón.

Si algo no imprime

• Sale papel en blanco: el rollo está al revés o no es papel térmico. Ráyalo con la uña: el térmico deja una marca gris. Si la deja, voltea el rollo.
• La impresora hace ruido y no sale nada: el trabajo va por la cola del fabricante. Revisa el paso de la segunda cola.
• No pasa absolutamente nada: revisa que la ventana del agente siga abierta y que le hayas dado permiso de red local a Chrome.
• Los montos de la derecha se parten en dos líneas: tu impresora usa 42 caracteres y no 48. Cámbialo en el ícono de impresora del POS (en el teléfono, Más → Impresora), en Ancho del papel.
• Los acentos salen raros: escríbenos, es un ajuste de codificación del lado nuestro.
• Para descartar la computadora: apaga la impresora, mantén presionado Feed, enciéndela. Debe imprimir una tira con su modelo y configuración. Si eso no sale, el problema es la impresora o el papel, no Recibix.

¿Tu modelo no aparece o algo no encaja? Escríbenos — nos sirve para ampliar esta guía.