Cliente de impresión

El cliente de impresión es un programa que se instala en el computador de la caja y envía las tirillas a la impresora térmica de red en tiempo real. Se descarga y se configura desde Menú → Configuración → Impresión POS (ruta /app/config). Cómo imprimir día a día está en Imprimir; los ajustes de impresoras y modo de impresión, en Impresión POS.

Permiso

ACCESO_CONFIGURACION para entrar a Configuración. La impresión térmica por WebSocket es una capacidad del plan Empresarial (Planes y límites).

Un vistazo

Menú → Configuración → Impresión POS

Cliente de impresión para Windows

Programa que se instala en el computador de la caja y envía las tirillas a la impresora térmica de red. No requiere instalar Python ni nada más.

1. Crea un token de cliente abajo y cópialo (solo se muestra una vez).
2. Descarga el instalador y ejecútalo en el computador de la caja.
3. El asistente pide el token y la IP de la impresora, los verifica y deja el cliente arrancando solo al encender el equipo.

download Descargar instalador (v1.2.0) 1 Linux / macOS: paquete zip (requiere Python) 2

Tokens de cliente POSadd Nuevo token 3

Nombre	Creado	Último uso	Expira	Activo	Acciones
Caja principal	2026-08-12	hace 2 min 4	2027-08-12		autorenew delete 5
Cocina	2026-08-12	—	2027-08-12		autorenew delete

Bloque de descarga y tabla de tokens. Cada computador con impresora usa su propio token.

1. 1 Descargar instalador: AgapantoPOS-Setup.exe para Windows. Si dice Instalador no publicado, aún no está disponible en este servidor.
2. 2 Enlace al paquete pos-client.zip para Linux y macOS (necesita Python 3.7 o superior).
3. 3 Nuevo token: pide un Nombre (ej. Caja principal) y muestra el token una sola vez en el diálogo Token generado — cópialo ahora.
4. 4 Último uso se actualiza cuando el cliente se conecta: es la forma rápida de saber que está en línea.
5. 5 Regenerar crea un token nuevo con el mismo nombre (hay que reconfigurar el cliente); la papelera lo elimina. El interruptor Activo lo desactiva sin borrarlo.

Instalar

WindowsLinuxmacOS

1. En Impresión POS pulsa Nuevo token, escribe un nombre y copia el token.
2. Pulsa Descargar instalador y ejecuta AgapantoPOS-Setup.exe en el computador de la caja. Python viene incluido; no instalas nada más.
3. El asistente pide la URL del servidor, el token de cliente (lo valida contra el servidor) y la IP y puerto de la impresora (los prueba). Deja todo en %ProgramData%\AgapantoPOS\.
4. Al terminar registra la tarea programada "Agapanto POS", que arranca el cliente al encender el equipo. Para cambiar token o impresora, abre Reconfigurar en el menú Inicio.

1. Descarga y descomprime pos-client.zip y entra a la carpeta.
2. Instala dependencias: ./scripts/install.sh.
3. Configura con el asistente python scripts/setup.py o edita config/pos_client.ini (ver abajo).
4. Inicia con ./scripts/start.sh. Para que arranque solo: sudo systemctl enable agapanto-pos && sudo systemctl start agapanto-pos (el instalador crea el servicio).

1. Descarga y descomprime pos-client.zip, abre Terminal en la carpeta y ejecuta ./scripts/install.sh.
2. Configura con python scripts/setup.py o editando config/pos_client.ini.
3. Inicia con ./scripts/start.sh. Para el autoarranque copia scripts/com.agapanto.posclient.plist a ~/Library/LaunchAgents/ y ejecuta launchctl load ~/Library/LaunchAgents/com.agapanto.posclient.plist.

El archivo de configuración

[server]
django_url = https://agapanto.com.co   ; sin barra final

[printer]
default_ip = 192.168.1.123             ; IP fija de la impresora térmica
default_port = 9100                    ; puerto RAW/JetDirect

[client]
client_token = <token copiado de Impresión POS>
client_name = Caja principal

El token identifica a la empresa por sí solo: el archivo no lleva ningún identificador de empresa. Los tokens vencen al año de creados (columna Expira).

Verificar que está conectado

• En la consola o en logs/pos_client.log debe aparecer Connected to Agapanto server successfully!.
• En Impresión POS, la columna Último uso del token cambia a la hora actual.
• Prueba la impresora desde el mismo computador: telnet 192.168.1.123 9100 debe conectar. En Windows, el instalador ya lo prueba con la opción de verificar impresora.
• Guarda una venta con Imprimir recibos automáticamente activo y mira si sale la tirilla.

Una impresora de red, puerto 9100

El cliente habla directamente con la impresora por TCP en el puerto 9100 (estándar ESC/POS). La impresora debe tener IP fija en la misma red del computador. En Impresoras registras nombre, Dirección IP, Puerto (9100), Ancho papel (mm) (58 u 80) y Codificación (CP1252 por defecto).

El token se muestra una vez

Si lo pierdes, usa Regenerar y vuelve a configurar el cliente. Un token puede ser reutilizado por quien lo tenga: no lo compartas por chat ni lo dejes en una nota visible en la caja.

¿Problemas?

• "Authentication failed" al iniciar. El token está mal copiado, vencido, desactivado o fue regenerado. Crea o copia uno nuevo.
• "Can't connect to server". Revisa django_url (con https:// y sin barra final) y que el computador tenga internet.
• "Printer timeout". La IP o el puerto de la impresora no responden. Comprueba con telnet IP 9100 y que la impresora esté en la misma red.
• Caracteres raros (? o cuadros) en la consola de Windows con el zip. Usa scripts\start_windows_utf8.bat, que fija la consola en UTF-8. El instalador no tiene este problema.
• Un empleado con ACCESO_SOLO_RED_POS no puede entrar. Ese control usa la conexión del cliente de impresión: si el cliente está apagado, nadie con ese permiso puede entrar. Ver Seguridad.

Siguiente: Seguridad.