Saltar a contenido

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 (USB o de red) en tiempo real. Cada computador con el cliente es un punto de impresión; se crean y se vinculan desde Menú → Configuración → Impresión y dispositivos → Impresión POS (ruta /app/config?tab=pos-printing). Cómo imprimir día a día está en Imprimir; el modo de impresión y la impresora de cada punto, en Impresión POS.

Permiso

ACCESO_CONFIGURACION para entrar a Configuración; crear un punto o pedir un código de vinculación exige además CONFIG_CREDENCIALES. 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
Puntos de impresión
Cada punto es un computador con el cliente de impresión instalado y su impresora térmica.
download Cliente para Windows v1.4.0 1 add Agregar punto de impresión 2
Caja principal
● Conectado · CAJA-01 · v1.4.0 3
more_vert 5
usb USB · EPSON TM-T20 Predeterminada 4
Cocina
● Desconectado · COCINA-PC · v1.4.0
more_vert
lan Red · 192.168.1.124:9100
Una tarjeta por computador. Cada punto tiene su propia vinculación y su propia impresora.
  1. 1 Cliente para Windows: descarga AgapantoPOS-Setup.exe en la versión publicada. Si no aparece el botón, el instalador aún no está publicado en este servidor.
  2. 2 Agregar punto de impresión abre el asistente de cuatro pasos: Nombre, Instalar, Conectar e Impresora.
  3. 3 Estado del computador: Conectado, Reconectando, Desconectado o Desactivado, con el nombre del equipo y la versión del cliente.
  4. 4 La impresora del punto: USB · nombre o Red · IP:puerto. Predeterminada marca la que recibe facturas y cierres de caja.
  5. 5 Menú del punto: Configurar impresora, Imprimir prueba, Actualizar impresoras del PC, Renombrar, Código de vinculación, Desactivar / Activar y Eliminar.

Cómo se vincula un computador

El computador se vincula con un código de 6 dígitos que Agapanto muestra en pantalla y tú escribes en el instalador. El código vale 10 minutos y sirve una sola vez. Al usarlo, el computador recibe su credencial directamente del servidor y la guarda: nadie tiene que copiar ni pegar nada largo.

Agregar punto de impresión
2 · Instalar
1. En el computador de Caja principal, descarga e instala el cliente:
download Descargar instalador (v1.4.0)
2. Cuando el instalador lo pida, escribe este código:
482913Vence en 9:41autorenew Generar otro
Ya lo instalé
El paso Instalar del asistente, con el código y el tiempo que le queda.

Instalar

  1. En Impresión POS pulsa Agregar punto de impresión, escribe dónde está el computador (por ejemplo Caja principal) y pulsa Continuar.
  2. En el computador de la caja pulsa Descargar instalador y ejecuta AgapantoPOS-Setup.exe. Python viene incluido; no instalas nada más.
  3. El instalador pide la URL del servidor (deja la que trae si usas la nube de Agapanto) y el código de vinculación: escribe los 6 dígitos que muestra el asistente. Si el código venció, pulsa Generar otro.
  4. Termina la instalación. Queda la tarea programada "Agapanto POS", que arranca el cliente al encender el equipo, y todo se guarda en %ProgramData%\AgapantoPOS\.
  5. De vuelta en Agapanto pulsa Ya lo instalé. Cuando aparezca Conectado desde …, pulsa Continuar, elige la impresora (USB o Red (IP)), el ancho del papel, y pulsa Imprimir prueba y luego Guardar.

  1. Crea el punto en Impresión POS como en Windows y deja el asistente abierto en el paso del código.
  2. Descomprime el paquete pos-client.zip (no se descarga desde esta pantalla: solicítalo a soporte), entra a la carpeta e instala dependencias con ./scripts/install.sh.
  3. Ejecuta python scripts/setup.py: pide la URL del servidor y el código de vinculación. También puedes vincular con un solo comando: python src/pos_client.py --pair 482913 --server https://tiendas.agapanto.com.co.
  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. Crea el punto en Impresión POS y deja el asistente abierto en el paso del código.
  2. Descomprime pos-client.zip (solicítalo a soporte), abre Terminal en la carpeta y ejecuta ./scripts/install.sh.
  3. Ejecuta python scripts/setup.py y escribe el código de vinculación cuando lo pida.
  4. 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.

Volver a vincular un computador

Sirve cuando cambias el computador de la caja, reinstalas Windows o la vinculación venció (dura un año).

  1. En la tarjeta del punto abre el menú more_vert y pulsa Código de vinculación.
  2. En el computador abre Inicio → Agapanto POS → Reconfigurar (o ejecuta de nuevo el instalador) y escribe el código.

Al usar el código, el computador que estuviera vinculado antes a ese punto se desconecta: un punto es un solo computador. Pedir un código no cambia nada hasta que alguien lo usa.

El archivo de configuración

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

[printer]
default_ip = 192.168.1.123             ; solo como respaldo: la impresora se configura en Agapanto
default_port = 9100

[client]
client_token = <lo escribe la vinculación; no lo edites a mano>
client_name = Caja principal

La credencial identifica a la empresa y al punto por sí sola: el archivo no lleva ningún identificador de empresa. No la copies a otro computador; para otro equipo crea otro punto.

Verificar que está conectado

  • La tarjeta del punto muestra Conectado, con el nombre del equipo y la versión del cliente.
  • En logs/pos_client.log (en Windows, dentro de %ProgramData%\AgapantoPOS\) debe aparecer Connected to Agapanto server successfully!.
  • Menú del punto → Imprimir prueba: debe salir una tirilla de prueba.
  • Guarda una venta con Imprimir recibos automáticamente activo y mira si sale la tirilla.

USB o red

Con USB, el cliente imprime en una impresora instalada en Windows para todos los usuarios; elige su nombre en la lista que reporta el PC. Con Red (IP), el cliente habla 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.

El código es de un solo uso

Cualquiera que escriba un código vigente queda vinculado a ese punto y recibe sus tirillas. Díctalo solo a quien está instalando el cliente; si lo mostraste por error, pulsa Generar otro y el anterior deja de servir.

¿Problemas?
  • El instalador dice El código no es válido, venció o ya se usó. Pasaron los 10 minutos, alguien ya lo usó o hay un dígito mal. Pulsa Generar otro y escribe el nuevo.
  • El instalador dice que no pudo contactar al servidor. Revisa la URL (con https:// y sin barra final) y que el computador tenga internet. El código sigue sirviendo mientras no venza.
  • Tras varios intentos fallidos ya no acepta ningún código. Hay un límite de 10 intentos cada 10 minutos por conexión. Espera y vuelve a intentar con un código nuevo.
  • El instalador pide un "token de cliente" en vez de un código. Es una versión anterior a 1.4. Descarga el instalador actual desde Cliente para Windows. Lo mismo aplica a Reconfigurar en equipos instalados con una versión antigua.
  • El registro repite Client token rejected by the server. El punto fue desactivado, eliminado o vinculado a otro computador, o la vinculación venció. Vuelve a vincular con un código.
  • La tarjeta dice Desconectado. El cliente no está corriendo o no tiene internet: revisa Inicio → Agapanto POS en ese computador.
  • La prueba sale en blanco por USB. Algunos controladores no aceptan impresión directa; instala el controlador del fabricante o Generic / Text Only.
  • 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.