Presentismo QR y fichada¶
Tipo: referencia. Dirigida a: todo el personal que ficha y quien administra los locales. Menú: Asistencias > Presentismo-QR (y su subpantalla de generación). Páginas hermanas: Guía: fichar con el QR · Guía: generar e imprimir el QR · Explicación: fichada con QR y ubicación · Presentismo · Mis Fichadas
Acción (permiso)¶
| Acción | Nombre | Qué habilita |
|---|---|---|
generar_qr |
Generar QR (submódulo Presentismo QR) | Es la acción que Hexalba exige para registrar una fichada por QR. Quien no la tiene no puede fichar con el celular. |
Aunque se llame "Generar QR", gobierna la fichada. La pantalla de generación está enlazada desde la de fichada y la ve quien llegue a ella.
Pantalla de fichada¶
| Elemento | Contenido |
|---|---|
| Indicador Cámara | Solicitando... / Activa / Sin permiso. |
| Indicador GPS | Solicitando... / Activo / Sin permiso. La ubicación se pide una sola vez, al abrir la pantalla (con alta precisión y hasta 15 segundos). |
| Escanear QR del Local | Visor de cámara (cámara trasera), 10 cuadros por segundo, recuadro de 250 px. |
| Reintentar cámara | Aparece si no hay permiso de cámara; vuelve a pedirla sin recargar. |
| Tu Información | Nombre, apellido, rol y turno del usuario (solo lectura). |
| Resultado | Panel verde Fichada Exitosa (mensaje, hora y estado) o rojo Error al Fichar (mensaje). Botón Escanear de Nuevo. |
| Enlace Generar / Imprimir QR de Locales | Lleva a la pantalla de generación. |
Hexalba solo habilita la cámara y la ubicación para la propia app, no para sitios de terceros.
Qué se guarda al fichar¶
| Dato | Valor |
|---|---|
| Empleado, local | Los de la sesión y el QR escaneado. |
| Hora | La del servidor, en horario de Argentina. |
| Estatus | QR |
| Puntualidad | PUNTUAL o LLEGADA TARDE (N min), según el turno del empleado en el local del QR, el día de la semana y la tolerancia del local. Sin turno, sin ese turno en el local o sin horario de entrada ese día: PUNTUAL. |
No se guardan las coordenadas del celular: solo se usan para validar la distancia en ese momento.
Controles al fichar (en orden)¶
Hexalba hace estos controles uno detrás de otro; el primero que falla corta la fichada y muestra su mensaje en el panel rojo Error al Fichar.
| # | Control | Mensaje cuando falla |
|---|---|---|
| 1 | Sesión iniciada | "No autorizado" |
| 2 | Tener la acción generar_qr |
Mensaje de falta de permiso |
| 3 | Límite de 10 intentos por minuto por usuario | "Demasiados intentos. Esperá N segundos." |
| 4 | El QR es de Hexalba y trae un identificador de local | "QR inválido" |
| 5 | El local existe y está activo | "Local no encontrado o inactivo" |
| 6 | El local está entre los locales asignados al usuario | "No tenés acceso a este local" |
| 7 | Usuario existente y no bloqueado | "Usuario no encontrado" / "Usuario bloqueado: no podés registrar presentismo." |
| 8 | El celular mandó una ubicación válida | "Coordenadas GPS inválidas. Activá GPS y otorgá permisos." |
| 9 | El local tiene coordenadas cargadas | "Coordenadas GPS no configuradas para este local" |
| 10 | Distancia al local menor o igual al radio del local | "Estás fuera del radio permitido del local. Acercate para poder fichar." y la distancia, por ejemplo "(85m)" |
| 11 | La hora del servidor es coherente | "Hora del servidor inconsistente" |
| 12 | No hay otra fichada vigente del usuario en el día (horario de Argentina). Una fichada anulada no cuenta: si te anularon la del día, podés volver a fichar. | "Ya registraste tu entrada hoy." |
Si todo pasa, el panel verde Fichada Exitosa muestra "Fichada registrada correctamente", la hora y la puntualidad. Si el celular no logra comunicarse con Hexalba, el mensaje es "Error de conexión con el servidor.".
Parámetros del local que intervienen¶
Se editan en Locales.
| Campo | Valor de fábrica | Uso |
|---|---|---|
| Latitud, Longitud | Sin valor (obligatorias en el alta del local) | Centro del círculo de validación. |
| Radio GPS (metros) | 50 | Distancia máxima permitida. La pantalla de Locales acepta entre 10 y 500 metros. |
| Tolerancia llegada tarde (min) | 15 | Margen antes de marcar LLEGADA TARDE. |
Pantalla Generar QR de Local¶
| Elemento | Contenido |
|---|---|
| Seleccionar Local | Lista de locales activos asignados (nombre e iniciales). |
| Panel QR: nombre | QR de 300 px con nivel de corrección alto, nombre e iniciales del local y el texto del código en letra chica; botón Imprimir. Aparece al elegir un local. |
| Todos los QR | Cuadrícula con el QR de cada local activo; tocar uno lo abre en el panel grande. |
| Volver a Presentismo QR | Regresa a la pantalla de fichada. |
Imprimir abre el cuadro de impresión del navegador. En la hoja sale solo el recuadro del QR: arriba "QR: nombre del local" y, debajo, el código, el nombre y las iniciales del local y el texto del código en letra chica. No salen el menú lateral, la barra de arriba, el título de la pantalla, el botón Imprimir, Seleccionar Local, Volver a Presentismo QR ni Todos los QR. El contenido del QR depende únicamente del local, así que siempre es el mismo código para un local.