Problemas Comunes¶

Producto: OpenTPV | Módulo: Solución de Problemas | Última actualización: 2026-03-18

Introducción¶

Esta guía cubre los problemas más frecuentes que pueden ocurrir durante el uso diario de OpenTPV y sus soluciones paso a paso.

Problemas de Conexión¶

El sistema no conecta a la base de datos¶

Síntomas: Mensaje de error al iniciar OpenTPV, pantalla en blanco o mensaje "No se puede conectar al servidor".

Soluciones:

Verifique que MariaDB esté ejecutándose:
Abra el Administrador de Servicios de Windows
Busque el servicio "MariaDB" o "MySQL"
Si está detenido, inícielo
Verifique los datos de conexión:
Vaya a Administración → Conexiones
Confirme que el servidor, puerto, base de datos, usuario y contraseña sean correctos
Puerto por defecto: 3306
Verifique el firewall:
Asegúrese de que el puerto 3306 esté permitido en el firewall de Windows
Si usa un servidor remoto, verifique la conectividad de red

La conexión se pierde intermitentemente¶

Soluciones: - Verifique la estabilidad de la red - Revise los cables de red y switches - Aumente el timeout de conexión en la configuración - Si usa Wi-Fi, considere cambiar a conexión por cable

Problemas de Impresión¶

La impresora no imprime¶

Soluciones:

Verifique la conexión física:
Cable USB o de red conectado correctamente
Impresora encendida con papel
Verifique la configuración:
Vaya a Administración → Impresoras
Confirme que el puerto de impresora sea correcto
Pruebe con una impresión de prueba
Reinstale el driver:
Desinstale la impresora de Windows
Reinstale usando el driver del fabricante

El ticket se imprime con caracteres extraños¶

Soluciones: - Verifique que el modelo de impresora sea compatible con ESC/POS - Confirme que el ancho de papel configurado coincida con el real (58mm vs 80mm) - Actualice el firmware de la impresora si es posible

El timbre electrónico no se imprime¶

Soluciones: - El timbre PDF417 requiere una impresora de al menos 80mm - Verifique que la impresora soporte gráficos de alta densidad - Reinicie la impresora y reintente

Problemas con DTE¶

No se genera el DTE¶

Posibles causas y soluciones:

Causa	Solución
Certificado expirado	Renueve el certificado digital (.pfx)
Sin folios disponibles	Cargue un nuevo CAF desde el SII
CAF vencido	Solicite nuevos folios (los CAF vencen a los 6 meses)
Datos del emisor incorrectos	Verifique en Documentos Electrónicos → Emisor

El SII rechaza el DTE¶

Motivos comunes:

Error SII	Significado	Solución
Folio ya utilizado	El número de documento ya fue usado	Verifique la secuencia de folios
Certificado no válido	El certificado no es reconocido	Reinstale el certificado
RUT emisor no autorizado	La empresa no está habilitada	Verifique su habilitación en sii.cl
Error en el XML	El documento tiene errores de formato	Contacte a soporte técnico

Los DTE no se envían al SII¶

Soluciones: 1. Verifique la conexión a internet 2. Verifique que el ambiente (Certificación/Producción) sea correcto 3. Envíe manualmente desde Documentos Electrónicos → Envíos SII 4. Revise los logs del sistema para más detalles

Problemas con Transbank¶

El terminal no responde¶

Verifique la conexión del cable al terminal
Verifique el puerto COM configurado en Administración → Conexiones
Use Chequear Conexión desde las funciones de Transbank
Reinicie el terminal y reintente
Si persiste, cargue las llaves nuevamente

Pago aprobado pero no registrado en OpenTPV¶

Use Último Pago para verificar la transacción en el terminal
Si fue aprobada, use Ingreso Manual para registrarla en OpenTPV
Ingrese el número de operación y código de autorización del voucher

Problemas de Inventario¶

El stock no coincide¶

Posibles causas: - Ventas sin descuento de inventario activado - Devoluciones no procesadas - Traspasos no registrados - Mermas no registradas

Solución: Realice una toma de inventario y rectifique las diferencias.

Productos duplicados¶

Si tiene productos duplicados en el sistema: 1. Identifique cuál es el producto correcto (con historial de ventas) 2. Transfiera el stock del duplicado al producto principal 3. Desactive o elimine el producto duplicado

Problemas de Rendimiento¶

El sistema va lento¶

Base de datos: Verifique que el servidor MariaDB tenga recursos suficientes
Red: Compruebe la velocidad de conexión al servidor
Catálogo grande: Si tiene más de 50.000 productos, considere optimizar las búsquedas usando categorías
Logs: Limpie los registros de log antiguos periódicamente
Antivirus: Asegúrese de que OpenTPV esté en la lista de excepciones del antivirus

Preguntas Frecuentes¶

¿Dónde están los archivos de log? En [Directorio de la aplicación]\Log\General.log y en la base de datos (accesible desde Administración → Logs).

¿Cómo contacto a soporte técnico? Envíe un email a soporte@openx.cl con la descripción del problema, capturas de pantalla y el archivo de log.

¿Puedo reinstalar OpenTPV sin perder datos? Sí, siempre que no elimine la base de datos. Los datos están en MariaDB, no en la carpeta de la aplicación.

¿Necesita ayuda adicional? Contacte a soporte: soporte@openx.cl