Centro de ayuda

dashboardDashboard 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.

groupGestión de empleados

Administra tu plantilla desde la sección Empleados:

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

location_onUbicaciones 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.

scheduleÁ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.

ruleReglas 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.

publicZona 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.

event_noteIncidencias 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.

bar_chartReportes

• check_circleDashboard — resumen del día con % de asistencia, puntualidad y faltas
• check_circleMatriz — cuadrícula empleados × días con colores por estatus
• check_circleAuditoría — detalle de cada checkin con hora, tipo, GPS y foto
• check_circleNómina — horas trabajadas vs esperadas, pausas de comida, exportable a Excel

paletteBranding 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.

¿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:

• check_circleModelo de empleados — hr.employee (estándar) o x_empleados (Studio custom)
• check_circleCampo requerido — x_studio_asist_code (Char)
• check_circleCampo opcional — x_studio_registra_comida (Boolean)
• check_circleModelo de asistencias — x_asistencias_asist
• check_circleCampos opcionales — x_studio_foto, x_studio_ubicacion
• check_circlePermisos — lectura y escritura en ambos modelos

Cómo conectar

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

Modelo de sincronización

AsisTpro usa un modelo local-first, batch sync:

1. 1El empleado checa → el registro se guarda instantáneamente en PostgreSQL local
2. 2El registro se marca como pending
3. 3Cuando el admin hace clic en "Enviar a Odoo", se abre una sola conexión XML-RPC y se envían todos los registros pendientes en batch
4. 4Cada registro confirmado 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:

• check_circleMarcar para reenvío — solo re-marca registros que NO tienen confirmación de Odoo. Seguro.
• warningForzar reenvío — limpia la confirmación y reenvía. Puede duplicar registros en Odoo.

Webhook para automatización

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

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

• check_circleHeader: X-Admin-Secret: tu-secret
• check_circleBody: {"type": "attendance", "limit": 500}
• check_circleSi 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.