Errores Frecuentes¶
Producto: OpenTPV | Módulo: Solución de Problemas | Última actualización: 2026-03-18
Introducción¶
OpenTPV muestra mensajes de error categorizados por tipo y color. Esta guía le ayudará a entender y resolver los errores más comunes.
Tipos de Mensajes¶
OpenTPV utiliza un sistema de mensajes clasificados por severidad:
| Tipo | Color | Sonido | Descripción |
|---|---|---|---|
| AVISO | 🔴 Rojo | aviso.wav | Información importante que requiere atención |
| ALERTA | 🟡 Dorado | alerta.wav | Advertencia que podría afectar la operación |
| ERROR | 🔴 Rojo | error.wav | Error que impide continuar la operación |
| CONFIRMACIÓN | 🟢 Verde | — | Solicita confirmación del usuario (Sí/No) |
| ENTRADA | — | — | Solicita ingreso de datos (con campo de texto) |
Errores de Conexión¶
"No se puede conectar al servidor de base de datos"¶
| Aspecto | Detalle |
|---|---|
| Tipo | ERROR |
| Causa | MariaDB no está ejecutándose o los datos de conexión son incorrectos |
| Solución | 1. Verifique que el servicio MariaDB esté activo 2. Revise servidor, puerto, usuario y contraseña en Conexiones |
"Timeout de conexión"¶
| Aspecto | Detalle |
|---|---|
| Tipo | ERROR |
| Causa | La base de datos no responde a tiempo |
| Solución | 1. Verifique la red 2. Reinicie el servicio MariaDB 3. Verifique carga del servidor |
Errores de Facturación Electrónica¶
"No hay folios disponibles para este tipo de documento"¶
| Aspecto | Detalle |
|---|---|
| Tipo | ERROR |
| Causa | Se agotaron los folios del CAF para el tipo de documento seleccionado |
| Solución | 1. Vaya a Documentos Electrónicos → CAF 2. Solicite nuevos folios en sii.cl 3. Cargue el nuevo archivo CAF |
"CAF vencido"¶
| Aspecto | Detalle |
|---|---|
| Tipo | ALERTA |
| Causa | El CAF tiene más de 6 meses desde su autorización |
| Solución | Solicite nuevos folios en el SII y cargue el nuevo CAF |
"Certificado digital expirado"¶
| Aspecto | Detalle |
|---|---|
| Tipo | ERROR |
| Causa | El certificado .pfx ha vencido |
| Solución | 1. Renueve el certificado con su proveedor 2. Actualice el archivo en Documentos Electrónicos → Emisor |
"Error al firmar el documento"¶
| Aspecto | Detalle |
|---|---|
| Tipo | ERROR |
| Causa | La clave del certificado es incorrecta o el archivo está corrupto |
| Solución | 1. Verifique la clave del certificado 2. Use el botón Comprobar en la configuración del emisor 3. Si persiste, reinstale el certificado |
"Error en el envío al SII"¶
| Aspecto | Detalle |
|---|---|
| Tipo | ERROR |
| Causa | No se pudo enviar el DTE a los servidores del SII |
| Solución | 1. Verifique la conexión a internet 2. Verifique que el ambiente (Certificación/Producción) sea correcto 3. Reintente desde Documentos Electrónicos → Envíos SII |
Errores de Venta¶
"Cliente requerido para este tipo de documento"¶
| Aspecto | Detalle |
|---|---|
| Tipo | AVISO |
| Causa | Intentó emitir factura sin asignar un cliente |
| Solución | Asigne un cliente con F11 antes de cobrar |
"Stock insuficiente"¶
| Aspecto | Detalle |
|---|---|
| Tipo | ALERTA |
| Causa | El producto no tiene stock en la bodega activa |
| Solución | Verifique el stock del producto. Según la configuración, puede continuar con advertencia o la venta se bloquea |
"Crédito insuficiente"¶
| Aspecto | Detalle |
|---|---|
| Tipo | ALERTA |
| Causa | El cliente no tiene crédito suficiente para la venta |
| Solución | 1. Solicite autorización de un supervisor 2. Cambie a pago en efectivo o tarjeta 3. Ajuste el límite de crédito del cliente |
"Descuento excede el máximo permitido"¶
| Aspecto | Detalle |
|---|---|
| Tipo | AVISO |
| Causa | El descuento aplicado supera el límite configurado para el usuario |
| Solución | Solicite autorización de un supervisor con código |
Errores de Pago¶
"Error de comunicación con terminal de pago"¶
| Aspecto | Detalle |
|---|---|
| Tipo | ERROR |
| Causa | No se puede comunicar con el terminal Transbank/BCI/Haulmer |
| Solución | 1. Verifique la conexión del terminal 2. Use Chequear Conexión 3. Reinicie el terminal 4. Use Ingreso Manual como respaldo |
"Transacción rechazada"¶
| Aspecto | Detalle |
|---|---|
| Tipo | AVISO |
| Causa | El banco rechazó la transacción |
| Solución | El cliente debe intentar con otra tarjeta o medio de pago |
Errores de Impresión¶
"Impresora no disponible"¶
| Aspecto | Detalle |
|---|---|
| Tipo | ERROR |
| Causa | La impresora configurada no responde |
| Solución | 1. Verifique conexión física 2. Verifique puerto en Administración → Impresoras 3. Reinicie la impresora |
"Error al generar reporte"¶
| Aspecto | Detalle |
|---|---|
| Tipo | ERROR |
| Causa | Crystal Reports no pudo generar el documento |
| Solución | 1. Verifique que Crystal Reports Runtime esté instalado 2. Reinicie la aplicación 3. Si persiste, reinstale OpenTPV |
Consultar el Log de Errores¶
Para diagnóstico detallado:
- Vaya a Administración → Logs
- Filtre por nivel ERROR
- Revise el campo Message para la descripción
- Revise Exception y StackTrace para detalles técnicos
- Exporte a Excel si necesita enviar a soporte
Niveles de log¶
| Nivel | Descripción |
|---|---|
| INFO | Operaciones normales registradas |
| WARNING | Advertencias que no impiden la operación |
| ERROR | Errores que impiden completar una operación |
¿Necesita ayuda adicional? Contacte a soporte: soporte@openx.cl