Overslaan naar inhoud
Nederlands
Klantenportal
Ga naar othersideatwork.nl
  • Er zijn geen suggesties want het zoekveld is leeg.

Aansluiten SIVI-koppeling naar XS

Vr, 31 Dec, 2021 at 2:01 PM

Belangrijk aandachtspunt:

INHOUDSOPGAVE


1) Achtergrond

Door het instituut SIVI is in het verleden communicatiestandaarden in het leven geroepen om efficiënt gegevens uit te wisselen tussen de verschillende partijen in de arbodienstverleningsbranche. Om die efficiëntie te bereiken is de Verzuimstandaard gebaseerd op een aantal verschillende typen berichten met elk haar eigen doeleinde:


Tables can't be imported directly. Please insert an image of your table which can be found here.

Type bericht Primair doel werkgever werknemer arbeidsrelatie dienstverbanden

2) Randvoorwaarden

De SIVI Verzuimstandaard wordt binnen de Nederlandse markt door veel partijen ondersteund, maar lang niet alle partijen ondersteunen alle berichttypen. Door het SIVI-instituut wordt een overzicht van de implementaties bijgehouden, maar informeer bij je koppelpartij naar de actuele stand van zaken. Voor een koppeling op basis van SIVI geldt namelijk een aantal randvoorwaarden. Omwille van het voorbeeld gaan we er gemakshalve van uit dat dit een koppeling is van een werkgever naar een arbodienst - dus men wil informatie verzenden vanuit een HR-systeem naar de Xpert Suite:

  • beide partijen dienen dezelfde typen berichten te ondersteunen:
    • het absolute minimum is het Verzuimmeldingen-bericht om verzuimmutaties uit te kunnen wisselen, wat resulteert in een negatieve deelnemerregistratie: de ontvangende partij is enkel op de hoogte van werknemers met een zorgvraag. Let op: dit betekent ook dat contactgegevens (telefoonnummer(s), mailadres(sen) en woonadres) van een werknemer enkel worden bijgewerkt als een verzuimmutatie wordt doorgestuurd
    • als je een positieve deelnemerregistratie wenst te voeren (dus alle werknemers in beeld hebben en houden omwille van statistieken) dient het HR-systeem het WerknemersGegevens- en/of Dienstverbanden-bericht te kunnen genereren. Dit berichttype moet dan door het HR-systeem gegenereerd worden als medewerkergegevens worden gemuteerd
    • als je een organisatiestructuur wenst te onderhouden door middel van SIVI, moet het HR-systeem het WerkgeverGegevensBasisRegistratie-bericht te kunnen versturen inclusief de <Organisatie eenheid>-sectie van dat berichttype. Als alternatief moet het HR-systeem een (al dan niet hiërarchisch) overzicht van afdelingen kunnen genereren conform de Standaard Afdelingen Import, waarbij dezelfde afdelingscodes worden gehanteerd als in de SIVI-communicatie
    • als je documenten zoals spreekuurverslagen wilt kunnen versturen die de arbodienst heeft opgesteld als onderdeel van het verzuimtraject, dient het HR-systeem het Documenten-bericht kunnen ontvangen
  • op een SIVI-koppeling worden unieke sleutels gebruikt voor werkgevers en werknemers, welke goed tussen de twee partijen moeten worden afgestemd:
    • de gegevens IdWrkgvrArbdnst en AansltnrGeguitwlngArbdnst zijn van belang om een werkgever op de koppeling uniek te identificeren. Deze wordt meestal bepaald door de ontvangende partij
    • het gegeven IdWrknmr is het gegeven bij uitstek om werknemers uniek te identificeren en wordt bepaald door het verzendende systeem - in ons voorbeeld het HR-systeem. In XS Connect kan ook het personeelsnummer gehanteerd worden, maar dit raadt Otherside at Work enkel aan als de verzendende partij kan garanderen dat een personeelsnummer altijd uniek is en nooit opnieuw wordt uitgegeven
  • de SIVI Verzuimstandaard is ontworpen als een op mutaties gebaseerde koppeling, wat betekent dat elke mutatie die opgevoerd wordt in het HR-systeem resulteert in een SIVI-bericht voor dat ene verzuimdossier bij die ene werknemerdat naar de arbodienstverlener verstuurd wordt. Wees ervan bewust dat:
    • bij de eerste opstart - minimaal - de actuele stand van zaken tussen HR-systeem en Xpert Suite eerst moet worden gesynchroniseerd. Voor iemand die bij de opstart in de Xpert Suite niet al als ziek te boek stond zal uitval optreden als het eerste voor hem ontvangen bericht een (deel)herstelmelding is. Hiertoe zijn twee overzichten nodig:
      • een overzicht van (minimaal) alle op dit moment verzuimende medewerkers. Dit overzicht dient de gebruikte sleutel (IdWrknmr) te bevatten in het veld ExternWerknemerID
      • een overzicht van (minimaal) het actueel verzuim. Dit zijn alle verzuimdossiers die hetzij nu nog lopen hetzij zijn afgesloten in de afgelopen 28 dagen - want deze kunnen nog resulteren in samengesteld verzuim
    • opvolging van uitval op de koppeling cruciaal is. Elke (verzuim)mutatie wordt afzonderlijk verstuurd, dus als een mutatie in een verzuimdossier uitvalt bestaat de kans dat daarna ontvangen mutaties óók uitvallen omdat 'de keten' niet meer klopt


3) Globaal stappenplan

Voor het aansluiten van een koppeling op basis van de SIVI-communicatiestandaard dienen de volgende stappen te worden doorlopen:

  1. Stem met de koppelpartij (of de leverancier van het te koppelen systeem) de volgende zaken af:
    1. welke 'jaargang' van de SIVI-communicatiestandaard zal worden gebruikt
    2. welke berichttypen worden ondersteund? Dit bepaalt welke gegevensstromen moeten worden aangemaakt binnen XS Connect
    3. vindt de opstart plaats met enkel het actuele verzuim (enkel voor de dienstverlening) of ook verzuimhistorie (voor statistieken)? Als je kiest voor verzuimhistorie dient de koppelpartij ook de selectiecriteria voor het overzicht van werknemers uit te breiden
    4. wie van beide partijen gaat de server voor de bestandsoverdracht hosten? Otherside at Work adviseert dat de ontvangende partij altijd beschikbaar is voor de verzendende partij om nieuwe informatie te plaatsen (het 'push'-principe). Dat betekent dat Otherside at Work in deze de (SFTP-)server host en de verzendende partij verbinding kan maken zodra men een bericht wil plaatsen
    5. wat zijn de te gebruiken sleutels op de koppeling voor werkgevers en werknemers?
  2. Zo die nog niet bestaat/bestaan, maak in XS het juiste aantal nieuwe werkgevers aan en controleer:
    1. of ze de juiste werkgevercode hebben zoals onderling afgestemd
    2. of ze voorzien zijn van de juiste protocolvariaties
    3. of ze voorzien zijn van de verzuimclassificaties uit de SIVI-bibliotheek (zie paragraaf 4)
  3. Maak in XS Connect een nieuwe account aan voor de betreffende koppelpartner, kies het juiste type account en wissel de inloggegevens uit met de koppelpartner (zie paragraaf 5)
  4. Maak binnen het aangemaakte account het juiste aantal importconfiguraties aan - afhankelijk van het aantal berichttypen dat wordt ondersteund
  5. Zet de verwerking van dit klantaccount uit. De ontvangen SIVI-berichten mogen pas verwerkt worden nadat de administraties van beide systemen zijn gelijkgetrokken door middel van de opstartprocedure 
  6. Geef de koppelpartner groen licht om
    1. aan hun zijde het genereren en aanleveren van SIVI-berichten te starten
    2. de werknemer- en verzuimoverzichten op te stellen
  7. Lees de werknemer- en verzuimoverzichten in via een apart account in XS Connect
  8. Start nu de verwerking van de SIVI-berichten

Tip:
Tip:

4) Werkgevergegevens aanvullen met de verzuimclassificaties


Tables can't be imported directly. Please insert an image of your table which can be found here.

Stap Actie Wieverzuimclassificaties

5) Aanmaken account in Xpert Suite


Tables can't be imported directly. Please insert an image of your table which can be found here.

Stap Actie Wie
  • Of het 'push' of 'pull' wordt:
    • In het geval van 'push' selecteer je accounttype 'Otherside SFTP' - de klant kan verbinden zodra er een nieuw SIVI-bericht klaarstaat
    • In het geval van 'pull' selecteer je accounttype 'Externe SFTP' - XS Connect zal periodiek moeten verbinden om te kijken of er al nieuwe berichten klaarstaan
  • Of de inloggegevens bekend zijn:
    • In het geval van Otherside SFTP dien je een SFTP-account aan te maken voor de koppelpartner. Dit resulteert in een gebruikersnaam, een private key en een wachtwoord behorende bij de private key
    • In het geval van Externe SFTP moet de koppelpartner een gebruikersnaam/wachtwoord-combinatie of een gebruikersnaam/private key/wachtwoord-combinatie hebben opgeleverd
  • of, in geval van Externe SFTP, de koppelpartner heeft aangegeven in welke folder(s) op hun SFTP-server de op te halen SIVI-berichten klaarstaan
  • naar welk emailadres de verwerkingsverslagen vanuit de koppeling naartoe gestuurd mogen worden
  • voor welke werkgever(s) het account dient te worden geautoriseerd
  • Naam account: Dit is een vrij te kiezen naam
  • Type account: zie stap 1. In het geval van Externe SFTP dien je hier ook de volgende gegevens in te vullen:
    • URL van de SFTP-server van de koppelpartner
    • Poort van de SFTP-server van de koppelpartner
    • Gebruikersnaam
    • Wachtwoord
  • Ontvanger(s) logverslag: vul hier de emailadressen in die het verwerkingsverslagen van de koppeling wensen te ontvangen
  • Autorisaties (zie stap 2): kies hier voor werkgever indien er één werkgever is geautoriseerd of voor werkgevergroep indien er meerdere werkgevers zijn geautoriseerd. Het is ook mogelijk om één werkgever in een werkgevergroep te zetten indien het aantal werkgevers in de toekomst uitgebreid gaat worden.
Otherside SFTP Otherside SFTP
  • het absolute minimum is een gegevensstroom met Verzuimmeldingen. Maak hiertoe een configuratie aan, daarbij gebruik makend van de afgestemde SIVI-standaard:
  • als de koppelpartner ook het WerknemersGegevens-bericht ondersteunt en wenst aan te leveren, maak dan daar ook een configuratie voor aan:

Tip: Externe SFTP

Tip: moet

6) Uit- en inschakelen van verwerking

Bij elk klantaccount kan de verwerking van de aanlevering uit- en weer ingeschakeld worden vanuit het overzichtscherm. Volg hiertoe de volgende stappen:


Tables can't be imported directly. Please insert an image of your table which can be found here.

Stap Actie Wie Effectief plaats je dit account nu in een 'foutstand'.
R Robin is the author of this solution article.