Informatie:

De XML bestanden die op de FTP server aangeboden worden dienen te voldoen aan de MAGDA richtlijnen. Bijkomend moet het Inhoud element aanwezig zijn in het aangeleverde gegevensbestand.

De gegevens moeten worden aangeleverd in XML formaat 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 Bestandsuitwisseling (Publicaties/batchverwerking) door.

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 domein.publicatienaam-versie_timestamp.extensie.

Voorbeeld	soczek.publiceermutatiesocialestatuten-0200_20190129155516000.xml

Bronbestand 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 Webservices 02.00.

De inhoud bestaat uit een overzicht van één of meer berichten van toegekende sociale statuten voor een persoon.

XSD

Hoewel het XSD niet afdwingt dat een Inhoud element aanwezig is, kan er geen transformatie plaatsvinden naar het KSZ formaat zonder dit element.

Indien dit element ontbreekt in de aanlevering, zal de verwerking van de transformatie geblokkeerd worden. K&G zal dan voor een nieuwe aanlevering moeten zorgen.

Elementen

Visueel

Detail

Element ../Onderwerpen/Onderwerp/							Kardinaliteit	Beschrijving Max. 1.000.000 berichten
Referte							1	Unieke referte die 1 publicatie bericht identificeert, bij voorkeur een UUID.
Inhoud							1	Gegevensblok met de inhoudelijke gegevens van de toegekende sociale statuten per persoon
	Metadata						0..1	Niet gebruikt in geval van aanlevering vanuit K&G
	MutatieSocialeStatuten						1	Gegevensblok met sociale statuten in het dossier
		Bron					1	Aanduiding van de authentieke bron vanwaar het publicatie bericht afkomstig is. Mogelijke waarde: enkel "KENG" toegelaten
		INSZ					1	Identificatienummer van de sociaal verzekerde
		_{KEUZE 1} SociaalStatuten					0..1	Gegevensblok m.b.t. lijst van sociale statuten voor INSZ
			@VolledigOverzicht				1	Aanduiding of een volledig overzicht van de sociale statuten wordt doorgegeven voor het betrokken INSZ. Mogelijke waarde: enkel waarde "1" toegelaten
			SociaalStatuut				1..100	Gegevensblok m.b.t. 1 sociaal statuut Max. 100 sociale statuten per persoon
				Naam			1	Code/Omschrijving blok naam sociaal statuut
					Code		1	Signaalwoord dat het sociaal statuut aangeeft Voorbeeld: P1-4, P1-6, TP-6
					Omschrijving		1	Omschrijving van het sociaal statuut verplicht mee te geven door de afzender
						@Oorsprong	0..1	Niet gebruikt
						@TaalCode	0..1	Niet gebruikt
				Waarden			0..1	Lijst met bijkomende waarden Max. 8 waarden per sociaal statuut
					Waarde		1..8	Waarde bij het sociaal statuut Voorbeeld: 8 (punten)
				Periodes			0..1	Lijst met periodes waarin de persoon tot de bepaalde situatie behoort
					Periode		1..100	Periode waarin de persoon tot de bepaalde situatie behoort Max. 100 periodes per sociaal statuut
						Begin	1	Begindatum van de periode
						Einde	0..1	Einddatum van de periode (optioneel)
				Betaling			0..1	Niet gebruikt
		_{KEUZE 2} Annulering					0..1	Aanduiding of er sprake is van een volledige annulering van het dossier sociale statuten voor het betrokken INSZ sinds de laatste aanlevering.
Uitzonderingen							0..1	Niet gebruikt in geval van aanlevering vanuit K&G

Opmerkingen

Uitzonderingen elementen hoeven niet gebruikt te worden in de aanlevering vanuit K&G. Dit wordt echter niet gevalideerd, eventuele inhoud wordt genegeerd in de transformatie naar de KSZ.

Na de verwerking bezorgt de KSZ een antwoord bestand met de stand van uitvoering van elk dossier. Dit bestand wordt tijdelijk bijgehouden op het Magda platform, maar niet verwerkt.

Voorbeelden

<?xml version="1.0" encoding="UTF-8"?>
<!--Sample XML file generated by XMLSpy v2016 rel. 2 sp1 (http://www.altova.com)-->
<n1:PubliceerMutatieSocialeStatuten xmlns:n1="http://service.publiceermutatiesocialestatutendienst-02_00.soczek-02_00.vip.vlaanderen.be" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://service.publiceermutatiesocialestatutendienst-02_00.soczek-02_00.vip.vlaanderen.be ../../SocZek.PubliceerMutatieSocialeStatuten-02.00/Service/PubliceerMutatieSocialeStatuten.xsd">
	<Publicatie>
		<Context>
			<Naam>a</Naam>
			<Versie>00.00.0000</Versie>
			<Bericht>
				<Type>ANTWOORD</Type>
				<Tijdstip>
					<Datum>,000-00-00</Datum>
					<Tijd>00:00</Tijd>
				</Tijdstip>
				<Afzender>
					<Identificatie>a</Identificatie>
					<Naam>a</Naam>
					<Referte>a</Referte>
					<OrganisatieEenheid>a</OrganisatieEenheid>
					<Hoedanigheid>a</Hoedanigheid>
					<Gebruiker>00000000000</Gebruiker>
				</Afzender>
				<Ontvanger>
					<Identificatie>a</Identificatie>
					<Naam>a</Naam>
					<Referte>a</Referte>
					<OrganisatieEenheid>a</OrganisatieEenheid>
					<Hoedanigheid>a</Hoedanigheid>
					<Gebruiker>00000000000</Gebruiker>
				</Ontvanger>
			</Bericht>
		</Context>
		<Onderwerpen>
			<Onderwerp>
				<Referte>a</Referte>
				<Inhoud>
					<Metadata>
						<Referte>a</Referte>
						<Type Beschrijving="">00</Type>
						<Datum>2001-12-17T09:30:47Z</Datum>
					</Metadata>
					<MutatieSocialeStatuten>
						<Bron>KENG</Bron>
						<INSZ>00000000000</INSZ>
						<SocialeStatuten VolledigOverzicht="0">
							<SociaalStatuut>
								<Naam>
									<Code>a</Code>
									<Omschrijving Oorsprong="0" TaalCode="00">a</Omschrijving>
								</Naam>
								<Waarden>
									<Waarde>a</Waarde>
									<Waarde>a</Waarde>
								</Waarden>
								<Periodes>
									<Periode>
										<Begin>0000-,0-,0</Begin>
										<Einde>0000-,0-,0</Einde>
									</Periode>
									<Periode>
										<Begin>0000-,0-,0</Begin>
										<Einde>0000-,0-,0</Einde>
									</Periode>
								</Periodes>
								<Betaling>1</Betaling>
							</SociaalStatuut>
							<SociaalStatuut>
								<Naam>
									<Code>a</Code>
									<Omschrijving Oorsprong="0" TaalCode="00">a</Omschrijving>
								</Naam>
								<Waarden>
									<Waarde>a</Waarde>
									<Waarde>a</Waarde>
								</Waarden>
								<Periodes>
									<Periode>
										<Begin>0000-,0-,0</Begin>
										<Einde>0000-,0-,0</Einde>
									</Periode>
									<Periode>
										<Begin>0000-,0-,0</Begin>
										<Einde>0000-,0-,0</Einde>
									</Periode>
								</Periodes>
								<Betaling>1</Betaling>
							</SociaalStatuut>
						</SocialeStatuten>
					</MutatieSocialeStatuten>
				</Inhoud>
			</Onderwerp>
			<Onderwerp>
				<Referte>a</Referte>
				<Inhoud>
					<Metadata>
						<Referte>a</Referte>
						<Type Beschrijving="">00</Type>
						<Datum>2001-12-17T09:30:47Z</Datum>
					</Metadata>
					<MutatieSocialeStatuten>
						<Bron>KENG</Bron>
						<INSZ>00000000000</INSZ>
						<SocialeStatuten VolledigOverzicht="1">
							<SociaalStatuut>
								<Naam>
									<Code>a</Code>
									<Omschrijving Oorsprong="0" TaalCode="00">a</Omschrijving>
								</Naam>
								<Waarden>
									<Waarde>a</Waarde>
									<Waarde>a</Waarde>
								</Waarden>
								<Periodes>
									<Periode>
										<Begin>0000-,0-,0</Begin>
										<Einde>0000-,0-,0</Einde>
									</Periode>
									<Periode>
										<Begin>0000-,0-,0</Begin>
										<Einde>0000-,0-,0</Einde>
									</Periode>
								</Periodes>
								<Betaling>1</Betaling>
							</SociaalStatuut>
							<SociaalStatuut>
								<Naam>
									<Code>a</Code>
									<Omschrijving Oorsprong="0" TaalCode="00">a</Omschrijving>
								</Naam>
								<Waarden>
									<Waarde>a</Waarde>
									<Waarde>a</Waarde>
								</Waarden>
								<Periodes>
									<Periode>
										<Begin>0000-,0-,0</Begin>
										<Einde>0000-,0-,0</Einde>
									</Periode>
									<Periode>
										<Begin>0000-,0-,0</Begin>
										<Einde>0000-,0-,0</Einde>
									</Periode>
								</Periodes>
								<Betaling>1</Betaling>
							</SociaalStatuut>
						</SocialeStatuten>
						<Annulering>1</Annulering>
					</MutatieSocialeStatuten>
				</Inhoud>
			</Onderwerp>
		</Onderwerpen>
	</Publicatie>
</n1:PubliceerMutatieSocialeStatuten>

Uitzonderingen

Fouten die optreden tijdens de transformatie van het aangeleverde bestanden resulteren in een blokkering van de Magda verwerking.

Codetabellen

Bron dienstnaam	Element	Van code	Naar code
notifySocialRightsV1	MutatieSocialeStatuten/SocialeStatuten/SociaalStatuut/Naam/Omschrijving@TaalCode	nl	NL
notifySocialRightsV1	MutatieSocialeStatuten/SocialeStatuten/SociaalStatuut/Naam/Omschrijving@TaalCode	fr	FR
notifySocialRightsV1	MutatieSocialeStatuten/SocialeStatuten/SociaalStatuut/Naam/Omschrijving@TaalCode	de	DE
notifySocialRightsV1	MutatieSocialeStatuten/SocialeStatuten@VolledigOverzicht	1	true
notifySocialRightsV1	MutatieSocialeStatuten/SocialeStatuten/SociaalStatuut/Betaling	1	true
notifySocialRightsV1	MutatieSocialeStatuten/SocialeStatuten/Annulering	1	true

Op deze pagina

1 Algemeen
2 Bestandsnaam
3 Bronbestand in XML
- 3.1 Algemeen
- 3.2 XSD
- 3.3 Elementen
- 3.4 Opmerkingen
- 3.5 Voorbeelden
- 3.6 Uitzonderingen
4 Codetabellen

Binnen deze handleiding

MAGDA Gebruikersomgeving

Interface (SocZek.PubliceerMutatieSocialeStatuten-02.00 - distributie naar de KSZ)

Informatie:

Algemeen

Bestandsnaam

Opmerking:

Bronbestand in XML

Algemeen

Informatie:

XSD

Elementen

Visueel

Detail

Opmerkingen

Voorbeelden

Uitzonderingen

Codetabellen

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