Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

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.

Excerpt
hiddentrue

Deze dienst betreft de attesten omtrent de uitkeringen om loon verlies te compenseren 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). Een attest kan worden opgevraagd op basis van het INSZ van een persoon waarbij achterliggend de desbetreffende verzekeringsinstelling wordt aangesproken.

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.

Drawio
mVer2
zoom1
simple0
inComment0
custContentId6425713890
pageId6425875631
lbox1
diagramDisplayNameUntitled Diagram-1693492716327.drawio
contentVer2
revision2
baseUrlhttps://vlaamseoverheid.atlassian.net/wiki
diagramNameUntitled Diagram-1693492716327.drawio
pCenter0
width1221
links
tbstyle
height120
  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 registreert een dient het INSZ nummer in de vraag te registreren in het MAGDA inschrijvingsrepertorium via de RegistreerInschrijving dienst.

PubliceerArbeidsongeschiktheid-02.01 dienst.

RegistreerInschrijving en RegistreerUitschrijving : Deze diensten worden gebruikt voor het aanmaken en wissen van een inschrijving in het MAGDA inschrijvingsrepertorium.

Gegevensbronnen

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.

Note

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.

Info

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

Anchor
opvraging
opvraging
Opvraging

Responsetijden & Beschikbaarheid

Note

Opmerking:

De MAGDA response tijden zijn heel sterk afhankelijk van de response tijden van de bron. Als de brongegevens heel traag worden aangeleverd kan het MAGDA antwoord niet snel worden aangeleverd. 

Logging

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

Op deze pagina

Table of Contents
maxLevel2

Binnen deze handleiding

Child pages (Children Display)

Omgevingsinformatie

Domein

SocZek

Classificatie

Persoonsgegevens


Info

Met vragen kunt u steeds terecht bij de MAGDA Service Desk.

Create from Template
spaceKeyMG
templateName494699588
templateId494699588
titleBeschrijving Vraag (DIENSTNAAM-VERSIE)
buttonLabelMaak "Beschrijving Vraag"-pagina

Create from Template
spaceKeyMG
templateName494568993
templateId494568993
titleBeschrijving Antwoord (DIENSTNAAM-VERSIE)
buttonLabelMaak "Beschrijving Antwoord"-pagina

Create from Template
spaceKeyMG
templateName496599113
templateId496599113
titleUitzonderingen (DIENSTNAAM-VERSIE)
buttonLabelMaak "Uitzonderingen"-pagina

Create from Template
spaceKeyMG
templateName494699935
templateId494699935
titleTestgegevens & Voorbeelden (DIENSTNAAM-VERSIE)
buttonLabelMaak "Testgegevens & Voorbeelden"-pagina

Create from Template
spaceKeyMG
templateName494667241
templateId494667241
titleVeelgestelde vragen (DIENSTNAAM-VERSIE)
buttonLabelMaak "Veelgestelde Vragen"-pagina

Create from Template
spaceKeyMG
templateName494470620
templateId494470620
titleGekende problemen (DIENSTNAAM-VERSIE)
buttonLabelMaak "Gekende Problemen"-pagina

Create from Template
spaceKeyMG
templateName496664661
templateId496664661
titleVerschillen tegenover vorige versie (DIENSTNAAM-VERSIE)
buttonLabelMaak "Verschillen tegenover vorige versie"-pagina