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

1 Algemeen
2 Bestandsnaam
3 Publicatie in XML
- 3.1 Algemeen
- 3.2 XSD
- 3.3 Elementen
- 3.4 Voorbeeld
- 3.5 Uitzonderingen
4 Codetabellen

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 Overzicht testdata, endpoints en XSD's .

Elementen

Visueel

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
			InvalidityStartDate				Begindatum van de invaliditeit
			exitCode				Code voor het beëindigen van de arbeidsongeschikheid. Zie Codelijsten op Codetabellen Antwoord (SocZek.GeefArbeidsongeschiktheid-01.00)
			payments				Dit betreft de informatie over de mogelijke betalingen verbonden aan deze uitkering
				payment
					document		Type van boekhoudkunding document. Zie codelijsten op Codetabellen Antwoord (SocZek.GeefArbeidsongeschiktheid-01.00)
					incapacityCategory		Code die bediende-categorie bepaalt. Zie codelijsten op Codetabellen Antwoord (SocZek.GeefArbeidsongeschiktheid-01.00)
					familySituation		Code die gezinstoestoestand van de titularis bepaalt. Zie codelijsten op Codetabellen Antwoord (SocZek.GeefArbeidsongeschiktheid-01.00)
					allowanceCategory		Code die het type uitkering, betaald aan de titularis, bepaalt. Zie codelijsten op Codetabellen Antwoord (SocZek.GeefArbeidsongeschiktheid-01.00)
					allowanceCode		Code de de aard van uitkering, betaald aan de titularis, bepaalt. Zie codelijsten op Codetabellen Antwoord (SocZek.GeefArbeidsongeschiktheid-01.00)
					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>2020Q3</yearQuarter>
				<creationDate>2022-11-19</creationDate>
				<attestationId>cf5a57c1-31b6-440f-b298-03896acc89d7</attestationId>
				<attestationVersion>0</attestationVersion>
				<attestationStatus>CREATION</attestationStatus>
			</attestationIdentification>
			<allowances>
				<allowance>
					<period>
						<beginDate>2020-07-01</beginDate>
						<endDate>2020-09-30</endDate>
					</period>
					<initialStartDate>2019-05-10</initialStartDate>
					<exitCode>0</exitCode>
					<payments>
						<payment>
							<allowanceCategory>0</allowanceCategory>
							<allowanceCode>DA</allowanceCode>
							<period>
								<beginDate>2020-07-01</beginDate>
								<endDate>2020-07-31</endDate>
							</period>
							<amount>942.84</amount>
							<days>27</days>
						</payment>
						<payment>
							<allowanceCategory>0</allowanceCategory>
							<allowanceCode>DA</allowanceCode>
							<period>
								<beginDate>2020-08-01</beginDate>
								<endDate>2020-08-31</endDate>
							</period>
							<amount>907.92</amount>
							<days>26</days>
						</payment>
						<payment>
							<allowanceCategory>0</allowanceCategory>
							<allowanceCode>DA</allowanceCode>
							<period>
								<beginDate>2020-09-01</beginDate>
								<endDate>2020-09-30</endDate>
							</period>
							<amount>907.92</amount>
							<days>26</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 Codetabellen Antwoord (SocZek.GeefArbeidsongeschiktheid-01.00)

MAGDA Gebruikersomgeving

Interface (SocZek.PubliceerArbeidsongeschiktheid-02.01)

Informatie:

Algemeen

Bestandsnaam

Opmerking:

Op deze pagina

Binnen deze handleiding

Publicatie in XML

Algemeen

Informatie:

XSD

Elementen

Visueel

Detail

Voorbeeld

Uitzonderingen

Codetabellen

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