Support Hub/API & Integrations/Automatisering van ponsstatus bij biometrische…
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

Automatisering van ponsstatus bij biometrische registratie: Inchecken en Uitchecken

Automatisering van ponsstatus bij biometrische registratie: Inchecken en Uitchecken

In een biometrisch aanwezigheidssysteem is het voor een correcte aanwezigheidsregistratie van groot belang dat nauwkeurig wordt bepaald of een ponsing een IN- of OUT-registratie is. Bij Cams Biometrics bieden wij flexibele manieren om de ponsstatus te bepalen, zowel op hardwareniveau als op beheerportaalniveau (API).

Dit artikel legt uit hoe ponsstatussen worden vastgelegd, welke opties ontwikkelaars kunnen configureren en welke belangrijke technische beperkingen in acht moeten worden genomen om een betrouwbare werking in realtimesystemen te garanderen.


🛠️ 1. Ponsstatus op hardwareniveau

Op de meeste biometrische apparaten worden alle ponsingen standaard vastgelegd als “Check In”.

Als een gebruiker een “Check Out” of een andere aangepaste status wil vastleggen, moet hij de juiste ponsmodus handmatig selecteren op het apparaat (bijvoorbeeld door op een “Check Out”-knop te drukken of een optie op het touchscreen te gebruiken) voordat hij pont.

✅ Deze opzet werkt goed in omgevingen waar gebruikers zijn getraind om de juiste ponsmodus op het apparaat te selecteren.

❌ Belangrijk: Het automatisch selecteren van de status op hardwareniveau is niet mogelijk. Biometrische apparaten bevatten geen bedrijfslogica. Ontwikkelaars moeten ervoor zorgen dat ponsstatussen correct worden verwerkt door de verbonden software of API-logica.


🌐 2. Ponsstatus op Cams-portaalniveau (automatiseringsopties)

Om de gebruikerservaring te vereenvoudigen en de classificatie van ponsstatussen te automatiseren, kunnen ontwikkelaars die integreren met de Cams Web API kiezen uit de volgende serverzijdige logicaopties. Deze regels worden nadat de ponsing op het apparaat is vastgelegd toegepast.

📌 Optie 1: Actual

  • De exacte ponsstatus (IN/OUT) die de gebruiker op het apparaat heeft geselecteerd, wordt doorgegeven aan de server.

📌 Optie 2: First In Rest Out

  • De eerste ponsing van de dag wordt gemarkeerd als IN.
  • Alle volgende ponsingen binnen dezelfde periode van 24 uur voor dezelfde gebruiker worden gemarkeerd als OUT.
  • Ideaal voor systemen waarin gebruikers het ponstype niet handmatig selecteren.

📌 Optie 3: ZigZag

  • Ponsingen wisselen gedurende de dag af tussen IN en OUT.
  • De eerste ponsing is IN, de tweede is OUT, de derde is IN, enzovoort.
  • De logica wordt per gebruiker bijgehouden op basis van de activiteit van de afgelopen 24 uur.

ℹ️ Zowel de modus First In Rest Out als ZigZag hebben toegang nodig tot de ponsgeschiedenis van de afgelopen 24 uur om correct te kunnen functioneren.


⚠️ Belangrijke beperkingen om rekening mee te houden

Hoewel deze automatische logicaopties de integratie vereenvoudigen, zijn er belangrijke beperkingen die u moet begrijpen:

❗ 1. Geen permanente opslag van gebruikersgegevens

Cams Biometrics slaat gebruikers- en ponsgegevens niet permanent op. Voor First In Rest Out en ZigZag slaan wij de ponsgeschiedenis uitsluitend tijdelijk op voor de afgelopen 24 uur.

Als een apparaat langer dan 24 uur offline is, zijn eerdere ponsingen niet meer beschikbaar om de volgende ponsing correct te beoordelen. Dit kan leiden tot een onjuiste classificatie (bijvoorbeeld het behandelen van de tweede ponsing als IN in plaats van OUT).

❗ 2. Logica werkt alleen per apparaat

Deze ponsstatuslogica wordt toegepast op basis van per apparaat per gebruiker. Als een gebruiker op meerdere apparaten pont, voert het systeem geen kruisverwijzing uit tussen apparaten. Dit leidt tot logicafouten bij toepassingen met meerdere apparaten.

❗ 3. Apparaten moeten minstens eenmaal per 24 uur verbinding maken

Om automatisering van de ponsstatus betrouwbaar te laten werken, moeten apparaten minstens eenmaal per 24 uur online komen en synchroniseren. Anders kunnen de Cams-servers de vereiste kortetermijn-ponsgeschiedenis niet bijhouden.

❗ 4. Niet geschikt voor ploegendienst-aanwezigheid

Automatisering van de ponsstatus is uitsluitend gebaseerd op gegevens van de afgelopen 24 uur, en de classificatie vindt plaats binnen dezelfde kalenderdag als de ponsing.

Als u ploegendienst-aanwezigheid beheert, met name bij nachtdiensten of flexibele diensten, raden wij sterk aan niet te vertrouwen op de ponsstatus uit de API. Bouw in plaats daarvan uw eigen logica in uw systeem om ponsingen te interpreteren op basis van uw diensttijden.

🛠️ Cams ondersteunt momenteel geen automatisering van de ponsstatus op basis van diensttijden. Die logica moet worden geïmplementeerd in uw aangewezen software voor aanwezigheidsbeheer.


✅ Best practices & aanbevelingen

Controleer voordat u de automatische ponsstatuslogica (First In Rest Out of ZigZag) inschakelt, of:

  • Gebruikers consequent ponsen op één toegewezen apparaat.
  • Elk apparaat minstens eenmaal per 24 uur verbinding maakt met de server.
  • U het gedrag en de beperkingen van deze logicamodi begrijpt, om onjuiste interpretatie van ponsingen te voorkomen.

🛑 Activeer deze opties niet tenzij uw opzet volledig voldoet aan de bovenstaande voorwaarden. Onjuist gebruik kan leiden tot onjuiste aanwezigheidsberekeningen voor uw klant.


🚀 Cams biedt no-code of directe integratie

Om uw ontwikkelproces te vereenvoudigen, biedt Cams plug-and-play (no-code) integratieopties evenals volledige maatwerkondersteuning.

Indien nodig kan ons team:

  • Maatwerklogica ontwikkelen op basis van de werkstroom van uw systeem.
  • Kant-en-klare integratiecode leveren voor elke serverstaal (PHP, Node.js, Java, Python, .NET, enz.) en elke database (MySQL, PostgreSQL, SQL Server, enz.).

Laat ons simpelweg uw technologiestack weten, dan helpen wij u om naadloos te integreren.

Was this article helpful?