Errores comunes

Esta sección describe los problemas más frecuentes que podés encontrar, sus causas y cómo resolverlos paso a paso.

Impresora ESC/POS no detectada

Síntomas

La lista en Configuración → Negocio → Recibo → Impresora directa aparece vacía o no muestra tu impresora.
Al intentar imprimir un ticket el sistema muestra el mensaje “No se encontró ninguna impresora disponible” o “Error al enviar trabajo de impresión”.
El botón Imprimir prueba no produce ninguna reacción.

Causas posibles

Causa	Indicador
La impresora no está instalada en Windows	No aparece en el Panel de control → Dispositivos e impresoras
El servicio de impresión de Windows está detenido	La lista de impresoras tarda mucho en cargar o queda vacía
Driver incorrecto o corrupto	La impresora aparece pero con un ícono de advertencia en Windows
Cable USB suelto o impresora apagada	El LED de la impresora no enciende
Impresora de red en subred distinta	Aparece en Windows pero falla al imprimir

Pasos para diagnosticar

Abrí Panel de control → Dispositivos e impresoras en Windows y confirmá que tu impresora aparece sin advertencias.
Intentá imprimir una página de prueba desde Windows (clic derecho → Imprimir página de prueba). Si falla en Windows, el problema es externo al sistema.
Verificá que el servicio de impresión de Windows esté activo: presioná Win + R, escribí services.msc, buscá Print Spooler y comprobá que su estado sea En ejecución.
Si el servicio estaba detenido, inicialo y volvé a abrir Configuración → Negocio → Recibo.
Confirmá que el cable USB esté bien conectado en ambos extremos, o que la impresora de red esté en la misma red local que la computadora.

Solución

Driver faltante o incorrecto: descargá el driver oficial del fabricante e instalalo; luego reiniciá el servicio de impresión.
Servicio de impresión detenido: en services.msc, hacé clic derecho → Iniciar. Para que inicie automático, cambiá el tipo de inicio a Automático.
Impresora no seleccionada en el sistema: ve a Configuración → Negocio → Recibo → Impresora directa, elegí la impresora de la lista y guardá. Usá Imprimir prueba para confirmar.

“Licencia inválida” al iniciar

Síntomas

Al abrir la aplicación aparece la pantalla “Licencia inválida” o “No se pudo verificar la licencia” antes de llegar al inicio de sesión.
El sistema muestra el mensaje “El archivo de licencia no se encontró”.
Ves una cuenta regresiva de minutos antes de poder reintentar.

Causas

El hardware del equipo cambió: ocurre cuando cambias componentes importantes (placa madre, disco), reinstalás Windows, o movés la instalación a otra computadora. La licencia está vinculada al hardware del equipo.
Archivos de licencia eliminados o corruptos: los archivos de licencia fueron borrados, movidos o modificados por un antivirus u otra aplicación.
Licencia vencida: el período de activación llegó a su fin.
Reactivación necesaria: se requiere volver a ingresar la clave de licencia después de un cambio de hardware autorizado.

Solución

Si ya tenés la clave nueva, pegala en la pantalla de activación que aparece automáticamente.
Si todavía no la tenés, copiá el ID del equipo o la solicitud de renovación desde esa misma pantalla y enviasela a tu distribuidor.
Si cambiaste de computadora, contactá a Soporte con tu número de licencia para transferirla al nuevo hardware.
Si un antivirus eliminó los archivos de licencia, agregalos a la lista de exclusiones del antivirus y volvé a activar.

Estado local

Si la aplicación abre y tenés acceso a Acerca de, usá estos pasos antes de pedir ayuda:

Ve a Acerca de → Licencia.
En Estado local, hacé clic en Revisar.
Revisá el estado general y si algún control aparece como Correcto, Faltante o Atención.
Si soporte te lo pide, hacé clic en Paquete soporte. El sistema guarda un archivo ZIP en Descargas con información resumida de la licencia, sin incluir tus ventas, rutas locales ni claves.
Enviá ese ZIP a tu distribuidor autorizado.

No muevas ni modifiques los archivos de licencia manualmente. Cualquier modificación los invalida y requiere reactivación.

El servidor LAN no se descubre

Síntomas

Una terminal cliente muestra “No se encontró ningún servidor en la red” al iniciar.
El sistema queda en modo local cuando debería conectarse a un servidor remoto.
En la pantalla de conexión, el botón Buscar servidor gira indefinidamente sin resultado.

Causas

Causa	Probabilidad
Firewall de Windows bloqueando los puertos de TuBiznext	Alta
Computadoras en subredes distintas (ej. 192.168.1.x y 192.168.2.x)	Alta
El servidor no está corriendo (TuBiznext cerrado en el servidor)	Alta
La red Wi-Fi tiene aislamiento de clientes activo	Media

Cómo diagnosticar

En la computadora servidor, verificá que TuBiznext esté abierto y en modo Servidor. Esta revisión se hace desde Configuración → Red, por lo que requiere rol Administrador.
En la computadora cliente, abrí cmd y ejecutá: ping [IP del servidor]. Si no hay respuesta, la conectividad básica falla: revisá el cable o Wi-Fi.
En la computadora servidor, revisá el Firewall de Windows y verificá que los puertos de TuBiznext estén permitidos en las reglas de entrada.

Solución

Firewall bloqueando puertos: agregá las reglas de entrada correspondientes en el Firewall de Windows. El instalador de TuBiznext las crea automáticamente, pero pueden eliminarse. Consultá Red local → Si el Firewall bloquea la conexión para los pasos.
Subredes distintas: conectá todas las computadoras a la misma red (mismo router, mismo switch). La comunicación entre equipos no cruza subredes.
Wi-Fi con aislamiento de clientes: desactivá el “Client Isolation” o “AP Isolation” en la configuración de tu router. Esta opción impide la comunicación entre dispositivos Wi-Fi.

“Se detectó un servidor distinto al pareado”

Síntomas

Al iniciar sesión en una terminal cliente, aparece un banner amarillo con el texto “Se detectó un servidor distinto al pareado”.
La terminal no se conecta automáticamente al servidor que aparece en la red.

Causa

Cuando un cliente se conecta exitosamente a un servidor por primera vez, queda pareado con ese equipo. Si después aparece otro equipo intentando ser el servidor (con identidad distinta), la terminal lo detecta y muestra el aviso.

Esto puede ocurrir por dos motivos:

Legítimo: cambiaste el equipo servidor (reinstalación, equipo nuevo, etc.). La terminal todavía recuerda al anterior.
Sospechoso: alguien en la red intenta imitar al servidor para robar credenciales.

Solución

Si el cambio es legítimo:

En la terminal cliente, ve a Configuración → Red.
Bajá a la sección Servidor pareado.
Hacé clic en Olvidar servidor actual y confirmá.
Iniciá sesión de nuevo. La terminal se va a parear con el servidor disponible.

Si NO esperabas un cambio:

Avisá al Administrador de inmediato.
No te conectes manualmente.
Revisá quién más está en tu red (puede haber otro equipo intentando imitar al servidor).

“Servidor con firma inválida detectado”

Síntomas

Aparece un banner rojo en la terminal cliente con ese texto.
El servidor sospechoso aparece descartado automáticamente — la terminal no se conecta a él.

Causa

Se detectó un equipo en la red intentando hacerse pasar por el servidor pero sin la identidad correcta. La terminal lo rechazó automáticamente sin enviar ningún dato.

Solución

Esto es una alerta de seguridad seria. Actuá así:

Avisá al Administrador del negocio inmediatamente.
Identificá qué dispositivos están conectados a la red (revisá el panel de administración del router).
Desconectá cualquier equipo desconocido.
Si seguís viendo el aviso, considerá cambiar la contraseña del WiFi.

“Demasiados intentos fallidos” al iniciar sesión

Síntomas

Al intentar iniciar sesión aparece el mensaje “Demasiados intentos fallidos. Intentá en X minutos.”
La terminal NO permite ingresar la contraseña, ni la correcta.

Causa

Después de 5 intentos fallidos con contraseña incorrecta, el sistema bloquea automáticamente:

Por dirección IP — la computadora desde la que se intentó.
Por nombre de usuario — la cuenta afectada, sin importar desde qué computadora.

El bloqueo dura 30 minutos.

Solución

Esperá 30 minutos. El contador se resetea solo.
Confirmá la contraseña correcta antes de reintentar (los 5 intentos cuentan a un mismo bloqueo).
Si es urgente y no podés esperar, un Administrador puede reiniciar el servidor desde Configuración → Red → Detener servidor y volver a iniciarlo. Eso limpia los contadores.

“Licencia revocada remotamente”

Síntomas

Al abrir la aplicación aparece el mensaje “Licencia revocada remotamente. Contactá al proveedor.”
El sistema bloquea el acceso aunque antes funcionaba normalmente.

Causa

El distribuidor revocó tu licencia desde su panel de control. Causas posibles:

Falta de pago de la renovación.
Uso de la licencia en más equipos de los autorizados (clonación detectada).
Sospecha de manipulación del sistema reportada por la app.
Cierre del acuerdo comercial.

Solución

Contactá a tu distribuidor. Solo él puede reactivar la licencia.
Una vez resuelto (pago, aclaración, etc.), pediles que reactiven la licencia.
En tu equipo, abrí la aplicación — en el próximo intento de validación va a destrabarse automáticamente.

Conflicto de turno (dos turnos abiertos)

Síntomas

Al abrir la aplicación aparece el mensaje “Ya existe un turno abierto para este usuario” aunque no recordás haberlo abierto.
Un Vendedor intenta iniciar turno pero el sistema indica que ya tiene uno activo.
En el listado de turnos del Administrador aparecen dos entradas abiertas para el mismo Vendedor.

Causa

Esto ocurre cuando un turno no se cerró correctamente en una sesión anterior: la aplicación se cerró sin hacer el cierre de turno, hubo un corte de luz, o se cerró la ventana sin finalizar el turno.

El turno permanece abierto hasta que se cierre manualmente. No hay cierre automático por tiempo.

Cómo resolver

Si sos Vendedor:

Ve a Turnos → Cerrar turno.
Realizá el arqueo de caja con los montos reales del período.
Guardá el cierre. A partir de ese momento podés abrir un turno nuevo.

Si sos Administrador:

Ve a Turnos → Turnos de Trabajo en la barra de navegación.
Ubicá el turno abierto del vendedor afectado.
Cerralo directamente indicando en la nota que fue un cierre administrativo.
El Vendedor ya puede iniciar un turno nuevo.

La aplicación se cierra sola

Causas posibles

Un fallo inesperado en algún proceso interno de la aplicación.
La computadora tiene poca memoria RAM disponible y el sistema operativo termina el proceso.
Hay un error en los datos locales (disco lleno, archivo dañado).

Cuándo es un problema real

Situación	¿Problema real?
La app se cierra al iniciar sin ninguna acción	Sí
La app se cierra luego de registrar una venta	Sí
La app se cierra y hay un mensaje de error antes	Sí
La app se cierra al abrir herramientas de desarrollo	No

Cómo reportar

Si el cierre es inesperado:

Anotá la hora exacta y qué estabas haciendo cuando ocurrió.
Revisá si hay un mensaje de error en pantalla antes del cierre: capturalo o anotalo.
Contactá a Soporte con esa información.

La base de datos está bloqueada

Síntomas

La aplicación muestra el error “No se pudo completar la operación: base de datos ocupada”.
Una operación (venta, pago, ajuste de inventario) queda a la mitad y no se confirma.
El sistema responde lento y las operaciones de escritura tardan más de lo normal.

Causa común

El error aparece cuando varias operaciones intentan guardar datos al mismo tiempo y una de ellas no puede obtener acceso. También puede ocurrir si otro programa, como un antivirus o explorador de archivos, tiene abierto un archivo interno de TuBiznext.

Solución

Esperá unos segundos y reintentá. El sistema libera el bloqueo en cuanto la operación en curso termina. Un reintento inmediato suele ser suficiente.
Cerrá otros programas que puedan acceder a los archivos del sistema: exploradores de archivos, antivirus con inspección activa.
Reiniciá la aplicación: si el bloqueo persiste, cerrá y volvé a abrir TuBiznext.
En modo LAN: si varias terminales generan el error al mismo tiempo, evitá hacer operaciones masivas (importación de inventario, generación de reportes pesados) mientras se procesan ventas.

Un backup falla al restaurar

Síntomas

Al intentar restaurar, aparece el mensaje “Error al restaurar: archivo incompatible” o “La versión del respaldo no es compatible con esta instalación”.
La restauración comienza pero se interrumpe con un error.
Después de restaurar, la aplicación no abre o muestra datos incorrectos.

Causas

Causa	Descripción
Versión incompatible	El respaldo fue generado con una versión mayor de TuBiznext que la instalada actualmente
Archivo corrupto	El archivo de respaldo se dañó durante la transferencia o almacenamiento (USB defectuoso, corte de luz al copiar)
Archivo incompleto	La exportación no terminó correctamente — el archivo está truncado
Ruta incorrecta	El archivo fue renombrado o movido después de exportarse

Solución

Verificá la versión: comprobá que la versión de TuBiznext instalada sea igual o mayor a la versión con que se generó el respaldo.
Verificá la integridad del archivo: si el archivo viene de un USB, copialo al disco local primero y luego intentá restaurar.
Probá con un respaldo anterior: si tenés múltiples respaldos, intentá con el más reciente que funcione.
Actualizá TuBiznext: si el respaldo es de una versión más nueva, actualizá la aplicación antes de restaurar.

Guardá siempre al menos dos copias del respaldo en ubicaciones distintas (por ejemplo, USB y carpeta de red). Si un archivo se corrompe, el otro sirve de respaldo.

“Otro vendedor acaba de descontar stock”

Síntomas

Al confirmar una venta, aparece el mensaje “Otro vendedor acaba de descontar stock de “[producto]”. Refrescá el carrito y volvé a intentarlo.”
La venta NO se registró.

Causa

Dos Vendedores intentaron vender el mismo producto al mismo tiempo y uno confirmó primero. El stock real ya quedó en 0, o por debajo de la cantidad que pediste, y el sistema impide registrar tu venta para evitar stock fantasma negativo.

Esto no es un bug — es la protección que garantiza que el inventario siempre cuadra con la realidad.

Solución

Refrescá la pantalla del POS (presioná F5 o reabrí el producto desde el catálogo).
Vas a ver el stock actualizado en tiempo real.
Si todavía hay unidades, podés intentar la venta de nuevo.
Si no, avisá al cliente que el producto se acabó.

“Servidor en modo mantenimiento” al iniciar sesión

Síntomas

Al iniciar sesión aparece el error “Servidor en modo mantenimiento. Intentá en unos minutos.”.
Otros Vendedores tampoco pueden entrar.
Los Administradores sí pueden iniciar sesión normalmente.

Causa

Un Administrador activó el Modo mantenimiento desde el panel del servidor. Esto bloquea temporalmente los nuevos inicios de sesión de Vendedores mientras se hacen cambios o actualizaciones, sin desconectar a los que ya están conectados.

Solución

Esperá unos minutos. Normalmente el modo se desactiva en cuanto el Administrador termina lo que estaba haciendo.
Si necesitás entrar urgente, contactá al Administrador para que desactive el modo.
Los Vendedores que ya estaban conectados antes del modo mantenimiento siguen vendiendo normal. El modo no los desconecta.

“El servidor se va a cerrar” — toast rojo

Síntomas

Aparece un toast rojo durante 8 segundos: “En unos segundos quedará offline. Guardá tu trabajo y esperá la reconexión.”
A los pocos segundos perdés la conexión al servidor.

Causa

Un Administrador detuvo el servidor desde el panel de administración. El sistema te avisa con anticipación para que termines lo que estabas haciendo en vez de perder una venta a la mitad.

Solución

No empieces una venta nueva durante el aviso.
Si tenés una venta en proceso, terminala rápido (cobrala o cancelala).
Esperá unos segundos — el cliente del POS se reconecta solo cuando el servidor vuelve a estar disponible.

“Posible problema con la base de datos”

Síntomas

Aparece un toast rojo persistente: “Posible problema con la base de datos. Hacé un backup ahora.”
El mensaje incluye un código tipo *** in database main *** Page X: ....

Causa

El chequeo rápido de integridad que TuBiznext corre al arrancar y durante el día detectó inconsistencias en los datos locales. Causas comunes:

Corte de luz durante una operación de escritura pesada.
Disco duro empezando a fallar (sectores defectuosos).
Un antivirus que modificó archivos internos del sistema.
Apagar la PC mientras TuBiznext estaba escribiendo.

Solución

Hacé un backup ahora mismo desde Configuración → Datos → Backup cifrado. Esta acción requiere rol Administrador.
Guardá el backup en USB o en otra ubicación física distinta al disco actual.
Cerrá TuBiznext y reabrilo. A veces el chequeo da falso positivo si la app cerró mal antes.
Si el aviso persiste tras reiniciar, contactá a Soporte. Pueden ayudarte a reconstruir los datos desde un respaldo o desde una exportación segura.
Verificá la salud de tu disco duro con herramientas de Windows o de tu técnico.

“Cliente y servidor en redes distintas”

Síntomas

En el panel Diagnóstico de red de Configuración → Red aparece un evento rojo: “Cliente y servidor en redes distintas: X.X.X.X/24 vs Y.Y.Y.Y/24”.
La conexión funciona si ponés la IP manualmente, pero el descubrimiento automático no encuentra al servidor.

Causa

Tu computadora cliente está en una subred distinta a la del servidor (por ejemplo el cliente está en WiFi de invitados y el server en la red corporativa). El descubrimiento por broadcast UDP no cruza subredes, por eso falla el discovery, aunque la conexión TCP funcione si vas directo a la IP.

Solución

Opción A — usar IP manual (más rápido):

Si conocés la IP del servidor, un Administrador puede ponerla manualmente en Configuración → Red → Cliente → Ingresar IP manualmente. Funciona aunque estén en redes distintas.

Opción B — unir las redes (más correcto):

Conectá ambas computadoras a la misma red WiFi o cable.
En el router, desactivá el aislamiento entre redes guest/corporativa si lo tenés activo.
Si usás VPN, verificá que ambas máquinas estén dentro o fuera de la VPN — no mezcla.

“Sin permisos para abrir la base de datos” al iniciar el servidor

Síntomas

Al hacer clic en Iniciar servidor aparece el error: “Sin permisos para abrir la base de datos en [ruta]. Cerrá otras instancias de TuBiznext.”
El servidor no levanta.

Causa

Otra instancia de TuBiznext, o un proceso de una sesión anterior, tiene abierto un archivo interno en modo exclusivo. Causas:

Tenés dos ventanas de TuBiznext abiertas simultáneamente.
Un proceso anterior crasheó y quedó zombi.
Un antivirus está scanneando el archivo en ese momento.

Solución

Cerrá todas las ventanas de TuBiznext en esta computadora.
Abrí el Administrador de tareas (Ctrl+Shift+Esc), buscá tubiznext-server.exe o TuBiznext.exe y finalizalos si quedaron corriendo.
Reabrí TuBiznext y volvé a intentar iniciar el servidor.
Si pasa siempre, agregá la carpeta de datos de TuBiznext a las exclusiones de tu antivirus.

“El servidor no respondió en Xs”

Síntomas

Al iniciar el servidor aparece: “El servidor no respondió en 14s (puerto 7878). Aumentá el timeout en Configuración → Red → Avanzado si tu PC es lenta.”
El servidor no levanta tras varios intentos.

Causa

La PC servidor tardó más de lo configurado en arrancar el proceso del servidor LAN. Causas típicas:

Disco duro viejo o lento.
Antivirus haciendo análisis al arranque del proceso.
PC con poca RAM (muchas apps abiertas).
Base de datos muy grande que tarda en abrir.

Solución

Aumentá el timeout desde Configuración → Red → Modo Servidor → Avanzado. Subí el slider a 30 o 45 segundos.
Volvé a hacer clic en Iniciar servidor.
Si seguís teniendo el problema con timeout >30s, revisá:
- Espacio libre en disco (mínimo 2 GB).
- Si el antivirus está escaneando el proceso (agregá excepción).
- Tamaño de la base local. Si creció demasiado, pedí ayuda a soporte para archivar o limpiar datos viejos.

“No se encontró un puerto libre” al iniciar el servidor

Síntomas

Al iniciar el servidor aparece: “No se encontró un puerto libre entre 7878 y 7883. Último error: puerto X en uso.”
El servidor no arranca.

Causa

Tanto el puerto preferido como los 5 siguientes consecutivos están ocupados por otros programas (otro server web local, otra instalación de TuBiznext, herramientas de desarrollo, etc.).

Solución

Cerrá otros programas que puedan estar usando esos puertos (dev servers, otros POS, servicios de red).
Si no podés cerrarlos, cambiá el puerto base desde Configuración → Red → Modo Servidor → Puerto a uno alejado (por ejemplo 8800).
Avisá a las terminales cliente del nuevo puerto si ya estaban configuradas.

Si el problema que enfrentás no está en esta lista, consultá las Preguntas frecuentes o contactá a Soporte.

¿Todavía no tienes TuBiznext? Pruébalo 30 días gratis.