========================================================
  CONFIGURACION IMPRESORA TERMICA XP-80C - LOTUYO APP
  (Windows 10 / 11)
========================================================

CONTENIDO DEL PAQUETE
----------------------
- XPrinter Driver Setup V8.2.exe  : Driver oficial de la impresora
- print-server/                    : Servidor local de impresion LoTuyo
- INSTRUCCIONES.txt                : Este archivo

--------------------------------------------------------
PASO 1: CONEXION FISICA
--------------------------------------------------------
1. Apaga la impresora.

2. Conecta el cable USB a un PUERTO TRASERO de la PC
   (si es PC de escritorio). Los puertos traseros van
   directo a la placa base y dan voltaje mas estable,
   evitando desconexiones aleatorias al imprimir.
   En laptops cualquier puerto funciona igual.

3. Conecta el cable de alimentacion.

4. Enciende la impresora.

5. Verifica que el papel termico de 80mm este bien insertado.
   (Prueba: mantener boton Feed presionado al encender,
   debe imprimir una pagina de autodiagnostico).

--------------------------------------------------------
PASO 2: INSTALAR NODE.JS (solo si no lo tienes)
--------------------------------------------------------
1. Ir a: https://nodejs.org
2. Descargar la version LTS e instalar normalmente.
3. Reiniciar la PC al terminar.

Verifica abriendo CMD y ejecutando:
  node --version
Debe mostrar v18 o superior.

--------------------------------------------------------
PASO 3: INSTALAR EL DRIVER DE LA IMPRESORA
--------------------------------------------------------
1. Ejecutar "XPrinter Driver Setup V8.2.exe".
2. Seguir el asistente (Siguiente, Siguiente, Instalar).
3. Reiniciar la PC si se solicita.
4. Verificar en:
   Configuracion > Bluetooth y dispositivos > Impresoras
   que aparezca la impresora instalada.

--------------------------------------------------------
PASO 4: CONFIRMAR EL NOMBRE DE LA IMPRESORA EN WINDOWS
--------------------------------------------------------
IMPORTANTE: El servidor de impresion busca la impresora
por su nombre EXACTO tal como quedo registrada en Windows.
El instalador XPrinter NO siempre la deja como "XP-80C":
segun el modelo/serie elegida durante la instalacion
(ej. impresoras genericas como Roccia RC-5801) puede
quedar como "XP-58", "XP-58C", "XP-90", etc.

1. Ir a: Configuracion > Bluetooth y dispositivos > Impresoras
   (o Panel de Control > Dispositivos e impresoras)
2. Busca la impresora recien instalada y anota su nombre
   EXACTO (mayusculas, guiones, todo tal cual aparece).
3. En la app LoTuyo: Ventas > Configuracion > seccion
   "Impresora Termica Alambrica" > campo "Nombre de
   Impresora Termica (Local)" > pega ese nombre exacto.

Si prefieres renombrarla en vez de cambiar la app:
1. Clic en la impresora > Propiedades de impresora
2. En la pestana "General", cambia el nombre a XP-80C
3. Aceptar y cerrar (y deja el campo de la app en XP-80C).

--------------------------------------------------------
PASO 5: INSTALAR EL SERVIDOR DE IMPRESION (UNA SOLA VEZ)
--------------------------------------------------------
1. Abre la carpeta "print-server" dentro de este ZIP.
2. Clic derecho en "instalar.bat" > "Ejecutar como administrador".
3. Esperar a que termine. Mostrara:
   "Instalacion completa! ... Se iniciara automaticamente"
4. Listo. El servidor corre en segundo plano, sin ventanas.

IMPORTANTE: Solo necesitas hacer esto UNA SOLA VEZ.
Desde ese momento el servidor se inicia automaticamente
cada vez que enciendes la PC.

--------------------------------------------------------
PASO 6: VERIFICAR QUE FUNCIONA
--------------------------------------------------------
Con el servidor instalado, entra a la app LoTuyo.
Ve a Ventas > abre el detalle de cualquier venta.
Presiona el boton "Imprimir". El ticket deberia salir
impreso en papel automaticamente (2 copias).

Para verificar que el servicio esta activo:
  Buscar "Servicios" en el menu Inicio > buscar
  "LoTuyo Print Server" > debe mostrar "En ejecucion".

--------------------------------------------------------
SOLUCION DE PROBLEMAS
--------------------------------------------------------

"No se pudo conectar con el servidor de impresion"
  -> El servicio no esta corriendo.
     Abre "Servicios" en el menu Inicio, busca
     "LoTuyo Print Server" y haz clic en "Iniciar".
     Si no aparece, vuelve a ejecutar instalar.bat
     como Administrador.

"Error al enviar a impresora"
  -> La impresora no se llama exactamente "XP-80C"
     o no esta encendida/conectada.
     Verifica el nombre en:
     Configuracion > Impresoras > clic en la impresora
     > Propiedades > pestana General.

"El ticket sale pero con texto extrano o ilegible"
  -> El driver no esta en modo Raw.
     Desinstala el driver XPrinter, reinicia la PC
     y vuelve a instalar desde el .exe incluido.

"La impresora no aparece en Windows"
  -> Prueba con otro cable USB o puerto diferente.
     Verifica que la impresora este encendida y con
     papel correctamente insertado.

"El servicio 'LoTuyo Print Server' aparece Detenido y no
 inicia (Error 1053: El servicio no respondio a tiempo)"
  -> Causa conocida: falta el archivo de configuracion
     interno del servicio (lotuyoprintserver.xml) dentro
     de la carpeta print-server\daemon. Pasa por ejemplo
     si una instalacion anterior quedo a medias o si la
     PC se apago/reinicio durante la instalacion.
     Solucion (con permisos de Administrador):
       1. Ejecuta "desinstalar.bat" como Administrador.
       2. Borra por completo la carpeta "daemon" dentro
          de print-server (si existe).
       3. Ejecuta "instalar.bat" como Administrador de nuevo.
       4. Verifica en "Servicios" que quede "En ejecucion".
     Para confirmar que el archivo de config si se genero:
       Debe existir print-server\daemon\lotuyoprintserver.xml
       ademas del .exe y los logs.

"El puerto 3001 ya esta en uso / EADDRINUSE al reiniciar
 el servicio"
  -> Generalmente significa que alguien dejo corriendo
     manualmente "node index.js" en una terminal aparte
     (por ejemplo durante pruebas). Cierra esa terminal
     y vuelve a iniciar el servicio desde "Servicios".

--------------------------------------------------------
DESINSTALAR (si es necesario)
--------------------------------------------------------
  Clic derecho en "desinstalar.bat" > Ejecutar como administrador.

--------------------------------------------------------
DATOS TECNICOS
--------------------------------------------------------
- El servidor corre en: http://127.0.0.1:3001
- Copias por ticket configurables desde la app (1 o 2)
- Ancho de papel configurable desde la app: 80mm (48
  columnas) o 58mm (32/30 columnas) — debe coincidir
  con el papel real de la impresora
- Soporta logo de negocio, encabezado y pie de pagina
  multilinea (todo configurable en Ventas > Configuracion)
- Solo funciona en la PC donde esta instalado
- Para soporte tecnico contactar al equipo de LoTuyo

========================================================
