Opbouw Interface

Beschrijving voor het gebruik van CSV-bestanden is terug te vinden onderaan deze pagina

Elke MAGDA 2.0 publicatie is op eenzelfde manier opgebouwd; dit is het MAGDA 2.0 canoniek model. Dit maakt het voor de afnemer eenvoudiger MAGDA publicaties te implementeren.

Publicatie

Het rootelement, dat de naam van de publicatie betreft, bevat twee elementen:

Publicatie
Uitzonderingen

Het element Uitzonderingen op dit niveau wordt niet gebruikt voor publicaties.

Het element Publicatie bevat de elementen

Context
Onderwerpen
Uitzonderingen

Context

Het Context element, dat structureel identiek is voor de verschillende MAGDA diensten, wordt in het kader van publicaties gebruikt voornamelijk gebruikt om de afzender (de afnemer) te identificeren.

Element Context/	Cardinaliteit	Omschrijving

Element Context/	Cardinaliteit	Omschrijving
Naam	Verplicht	Bevat de naam van de publicatiedienst vb PubliceerOnderneming, PubliceerSocialeSchuld.
Versie	Verplicht	Bevat het versienummer van de publicatiedienst . Formaat: <Hoofdnummer>.<Bijnummer>.<Buildnummer> Vb: 02.00.0000
Bericht/Type	Verplicht	Enkel "PUBLICATIE" is mogelijk, dit wordt afgedwongen door een xsd-validatie bij de verwerking van de publicatie.
Bericht/Tijdstip	Verplicht	Dit is het tijdstip (datum en uur) van aanmaak van de publicatie. Formaat Datum: yyyy-mm-dd Vb: 2006-05-12 Formaat tijd: HH:mm:ss.sss (de milliseconden kunnen soms niet aanwezig zijn) Vb: 16:15:11.435
Bericht/Afzender/Identificatie	Verplicht	Steeds: "vip.vlaanderen.be"
Bericht/Afzender/Naam	Optioneel	Indien aanwezig: "MAGDA"
Bericht/Afzender/Referte	Verplicht	Bevat een waarde die elke boodschap uniek identificeert, dit is een UUID van 36 lang.
Bericht/Afzender/OrganisatieEenheid	Optioneel	De OrganisatieEenheid of “Instrumenterende Overheid” is een niveau van toepassingscategorisatie. Het is immers mogelijk dat meerdere organisatie-eenheden eenzelfde toepassing gebruiken op een MAGDA dienst te benaderen. Op dit moment wordt dit niet gebruikt binnen MAGDA.
Bericht/Afzender/Hoedanigheid	Optioneel	Niet aanwezig.
Bericht/Afzender/Gebruiker	Optioneel	Niet aanwezig.
Bericht/Ontvanger/Identificatie	Verplicht	Bevat de URI van de afnemer. Deze URI wordt verkregen tijdens het aansluitingsproces
Bericht/Ontvanger/Naam	Optioneel	Naam van de ontvanger. Zal veelal niet aanwezig zijn.
Bericht/Ontvanger/Referte	Optioneel	Niet aanwezig.
Bericht/Ontvanger/OrganisatieEenheid	Optioneel	Niet aanwezig.
Bericht/Ontvanger/Hoedanigheid	Optioneel	De hoedanigheid bepaalt in welk kader - met welke reden - dit bestand aangeboden wordt.
Bericht/Ontvanger/Gebruiker	Optioneel	Niet aanwezig.
Annotaties	Optioneel	Niet aanwezig.

<Context>
	<Naam>PubliceerSocialeSchuld</Naam>
	<Versie>02.00.0000</Versie>
	<Bericht>
		<Type>PUBLICATIE</Type>
		<Tijdstip>
			<Datum>2018-08-23</Datum>
			<Tijd>01:12:00</Tijd>
		</Tijdstip>
		<Afzender>
			<Identificatie>vip.vlaanderen.be</Identificatie>
			<Naam>MAGDA</Naam>
			<Referte>79d85e86-1704-4795-b8cf-d401e7253dd9</Referte>
		</Afzender>
		<Ontvanger>
			<Identificatie>wse.vlaanderen.be</Identificatie>
			<Hoedanigheid>155</Hoedanigheid>
		</Ontvanger>
	</Bericht>
</Context>

Onderwerpen

Het Onderwerpen-element bevat de feitelijke gepubliceerde gegevens. Elke gepubliceerd Onderwerp bevat:

Referte: deze referte is uniek voor elk onderwerp. Hier wordt (geprefereerd) gewerkt met een UUID van 36 lang
Inhoud: voor de Inhoud wordt verwezen naar de dienstspecifieke pagina's waar de inhoud beschreven staat
Uitzonderingen: een publicatie kan één tot meerdere Uitzonderingen op dit niveau bevatten. Hiervoor wordt verwezen naar de dienstspecifieke pagina's

Onderstaand voorbeeld is bedoeld voor het tonen van de opbouw van de Onderwerpen en Onderwerp-element. De gegevens binnen het Inhoud-element zijn verschillend van publicatie tot publicatie.

<Onderwerpen>
	<Onderwerp>
		<Referte>dd014ba4-17e3-45ba-8d83-1f0210bd2456</Referte>
		<Inhoud>
			<Vraag>
				<Ondernemingsnummer>0424038270</Ondernemingsnummer>
				<Aanvrager>
					<Ondernemingsnummer>0316380841</Ondernemingsnummer>
					<Vestigingsnummer>2143726130</Vestigingsnummer>
				</Aanvrager>
			</Vraag>
			<FinancieleSituatie>
				<Informatie>
					<Referentienummer>20901FKYE9WVZ</Referentienummer>
					<RSZNummer>123906732</RSZNummer>
					<Ondernemingsnummer>0424038270</Ondernemingsnummer>
					<DatumVerzendingAntwoord>2017-10-24</DatumVerzendingAntwoord>
				</Informatie>
				<Contactpersonen>
					<Contactpersoon>
						<Naam>
							<Achternamen>
								<Achternaam>Direction FINACO - Section attestations</Achternaam>
							</Achternamen>
						</Naam>
						<Contact>
							<Telefoonnummer>02 555 555 555</Telefoonnummer>
							<Email>mail@mail.be</Email>
						</Contact>
					</Contactpersoon>
					<Contactpersoon>
						<Naam>
							<Achternamen>
								<Achternaam>Directie FINACO - Sectie attesten</Achternaam>
							</Achternamen>
						</Naam>
						<Contact>
							<Telefoonnummer>02 555 555 555 </Telefoonnummer>
							<Email>mail@mail.be</Email>
						</Contact>
					</Contactpersoon>
				</Contactpersonen>
				<Werkgever>
					<Ondernemingsnummer>0424038270</Ondernemingsnummer>
					<RSZNummer>123906732</RSZNummer>
				</Werkgever>
			</FinancieleSituatie>
		</Inhoud>
	</Onderwerp>
	<Onderwerp>
		<Referte>dd014ba4-17e3-45ba-8d83-1f0210bd2456</Referte>
		<Inhoud>
			<Vraag>
				<Ondernemingsnummer>0807658523</Ondernemingsnummer>
				<Aanvrager>
					<Ondernemingsnummer>0316380841</Ondernemingsnummer>
					<Vestigingsnummer>2143726130</Vestigingsnummer>
				</Aanvrager>
			</Vraag>
			<FinancieleSituatie>
				<Informatie>
					<Referentienummer>20901FKYE9Z1Z</Referentienummer>
					<RSZNummer>183845651</RSZNummer>
					<Ondernemingsnummer>0807658523</Ondernemingsnummer>
					<DatumVerzendingAntwoord>2017-10-24</DatumVerzendingAntwoord>
				</Informatie>
				<Detail>
					<TypeDocument>2C01</TypeDocument>
					<EindeBijwerkingWerkgeversrekening>
						<Datum>2017-10-20</Datum>
						<Kwartaal>20172</Kwartaal>
					</EindeBijwerkingWerkgeversrekening>
					<BedragenSchuld>
						<AangaandeBijdragen>0</AangaandeBijdragen>
						<AangaandeToenames>0</AangaandeToenames>
						<AangaandeInteresten>0</AangaandeInteresten>
						<AangaandeLegaleKosten>0</AangaandeLegaleKosten>
					</BedragenSchuld>
				</Detail>
				<Contactpersonen>
					<Contactpersoon>
						<Naam>
							<Achternamen>
								<Achternaam>Direction FINACO - Section attestations</Achternaam>
							</Achternamen>
						</Naam>
						<Contact>
							<Telefoonnummer>02 555 20 61</Telefoonnummer>
							<Email>mail@mail.be</Email>
						</Contact>
					</Contactpersoon>
					<Contactpersoon>
						<Naam>
							<Achternamen>
								<Achternaam>Directie FINACO - Sectie attesten</Achternaam>
							</Achternamen>
						</Naam>
						<Contact>
							<Telefoonnummer>02 555 20 51</Telefoonnummer>
							<Email>mail@mail.be</Email>
						</Contact>
					</Contactpersoon>
				</Contactpersonen>
				<Werkgever>
					<Ondernemingsnummer>0807658523</Ondernemingsnummer>
					<RSZNummer>183845651</RSZNummer>
					<Naam>PICOBELLO NEW  BVBA</Naam>
					<JuridischArrondissement>100</JuridischArrondissement>
					<Rechtsvorm>
						<Omschrijving>BVBA</Omschrijving>
					</Rechtsvorm>
					<Tewerkstelling>
						<Code Beschrijving="100 t.e.m. 199 werknemers">6</Code>
					</Tewerkstelling>
					<Activiteiten>
						<Activiteit>
							<Code>81210</Code>
						</Activiteit>
					</Activiteiten>
					<PeriodeActiviteit>
						<DatumAansluiting>2009-03-01</DatumAansluiting>
					</PeriodeActiviteit>
					<Adres>
						<Straat>
							<Naam>STRAAT 13</Naam>
						</Straat>
						<Gemeente>
							<PostCode>2222</PostCode>
							<Naam>PEPINGEN</Naam>
						</Gemeente>
						<Land>
							<NISCode>150</NISCode>
							<ISOCode>BEL</ISOCode>
							<Naam>BELGIE</Naam>
						</Land>
					</Adres>
					<Categorieen>
						<Categorie>
							<Code>597</Code>
							<Periode>
								<Begin>2009-03-01</Begin>
							</Periode>
						</Categorie>
					</Categorieen>
				</Werkgever>
			</FinancieleSituatie>
		</Inhoud>
	</Onderwerp>
</Onderwerpen>

Uitzonderingen

Voor meer informatie rond de Uitzonderingen binnen het Publicatie-element van een MAGDA 2.0 publicatie wordt verwezen naar Linken uitzonderingen publicaties

CSV bestandformaat

Bestanden die worden aan- of afgeleverd in CSV formaat moeten voldoen aan de volgende richtlijnen

ISO-8859-1 encoding
Geen header rij. De eerste rij moet effectieve gegevens bevatten
De volgorde van de velden moet voldoen aan de in de handleiding opgegeven lijst
De velden worden afgebakend met dubbele aanhalingstekens (")
De velden worden gescheiden door een punt-komma (;)
Lege velden worden steeds weergegeven door twee opeenvolgende dubbele aanhalingstekens. Velden worden nooit weggelaten
Geen line feed na de laatste datalijn, het bestand eindigt m.a.w. bij het laatste karakter van de laatste datalijn

Op deze pagina

1 Opbouw Interface
- 1.1 Publicatie
  - 1.1.1 Context
  - 1.1.2 Onderwerpen
  - 1.1.3 Uitzonderingen
2 CSV bestandformaat

Verbonden pagina’s

MAGDA Gebruikersomgeving

Publicaties aangeboden door MAGDA