Support Hub/API & Integrations/Automatización del estado de marcaje biométrico: Entrada y Salida
Machine translation. This page was translated by AI from the English article and has not been reviewed by a person yet. Read the English original
Fix

Automatización del estado de marcaje biométrico: Entrada y Salida

Automatización del estado de marcaje biométrico: Entrada y Salida

En un sistema de asistencia biométrica, identificar con precisión si un marcaje es una entrada ENTRADA o una SALIDA es fundamental para garantizar un seguimiento correcto de la asistencia. En Cams Biometrics, ofrecemos formas flexibles de determinar el estado del marcaje, tanto a nivel de hardware como a nivel del portal de administración (API).

Este artículo explica cómo se registran los estados de marcaje, qué opciones pueden configurar los desarrolladores y qué restricciones técnicas importantes deben tenerse en cuenta para garantizar un rendimiento fiable en sistemas en tiempo real.


🛠️ 1. Estado de marcaje a nivel de hardware

En la mayoría de los equipos biométricos, todos los marcajes se registran como “Entrada” de forma predeterminada.

Si un usuario desea registrar una “Salida” o cualquier otro estado personalizado, debe seleccionar manualmente el modo de marcaje adecuado en el equipo (por ejemplo, pulsando un botón “Salida” o usando una opción de la pantalla táctil) antes de marcar.

✅ Esta configuración funciona bien en entornos donde los usuarios están capacitados para seleccionar el modo de marcaje correcto en el equipo.

❌ Importante: Seleccionar el estado automáticamente a nivel de hardware no es posible. Los equipos biométricos no mantienen ninguna lógica de negocio. Los desarrolladores deben asegurarse de que los estados de marcaje se procesen correctamente en el software conectado o en la lógica de la API.


🌐 2. Estado de marcaje a nivel del portal de Cams (opciones de automatización)

Para simplificar la experiencia del usuario y automatizar la clasificación del estado de marcaje, los desarrolladores que se integren con la Cams Web API pueden elegir entre las siguientes opciones de lógica del lado del servidor. Estas reglas se aplican después de que el marcaje se registra en el equipo.

📌 Opción 1: Actual

  • El estado de marcaje exacto (ENTRADA/SALIDA) seleccionado por el usuario en el equipo se envía directamente al servidor.

📌 Opción 2: First In Rest Out

  • El primer marcaje del día se marca como ENTRADA.
  • Todos los marcajes posteriores del mismo usuario dentro del mismo período de 24 horas se marcan como SALIDA.
  • Ideal para sistemas en los que los usuarios no seleccionan manualmente el tipo de marcaje.

📌 Opción 3: ZigZag

  • Los marcajes se alternan entre ENTRADA y SALIDA a lo largo del día.
  • El primer marcaje es ENTRADA, el segundo es SALIDA, el tercero es ENTRADA, y así sucesivamente.
  • La lógica se mantiene para cada usuario según la actividad de las últimas 24 horas.

ℹ️ Los modos First In Rest Out y ZigZag requieren acceso al historial de marcajes de las últimas 24 horas para funcionar con precisión.


⚠️ Restricciones clave que debe conocer

Aunque estas opciones de lógica automática simplifican la integración, existen limitaciones importantes que debe comprender:

❗ 1. No hay almacenamiento permanente de datos de usuarios

Cams Biometrics no almacena datos de usuarios ni de marcajes de forma permanente. Para First In Rest Out y ZigZag, solo almacenamos temporalmente el historial de marcajes de las últimas 24 horas.

Si un equipo está fuera de línea durante más de 24 horas, los marcajes anteriores ya no estarán disponibles para evaluar correctamente el siguiente marcaje. Esto puede provocar una clasificación incorrecta (por ejemplo, tratar el segundo marcaje como ENTRADA en lugar de SALIDA).

❗ 2. La lógica funciona solo por equipo

Estas lógicas de estado de marcaje se aplican por equipo y por usuario. Si un usuario marca en varios equipos, el sistema no cruza información entre equipos. Esto provocará fallos de lógica en casos de uso con varios dispositivos.

❗ 3. Los equipos deben conectarse al menos una vez cada 24 horas

Para que la automatización del estado de marcaje funcione de forma fiable, los equipos deben estar en línea y sincronizarse al menos una vez cada 24 horas. De lo contrario, los servidores de Cams no podrán mantener el historial de marcajes a corto plazo necesario.

❗ 4. No es adecuado para asistencia basada en turnos

La automatización del estado de marcaje se basa únicamente en los datos de las últimas 24 horas, y la clasificación se realiza dentro del mismo día natural del marcaje.

Si gestiona asistencia basada en turnos, especialmente turnos nocturnos o flexibles, le recomendamos encarecidamente que no dependa del estado de marcaje de la API. En su lugar, desarrolle su propia lógica en su sistema para interpretar los marcajes según sus definiciones de turnos.

🛠️ Actualmente, Cams no admite la automatización del estado de marcaje basada en horarios de turno. Esa lógica debe implementarse en el software de gestión de asistencia designado.


✅ Buenas prácticas y recomendaciones

Antes de activar la lógica automática del estado de marcaje (First In Rest Out o ZigZag), asegúrese de que:

  • Los usuarios marcan siempre desde un equipo asignado.
  • Cada equipo se conecta al servidor al menos una vez cada 24 horas.
  • Comprende el comportamiento y las limitaciones de estos modos de lógica para evitar una interpretación incorrecta de los marcajes.

🛑 No active estas opciones a menos que su configuración cumpla completamente con las condiciones anteriores; un uso incorrecto puede provocar errores en el cálculo de la asistencia para su cliente.


🚀 Cams ofrece integración sin código o instantánea

Para simplificar su proceso de desarrollo, Cams ofrece opciones de integración sin código (plug-and-play), así como soporte personalizado completo.

Si lo necesita, nuestro equipo puede:

  • Desarrollar lógica personalizada según el flujo de trabajo de su sistema.
  • Proporcionar código de integración listo para instalar en cualquier lenguaje de servidor (PHP, Node.js, Java, Python, .NET, etc.) y en cualquier base de datos (MySQL, PostgreSQL, SQL Server, etc.).

Simplemente indíquenos su stack tecnológico y le ayudaremos a integrarlo sin problemas.

Was this article helpful?