9. Solución de problemas

Qué vas a lograr: resolver vos mismo lo que se rompe seguido, y saber exactamente qué contarnos cuando toca escribirnos.

Antes de empezar: si vas a pedir ayuda, mandanos siempre estas tres cosas.

1. La versión instalada: Configuración → Licencia → tarjeta Actualizaciones.
2. Tu ID de hardware: Configuración → Licencia → Copiar.
3. Qué estabas haciendo y qué mensaje exacto apareció en pantalla.

Si la app se cerró sola, se congeló o falló sin un mensaje claro, sumá el registro de la aplicación. Cómo sacarlo está en la sección 9.9.

Escribinos a ceo@nekaigt.com. Es nuestro único canal de soporte: todavía no tenemos WhatsApp de soporte, así que desconfiá de cualquier otro número o correo que diga ser de KakawFlash.

9.1 No me llega ninguna actualización

Cómo se ve: pasan semanas y nunca aparece la franja azul de «Nueva versión disponible».

Paso 1: mirá el diagnóstico

1. Entrá a Configuración → Licencia.
2. Buscá la tarjeta Actualizaciones.
3. Hacé clic en Buscar actualización ahora.
4. Leé el resultado:

Paso 2: revisá el internet

KakawFlash necesita llegar a github.com para buscar actualizaciones. Muchas redes de oficina lo bloquean.

1. Abrí el navegador en esa misma computadora.
2. Entrá a https://github.com.
3. Si no carga, hablá con quien maneje la red o probá desde otra conexión (por ejemplo, los datos del celular).
4. Volvé a KakawFlash y hacé clic en Buscar actualización ahora.

Paso 3: mandanos el diagnóstico

1. En la tarjeta Actualizaciones, hacé clic en Copiar diagnóstico.
2. Pegalo en tu mensaje a soporte.

Eso nos dice la versión, las direcciones que consulta y el último error exacto.

Paso 4: versiones v1.0.9 o anteriores

Si la Versión instalada es v1.0.9 o más vieja, esa copia nunca va a ver una actualización. Es un defecto nuestro de esas versiones: llevan dentro una dirección equivocada y no se puede corregir a distancia.

La solución es reinstalar una sola vez. A partir de ahí las actualizaciones llegan solas.

1. Creá un respaldo portable: Configuración → Respaldos → Crear respaldo portable (contraseña de 12 caracteres o más).
2. Copialo a una USB con Guardar copia en USB…. Un minuto, y te cubre.
3. Descargá el instalador más reciente desde https://github.com/NeKai-devs/nekai-pos-releases/releases/latest. Es el archivo KakawFlash_X.Y.Z_x64-setup.exe.
4. Cerrá KakawFlash por completo. Que no quede ninguna ventana abierta.
5. Ejecutá el instalador. Se instala encima de la versión anterior: no hace falta desinstalar nada.
6. Abrí la app e ingresá con tu PIN de siempre.
7. Verificá en Configuración → Licencia → Actualizaciones que la versión ahora sea la nueva.

Tus datos se conservan. La base vive fuera de la carpeta del programa y el instalador no la toca.

9.2 Olvidé el PIN

Olvidé el PIN de un cajero

Pedile al administrador que lo cambie:

1. Configuración → Usuarios.
2. Botón PIN en la fila de esa persona.
3. PIN nuevo → Cambiar.

Olvidé el PIN de administrador

1. En la pantalla de inicio de sesión, hacé clic en ¿Olvidaste tu PIN de administrador?
2. Copiá el ID de hardware que aparece.
3. Enviánoslo y te mandamos un código de recuperación de un solo uso.
4. Pegá el código, escribí el PIN nuevo y hacé clic en Recuperar acceso.

Pasos con más detalle en el capítulo 8.

«Demasiados intentos. Reintentá en N min.»

Pasaste de 5 intentos fallidos con ese usuario. Esperá los minutos que dice el mensaje y probá otra vez. La primera vez es 1 minuto y se duplica con cada fallo extra, hasta 64 minutos. Cerrar y abrir la app no lo acelera.

9.3 La impresora no imprime

Primero, lo importante: la venta se guarda igual aunque no imprima. El aviso dice «No se pudo imprimir: (el motivo). La venta sí se guardó.». Nunca vuelvas a cobrar una venta solo porque no salió el ticket. Reimprimila desde Caja → Ventas del turno o, si sos administrador, desde Reportes → Historial de ventas.

Revisá lo básico

1. ¿La impresora está encendida y con luz fija, no parpadeando?
2. ¿Tiene papel y la tapa bien cerrada?
3. ¿El rollo está puesto por el lado correcto? El papel térmico imprime de un solo lado.
4. ¿El cable está firme en los dos extremos?
5. Apagá la impresora, esperá 10 segundos y encendela de nuevo.

Probá de nuevo

1. Entrá a Caja → Ventas del turno y hacé clic en el ojo de una venta. Si sos administrador, también podés usar Reportes → Historial de ventas y hacer clic en la fila.
2. En el ticket, hacé clic en el icono de impresora.

Cómo le habla KakawFlash a tu impresora

• El programa arma el ticket y se lo entrega a la cola de impresión de Windows, como cualquier otro programa. Alcanza con que la impresora aparezca instalada en Configuración de Windows → Bluetooth y dispositivos → Impresoras y escáneres; no hace falta ningún puerto COM ni LPT.
• Manda el trabajo a la impresora que elegiste en Configuración → Impresora. Si no elegiste ninguna, usa la predeterminada de Windows.
• Si la que elegiste ya no está conectada, prueba con la predeterminada y te lo avisa en esa pestaña.
• Las impresoras viejas de puerto serial o paralelo siguen funcionando: si la cola no responde, el programa prueba LPT1, LPT2 y COM1 como último recurso.
• Si no salió papel, te lo dice. El aviso es «No se pudo imprimir: …» con el motivo real. El programa ya no dice «Ticket enviado a impresora» cuando no imprimió nada.

Qué hacer entonces:

1. Entrá a Configuración → Impresora y tocá Imprimir prueba. El mensaje que salga ahí es el motivo exacto.
2. Si dice que no está conectada, tocá Actualizar lista, elegila de nuevo y Guardar.
3. Si la lista sale vacía, instalá el controlador del fabricante y volvé a probar.
4. Si nada de eso funciona, escribinos con el texto del aviso: nos dice casi siempre qué pasó.

El ticket que no salió no se perdió

Cuando ninguna impresora acepta el ticket, el programa lo guarda como archivo en esta carpeta para que puedas reenviarlo:

C:\Users\TU-USUARIO\AppData\Roaming\nekai-pos\receipts

Nos sirve para diagnosticar. No lo abras con doble clic: no es un documento normal.

Si la impresión funciona, ahí no queda nada: un ticket lleva el nombre y el NIT de tu cliente, así que no guardamos copias que nadie pidió. Los tickets que sí quedaron ahí se borran solos a los 7 días.

El cajón de monedas no abre

1. Revisá que el cajón esté conectado a la impresora (no a la computadora).
2. Revisá que esté marcada la casilla Abrir cajón de monedas en ventas de efectivo en Configuración → Negocio.
3. El cajón se abre cuando se imprime un ticket de venta en efectivo. Si la impresora no imprime, el cajón tampoco abre.

9.4 La licencia venció o no es válida

«Tu prueba gratis terminó» o «Licencia expirada»: no puedo cobrar

Desde la versión 1.0.15 el programa sigue abriendo, pero en modo solo lectura: podés ver, cerrar el turno, exportar y respaldar, pero no vender. Qué podés hacer y qué no está en el capítulo 7.

1. Entrá a Configuración → Licencia y hacé clic en Copiar junto al ID de hardware.
2. Enviánoslo a ceo@nekaigt.com con la versión que tenés y pedí tu licencia.
3. Pegá la clave en Activar licencia y hacé clic en Activar licencia.

Volvés a vender en el acto, sin reiniciar. Tus datos siguen intactos: no se borra nada.

La app pide activación al abrir

Pasa si nunca activaste una licencia, si la licencia no corresponde a esta computadora o si tenés la versión 1.0.14 o anterior con la licencia vencida.

1. Anotá o copiá el ID de hardware que muestra esa misma pantalla.
2. Enviánoslo a ceo@nekaigt.com y pedí tu licencia.
3. Pegá la clave en Clave de licencia.
4. Hacé clic en Activar licencia.

Si es una computadora nueva y querés probar primero, tocá Empezar prueba gratis de 14 días en esa misma pantalla. El botón aparece solo si el equipo nunca tuvo licencia ni prueba.

«Actualizamos los términos»

Aparece una vez, después de iniciar sesión, cuando una actualización trae textos legales nuevos. Los tiene que aceptar un administrador: es el dueño quien firma el contrato.

1. Iniciá sesión con un usuario Administrador.
2. Abrí y leé el contrato y el aviso de privacidad.
3. Marcá las dos casillas y hacé clic en Continuar.

Tus datos y tu licencia quedan como estaban.

Si entra primero un cajero, ve el mensaje «Los términos de KakawFlash cambiaron y un administrador tiene que leerlos y aceptarlos antes de seguir vendiendo.» Mientras nadie los acepte, ningún cajero puede vender. El cajero toca Ingresar con otro usuario y entra el administrador. Por eso, después de actualizar, conviene que el administrador sea el primero en abrir el programa.

Evitalo: la franja de aviso

Cuando faltan 30 días o menos, aparece una franja amarilla arriba avisándote. A los 7 días o menos se pone roja. En la prueba gratis la franja aparece todos los días y se pone roja cuando quedan 3. Pedí tu licencia apenas la veas, no el último día.

Si la licencia vence mientras estás trabajando, igual podés cerrar la caja y sacar el corte Z.

«Hardware cambiado»

La licencia está atada a esta computadora. Ese mensaje aparece cuando el programa ya no la reconoce: reinstalaste Windows formateando el disco, o pasaste a otra computadora. Cambiarle el nombre, o cambiar una pieza sin reinstalar Windows, no la afecta.

Mandanos el ID de hardware nuevo y te emitimos la licencia correspondiente, sin costo, por el tiempo que te quedaba. Si vas a cambiar de computadora o reinstalar Windows, avisanos antes y la tenemos lista. Tus datos no se ven afectados: desde la versión 1.0.15 no dependen del nombre del equipo.

9.5 La pantalla es chica (1024 × 600)

KakawFlash funciona desde 1024 × 600, que es lo que traen muchas mini PC de punto de venta. En esa resolución va justo, pero se puede trabajar cómodo.

1. Poné la app en pantalla completa. Maximizá la ventana.
2. Ocultá la barra de tareas de Windows. Clic derecho en la barra → Configuración → activá «Ocultar automáticamente la barra de tareas».
3. Escala de Windows al 100 %. Clic derecho en el escritorio → Configuración de pantalla → Escala en 100 %. Con 125 % la pantalla se ve como si fuera más chica todavía.
4. Usá el teclado en vez del mouse. F2 buscar, F4 cobrar, F8 confirmar. Así no dependés de ver botones lejanos.
5. Usá Ctrl + K para moverte entre pantallas sin buscar en el menú.
6. Cerrá el catálogo con F10 cuando no lo necesités: te devuelve todo el espacio al carrito.
7. En las tablas anchas (Productos, Reportes) deslizá con la rueda del mouse mientras mantenés Shift para moverte de lado.

Si la ventana se ve cortada, revisá primero la escala del punto 3: es la causa más común.

9.6 Otros mensajes que te podés encontrar

9.7 La app no abre o se ve en blanco

1. Cerrala del todo. Si quedó colgada, abrí el Administrador de tareas (Ctrl + Shift + Esc), buscá KakawFlash (o Nekai POS, si todavía tenés una versión anterior al cambio de nombre) y finalizá la tarea.
2. Volvé a abrirla desde el menú Inicio.
3. Si sigue igual, reiniciá la computadora.
4. Si después de reiniciar sigue igual, no reinstales todavía: escribinos primero. Copiá %APPDATA%\nekai-pos\nekai_pos.db a una USB antes de tocar nada.

9.8 Lo que nunca hay que hacer

1. No borres ni renombres archivos dentro de %APPDATA%\nekai-pos por tu cuenta.
2. No instales una versión más vieja encima de una más nueva.
3. No abras la base de datos con otro programa. Está cifrada y podés dañarla.
4. No compartas el PIN de administrador con el equipo.
5. No vuelvas a cobrar una venta porque no salió el ticket. Revisá primero el historial.

9.9 Cómo mandarnos el registro de la aplicación

KakawFlash anota en un archivo de texto lo que pasa por dentro: cuándo arrancó, qué falló, qué imprimió, cuándo respaldó y si buscó actualizaciones. Con ese archivo encontramos la causa sin pedirte que repitas el problema.

El archivo se llama kakawflash.log. Existe desde la versión 1.0.15.

Desde la app

Solo un administrador ve estos botones.

1. Entrá a Configuración → Licencia.
2. Buscá la tarjeta Actualizaciones. Abajo dice Registros de la aplicación y muestra dónde está el archivo.
3. Hacé clic en Abrir carpeta de logs. Se abre la carpeta en el Explorador de archivos.
4. Adjuntá el archivo kakawflash.log a tu correo para ceo@nekaigt.com.

Si preferís buscarlo vos, el botón Copiar ruta de los logs copia la dirección exacta.

Si la app no abre

El archivo se escribe igual. Buscalo así:

1. Abrí el Explorador de archivos de Windows.
2. Pegá %APPDATA%\nekai-pos\logs en la barra de direcciones y presioná Enter.
3. Adjuntá el archivo kakawflash.log.

La carpeta se llama nekai-pos, el nombre anterior del programa. Es la correcta: no la renombres.

Archivos con número

Cuando el archivo crece, el programa guarda el anterior como kakawflash.log.1, kakawflash.log.2 y así hasta .4. Si el problema fue hace varios días, mandanos también esos.

Qué lleva y qué no

No lo abras ni lo edites antes de mandarlo: mandalo tal cual.

Siguiente paso

Capítulo 10 — Preguntas frecuentes.