Volver a la documentación

Guía de Instalación y Configuración: POS Agent

El POS Agent es una utilidad ligera diseñada para actuar como puente entre nuestro sistema web y su hardware local. Su función principal es gestionar la comunicación directa con impresoras térmicas y la apertura automática del cajón de dinero, garantizando una operación rápida y silenciosa.

Instalación Rápida

Siga estos pasos para integrar el agente en su terminal de ventas:

  1. Descarga: Obtenga el instalador POSAgent-Setup.exe a través de nuestro equipo de soporte o el enlace oficial.
  2. Ejecución: Haga clic derecho sobre el archivo y seleccione Ejecutar como Administrador. Esto es crítico para la correcta instalación de certificados de seguridad.
  3. Asistente: Complete las instrucciones en pantalla. El sistema configurará automáticamente los permisos necesarios.
  4. Inicio: Al finalizar, el servicio se ejecutará en segundo plano y se iniciará automáticamente cada vez que encienda su computadora.

¿Cómo verificar que está activo?

El agente no requiere interacción constante. Para confirmar que está operando:

  • Acceda desde su navegador a: https://localhost:3000/
  • Si visualiza un panel con el estado "Online" en color verde, la conexión es exitosa.

Configuración de la Impresora

Para garantizar la máxima estabilidad, recomendamos configurar su equipo mediante el protocolo de Impresora Compartida.

Paso 1: Compartir el dispositivo en Windows

  1. Diríjase a Panel de Control > Dispositivos e Impresoras.
  2. Haga clic derecho sobre su impresora térmica y elija Propiedades de la impresora.
  3. En la pestaña Compartir, active la casilla Compartir esta impresora.
  4. Asigne un nombre de recurso sencillo y sin espacios (Ej: POS80 o Caja1).
  5. Presione Aceptar.

Paso 2: Vincular el Agente

  1. Ingrese al panel del agente en https://localhost:3000/.
  2. Ubique el campo Interface o edite el archivo config.json en el directorio de instalación.
  3. Defina la ruta utilizando el formato de red local: \\localhost\NombreAsignado.

Ejemplo de configuración en JSON:

"interface": "\\\\localhost\\POS80"

Solución de Problemas

Problema Solución Sugerida
No hay impresión Verifique encendido, papel y conexión USB. Reconfirme que el nombre compartido en Windows coincida exactamente con el del Agente.
Error de conexión Asegúrese de que el icono del POS Agent aparezca en la barra de tareas (junto al reloj). Si no está, inícielo desde el menú Inicio.
Advertencia de Seguridad Si el navegador bloquea la dirección localhost, reinstale el programa ejecutándolo como Administrador para validar los certificados SSL.

Desinstalación

Si requiere remover la utilidad, utilice el acceso directo Uninstall POS Agent ubicado en el menú Inicio o en la carpeta de instalación. Esto eliminará los servicios y certificados del sistema de forma limpia.