Automatisierung des Buchungsstatus bei Biometrie: Check-In und Check-Out
In einem biometrischen Zeiterfassungssystem ist es entscheidend, genau zu erkennen, ob eine Buchung ein IN- oder OUT-Eintrag ist, um eine korrekte Anwesenheitserfassung sicherzustellen. Bei Cams Biometrics bieten wir flexible Möglichkeiten, den Buchungsstatus zu bestimmen, sowohl auf Hardware-Ebene als auch auf Admin-Portal-Ebene (API).
Dieser Artikel erklärt, wie Buchungsstatus erfasst werden, welche Optionen Entwickler konfigurieren können und welche wichtigen technischen Einschränkungen berücksichtigt werden müssen, um eine zuverlässige Leistung in Echtzeitsystemen sicherzustellen.
🛠️ 1. Buchungsstatus auf Hardware-Ebene
Auf den meisten biometrischen Geräten werden alle Buchungen standardmäßig als „Check In“ erfasst.
Wenn ein Benutzer einen „Check Out“ oder einen anderen benutzerdefinierten Status erfassen möchte, muss er den passenden Buchungsmodus manuell am Gerät auswählen (z. B. durch Drücken der Schaltfläche „Check Out“ oder über eine Option auf dem Touchscreen), bevor er sich bucht.
✅ Diese Einrichtung funktioniert gut in Umgebungen, in denen Benutzer darin geschult sind, am Gerät den richtigen Buchungsmodus auszuwählen.
❌ Wichtig: Die automatische Auswahl des Status auf Hardware-Ebene ist nicht möglich. Biometrische Geräte verfügen über keine Geschäftslogik. Entwickler müssen sicherstellen, dass Buchungsstatus durch die angebundene Software bzw. API-Logik korrekt verarbeitet werden.
🌐 2. Buchungsstatus auf Cams-Portal-Ebene (Automatisierungsoptionen)
Um die Benutzererfahrung zu vereinfachen und die Klassifizierung des Buchungsstatus zu automatisieren, können Entwickler, die sich mit der Cams Web API integrieren, zwischen den folgenden serverseitigen Logikoptionen wählen. Diese Regeln werden nachdem die Buchung im Gerät erfasst wurde angewendet.
📌 Option 1: Actual
- Der exakte Buchungsstatus (IN/OUT), den der Benutzer am Gerät ausgewählt hat, wird an den Server weitergegeben.
📌 Option 2: First In Rest Out
- Die erste Buchung des Tages wird als IN markiert.
- Alle folgenden Buchungen desselben Benutzers innerhalb desselben 24-Stunden-Zeitraums werden als OUT markiert.
- Ideal für Systeme, in denen Benutzer den Buchungstyp nicht manuell auswählen.
📌 Option 3: ZigZag
- Buchungen wechseln sich im Laufe des Tages zwischen IN und OUT ab.
- Die erste Buchung ist IN, die zweite ist OUT, die dritte ist IN usw.
- Die Logik wird für jeden Benutzer auf Basis seiner Aktivitäten der letzten 24 Stunden beibehalten.
ℹ️ Sowohl der Modus
First In Rest Outals auchZigZagbenötigen Zugriff auf den Buchungsverlauf der letzten 24 Stunden, um korrekt zu funktionieren.
⚠️ Wichtige Einschränkungen, die Sie beachten sollten
Diese automatischen Logikoptionen vereinfachen die Integration, es gibt jedoch wichtige Einschränkungen, die Sie verstehen sollten:
❗ 1. Keine dauerhafte Speicherung von Benutzerdaten
Cams Biometrics speichert Benutzer- und Buchungsdaten nicht dauerhaft. Für First In Rest Out und ZigZag speichern wir den Buchungsverlauf nur für die letzten 24 Stunden vorübergehend.
Wenn ein Gerät länger als 24 Stunden offline ist, stehen frühere Buchungen nicht mehr zur Verfügung, um die nächste Buchung korrekt auszuwerten. Dies kann zu einer falschen Klassifizierung führen (z. B. dass die zweite Buchung als IN statt als OUT behandelt wird).
❗ 2. Logik gilt nur pro Gerät
Diese Logiken für den Buchungsstatus werden pro Gerät und pro Benutzer angewendet. Wenn ein Benutzer sich an mehreren Geräten bucht, gleicht das System die Buchungen nicht geräteübergreifend ab. Dies führt bei Anwendungsfällen mit mehreren Geräten zu Fehlern in der Logik.
❗ 3. Geräte müssen mindestens einmal alle 24 Stunden verbunden sein
Damit die Automatisierung des Buchungsstatus zuverlässig funktioniert, müssen sich Geräte mindestens einmal innerhalb von 24 Stunden online schalten und synchronisieren. Andernfalls können die Cams-Server den erforderlichen kurzfristigen Buchungsverlauf nicht vorhalten.
❗ 4. Nicht geeignet für schichtbasierte Anwesenheitserfassung
Die Automatisierung des Buchungsstatus basiert ausschließlich auf Daten der letzten 24 Stunden, und die Klassifizierung erfolgt innerhalb desselben Kalendertags wie die Buchung.
Wenn Sie schichtbasierte Anwesenheitserfassung verwalten, insbesondere bei Nachtschichten oder flexiblen Schichten, empfehlen wir dringend, sich nicht auf den Buchungsstatus aus der API zu verlassen. Entwickeln Sie stattdessen eine eigene Logik in Ihrem System, um Buchungen auf Basis Ihrer Schichtdefinitionen auszuwerten.
🛠️ Cams unterstützt derzeit keine Automatisierung des Buchungsstatus auf Basis von Schichtzeiten. Diese Logik muss in Ihrer vorgesehenen Software zur Anwesenheitsverwaltung umgesetzt werden.
✅ Bewährte Methoden & Empfehlung
Bevor Sie die automatische Logik für den Buchungsstatus (First In Rest Out oder ZigZag) aktivieren, stellen Sie sicher, dass:
- Benutzer konsequent über ein zugewiesenes Gerät buchen.
- Jedes Gerät mindestens einmal alle 24 Stunden eine Verbindung zum Server herstellt.
- Sie das Verhalten und die Einschränkungen dieser Logikmodi verstehen, um eine falsche Auslegung von Buchungen zu vermeiden.
🛑 Aktivieren Sie diese Optionen nur, wenn Ihre Einrichtung die oben genannten Bedingungen vollständig erfüllt. Eine unsachgemäße Verwendung kann bei Ihrem Kunden zu Fehlberechnungen der Anwesenheit führen.
🚀 Cams bietet No-Code- oder sofortige Integration
Um Ihren Entwicklungsprozess zu vereinfachen, bietet Cams Integrationsoptionen ohne Programmierung (Plug-and-play) sowie vollständige individuelle Unterstützung an.
Bei Bedarf kann unser Team:
- individuelle Logik auf Basis Ihres Systemablaufs entwickeln.
- einsatzbereiten Integrationscode für jede Serversprache (PHP, Node.js, Java, Python, .NET usw.) und jede Datenbank (MySQL, PostgreSQL, SQL Server usw.) bereitstellen.
Teilen Sie uns einfach Ihren Tech-Stack mit, und wir helfen Ihnen bei einer reibungslosen Integration.