Marcación Documentación
Conoce el producto Iniciar sesión
Para administradores

Gestión de la plataforma

Da de alta a las personas (a mano o de forma masiva), define su rol, turno y zonas, y configura las reglas de marcación de la empresa.

Empleados

Listado de empleados con su área, turno, modalidad y estado de hoy.
Listado de empleados con su área, turno, modalidad y estado de hoy.

El listado muestra a cada persona con su foto o iniciales, correo, cargo, área, turno, modalidad (Remoto libre o Zonas: N) y su estado de hoy. Distingue a los administradores (Admin) y a las cuentas de Microsoft (ícono ). Usa el buscador por nombre, correo o área.

Editar a una persona

Ficha de un usuario de Microsoft: datos de Entra en solo lectura, rol, turno y zonas editables.
Ficha de un usuario de Microsoft: datos de Entra en solo lectura, rol, turno y zonas editables.

La ficha tiene dos partes. A la izquierda, los datos personales; a la derecha, Jornada y marcación:

Usuarios de Microsoft Entra ID

Nombre, correo, cargo, área, oficina, teléfono y legajo vienen de Entra ID y se actualizan en cada ingreso: aquí son de solo lectura. Lo que defines en la aplicación es el rol, el turno, la modalidad y las zonas.

Usuarios locales

Ficha de un usuario local: además se editan los datos personales y la contraseña.
Ficha de un usuario local: además se editan los datos personales y la contraseña.

Para estos usuarios también editas nombre, correo, cargo, área, teléfono, legajo, rol y contraseña (en blanco, no cambia; mínimo 8 caracteres). Nadie puede quitarse a sí mismo el rol de administrador.

Roles: quién es administrador

Usuarios locales

El rol se elige en la ficha: Empleado o Administrador.

Usuarios de Microsoft Entra ID

En la ficha, el campo Rol en la aplicación tiene tres opciones:

OpciónEfecto
Automático (según Entra ID)Es administrador si en Entra ID tiene asignado el rol de aplicación Admin (o el valor de ENTRA_ADMIN_ROLE) o si su correo figura en ENTRA_ADMIN_EMAILS. Se reevalúa en cada inicio de sesión. Es el valor por defecto.
EmpleadoFija el rol a mano: aunque Entra ID lo marque como administrador, será empleado.
AdministradorFija el rol a mano: será administrador aunque Entra ID no se lo asigne.
Lo fijado a mano tiene prioridad

Un rol fijado como Empleado o Administrador se mantiene en los próximos ingresos hasta que lo devuelvas a Automático. Si a alguien le quitan el rol en Entra ID pero tú lo fijaste como administrador, seguirá siendo administrador aquí. Nadie puede cambiar su propio rol.

Primer administrador

Si todavía no tienes administradores, agrega tu correo a ENTRA_ADMIN_EMAILS (varios correos se separan con coma o punto y coma) o crea un administrador local con flask --app run create-admin. Ver Instalación y despliegue.

Importación masiva

En Empleados → Importar encuentras dos formas de dar de alta a muchas personas a la vez. Ninguna modifica a personas que ya existen.

El botón Importar ofrece Entra ID y Excel, según cómo esté configurada la plataforma.
El botón Importar ofrece Entra ID y Excel, según cómo esté configurada la plataforma.

Desde Microsoft Entra ID

Selecciona a quién traer del directorio, con buscador.
Selecciona a quién traer del directorio, con buscador.
  1. Entra a Importar → Desde Entra ID. Se lista el directorio: solo cuentas activas y miembros (no invitados).
  2. Usa el buscador y marca a las personas. El casillero de la cabecera selecciona todas las nuevas visibles.
  3. Elige el turno que tendrán y si se controla su asistencia.
  4. Pulsa Importar seleccionados.

Cada fila indica su estado: Nuevo, Ya importado o Correo en uso (existe otro usuario con ese correo; no se importa). Quienes figuren en ENTRA_ADMIN_EMAILS entran como administradores. Cuando la persona inicie sesión, su cuenta se enlaza con el registro importado, sin duplicados.

Permiso necesario en Azure

Para listar el directorio, el registro de la aplicación necesita el permiso de aplicación User.Read.All de Microsoft Graph con consentimiento de administrador. Sin él, la pantalla muestra un aviso con estos pasos y el resto de la plataforma sigue funcionando.

Desde un archivo Excel (usuarios locales)

Resultado de una importación: usuarios creados, contraseñas generadas y filas omitidas con su motivo.
Resultado de una importación: usuarios creados, contraseñas generadas y filas omitidas con su motivo.
  1. Entra a Importar → Desde Excel y pulsa Descargar plantilla.xlsx.
  2. Completa la hoja Usuarios (una fila por persona). La hoja Instrucciones lista tus turnos y ubicaciones disponibles.
  3. Súbela con Importar (hasta 100 usuarios por archivo).
ColumnaObligatoriaValores
Nombre completoSíTexto.
CorreoSíCorreo válido y que no exista ya en la plataforma.
ContraseñaNoMínimo 8 caracteres. Vacía: se genera una al azar.
RolNoEmpleado (por defecto) o Administrador.
Cargo, Área, Teléfono, LegajoNoTexto libre.
TurnoNoNombre exacto de un turno existente. Vacío: sin turno.
ModalidadNoLibre (por defecto) o Zonas.
UbicacionesSi la modalidad es ZonasNombres exactos de ubicaciones existentes, separados por punto y coma.
Controla asistenciaNoSí (por defecto) o No.

Al terminar ves un resumen: cuántas personas se crearon, la contraseña generada de quienes no tenían una y la lista de filas omitidas con su número y motivo (correo inválido o repetido, turno o ubicación inexistente, contraseña corta…). Las filas válidas se importan aunque otras tengan errores.

Las contraseñas generadas se muestran una sola vez

No se guardan en texto legible: cópialas antes de salir de la pantalla y entrégalas de forma segura. Si se pierden, edita al usuario y asígnale una nueva.

Pantalla de importación desde Excel.
Pantalla de importación desde Excel.

Ubicaciones (geovallas)

Ubicaciones con su radio y vista de mapa.
Ubicaciones con su radio y vista de mapa.

Una ubicación es un punto del mapa con un radio: es la zona dentro de la cual se acepta una marcación. Úsalas para oficinas, sucursales o sedes de clientes.

Editor de ubicación: haz clic en el mapa para fijar el centro y ajusta el radio.
Editor de ubicación: haz clic en el mapa para fijar el centro y ajusta el radio.
  1. Pulsa Nueva ubicación.
  2. Escribe el nombre y, si quieres, la dirección.
  3. Haz clic en el mapa para fijar el centro (también puedes escribir latitud y longitud, o usar tu ubicación actual).
  4. Ajusta el radio permitido con el deslizador (de 20 a 1000 m en el editor).
  5. Deja Ubicación activa encendida y guarda.

Una ubicación con marcaciones asociadas no se elimina: se desactiva, para no perder el historial. Si no tiene marcaciones, se elimina y se quita de las personas que la tenían asignada.

Turnos

Turnos con horario, pausa, tolerancia y días laborales.
Turnos con horario, pausa, tolerancia y días laborales.

Un turno define cuándo se espera que trabaje una persona. Pulsa Nuevo turno o edita uno existente y completa:

CampoPara qué sirve
NombreCómo se verá en listados y fichas.
Entrada / SalidaHorario de la jornada. Si la salida es menor o igual que la entrada, para calcular las horas esperadas se entiende que termina al día siguiente (turno nocturno).
Pausa (min)Minutos de descanso que se descuentan de las horas esperadas (0 a 480).
Tolerancia (min)Margen sobre la hora de entrada antes de contar tardanza (0 a 120).
Días laboralesLos días de la semana que se trabajan. Los demás figuran como Día libre.

Las horas esperadas por día son (salida − entrada) − pausa. Un turno con personas asignadas no se puede eliminar.

Configuración

Reglas de marcación y datos de la empresa.
Reglas de marcación y datos de la empresa.
OpciónEfecto
Nombre de la empresaAparece en el menú, el ingreso y los títulos.
Exigir ubicaciónNo se puede marcar sin compartir la ubicación GPS. Para quienes tienen modalidad Solo en zonas autorizadas, la ubicación siempre es obligatoria.
Exigir selfie en entrada y salidaSe toma una foto con la cámara como evidencia. Solo la propia persona y los administradores pueden verla. Las pausas no la piden.
Hora del servidor

Todas las fechas y horas usan el horario del servidor, sin conversión de zona horaria. Asegúrate de que la zona horaria del servidor sea la de tu país (para Paraguay, America/Asuncion).

Métodos de acceso

Configuración → Métodos de acceso.
Configuración → Métodos de acceso.

Decide cómo pueden ingresar las personas: con Microsoft Entra ID, con usuario local o con ambos. Si hay dos activos, la pantalla de ingreso muestra pestañas y puedes elegir cuál se abre primero.

Nota

Desactivar un método no borra a las personas: sus datos, turnos y marcaciones se conservan y podrán ingresar cuando se vuelva a activar.

Auditoría

La sección Auditoría (solo administradores) muestra las últimas 300 acciones con fecha y hora, quién las hizo, sobre quién o qué, el detalle y la dirección IP. Se registran los inicios y cierres de sesión, los cambios de rol, las altas, bajas y ediciones de personas, las marcaciones manuales y eliminadas, la resolución de solicitudes, las importaciones, y los cambios de ubicaciones, turnos y configuración. Hay un buscador para filtrar el listado.

Respaldos (opcional)

En Administración → Respaldos (solo administradores) se activa, si se desea, una copia periódica de la base de datos y de las fotos hacia un destino fuera del servidor. Es opcional: viene desactivado y no sustituye a las copias que ya haga tu infraestructura (por ejemplo, el respaldo de la máquina virtual). Cada respaldo es un único archivo marcaciones-AAAAMMDD-HHMMSS.tar.gz.

OpciónDetalle
ProgramaciónUn respaldo diario a la hora configurada. Si falla, se reintenta hasta 3 veces el mismo día, con 30 minutos de espera. También se puede lanzar con Respaldar ahora.
Cifrado (age)Los archivos se cifran con una clave pública antes de salir del servidor. La clave privada no se guarda en el servidor: el botón de generación la muestra una sola vez para que la guardes en un gestor de contraseñas. Sin ella no se puede restaurar.
RetenciónSe conservan los últimos N respaldos en FTP/FTPS y carpeta compartida. En Azure se recomienda una regla de ciclo de vida del contenedor.
Azure Blob StoragePega una URL de SAS del contenedor con permisos solo de Agregar, Crear y Escribir (sin leer, listar ni eliminar).
FTP / FTPSFTP simple (no recomendado), FTPS explícito o FTPS implícito, con usuario, contraseña y carpeta remota.
Carpeta compartida de Windows (SMB)Servidor, recurso compartido, carpeta y credenciales (DOMINIO\usuario). El servidor de la aplicación debe tener conexión de red con el equipo Windows (LAN o VPN).

Cada destino tiene un botón Probar conexión, que usa los valores del formulario sin necesidad de guardarlos. Las contraseñas y tokens se guardan cifrados, nunca se vuelven a mostrar y no aparecen en el historial. Por seguridad, no se aceptan destinos que apunten al propio servidor ni a direcciones de metadatos de la nube. Cada respaldo y cada cambio de configuración quedan en la auditoría.

Restaurar

Descarga el archivo .age (desde el historial o desde el destino) y, en una computadora con la aplicación instalada, ejecuta flask --app run backup-decrypt marcaciones-AAAAMMDD-HHMMSS.tar.gz.age --identity clave-privada.txt --out carpeta-restauracion. La carpeta contendrá la base de datos (marcacion.db), las fotos (uploads/) y un manifest.json. La clave privada se usa solo en esa computadora. Detén el servicio antes de reemplazar la base de datos en uso.


© 2026 Login S.A. Todos los derechos reservados. Esta documentación es pública y no requiere iniciar sesión.