Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

SocZek.GeefArbeidsongeschiktheid-01.00

Informatie:

Voor de ontsluiting van een MAGDA 2.0 webservice, alsook het generieke proces binnen een 2.0 webservice, wordt verwezen naar Werking en gebruik MAGDA 2.0 Webservices.

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.

Opmerking:

Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens. 

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

 

Pad

Opmerking

Begindatum

/Vraag/Criteria/ConsultAttestCriteria/yearQuarter

de eerste dag van het gevraagde kwartaal.

Einddatum

/Vraag/Criteria/ConsultAttestCriteria/yearQuarter

de laatste dag van het gevraagde kwartaal.

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.

Meer informatie over deze voorwaarden is terug te vinden op de pagina “Machtigingen en toelatingen”.

Meer informatie over het aansluitingsproces is terug te vinden op deze webpagina.

Batch

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

Prefix

SocZek.GeefArbeidsongeschiktheid-0100

Voorbeeld

SocZek.GeefArbeidsongeschiktheid-0100_20230803115553530

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