ASVerzuimmelding (SIVI)
Cezanne HR koppelen met de arbodienst via SIVI: absence events voor ziekte als verzuimmelding
Met een koppeling tussen Cezanne HR en de Arbodienst wordt een goedgekeurd absence event voor ziekte van een Nederlandse medewerker in Cezanne HR automatisch een ziek-, wijzigings- of betermelding bij de arbodienst, in het SIVI-formaat. Een ziekte zonder bekende einddatum, in Cezanne gemarkeerd als open-ended sickness, blijft bij de arbodienst open tot HR het einde invult.
Wat de koppeling doet
Organisaties die Cezanne HR gebruiken voor HR in meerdere landen, met een Nederlandse vestiging die een arbodienst heeft, leggen ziekte vast als absence event en melden die daarna nog eens in het portaal van de arbodienst. Een ziekte die HR in Cezanne verwijdert omdat ze op de verkeerde persoon stond, blijft bij de arbodienst staan.
- Bij de start kiezen we de absence types in de categorie ziekte en de Nederlandse company.
- KoppelHet vraagt elk uur de absence events op die sinds de vorige ronde zijn gewijzigd, plus de verwijderde events.
- Een goedgekeurde ziekte wordt een ziekmelding op het dienstverband van het event.
- Uit de uren per dagdeel bepaalt KoppelHet het percentage; een ander percentage wordt een wijziging.
- Zodra de markering open-ended verdwijnt en er een einddatum is, volgt de betermelding. Een verwijderd event dat al gemeld was, wordt een taak voor HR.
Waar je op let bij Cezanne HR en Arbodienst (SIVI)
- Cezanne HR heeft bij een absence event een aparte markering voor ziekte waarvan het einde nog niet bekend is. Zolang die aan staat, stuurt KoppelHet geen betermelding, ook als er een voorlopige einddatum in het event staat. Dat past op het open verzuimgeval dat de arbodienst verwacht.
- Voor elke dag van een afwezigheid legt Cezanne de uren voor de ochtend en de middag vast, plus het totaal van die dag. KoppelHet rekent daaruit het verzuimpercentage per dag, zodat een medewerker die alleen 's ochtends werkt bij de arbodienst als half hersteld staat.
- Een verwijderd absence event verdwijnt in Cezanne uit de gewone lijst, maar komt in een aparte tabel met verwijderde events, met de datums en wie het verwijderde. KoppelHet leest die tabel elk uur, zodat een ingetrokken ziekte niet stilletjes open blijft bij de arbodienst.
- Elk absence event noemt het dienstverband, de company en de organisatie-eenheid. KoppelHet stuurt alleen events van de Nederlandse company door en geeft de organisatie-eenheid mee, zodat de bedrijfsarts de medewerker bij de goede afdeling vindt.
- De absence-tabellen in de Cezanne-API zijn alleen toegankelijk voor de rol HR Professional. Een beperkte HR-rol ziet de verwijderde events en de dagdetails niet. KoppelHet vraagt daarom een eigen API-gebruiker met die rol aan, en verder alleen leesrechten.
- Een absence event heeft notities, een reden en een vinkje voor ziekengeld. KoppelHet selecteert in de API alleen de velden voor datums, status, categorie en dienstverband, zodat notities met medische details niet bij KoppelHet of de arbodienst komen.
Hoe we het bouwen en beheren
- De koppeling draait op het KoppelHet platform, gehost in een datacenter in de EU.
- Elke synchronisatie en elke fout is zichtbaar in de functionele logging; bij een fout krijgt jullie beheerder een melding.
- Een mutatie die niet door kan, wordt niet half doorgezet maar klaargezet om opnieuw te proberen.
- KoppelHet is ISO 27001-gecertificeerd. Gegevens gaan versleuteld over en blijven niet langer op het platform dan nodig.
- Na livegang beheren wij de koppeling en passen we hem aan als jullie proces verandert.
- De koppeling past naast je bestaande integratielaag. Alleen de velden uit het ontwerp gaan over; het platform houdt geen eigen registratie bij.
Implementatie en prijs
Dit is geen app die je aanzet. We bouwen de koppeling voor jullie organisatie op ons platform, met bouwstenen die we steeds opnieuw gebruiken. Zo is het maatwerk, zonder dat we bij nul beginnen.
Een consultant bereidt de intake voor en analyseert beide systemen. Daarna leggen we de mapping en uitzonderingen per veld vast, testen we in de test- of acceptatieomgeving en gaan we live op een moment dat jij kiest. De kosten bestaan uit een eenmalig bedrag voor de inrichting en een maandbedrag voor platform, monitoring en beheer.
Veelgestelde vragen
Moet HR de markering open-ended sickness gebruiken?
Het is niet verplicht, maar wel handig. Zonder die markering ziet KoppelHet een voorlopige einddatum als echt herstel.
Hebben we People PLUS+ nodig?
Nee. Webhooks vragen dat pakket, maar deze koppeling leest de tabellen elk uur via de API.
Gaan de notities bij een afwezigheid mee?
Nee. KoppelHet vraagt ze niet op. De arbodienst krijgt datums, een percentage en codes.
Technische details voor IT
Voor wie wil weten hoe het onder de motorkap werkt: gebruikte API's, velden en bronnen.
- Cezanne HR via de OData API (dataservice.svc) met OAuth 2.0 en een API-gebruiker met de rol HR Professional. PersonAbsenceEvents met $filter op AbsenceCategory, AbsenceStatus, CompanyCode en AbsenceEventLastModifiedDate en $select op PersonAbsenceEventGUID, PersonCode, EmploymentID, CompanyCode, OrgUnitCode, AbsenceEventEffectiveFrom, AbsenceEventEffectiveTo, Commences, Finishes en OpenEndedSickness. PersonAbsenceEventDetails per ReferenceDate (AMWorkingHours, PMWorkingHours, DayTotalWorkingHours) en PersonAbsenceDeletedEvents (AbsenceEventGuid, ActionDate). AbsenceTypes met Category.
- Naar de arbodienst gaan de SIVI-berichten Dienstverbanden, Werknemer gegevens en Verzuimmeldingen, met verwerkingscode nieuw, gewijzigd of correctie, Vangnet J/N (verplicht), organisatie-eenheid en een oorzaakcode zonder diagnose. Transport volgens de koppelvlakbeschrijving SIVI 2025 (REST-endpoint bij de arbodienst, XML in Base64 binnen JSON, OAuth 2.0), met een retour- en verwerkingsmelding terug.
Welke velden overgaan
De belangrijkste velden. De volledige mapping stellen we per klant vast.
| Veld in Cezanne HR | Veld in Arbodienst (SIVI) | Toelichting |
|---|---|---|
PersonCode | Identificatie werknemer | Geen BSN |
EmploymentID | Identificatie dienstverband | |
PersonAbsenceEventGUID | Verzuimgeval identificatie | |
AbsenceEventEffectiveFrom en Commences | Datum eerste verzuimdag | |
AM- en PMWorkingHours per ReferenceDate | Percentage verzuim | |
AbsenceEventEffectiveTo + 1 dag, als OpenEndedSickness uit staat | Datum hersteld en Einde verzuim J/N | |
OrgUnitCode | Organisatie-eenheid, code | |
Eigen veld in Cezanne | Vangnet J/N |
Gerelateerd
Cezanne HR → Active Directory
Cezanne HR koppelen met Active Directory: domeinaccounts per werkgever en locatie
Cezanne HR → ADP iHCM
Cezanne HR ADP iHCM koppeling: compensatie, eenmalige betalingen en vertrek naar de Nederlandse ADP-payroll
Cezanne HR → AFAS Profit
Cezanne HR koppelen met AFAS: de Nederlandse werkgever uit Cezanne in AFAS Profit Payroll
Cezanne HR → DATEV
Cezanne HR DATEV koppeling: de Duitse company uit Cezanne HR naar de Steuerberater