Support Hub/API & Integrations/Biometrische integratie voor loonplatforms: Razorpay,…
Translated from the English article and reviewed by a person. Read the English original
Developer

Biometrische integratie voor loonplatforms: Razorpay, Payruler en meer

Biometrische integratie voor loonplatforms: Razorpay, Payruler en meer

 

Elke loonrun is afhankelijk van aanwezigheidsregistratie. Gewerkte uren, te laat komen, overwerk, afwezigheden, nachtdiensten en werk op feestdagen beginnen allemaal met een scan op een biometrisch apparaat. Toch loopt in veel organisaties de weg van die scan naar het loonplatform nog altijd via exports, spreadsheets, kopiëren en plakken, en via iemand die de cijfers laat in de avond controleert vóór de loonafsluiting. Elke handmatige stap is een kans op een fout die uiteindelijk op iemands loonstrook terechtkomt. Deze gids legt uit waar het loon misgaat tussen het apparaat en de loonstrook, wat de loonadministratie werkelijk nodig heeft van aanwezigheidsgegevens, en hoe Cams Biometrics geverifieerde ponsingen koppelt aan loonplatforms zoals Razorpay en Payruler, en aan de HRMS- en ERP-systemen die voor alle anderen de loonadministratie draaien.

01 · De handmatige kloof

Waar het loon al misgaat voordat het begint

Loonplatforms zijn zeer goed in het berekenen van salaris. Ze passen salarisstructuren, belastingregels, inhoudingen en wettelijke bijdragen nauwkeurig en consistent toe. Maar ze kunnen alleen werken met de aanwezigheidsgegevens die ze krijgen. Als die gegevens te laat aankomen, onvolledig zijn of met de hand worden overgetypt, dan levert ook de meest nauwkeurige loonberekening ter wereld een verkeerde loonstrook op.

In een typisch handmatig proces passeren aanwezigheidsgegevens tussen het biometrische apparaat en het loonplatform verschillende handen:

Handmatige stap Wat er mis kan gaan
Export uit de apparaatsoftware Verkeerd datumbereik, een gemist apparaat of een apparaat dat offline was tijdens de export
Opschonen in een spreadsheet Formules verkeerd gekopieerd, rijen per vergissing verwijderd, nachtdiensten over twee dagen gesplitst
Apparaat-ID's koppelen aan medewerker-ID's Een medewerker aan het verkeerde record gekoppeld, of nieuwe medewerkers ontbreken in de koppeling
Uren en overwerk met de hand berekenen Afrondingsverschillen, overwerkregels die tussen vestigingen inconsistent worden toegepast
Uploaden of overtypen in de loonadministratie Typefouten, een bestand dat tweemaal is geüpload, of per vergissing een oude versie
Haasten vóór de afsluiting Late correcties overgeslagen, geschillen doorgeschoven naar de loonadministratie van volgende maand

Loonfouten ontstaan zelden in het loonplatform zelf. Ze ontstaan in de spreadsheet tussen het apparaat en het loonplatform.

02 · Van ponsing tot loon

Wat de loonadministratie werkelijk nodig heeft van aanwezigheid

Een loonplatform heeft niet elke afzonderlijke scan nodig. Het heeft een set duidelijke invoergegevens nodig per medewerker en per loonperiode. Al deze gegevens kunnen worden berekend uit geverifieerde biometrische ponsingen, met de regels die uw HR- of loonadministratieteam al hanteert.

Invoer loonadministratie Berekend uit Regel bepaald door
Aanwezige en afwezige dagen Of elke medewerker op elke werkdag inchecks heeft Uw werkkalender en verlofregistraties
Gewerkte uren Gekoppelde in- en uitcheck-tijden, geordend op LogTime Uw koppel- en afrondingsregels
Te laat komen en vroeg vertrekken Eerste incheck en laatste uitcheck vergeleken met de dienst Dienstroosters en coulanceperiodes
Overwerk Gewerkte uren boven de contractuele limiet Uw overwerkbeleid
Nachtdienstvergoedingen Werkperiodes die binnen nachturen vallen of over middernacht gaan Uw toeslagregels
Werk op feestdagen en in het weekend Ponsingen op data die als feestdag of rustdag zijn gemarkeerd Uw feestdagenkalender

Let op de derde kolom. Cams Biometrics Gateway levert de geverifieerde ponsingen. De regels die ponsingen omzetten in loonvoorwaarden horen thuis in uw HRMS, loonplatform of aanwezigheidslogica, omdat die regels specifiek zijn voor uw organisatie, uw contracten en uw lokale arbeidswetgeving.

Een eenvoudig wekelijks voorbeeld

Hier ziet u hoe geverifieerde ponsingen loonvoorwaarden worden voor één medewerker in één week, met als voorbeeldregel dat uren boven 40 per week als overwerk gelden. Elke dag bevat een lunchpauze, geregistreerd als een uitcheck en een incheck, die niet als gewerkte tijd wordt meegeteld.

Dag Eerste incheck Laatste uitcheck Gewerkte uren Opmerkingen
Maandag 08:58 18:04 8u 32m
Dinsdag 09:00 17:35 8u 05m
Woensdag 08:45 18:55 9u 40m Later gebleven voor een levering
Donderdag 09:25 17:45 7u 50m Te laat binnengekomen, na de coulanceperiode
Vrijdag 09:00 17:40 8u 10m
Totaal 42u 17m 2u 17m overwerk volgens de voorbeeldregel

Daarom zijn gewerkte uren korter dan de tijd tussen de eerste incheck en de laatste uitcheck. Het loonplatform ontvangt de samenvattende cijfers, niet honderden afzonderlijke scans.

03 · Integratiepaden

Twee manieren om aanwezigheid aan de loonadministratie te koppelen

Er zijn twee gangbare manieren om geverifieerde biometrische aanwezigheid in de loonadministratie te krijgen. De juiste keuze hangt ervan af of de aanwezigheidsregels in uw HRMS staan of rechtstreeks in uw loonplatform.

Pad A: via uw HRMS of ERP

Biometrisch apparaat

Geverifieerde scan

→

Cams Gateway

Callback-event in realtime

→

HRMS of ERP

Past shift-, verlof- en overwerkregels toe

→

Loonadministratie

Ontvangt aanwezigheidssamenvattingen

Pad B: rechtstreeks naar een loonplatform

Biometrisch apparaat

Geverifieerde scan

→

Cams Gateway

Callback-event in realtime

→

Uw ontvanger of automatisering

Slaat ponsingen op, maakt ze schoon en vat ze samen

→

Loonplatform

Ontvangt aanwezigheid via zijn API

Pad A: via HRMS of ERP Pad B: rechtstreeks naar loonadministratie
Het beste wanneer Uw HRMS of ERP beheert al diensten, verlof en aanwezigheidsregels De loonadministratie is uw belangrijkste HR-systeem, of u heeft geen apart HRMS
Waar de regels staan In het HRMS of ERP In uw ontvanger, automatisering of het loonplatform
Waar Cams naartoe stuurt Het Callback-eindpunt van het HRMS of ERP Uw callback-ontvanger of automatiseringstool
Wat de loonadministratie ontvangt Aanwezigheidssamenvattingen uit het HRMS Aanwezigheidssamenvattingen van uw ontvanger

Hoe dan ook is de Callback API het startpunt

In beide paden stuurt Cams Gateway elke geverifieerde scan in realtime via de Callback API naar uw eindpunt. Wat verandert, is welk systeem die scans omzet in loonvoorwaarden. In geen van beide paden hoeft iemand aanwezigheidsgegevens te exporteren of opnieuw in te typen.

04 · Loonplatforms

Razorpay, Payruler en meer

Cams Biometrics werkt samen met een breed scala aan loon-, HRMS- en ERP-platforms. Omdat elk event als standaard JSON via HTTP/HTTPS wordt aangeleverd, is de integratiebenadering in principe hetzelfde voor elk platform dat aanwezigheidsgegevens via een API of import kan ontvangen.

Platformtype Voorbeelden uit de Cams-integratielijst Gangbare aanpak
Loonplatforms Razorpay, Payruler Samengevatte aanwezigheid naar het loonplatform gestuurd via zijn API of ondersteunde importmethode
HRMS-platforms OrangeHRM, BayZat, PalmHR, Zoho Callback-events geschreven in de aanwezigheidsmodule van het HRMS, die vervolgens de loonadministratie voedt
ERP-platforms Odoo, ERPNext, SAP, Microsoft Dynamics Callback-events geschreven in de aanwezigheidsregistratie van het ERP, gebruikt door de loonmodule
Automatiseringstools n8n, Make, Zapier Workflows ontvangen callback-events en geven samenvattingen door aan het loonplatform

Controleer de aanwezigheidsopties van elk platform

Elk loonplatform heeft zijn eigen API, importformaten en regels voor hoe aanwezigheidsgegevens kunnen worden aangeleverd. Controleer vóór de bouw welke aanwezigheidsvelden uw loonplatform accepteert en hoe het verwacht dat ze worden verstuurd. Koppel uw samenvattingsvelden eenmalig aan die velden, en de integratie werkt elke loonperiode.

Als u de ontvanger zelf bouwt, kunnen de Cams AI Code Generator Prompts een complete callback-ontvanger genereren in Python, Node.js, PHP en andere talen, klaar om de loonmapping aan toe te voegen.

05 · Stap voor stap

De loonklare aanwezigheidspijplijn

Welke route u ook kiest, betrouwbare loonintegratie volgt dezelfde pijplijn. Elke stap verwijdert een bron van fouten die handmatige processen openlaten.

1

Vastleggen

Elke scan wordt op het apparaat geverifieerd met vingerafdruk, gezicht, handpalm, kaart, pincode of QR-code.

2

Ontvangen

Cams Gateway stuurt elke scan via de Callback API naar uw eindpunt, en uw eindpunt antwoordt met done.

3

Opslaan en dubbele events verwijderen

Sla elk ruw event op en negeer herhaalde OperationIDs, zodat geen enkele ponsing ooit dubbel wordt geteld.

4

Opschonen en ordenen

Sorteer ponsingen op LogTime, voeg per ongeluk dubbele scans samen en koppel incheck- aan uitcheck-tijden met consistente regels.

5

Berekenen

Pas dienst-, overwerk-, toeslag- en feestdagregels toe om loonvoorwaarden per medewerker te produceren.

6

Afwikkelen en vergrendelen

Geef tijd voor late events van offline apparaten om aan te komen, en vergrendel daarna de periode vóór de loonafsluiting.

7

Naar de loonadministratie sturen

Lever de vergrendelde samenvattingen aan uw loonplatform, rechtstreeks of via uw HRMS.

8

Auditspoor bewaren

Bewaar ruwe events en elke correctie, zodat elk cijfer op een loonstrook kan worden teruggeleid naar echte scans.

Wie doet wat

Cams Gateway legt geverifieerde scans vast en levert ze af. Uw HRMS, ERP, ontvanger of automatiseringstool past uw regels toe en berekent loonvoorwaarden. Uw loonplatform berekent het loon. Elk systeem doet het werk waarvoor het het best geschikt is, en niemand hoeft aanwezigheidsgegevens tussen hen te kopiëren.

06 · Waarom geverifieerde data belangrijk is

Vertrouwen, geschillen en naleving

Wanneer een medewerker zijn loon in twijfel trekt, verloopt het gesprek heel anders met geverifieerde biometrische aanwezigheid. In plaats van een spreadsheet te vergelijken met iemands geheugen, kan HR de exacte scans tonen achter elk cijfer: wanneer, waar en hoe de medewerker zich heeft geverifieerd.

Zorgpunt Hoe geverifieerde aanwezigheid helpt
Loongeschillen Elk uur op de loonstrook is terug te voeren op getimestampte scans bij een benoemde vestiging en apparaat
Buddy punching Biometrische verificatie betekent dat de persoon die heeft gescand ook degene is die wordt betaald
Administratie arbeidswetgeving Ruwe events en correcties geven een duidelijk overzicht van gewerkte tijd voor inspecties
Gegevensbescherming De loonadministratie ontvangt aanwezigheidssamenvattingen, geen vingerafdruksjablonen of gezichtsgegevens
Beveiliging Events reizen via HTTP/HTTPS met validatie van authenticatietokens en optionele AES-256-versleuteling

Stuur de loonadministratie alleen wat zij nodig heeft

Loonplatforms hebben gewerkte uren, afwezigheden, overwerk en toeslagen nodig. Ze hebben geen biometrische gegevens nodig. Houd biometrische verificatie op het apparaat en in de Gateway, en stuur bij loonplatforms alleen aanwezigheidssamenvattingen.

Veelgestelde vragen

Berekent Cams Biometrics het loon?

Nee. Cams Gateway legt geverifieerde aanwezigheidsevents vast en levert ze af. Uw HRMS, ERP of loonplatform past uw regels toe en berekent het loon. Zo blijft de loonlogica in het systeem dat uw team al vertrouwt.

Kunnen we vóór de loonadministratie een handmatige goedkeuringsstap behouden?

Ja, en veel organisaties doen dat. De pijplijn kan aanwezigheidssamenvattingen maken die HR kan controleren en goedkeuren voordat ze naar de loonadministratie worden gestuurd. Het verschil is dat HR geverifieerde data controleert in plaats van die opnieuw op te bouwen uit exports.

Hoe worden nachtdiensten die over middernacht gaan verwerkt?

Ponsingen worden op LogTime geordend en gekoppeld tot werkperiodes, dus een incheck om 22:00 en een uitcheck om 06:00 de volgende ochtend vormen samen één dienst. Hoe die dienst aan een uitbetalingsdatum wordt toegewezen, is een regel in uw HRMS- of loonlogica.

Wat als een apparaat vlak voor de loonafsluiting offline is?

Apparaten blijven scans registreren, en de offline cache en wachtrij van de Gateway leveren deze met hun oorspronkelijke tijdstempels zodra de verbinding terugkeert. Een afwikkelingsperiode inplannen vóórdat u de loonperiode vergrendelt, geeft late events de tijd om aan te komen.

Kunnen we apparaten van meerdere vestigingen en merken aan één loonadministratie koppelen?

Ja. Apparaten van meer dan 15 merken, verspreid over een willekeurig aantal vestigingen, leveren events in hetzelfde JSON-formaat via één Gateway-account, zodat één integratie één loonadministratie voedt.

Conclusie: laat de scan zelfstandig de loonstrook bereiken

Biometrische apparaten leggen al de meest betrouwbare aanwezigheidsgegevens vast die een organisatie heeft. Loonplatforms berekenen al nauwkeurig het loon. Het zwakke punt was altijd de handmatige weg ertussen: exports, spreadsheets, opnieuw typen en correcties in de late avond vóór de afsluiting.

Verbind de twee rechtstreeks, via uw HRMS of direct met uw loonplatform, en dat zwakke punt verdwijnt. Elke geverifieerde scan stroomt automatisch de aanwezigheid in, uw regels zetten die om in loonvoorwaarden, en elk cijfer op elke loonstrook is terug te voeren op echte, geverifieerde ponsingen.

Cams Biometrics Gateway verbindt de scan met de loonstrook. De Callback API stuurt elke geverifieerde ponsing in realtime, van apparaten van meer dan 15 merken, naar Razorpay, Payruler, uw HRMS, uw ERP of uw automatiseringstools, in één consistent JSON-formaat. De offline cache en wachtrij beschermen events vlak voor de afsluiting, en validatie van authenticatietokens met optionele AES-256-versleuteling houdt elk event veilig. Ontdek het platform op CamsBiometrics.com, lees de volledige Web API-documentatie op developer.camsbiometrics.com, en genereer uw ontvanger met de AI Code Generator Prompts.

Was this article helpful?