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.