Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Interface (SocZek.PubliceerArbeidsongeschiktheid-02.01)

Informatie:

De XML en CSV bestanden die via FTP gepubliceerd worden dienen te voldoen aan de MAGDA richtlijnen. Voor meer informatie over hoe een Publicatie-dienst algemeen gebruikt dient te worden, bekijk Werking en gebruik MAGDA 2.0 Publicaties.

De gegevens zijn beschikbaar in XML en opgebouwd volgens de MAGDA richtlijnen.

Algemeen

In deze sectie bespreken we de praktische werking van deze publicatiedienst met eventuele specifieke opmerkingen. Voor meer algemene informatie in verband met het gebruik van MAGDA publicatiediensten neemt u best de algemene handleiding Werking en gebruik MAGDA 2.0 Publicaties door.

De PeriodNotifications moeten eigenlijk begrepen worden als een ‘attestering’ van een (op handen zijnde) wijziging aan de kwartaalattesten uit de AttestNotifications en de online consult. De attestationId’s uit de PeriodNotifications zijn dus volledig onafhankelijk van de attestationId’s uit de AttestNotifications. Let bovendien op dat in de PeriodNotifications ook maar één risico kan aangeduid worden, terwijl in de kwartaalattesten meerdere risico’s zitten (net omdat het maar één attest is per insz en kwartaal). De versionering van de attestationId’s in de PeriodNotifications is dus van een minder belang. Men beschouwt de PeriodNotifications vooral als trigger om een online consult te doen voor het betrokken kwartaal.

De sociale risico’s kunnen worden opgedeeld in deze twee groepen:

  • (Groep A) De borstvoedingspauze, het vaderschaps, adoptie -of pleegverlof is verlof dat in discrete delen verspreid over de tijd opneembaar is.  Deze dagen (of uren) zijn enkel zichtbaar in de betalingen. Voor deze indemniteiten bevat de informatie omtrent het sociale risico typisch enkel een startdatum.

  • (Groep B) De arbeidsongeschiktheid door ziekte en werkverwijdering door zwangerschap/moederschap bestaat daarentegen telkens in ondeelbare periodes van ongeschiktheid. De periode van ongeschiktheid maakt deel uit van de informatie omtrent het sociale risico.

In de PubliceerArbeidsongeschiktheid 02.01 dienst worden alle nieuwe instanties van sociaal risico meegegeven, met hun periode en eventuele exitCode.

De periode die wordt meegegeven is de volledige periode van de ongeschiktheid zoals die op dat moment wordt vastgesteld. Is dit bijvoorbeeld een ziekte, dan betreft het de periode op het ziektebriefje. Is het bijvoorbeeld een vaderschapsverlof dan betreft het enkel een startdatum die overeenkomt met de bevallingsdatum of de initiële startdatum; afhankelijk van het dossier. De exitCode is een code die aanduidt waarom de ongeschiktheid afgesloten wordt (bv omdat de persoon niet meer ziek is en terug kan of moet gaan werken). Ze heeft dus enkel betekenis indien de periode een einddatum bevat; anders zal ze ingevuld worden met ‘0’. Voor sociale risico’s uit Groep A is de exitCode in de altijd ‘0’.

Bestandsnaam

Opmerking:

De exacte bestandsnaam wordt pas meegedeeld tijdens het aansluitingsproces. De gegevens die u hier vindt kunnen dus mogelijk wijzigen.

De bestandsnaam is van de vorm prefix_publicatienaam_timestamp.extensie.

Voorbeeld

SocZek_PubliceerArbeidsongeschiktheid-0201_20140224155516000.xml

Op deze pagina

Binnen deze handleiding

Publicatie in XML

Algemeen

Informatie:

De publicatie in XML bevat een standaard context zoals de andere MAGDA publicaties. Dit naar analogie met de contextbeschrijving voor webservices, bekijk hiervoor eens de handleiding Werking en gebruik MAGDA 2.0 Webservices.

XSD

De bestanden die worden aangeboden op de outputfolder zijn gevalideerd volgens de service-xsd horende bij deze dienst. De actuele xsd is ter beschikking op https://vlaamseoverheid.atlassian.net/wiki/spaces/MG/pages/487620609/Overzicht+testdata+endpoints+en+XSD+s .

Elementen

Visueel

image-20240227-141548.png

Detail

Element

../Inhoud/Arbeidsongeschiktheid

Beschrijving

Element

../Inhoud/Arbeidsongeschiktheid

Beschrijving

Attestation

 

 

ssin

 

 

 

@canceled

Indien dit attribuut ingevuld is zal het “true” bevatten en duidt het aan dat het INSZ geannuleerd is.

 

 

@replacedBy

Indien dit attribuut ingevuld is betekent het dat de INSZ dat opgegeven is in de vraag vervangen is. Dit attribuut bevat dan het nieuwe INSZ. De afnemer dient eventueel het nieuw INSZ uit dit attribuut in te schrijven in het repertorium.

 

attestationIdentification

 

 

 

yearQuarter

Het jaar-kwartaal waarvoor het attest geldt. Formaat [1-2]\d{3}Q(1|2|3|4). Vb : 2023Q1

 

 

creationDate

De datum waarop het attest werd aangemaakt.

 

 

attestationId

Het id van het attest.
Formaat : UUID

 

 

attestationVersion

Een incrementerend versienummer per nieuwe instantie van het attest.

 

 

attestationStatus

De status origineel, wijziging of annulatie:

  • CREATION

  • MODIFICATION

  • CANCELLATION

Bij annulatie zijn er geen sociale risico’s (meer) aanwezig.

 

 

temporaryAttest

Dit veld is aanwezig wanneer de attestationID, version en status niet gekend zijn. Het betreft hier dan een nog niet geattesteeerd attest voor het lopende trimester.

 

allowances

De uitkering(en) waarop dit attest betrekking hebben.

 

 

allowance

 

 

 

 

period

 

 

 

 

 

beginDate

Startdatum van de periode

 

 

 

 

endDate

Einddatum van de periode

 

 

 

InitialStartDate

Begindatum van de arbeidsongeschiktheid

 

 

 

exitCode

Code voor het beëindigen van de arbeidsongeschikheid.
Zie Codelijsten op https://vlaamseoverheid.atlassian.net/wiki/spaces/MG/pages/6428492049

 

 

 

payments

Dit betreft de informatie over de mogelijke betalingen verbonden aan deze uitkering

 

 

 

 

payment

 

 

 

 

 

 

document

Type van boekhoudkunding document.
Zie codelijsten op https://vlaamseoverheid.atlassian.net/wiki/spaces/MG/pages/6428492049

 

 

 

 

 

incapacityCategory

Code die bediende-categorie bepaalt.
Zie codelijsten op

 

 

 

 

 

familySituation

Code die gezinstoestoestand van de titularis bepaalt.
Zie codelijsten op

 

 

 

 

 

allowanceCategory

Code die het type uitkering, betaald aan de titularis, bepaalt.
Zie codelijsten op

 

 

 

 

 

allowanceCode

Code de de aard van uitkering, betaald aan de titularis, bepaalt.
Zie codelijsten op

 

 

 

 

 

period

Betalingsperiode.

 

 

 

 

 

 

beginDate

Startdatum van de uitgekeerde periode

 

 

 

 

 

 

endDate

EindDatum van de uitgekeerde period

 

 

 

 

 

amount

Bedrag (bruto belastbaar bedrag) gestort aan / teruggevorderd van de titularis. Kan dus ook negatief zijn. Bedrag in euro (met decimalen voor de eurocenten). (optioneel voor filtering doeleinde, bij NIC wel steeds aanwezig)
Vb: 5123,27

 

 

 

 

 

days

Aantal vergoede dagen. Kan negatief zijn (terugvordering). (optioneel voor filtering doeleinde, bij NIC wel steeds aanwezig in choice tussen days en hours)

 

 

 

 

 

hours

Aantal vergoede uren. Decimaal en kan negatief zijn (terugvordering). (optioneel voor filtering doeleinde, bij NIC wel steeds aanwezig in choice tussen days en hours)

AttestationPeriodStart

Startdatum van de periode waarop het attest slaat. Deze gegevens worden gebruikt voor de overlap inschrijvingscontrole

AttestationPeriodEnd

Enddatum van de periode waarop het attest slaat. Deze gegevens worden gebruikt voor de overlap inschrijvingscontrole

Voorbeeld

<Inhoud> <Arbeidsongeschiktheid> <Attestation> <ssin>01234567890</ssin> <attestationIdentification> <yearQuarter>2022Q1</yearQuarter> <creationDate>2022-07-20</creationDate> <attestationId>00000000-c69a-4bb3-b21c-e114c61fa1d6</attestationId> <attestationVersion>0</attestationVersion> <attestationStatus>CREATION</attestationStatus> </attestationIdentification> <allowances> <allowance> <socialRisk> <socialRiskCategory>IndependentIncapacityForWorkAllowance</socialRiskCategory> <independentIncapacityForWork> <socialStatus>4</socialStatus> <period> <beginDate>2014-03-17</beginDate> <endDate>2022-03-31</endDate> </period> <exitCode>0</exitCode> <invalidity> <startDate>2015-03-17</startDate> <invalidityCategory>1</invalidityCategory> </invalidity> <initialStartDate>2014-03-17</initialStartDate> </independentIncapacityForWork> </socialRisk> <payments> <payment> <document>PI41</document> <incapacityCategory>3</incapacityCategory> <familySituation>01</familySituation> <allowanceCategory>0</allowanceCategory> <allowanceCode>HE</allowanceCode> <period> <beginDate>2022-01-01</beginDate> <endDate>2022-03-31</endDate> </period> <amount>5078.64</amount> <days>77</days> </payment> </payments> </allowance> </allowances> </Attestation> <AttestationPeriodStart>2022-01-01</AttestationPeriodStart> <AttestationPeriodEnd>2022-03-31</AttestationPeriodEnd> </Arbeidsongeschiktheid> </Inhoud>

Uitzonderingen

Indien er gekozen werd om een uitzonderingsbestand te onvangen, komt er een Uitzondering terug met als foutcode 15015 – geen gegevens te publiceren.

<Uitzonderingen> <Uitzondering xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <Identificatie>15015</Identificatie> <Oorsprong>MAGDA</Oorsprong> <Type>INFORMATIE</Type> <Tijdstip> <Datum>2014-02-24</Datum> <Tijd>15:56:16</Tijd> </Tijdstip> <Diagnose>Geen te publiceren gegevens</Diagnose> </Uitzondering> </Uitzonderingen>

Codetabellen

Codetabellen zijn te vinden op


Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid

uitgegeven door Digitaal Vlaanderen