Centro de ayuda

Dashboard principal

Tu vista de inicio muestra el resumen del día: empleados que ya checaron, los que faltan, y los checkins recientes con foto y hora. Desde aquí navegas a todas las secciones.

Gestión de empleados

Administra tu plantilla desde la sección Empleados:

• Alta individual — nombre, locación, turno y opción de registro de comida. El código de 5 dígitos se genera automáticamente
• Importación Excel — descarga la plantilla, llénala y súbela para altas masivas
• Desactivar/reactivar — sin eliminar datos, solo habilitas o deshabilitas su acceso
• Reasignar licencias — desactiva todos y selecciona manualmente quiénes reciben licencia (útil para rotación de personal)

Ubicaciones y geocercas

Configura una o varias ubicaciones de trabajo. Cada una tiene nombre, coordenadas GPS y radio de tolerancia en metros. Los empleados asignados a esa ubicación deben checar dentro del radio.

Áreas de trabajo y turnos

Organiza empleados por áreas y asigna grupos de horario (turnos). Cada turno define hora de entrada, salida y días laborales de la semana, con horarios diferentes por día si es necesario. Puedes crear, desactivar, reactivar o eliminar áreas y turnos.

Reglas de asistencia

Configura la hora límite de entrada y los minutos de tolerancia para retardos. Estas reglas se aplican automáticamente al calcular puntualidad en reportes y nómina.

Zona horaria

Cada empresa puede configurar su zona horaria. Soporta todas las zonas de México, Latinoamérica, EE.UU. y España. Afecta los reportes, la hora mostrada en checkins y los cálculos de nómina.

Incidencias y permisos

Registra eventos desde un calendario visual: faltas justificadas, vacaciones, incapacidad médica, permisos especiales y días festivos. Se reflejan automáticamente en reportes, matriz y nómina.

Reportes

• Dashboard — resumen del día con % de asistencia, puntualidad y faltas
• Matriz — cuadrícula empleados × días con colores por estatus
• Auditoría — detalle de cada checkin con hora, tipo, GPS y foto (paginado)
• Nómina — horas trabajadas vs esperadas, pausas de comida, exportable a Excel

Branding y licencias

Sube tu logo y personaliza colores del portal de checkin. Gestiona tus licencias: cada empleado activo necesita una. Puedes comprar adicionales con Stripe, descargar códigos en PDF o Excel, y reasignar licencias cuando cambie tu plantilla.

Tu historial de registros

En la pantalla de checkin puedes tocar "Mis últimos registros" para ver tus últimas 5 checadas con tipo, fecha y hora. No necesitas pedirle reportes a tu administrador para verificar tus registros recientes.

Problemas comunes

• "No se pudo obtener ubicación" — Asegúrate de tener el GPS activado y los permisos del navegador aprobados
• "Código de licencia inválido" — Verifica tu código con tu administrador, puede haberse desactivado
• "Código no asignado a ningún empleado" — Tu código existe pero no está ligado a un empleado activo. Contacta a tu administrador
• La cámara no se activa — Cierra otras apps que usen la cámara e intenta de nuevo
• "Día completo" — Ya registraste todos tus movimientos del día. Si necesitas re-ingresar, contacta a tu administrador

¿Qué es el plugin de Odoo?

AsisTpro funciona 100% independiente. El plugin de Odoo es una extensión opcional que sincroniza empleados y asistencias con tu instancia de Odoo vía XML-RPC. Si no usas Odoo, puedes ignorar esta sección por completo.

Requisitos en Odoo

Tu instancia de Odoo necesita estos modelos y campos para que el plugin funcione:

• Modelo de empleados — hr.employee (estándar) o x_empleados (Studio custom)
• Campo requerido — x_studio_asist_code (Char) en el modelo de empleados
• Campo opcional — x_studio_registra_comida (Boolean) para control de comidas
• Modelo de asistencias — x_asistencias_asist con campos: x_name, x_studio_asist_code, x_studio_tipo
• Campos opcionales de asistencia — x_studio_foto, x_studio_ubicacion, x_studio_id_empleado
• Permisos — lectura y escritura en ambos modelos para el usuario de conexión

Cómo conectar

1. Ve a Dashboard → Integraciones
2. Ingresa la URL de tu Odoo, nombre de base de datos, usuario y contraseña (o API Key)
3. Selecciona el modelo de empleados que usas (hr.employee o x_empleados)
4. Haz clic en "Guardar y Probar Conexión"
5. Usa "🩺 Diagnosticar" para verificar modelos y campos

Modelo de sincronización

AsisTpro usa un modelo local-first, batch sync:

1. El empleado checa → el registro se guarda instantáneamente en PostgreSQL local
2. El registro se marca como pending (pendiente de sync)
3. Cuando el admin hace clic en "Enviar a Odoo" (o un webhook lo llama), se abre una sola conexión XML-RPC y se envían todos los registros pendientes en batch
4. Cada registro confirmado por Odoo se marca como synced con su ID externo guardado

Sincronizar empleados

Desde el panel de integraciones, haz clic en "📥 Sincronizar empleados". El plugin trae los empleados de Odoo y los crea o actualiza en AsisTpro (match por ID externo o código de asistencia). A los empleados nuevos se les asigna una licencia automáticamente si hay disponibles.

Reenvío y duplicados

El sistema protege contra duplicados con el campo external_sync_id:

• Marcar para reenvío — solo re-marca registros que NO tienen confirmación de Odoo. Seguro.
• Forzar reenvío — limpia la confirmación y reenvía. Puede duplicar registros en Odoo. Úsalo solo si sabes lo que haces.

Webhook para automatización

Puedes automatizar la sincronización con un servicio externo (UptimeRobot, cron-job.org, etc.):

POST https://asist.pro/webhooks/sync

• Header: X-Admin-Secret: tu-secret
• Body: {"type": "attendance", "limit": 500}
• Si omites tenant_id, sincroniza todos los tenants activos

Desconectar

Puedes desconectar Odoo en cualquier momento desde el botón "Desconectar" en el panel de integraciones. Los empleados y registros locales se conservan intactos. Simplemente los nuevos checkins ya no se marcarán como pendientes de sync.