Documentation

1. Conectar un reloj checador ZKTeco

1. En el panel, entra a Asistencias → Relojes checadores y registra el número de serie del equipo.
2. En el reloj checador, abre la configuración de servidor en la nube (ADMS) y apunta la dirección del servidor al endpoint de Asistencias.
3. El reloj checador se activa solo en su primer contacto y las checadas empiezan a llegar. La biometría se descarta y nunca se almacena.

2. Sin reloj checador: checada web y manual

Puedes dar de alta empleados y llevar su asistencia sin hardware. Cada empleado invitado checa entrada y salida desde su navegador y RR. HH. puede registrar checadas a mano con motivo. Todos los métodos caen en el mismo reporte de asistencia. El producto funciona con o sin relojes checadores y puedes añadirlos después.

3. Integración con Odoo

En Asistencias → Integraciones, tarjeta de Odoo, pega la URL, la base de datos, tu usuario y una clave API generada en Odoo (Preferencias → Seguridad de la cuenta). Las checadas se envían a hr.attendance automáticamente y puedes importar tus empleados. Compatible con Odoo 16, 17, 18 y 19, en la nube o autoalojado.

4. Webhooks: n8n, Zapier, Make

Cada checada se puede enviar en tiempo real a cualquier flujo. En la tarjeta de Webhook pega la URL de tu webhook de n8n u otro servicio y, opcionalmente, un secreto de firma. Recibirás un POST así:

POST https://tu-webhook
X-Attendance-Event: attendance.punch.created
X-Attendance-Signature: sha256=<hmac>

{
  "type": "attendance.punch.created",
  "rootId": "org_...",
  "occurredAt": "2026-09-25T14:00:00.000Z",
  "data": {
    "pin": "1001",
    "employeeId": "emp_...",
    "punchedAt": "2026-09-25T14:00:00.000Z",
    "punchState": 0
  }
}

5. API REST

Crea una clave API en Integraciones y consulta tus datos desde cualquier sistema. Ejemplo:

curl -H "Authorization: Bearer att_live_..." \
  "https://api.asistencias.app/v1/attendance/logs?limit=100"

Endpoints disponibles: /v1/attendance/logs, /employees, /presence. Paginación por cursor con el parámetro after.

6. Exportar a nómina

Desde Integraciones puedes descargar las checadas del mes a Excel (CSV), listo para cualquier sistema de nómina.