Guía de instalación — KakawFlash

Todo lo que necesitás saber antes, durante y después de instalar KakawFlash en Windows.

Si solo querés empezar rápido, andá al capítulo 1 del manual.

KakawFlash antes se llamaba Nekai POS. Es el mismo programa, de la misma empresa (Nekai Tech Solutions, S.A.). Cambia el nombre, nada más: tus datos, tu licencia y las actualizaciones automáticas siguen igual.

1. Requisitos

Sistema operativo

No hay instalador para macOS ni para Linux. Hoy distribuimos solo Windows.

Equipo

La ventana del programa no se puede achicar por debajo de 1024 × 600. Es el tamaño que traen muchas mini PC de punto de venta. La ventana abre en 1280 × 800 cuando la pantalla lo permite.

Si tu pantalla es de 1024 × 600, poné la escala de Windows al 100 %: con 125 % vas a ver la ventana cortada. Hay más consejos en el capítulo 9 del manual.

Opcional pero muy recomendable

• Escáner de código de barras USB (los que funcionan como teclado). No hay nada que configurar.
• Impresora térmica de tickets. Ver la sección 7.
• Cajón de monedas conectado a la impresora.

2. WebView2

KakawFlash usa WebView2, un componente gratuito de Microsoft para mostrar la interfaz.

• En Windows 11 ya viene instalado.
• En Windows 10 suele venir con Microsoft Edge, que está en casi todos los equipos.
• Si falta, el instalador de KakawFlash lo descarga e instala solo. Para eso necesita internet durante la instalación.

Si la computadora no tiene internet, instalá WebView2 antes por tu cuenta: buscá «Microsoft Edge WebView2 Runtime» en el sitio de Microsoft, descargá el instalador Evergreen Standalone de 64 bits y ejecutalo.

3. Instalar

1. Conseguí el archivo KakawFlash_X.Y.Z_x64-setup.exe.

   • Te lo enviamos nosotros, o
   • lo descargás de https://github.com/NeKai-devs/nekai-pos-releases/releases/latest.
2. Cerrá KakawFlash si ya lo tenías abierto.
3. Hacé doble clic en el instalador.
4. Si aparece el aviso azul de Windows, mirá la sección 4.
5. Seguí el asistente hasta el final.
6. Abrí KakawFlash desde el menú Inicio.

No hace falta ser administrador

El instalador es por usuario: instala para la cuenta de Windows con la que estás trabajando. No pide contraseña de administrador y no toca al resto de los usuarios del equipo.

Por lo mismo: si instalás con un usuario de Windows y después iniciás sesión con otro, ese otro usuario no va a ver el programa. Instalá siempre con la cuenta que se usa en el mostrador.

Dónde queda instalado

Normalmente en:

C:\Users\TU-USUARIO\AppData\Local\KakawFlash

Si instalaste una versión anterior, cuando el programa todavía se llamaba Nekai POS, la carpeta se llama Nekai POS. El instalador nuevo la reemplaza solo.

Actualizar a una versión nueva

Ejecutá el instalador nuevo encima. No desinstales primero. La instalación anterior se reemplaza y tus datos quedan intactos. Eso vale también al pasar de una versión «Nekai POS» a una «KakawFlash»: es el mismo programa con otro nombre.

Lo habitual es que ni siquiera tengas que hacerlo a mano: la app avisa sola cuando hay una versión nueva. Ver el capítulo 7 del manual.

4. El aviso «Windows protegió tu PC»

Al ejecutar el instalador es probable que veas una pantalla azul que dice «Windows protegió tu PC» y menciona a SmartScreen.

Qué significa: el instalador de KakawFlash todavía no lleva firma de editor (Authenticode). Windows no puede mostrar el nombre de la empresa que lo firmó, así que avisa por precaución. No quiere decir que el archivo tenga un virus ni que esté dañado.

Cómo continuar:

1. Hacé clic en Más información.
2. Hacé clic en Ejecutar de todas formas.

Cómo saber que el archivo es el nuestro:

• Descargalo únicamente desde el enlace de arriba o del que te enviamos nosotros.
• El nombre tiene esta forma exacta: KakawFlash_X.Y.Z_x64-setup.exe.
• Nunca lo bajes de un buscador, de un grupo de WhatsApp ni de una página de descargas.

¿Y las actualizaciones automáticas? Esas sí están firmadas, con una firma criptográfica propia que la app verifica antes de instalar. Si la firma no coincide, la actualización no se instala. Ahí SmartScreen no aparece.

Estamos trabajando en agregar la firma de editor al instalador para que el aviso desaparezca.

5. Dónde quedan tus datos

Tus datos no viven en la carpeta del programa. Están en:

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

Atajo: pegá %APPDATA%\nekai-pos en la barra del Explorador de Windows.

La carpeta y los nombres de archivo siguen diciendo nekai-pos / nekai_pos aunque el programa ahora se llame KakawFlash. Es a propósito: así las instalaciones anteriores y los respaldos ya guardados siguen funcionando tal cual.

Qué hay adentro:

Las exportaciones de Reportes (CSV y PDF) no van acá: se guardan en tu Escritorio. No están cifradas y llevan nombres y NIT de tus clientes: borralas cuando termines.

Consecuencia práctica: desinstalar o reinstalar el programa no borra tus datos. Y copiar nekai_pos.db a una USB es copiar todo tu negocio.

6. Requisitos de red

KakawFlash es offline-first: vendé, cobrá e imprimí sin internet.

Solo necesita salir a internet para dos cosas:

La app no envía tus ventas ni los datos de tus clientes a ningún lado, ni estadísticas de uso.

Si tenés firewall o proxy en el negocio, pedí que dejen pasar los tres dominios de la primera fila. Sin eso las actualizaciones no llegan y no vas a saber por qué: la app lo muestra en Configuración → Licencia → Actualizaciones → Último error.

7. Impresoras térmicas

Cómo le habla KakawFlash a la impresora

Desde la versión 1.0.15:

1. El programa arma el ticket con comandos ESC/POS, el estándar de las impresoras térmicas.
2. Lo entrega a la cola de impresión de Windows, como cualquier otro programa. Alcanza con que la impresora aparezca en Configuración de Windows → Bluetooth y dispositivos → Impresoras y escáneres.
3. Usa la impresora que elegiste en Configuración → Impresora. Si no elegiste ninguna, usa la predeterminada de Windows.
4. Si la cola no responde, prueba los puertos viejos LPT1, LPT2 y COM1, para impresoras de puerto serial o paralelo.
5. Si no salió papel, te avisa con el motivo: «No se pudo imprimir: …». La venta queda guardada igual. El ticket se guarda como archivo en %APPDATA%\nekai-pos\receipts\ para reenviarlo, y se borra solo a los 7 días. Cuando la impresión funciona no se guarda ninguna copia: un ticket lleva el nombre y el NIT del cliente.

Para elegir la impresora, el ancho de papel (58 u 80 mm) y probarla, mirá el manual, capítulo 7, sección «Impresora».

En la versión 1.0.14 o anterior el programa solo probaba LPT1, LPT2 y COM1, no usaba la cola de Windows y no avisaba cuando no imprimía. Si tenés una de esas versiones, actualizá.

Qué impresora comprar

Buscá una impresora térmica de 58 mm o 80 mm que sea:

• compatible con ESC/POS (casi todas lo son), y
• con controlador para Windows 10/11, para que aparezca en «Impresoras y escáneres».

USB, red o serial sirven las tres. Si tenés dudas antes de comprar, escribinos con el modelo a ceo@nekaigt.com.

El logo en el ticket

Si cargás un logo en Configuración → Negocio, se imprime arriba del ticket, centrado, convertido a blanco y negro. El ancho que usa es el más común en impresoras de 58 mm. En una de 80 mm sale igual, centrado.

Formatos aceptados: PNG, JPG o WEBP, hasta 2 MB.

El cajón de monedas

Se conecta a la impresora, no a la computadora. Con la casilla Abrir cajón de monedas en ventas de efectivo activada (viene marcada), cada ticket de venta en efectivo manda la señal estándar de apertura.

Si la impresora no imprime, el cajón tampoco abre.

8. Desinstalar

1. Abrí Configuración de Windows → Aplicaciones → Aplicaciones instaladas.
2. Buscá KakawFlash. Si todavía tenés una versión anterior al cambio de nombre, aparece como Nekai POS.
3. Hacé clic en Desinstalar.

También podés usar el desinstalador que está en la carpeta de instalación.

Qué se borra y qué no

El desinstalador ofrece la casilla «Eliminar los datos de aplicación». No borra tus ventas: borra otras carpetas, com.nekai.pos dentro de %APPDATA% y de %LOCALAPPDATA%, con preferencias de la ventana. No hace falta marcarla.

Si querés borrar también tus datos, tenés que eliminar %APPDATA%\nekai-pos a mano. Es irreversible. Copiala a una USB antes, aunque creas que no la vas a necesitar.

Si tenés «Nekai POS» y «KakawFlash» a la vez

Pasa si actualizaste desde la versión 1.0.13 o anterior, cuando el programa se llamaba Nekai POS. Windows deja las dos entradas, pero los datos son los mismos. Usá KakawFlash y desinstalá Nekai POS como arriba, sin marcar la casilla de borrar datos. Tus ventas siguen en KakawFlash.

Si instalaste el archivo .msi

Las versiones 1.0.13 a 1.0.16 publicaron, además del -setup.exe, un instalador .msi. Ese instala el programa para todo el equipo, en C:\Program Files\KakawFlash (en la 1.0.13, C:\Program Files\Nekai POS), y pide contraseña de administrador. Las actualizaciones automáticas instalan siempre el -setup.exe, que es por usuario. Desde la versión 1.0.17 solo existe el -setup.exe.

Al actualizar, el instalador detecta el .msi y te pide desinstalarlo, con una ventana de Windows Installer y la contraseña de administrador:

• Si aceptás, queda una sola instalación y no tenés que hacer nada más.
• Si cancelás o no tenés la contraseña, quedan dos KakawFlash, y el acceso directo viejo puede seguir abriendo la versión anterior, que vuelve a ofrecer la actualización. Seguí los pasos de abajo.

Para saber si te quedó el .msi, abrí en el Explorador C:\Program Files\KakawFlash o C:\Program Files\Nekai POS. Si alguna de esas carpetas existe, todavía está instalado.

Para quedarte con uno solo (tus datos no se tocan: viven en %APPDATA%\nekai-pos, no en la carpeta del programa):

1. Por las dudas, creá un respaldo portable y copialo a una USB (Configuración → Respaldos).
2. Cerrá KakawFlash.
3. En Configuración de Windows → Aplicaciones → Aplicaciones instaladas, desinstalá todas las entradas KakawFlash. Si aparece la casilla «Eliminar los datos de aplicación», no la marques. Si Windows pide la contraseña de administrador, es la del .msi.
4. Con la cuenta de Windows que se usa en el mostrador, instalá el KakawFlash_X.Y.Z_x64-setup.exe más reciente (sección 3).
5. Abrí KakawFlash, ingresá con tu PIN y revisá que estén tus ventas.

9. Lista de verificación después de instalar

Marcá cada punto la primera vez:

• [ ] La app abre y muestra la pantalla de consentimiento.
• [ ] La licencia quedó activada (Configuración → Licencia → Licencia Activa).
• [ ] Cambiaste el PIN de fábrica del usuario admin.
• [ ] Completaste los datos del negocio y el IVA.
• [ ] El escáner agrega productos al carrito.
• [ ] Sale un ticket de prueba por la impresora.
• [ ] El cajón de monedas abre con una venta en efectivo.
• [ ] Configuración → Licencia → Actualizaciones dice Al día y muestra la fecha del último chequeo.
• [ ] Creaste un primer respaldo y lo copiaste a una USB.

Si algún punto falla, buscalo en el capítulo 9 del manual.

10. Problemas durante la instalación

Contacto

Escribinos a ceo@nekaigt.com, de lunes a viernes en horario de oficina. Es nuestro único canal de soporte; todavía no tenemos WhatsApp ni teléfono.

Cuando escribas, incluí:

• la versión del instalador (KakawFlash_X.Y.Z_x64-setup.exe),
• tu versión de Windows,
• y una foto o captura del mensaje de error.