Dit document wordt u aangeboden door de Kruispuntbank van de Sociale Zekerheid

Transcriptie

1 Dit document wordt u aangeboden door de Kruispuntbank van de Sociale Zekerheid Het kan vrij verspreid worden op voorwaarde dat de bron en de URL vermeld worden Kruispuntbank van de Sociale Zekerheid Sint-Pieterssteenweg 375 B-1040 BRUSSEL Tel: Fax: RVV-BIM_OMNIO_Status_Gebruikershandleiding.doc 1/7

2 Gebruikershandleiding Index Gebruikershandleiding...2 Index... 2 Doel van het document...2 Functionaliteit... 2 Overzicht... 2 Opzoekingscriteria...2 Logica... 3 Resultaat... 4 Beschrijving van het XML bericht... 5 De aanvraag... 5 Voorbeeld...5 Het antwoord... 6 Voorbeeld...6 Foutcodes... 7 Contacten... 7 Doel van het document Dit document bespreekt de XML dienst RVV-BIM_OMNIO_Status. Functionaliteit Overzicht Deze dienst is een algemene dienst om online het statuut RVV-BIM en/of OMNIO voor een bepaalde persoon en een bepaalde datum na te gaan binnen het Netwerk van de Sociale Zekerheid. Dit onderzoek gebeurt door in het Personenrepertorium van de KSZ na te gaan of de persoon gekend is voor het DOSZ-OSSOM 1 en/of HVKZ-CSPM 2 voor de opgegeven datum en/of door additioneel het verzekerbaarheidsbestand van de mutualiteiten te raadplegen. Opzoekingscriteria Velden: - INSZ (verplicht): het INSZ van persoon waarvoor we consulteren - Datum (optioneel): de datum waarvoor het statuut gekend dient te worden (dit moet na liggen of zelf zijn); indien het niet meegegeven wordt, gaat men ervan uit dat het over de datum van de raadpleging gaat. Controles: - Foutieve input 1 Dienst voor de Overzeese Sociale Zekerheid - Office de Sécurité Sociale d Outre-mer 2 Hulp- en Voorzorgskas voor Zeevarenden - Caisse de Secours et de Prévoyance en faveur des Marins RVV-BIM_OMNIO_Status_Gebruikershandleiding.doc 2/7

3 In het geval dat de klant voor het formaat van de input het XSD-schema niet naleeft, dan zal er een foutboodschap teruggestuurd worden. Meestal is dit probleem te wijten aan een verkeerde versie van de XSD s aan de kant van de klant of zijn informaticaleverancier. Het kan ook zijn dat de klant/leverancier de XML-berichten niet valideert vooraleer ze naar de KSZ door te sturen. Dit is niet enkel een richtlijn, het is ook een verplichting. - Vervangen / niet bestaande INSZ: In het geval dat het INSZ van de betrokken persoon vervangen is of niet gevonden wordt, zal de dienst stoppen met een foutboodschap in het antwoord. Indien het ging om een vervanging wordt het nieuwe nummer meegegeven en dient de klant zijn vraag opnieuw te stellen met het huidige of nieuwe INSZ. - INSZ niet geïntegreerd: In het geval dat het INSZ van de betrokken persoon niet correct geïntegreerd 3 is voor de vragende sector, zal de dienst stoppen met een foutboodschap in het antwoord. De klant dient het INSZ van de betrokkene correct te integreren in het personenrepertorium van de KSZ en zijn aanvraag opnieuw door te sturen. Logica Eerst wordt er in het personenrepertorium van de KSZ opgezocht of er een integratie is voor de vragende sector voor de betrokkene, waarbij deze integratie moet voldoen aan de afgesproken regels voor het oproepen van deze dienst 4. Nadien 5 wordt er voor de betrokkene opgezocht of er voor de sector DOSZ-OSSOM geïntegreerd is met een hoedanigheidscode die overeenstemt met het statuut RVV-BIM (sector, type instelling, hoedanigheidscode: 020, 000, 002 of 012), voor een periode die overeenstemt met de opgevraagde datum. Indien men door vorige controles niet heeft kunnen concluderen dat het statuut RVV-BIM van toepassing is, gaat men dezelfde controle uitvoeren voor de sector HVKZ-CSPM (sector, type instelling, hoedanigheidscode: 009, 000, 002 of 012), voor een periode die overeenstemt met de opgevraagde datum. Indien het resultaat nog altijd niet positief is, gaat men het verzekerbaarheidsbestand van de mutualiteiten raadplegen. Hier krijgt men mogelijk 3 periodes met codes waaruit men kan opmaken of de betrokkene wel of niet onder een van de statuten RVV-BIM / OMNIO valt. Dit is het geval als de waarde van de indicatie grote risico van de eerste titularis code gelijk is aan 1. De periode die overeenkwam, of de aaneensluiting van de overeenkomstige periodes worden teruggegeven. Indien er geen periode overeenkomt met de opgevraagde datum, dan wordt het statuut op ongekend gezet. 3 Deze regels moeten per sector afgesproken worden met de KSZ en gestaafd worden door een beslissing van het Sectoraal Comité van de Sociale Zekerheid. 4 Deze regels moeten per sector afgesproken worden met de KSZ en gestaafd worden door een beslissing van het Sectoraal Comité van de Sociale Zekerheid. 5 Deze volgorde werd gehanteerd om performantieredenen. RVV-BIM_OMNIO_Status_Gebruikershandleiding.doc 3/7

4 Resultaat Als resultaat krijgt men: - een indicatie van het statuut van de betrokkene i.v.m. RVV-BIM en OMNIO. - de sector die de bron was in geval de betrokkene inderdaad in aanmerking komt voor RVV-BIM / OMNIO. - de periode die bij de bron overlapte met de datum in de aanvraag (of de datum van vandaag indien niet meegegeven) - Statuut: Niet gekend (afhankelijk van de bron is enkel het huidige statuut gekend en krijgt men niet gekend indien men een datum opvraagt waarvoor geen informatie gekend is) OMNIO RVV-BIM Beide Een van de twee (sommige bronnen geven een indicatie op het recht maar niet of het effectief om BIM of OMNIO gaat) - Sector: HealthCare: sector van de gezondheidszorg HVKZ-CSPM DOSZ-OSSOM - Periode: Indien de sector HVKZ-CSPM of DOSZ-OSSOM is, is de periode momenteel het hele jaar dat overeenkomt met de opzoekingscriteria. Indien het om NIC-CIN gaat, is het de door de mutualiteiten aangegeven en aan de opzoekingscriteria overeenkomende verzekerbaarheidsperiode. RVV-BIM_OMNIO_Status_Gebruikershandleiding.doc 4/7

5 Andere fout- of informatieboodschappen zijn, zoals bij de andere diensten terug te vinden in de ResultSummary van het SSDNReply gedeelte. Beschrijving van het XML bericht Dit hoofdstuk beschrijft enkel het eigenlijke berichtgedeelte van de XML berichten die naar de dienst gestuurd kunnen worden. Dit houdt in dat enkel de elementen worden besproken die zich kunnen bevinden op de plaats van het <any/> element in de <ServiceRequest> en <ServiceReply> elementen. ServiceId: RVV-BIM_OMNIO_Status Version: Gebruikte XML namespaces: - schema's van de eigenlijke aanvraag- en antwoordberichten - schema's voor veelgebruikte algemene XML elementen en types De aanvraag - RVV-BIM_OMNIO_StatusRequest Hoofdelement van de aanvraag. Dit element komt op de plaats van het <any/> element in een <ServiceRequest> element in het bericht. - SSIN Het INSZ - Date De datum waarvoor het statuut moet consulteerd worden Voorbeeld <?xml version="1.0" encoding="utf-8"?> <SSDNRequest xmlns=" > <RequestContext> <AuthorizedUser> <UserID>XXXXXXXXXXX</UserID> < >XXXXXX@XXXXXXXX.XX</ > <OrgUnit>XXXXXXXXXXX</OrgUnit> <MatrixID>XX</MatrixID> <MatrixSubID>X</MatrixSubID> </AuthorizedUser> <Message> RVV-BIM_OMNIO_Status_Gebruikershandleiding.doc 5/7

6 <Reference>EHFJKDU5S2DD53</Reference> <TimeRequest> T094712</TimeRequest> </Message> </RequestContext> <ServiceRequest> <ServiceId>RVV-BIM_OMNIO_Status</ServiceId> <Version> </Version> <RVV-BIM_OMNIO_StatusRequest xmlns=" xmlns:xsi=" <SSIN> </SSIN> <Date> </Date> </RVV-BIM_OMNIO_StatusRequest> </ServiceRequest> </SSDNRequest> Het antwoord RVV-BIM_OMNIO_StatusReply Hoofdelement van het antwoord. Dit element komt op de plaats van het <any/> element in een <ServiceReply> element in het bericht. - Status Het statuut - Source Element die de bron van de informatie beschrijft - Sector De sector - Period Periode die aangegeven is door de bron en die overlapt met de gevraagde datum - StartDate Begindatum van de periode - EndDate Einddatum van de periode Voorbeeld <?xml version="1.0" encoding="utf-8" standalone="yes"?> <SSDNReply xmlns=" > <ReplyContext> <common:resultsummary ok="yes" > <common:returncode>0</ns1:returncode> </common:resultsummary> RVV-BIM_OMNIO_Status_Gebruikershandleiding.doc 6/7

7 <AuthorizedUser> <UserID>XXXXXXXXXXX</UserID> <OrgUnit>XXXXXXXXXXX</OrgUnit> <MatrixID>XX</MatrixID> <MatrixSubID>X</MatrixSubID> </AuthorizedUser> <Message> <Reference>123AZERTY</Reference> <Ticket>6qNjt1mNxKCBSSh</Ticket> <TimeRequest> T111038</TimeRequest> <TimeReceive> T102727</TimeReceive> <TimeResponse> T102817</TimeResponse> </Message> </ReplyContext> <ServiceReply> <common:resultsummary ok="yes"> <common:returncode>0</common:returncode> </common:resultsummary> <ServiceId>RVV-BIM_OMNIO_Status</ServiceId> <Version> </Version> <RVV-BIM_OMNIO_StatusReply xmlns=" xmlns:xsi=" <Status>RVV-BIM OR OMNIO</Status> <Source> <Sector>NIC-CIN</Sector> <Period> <common:startdate> </common:startdate> <common:enddate> </common:enddate> </Period> </Source> </RVV-BIM_OMNIO_StatusReply> </ServiceReply> </SSDNReply> Foutcodes U heeft geen toelating om deze dienst uit te voeren De verplichte parameter is niet gespecifieerd of is leeg De parameter mag niet ingevuld zijn. Contacten Voor bijkomende functionele informatie vanwege de KSZ kan u een sturen naar: external@ksz-bcss.fgov.be RVV-BIM_OMNIO_Status_Gebruikershandleiding.doc 7/7