TimeFlow · Manual de Errores y Diagnóstico de Entregas

🔴 Falló: SMTP unexpected / Conexión cerrada Desconexión Abrupta del Servidor de Correo

Este error se produce cuando el sistema intenta comunicarse con el servidor de correo SMTP (cPanel / Exim en Orbit) pero la conexión TCP se corta inesperadamente antes de recibir la confirmación de envío.

Ejemplo real detectado:

2026-09-09 14:30:05 | ANGEL MARCELO RODRIGUEZ ABARCA | Compupress SpA | Retorno colacion (reloj: Entrada) | SMTP unexpected: | SPK7242800420

¿Por qué ocurrió exactamente?

Hora punta de retorno de colación (14:30 hrs): Cuando varios trabajadores marcan casi al mismo segundo al volver del almuerzo, se abren múltiples conexiones SMTP salientes simultáneas. El servidor cPanel / Exim tiene una protección anti-flood que cierra conexiones si detecta ráfagas en pocos segundos.
Destinatario externo (Yahoo / Hotmail): El correo de Ángel Rodríguez es [email protected]. Los servidores de Yahoo aplican retardos (greylisting o verificación de spam en tiempo real) que demoran la respuesta en el comando RCPT TO o DATA, provocando que la conexión local alcance el límite de espera y el socket se cierre.
Respuesta vacía: Al cerrarse el socket, la función de lectura recibió cadena vacía y reportó textualmente SMTP unexpected: .

🛠️ Solución y Prevención Aplicada:

Reintento Automático: El sistema ahora reintenta automáticamente el envío una segunda vez tras esperar 1 segundo si la conexión cae, absorbiendo desconexiones momentáneas sin intervención.
Diagnóstico Claro: El mensaje ya no sale en blanco; ahora indica con precisión si fue Timeout, Anti-flood o Desconexión de socket.
Reenvío en 1 Clic: En la pestaña "Correos" de administración, puede hacer clic en "Actualizar" o reenviar el comprobante si el trabajador lo solicita.

🟡 Sin correo en ficha (pending_no_email) Trabajador no tiene email registrado

Aparece en la tabla de Marcas en Vivo y en la auditoría de Correos cuando el reloj registra una marcación válida de asistencia o entrada de un operario, pero su ficha no tiene una dirección de correo configurada.

🛠️ Cómo Solucionarlo:

Vaya a la pestaña "👥 Personas" → "Fichas" en el panel de administración.
Busque al trabajador por su nombre o RUT.
Haga clic en "Editar Ficha".
Complete el campo Correo Electrónico (personal o de la empresa) y guarde los cambios.
A partir de ese momento, todas sus marcaciones y vales de colación llegarán de inmediato a su correo.

⚠️ Vale ya emitido hoy (Doble canje bloqueado) Control de Raciones de Almuerzo

Por normativa y control interno de casino, cada trabajador tiene derecho a 1 vale de colación de almuerzo por jornada laboral, el cual se genera automáticamente con su primera marca de "Entrada" de la mañana.

¿Qué pasa si vuelve a marcar entrada o pasa dos veces por el casino?
El sistema detecta la restricción única UNIQUE(uid, fecha, tipo). La terminal del casino alertará con un pop-up rojo: "Vale ya canjeado hoy a las HH:MM hrs", impidiendo el cobro duplicado del plato.

🌙 ¿Qué hacer si el trabajador se queda en Horas Extras (Onces)?

No use el vale de almuerzo: Los vales de almuerzo no sirven para la tarde.
Portal de Jefaturas: El Jefe de Producción o Taller debe ingresar al nuevo portal /jefe/ con su correo corporativo y autorizar la colación de tarde (onces) para el personal de horas extras.
El trabajador recibirá un nuevo vale QR exclusivo de tarde (ej. EGI-13613899-20260909-T-XXXX).

⚠️ Vale Expirado Intento de canje de un vale de fecha anterior

Los vales de colación tienen vigencia diaria estricta (expiran a las 23:59:59 del mismo día de emisión). Un vale generado un día martes no puede ser utilizado un miércoles. La terminal de casino rechazará el canje automáticamente con alerta de caducidad.

🔴 Código de Vale Inválido / Checksum HMAC Erróneo Falsificación o código adulterado

Cada código QR incluye una firma criptográfica HMAC de 4 caracteres hex (ej. 9A3F). Si alguien intenta alterar el RUT, la fecha o la empresa en el código de barras, la terminal de casino detecta la discrepancia matemática y rechaza el canje por seguridad.

🟢 Enviado OK (Aceptado por Servidor SMTP) Entrega Exitosa al Servidor Saliente

Indica que el correo fue generado, firmado y entregado exitosamente al servidor SMTP local (Exim en cPanel), el cual se encarga de enrutarlo al buzón de destino (Gmail, Yahoo, Outlook, etc.).