Situering

Deze dienst betreft de attesten omtrent de uitkeringen (allowance) om loon verlies te compenseren (indemnity) naar aanleiding van arbeidsongeschiktheid door ziekte of invaliditeit of andere sociale risico’s (zoals zwangerschap, vaderschap, adoptie enzoverder) in het kader van de ZIV (ziekte en invaliditeitsverzekering) (HDI). De dienst heet bij KSZ daarom HdiIndemnityAllowance. Merk op dat de sociale risico’s die geattesteerd worden niet altijd per definitie ook uitbetaald worden.

1. Deze uitkeringen gebeuren door de verschillende VI’s (verzekeringsinstellingen) van de ZIV. Per kwartaal maken de VI’s een attest op omtrent de uitkeringen voor een persoon. Eventuele annulaties of wijzigingen aan de attesten worden maandelijks verstuurd.
   De push met de kwartaalattesten heet bij de VI’s AllowanceAttestationNotification (AAN).
   De push met de kwartaalattesten heet bij KSZ notifyHdiIndemnityAllowanceAttest.

2. Deze verstuurde attesten zijn eveneens beschikbaar voor online consultatie, zowel voor het verleden als voor het huidig kwartaal. Voor het lopende trimester en de ondertussen gewijzigde attesten zijn bovendien ook de ‘tijdelijke’ (nog niet verstuurde) attesten beschikbaar met de situatie zoals op die dag gekend.
   De consult van de kwartaalattesten heet bij de VI’s AllowanceAttestationConsultation (AAC).
   De consult van de kwartaalattesten heet bij KSZ HdiIndemnityAllowance.consultAttest.

3. Personen met een nieuw of gewijzigd attest worden ook dagelijks verstuurd, met beknopte aanduiding van het sociaal risico en de periode. Het detail is enkel via consultatie beschikbaar.
   De push met de trigger heet bij de VI’s AllowancePeriodNotification (APN).
   De push met de trigger heet bij KSZ notifyHdiIndemnityAllowancePeriod.

Dit geheel aan stromen vervangt de oude stromen A052 en A020.

1. De afnemer stuurd een GeefArbeidsongeschiktheid vraag naar MAGDA

2. MAGDA maakt het HdiIndemnityAllowance.consultIndemnityPeriods request over aan KSZ.

3. KSZ valideert het request voor de klant (security, legalcontext, personenrepertorium) en stuurt de vraag door naar het NIC in het AllowanceAttestationConsultation formaat.

4. NIC bepaalt de verzekeringsinstelling verantwoordelijk voor het insz en opgevraagd kwartaal en stuurt de vraag door naar deze VI. Merk op dat voor één kwartaal telkens slechts één VI verantwoordelijk kan zijn omdat een wijziging van VI enkel kan gebeuren bij kwartaalwissel.

5. Het VI antwoord met de voor haar gekende gegevens.

6. Het NIC stuurt dit antwoord door naar KSZ in het AllowanceAttestationConsultation formaat.

7. KSZ stuurt het antwoord naar MAGDA als HdiIndemnityAllowance.consultIndemnityPeriods response.

8. MGDA stuurd het antwoord naar de afnemer in het GeefArbdeidsongeschiktheid formaat

Verwante diensten

De afnemer dient het INSZ nummer in de vraag te registreren in het MAGDA inschrijvingsrepertorium via de RegistreerInschrijving dienst.

PubliceerArbeidsongeschiktheid-02.01 wordt gebruikt voor het afleveren van nieuwe of gewijzigde attesten door de verzekeringsinstellingen. Deze worden in de vorm van een distributie afgeleverd via een een mailbox bij het MAGDA platform.

Gegevensbronnen

De authentieke bron(nen) voor deze dienst zijn de verschillende verzekeringsinstellingen (VI) van de ZIV. Deze worden geaggregeerd door het Nationaal Intermutualistisch College (NIC) en doorgegeven aan de Kruispuntbank van de Sociale Zekerheid (KSZ).

Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.

Overlap inschrijvingscontrole

Naast de standaard actieve inschrijving is deze dienst ook beschikbaar met overlap inschrijvingscontrole. Hierbij wordt een periode uit de vraag vergeleken met de periode die gebruikt is bij de Repertorium.RegistreerInschrijving-02.00 dienst. Er moet minimaal 1 dag overlap zijn tussen beide periodes. Bij een actieve inschrijvingscontrole dient het INSZ actief te zijn in het inschrijvingsrepertorium op het moment van verwerking van de vraag.

Begin- en eindatum van de periode uit de vraag

Volgend element wordt gebruikt als begin- en einddatum

Open

Gebruiksvoorwaarden

Om gebruikt te kunnen maken van deze dienst dient men een machtiging te hebben die toegang geeft tot deze gegevens en een aansluitingsprocedure te doorlopen.

Batch

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.

Functionaliteiten

Met de GeefArbeidsongeschiktheid 1.0 dienst kunnen de vergoedingen voor de ongeschiktheid van arbeid opgevraagd worden.

Vraag

In de vraag wordt het INSZ opgegeven van de bevraagde persoon in combinatie met het kwartaal waarop de bevraging slaat.

Antwoord

Het antwoord bevat alle gegevens die bij de verzekeringsinstelling gekend zijn. Deze zijn geformatteerd in het schema van de dhiIndemnityAllowance.consultIndemnityPeriods dienst van de KSZ.

Werking

Opties

Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:

• Configuratieparameters op het MAGDA platform zijn voor deze dienst niet van toepassing

Opvraging

Responsetijden & Beschikbaarheid

Logging

De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".

Op deze pagina

Binnen deze handleiding

Omgevingsinformatie

Maak "Beschrijving Vraag"-pagina

Maak "Beschrijving Antwoord"-pagina

Maak "Uitzonderingen"-pagina

Maak "Testgegevens & Voorbeelden"-pagina

Maak "Veelgestelde Vragen"-pagina

Maak "Gekende Problemen"-pagina

Maak "Verschillen tegenover vorige versie"-pagina