Page Comparison

Table of Contents

...

Filtering in logica

KBO heeft met het ExOfficioExecution element het mogelijk gemaakt om niet alleen doorhalingen door te geven, maar alle administratieve handelingen. Om de GeefOnderneming 2.0 dienst backwards compatibel te houden met de KBO R33 data filtert MAGDA alle handelingen uit die geen doorhalingen zijn.

Visueel

...

Note

Opmerking:

Eind Q1 2019 is een nieuwe versie van de GeefOnderneming 2.0 dienst in productie gegaan die gebruik maakt van de WSConsultKBO 3.0 dienst bij BOSA welke de R33 data gebruikt van KBO. Dit heeft gevolgen voor de contactgegevens. Zie op de "Update Q1 2019" pagina voor meer details!

Visueel

Image Added

Elementen

MAGDA ../AmbtshalveDoorhalingen/AmbtshalveDoorhaling	Opmerking
@DatumBegin	Begindatum van de geldigheid van de gegevens
@DatumEinde	Einddatum van de geldigheid van de gegevens
Reden/Code	De reden van de doorhaling CODE OMSCHRIJVING 001 Doorhaling op basis van een vonnis/arrest 002 Doorhaling op basis van een proces-verbaal/onderzoeksverslag 003 Doorhaling op basis van het RRNP 004 Doorhaling ten gevolge van niet-neerlegging jaarrekening 005 Doorhaling ten gevolge van niet vervullen UBO-verplichtingen 006 Doorhaling na twee brieven zonder gevolg 007 Doorhaling op basis van een authentieke bron 999 Andere doorhalingen
Reden/Omschrijving	Omschrijving van de doorhaling

...

Voorbeeld

Expand

title	Voorbeeld

Code Block

language	xml

<Doorhalingen>
	<Doorhaling DatumBegin="2012-12-11">
		<Reden>
			<Code>002</Code>
			<Omschrijving>Doorhaling door P-V</Omschrijving>
		</Reden>
	</Doorhaling>
</Doorhalingen>

Adres

In een Belgisch adres komt mogelijks een straatcode of NIScode van de gemeente terug en in het buitenlandse adres is er mogelijks nog een extra melding van de staat (alleen in bepaalde gevallen, zoals bv. de naam van een staat in de VSA).

Er kunnen in het antwoord mogelijks 0 tot meerdere ‘descriptions’ staan. Deze descriptions geven o.m. de naam van de straat in een taal en mogelijke contactinformatie

Dit element wordt gebruikt in

Bijhuis/Adres
Adressen/Adres

Visueel

...

Image Added

Elementen

MAGDA Adres/	Opmerking
@DatumBegin	Begindatum van geldigheid gegevens Formaat jjjj-mm-dd
@DatumEinde	Einddatum geldigheid van gegevens Formaat jjjj-mm-dd
Straat	-
Straat/Code	Rijksregister straatcode
Straat/Naam	Niet ingevuld. Waarde zit in Descripties
Huisnummer	Huisnummer
Busnummer	Busnummer
Gemeente/NISCode

...

NISCode van de gemeente
Gemeente/PostCode	Postcode van de gemeente
Gemeente/Naam	Niet ingevuld. Waarde zit in Descripties
Land/ISOCode	ISOCode van het land (1 tot 3 karakters)
Land/NISCode	NISCode van het land
Land/Naam	Naam van het land
Staat	Komt alleen voor in buitenlands adres
Type/Code	Code van het type adres
Type/Omschrijving	Omschrijving van het type adres
Descripties/Descriptie	-
Descripties/Descriptie/Adres/Straat	-
Descripties/Descriptie/Adres/Straat/Code	Wordt niet ingevuld
Descripties/Descriptie/Adres/Straat/Naam

...

Naam van de straat
Descripties/Descriptie/Adres/Huisnummer	Wordt niet ingevuld
Descripties/Descriptie/Adres/Busnummer	Wordt niet ingevuld
Descripties/Descriptie/Adres/Gemeente	-
Descripties/Descriptie/Adres/Gemeente/NISCode	Wordt niet ingevuld
Descripties/Descriptie/Adres/Gemeente/PostCode	Wordt niet ingevuld
Descripties/Descriptie/Adres/Gemeente/Naam	Naam van de gemeente
Descripties/Descriptie/Adres/Land/NISCode	Wordt niet ingevuld
Descripties/Descriptie/Adres/Land/ISOCode	Wordt niet ingevuld
Descripties/Descriptie/Adres/Land/Naam	Naam van het land
Descripties/Descriptie/Contact/

...

Taalcode	Code van de taal waarin de tekstuele adresinformatie wordt weergegeven. Normaal gezien = 'nl'
Descripties/Descriptie/Aanvulling	Aanvullende gegevens over het adres
Doorhalingen	Zie Doorhalingen hierboven

Voorbeeld

Expand

title	Voorbeeld

Code Block

language	xml

<Adressen>
	<Adres>
		<Land>
			<NISCode>111</NISCode>
			<ISOCode>FR</ISOCode>
			<Naam>FRANKRIJK</Naam>
		</Land>
		<Type>
			<Code>001</Code>
		</Type>
		<Descripties>
			<Descriptie>
				<Adres>
					<Straat>
						<Naam>rue Eugène Mascart</Naam>
					</Straat>
					<Gemeente>
						<Naam>Bavay</Naam>
					</Gemeente>
					<Land>
						<NISCode>111</NISCode>
						<Naam>Frankrijk</Naam>
					</Land>
				</Adres>
			</Descriptie>
		</Descripties>
	</Adres>
	<Adres>
		<Straat>
			<Code>0001</Code>
		</Straat>
		<Huisnummer>32-34</Huisnummer>
		<Gemeente>
			<NISCode>56022</NISCode>
			<PostCode>6560</PostCode>
		</Gemeente>
		<Land>
			<NISCode>150</NISCode>
			<ISOCode>BE</ISOCode>
			<Naam>BELGIE</Naam>
		</Land>
		<Type>
			<Code>003</Code>
		</Type>
		<Descripties>
			<Descriptie>
				<Adres>
					<Straat>
						<Naam>Rue St Antoine</Naam>
					</Straat>
					<Gemeente>
						<Naam>Erquelinnes</Naam>
					</Gemeente>
					<Land>
						<NISCode>150</NISCode>
						<Naam>België</Naam>
					</Land>
				</Adres>
			</Descriptie>
		</Descripties>
	</Adres>
</Adressen>

Contact

Dit element wordt gebruikt in

...

KBO heeft de contactinformatie uit het adres gehaald zonder enige referentie ernaartoe. Daarenboven is het contact element genormaliseerd en kunnen verschillende types van data (faxnummer, telefoonnummer, etc.) verschillende malen voorkomen. Dit genereert twee problemen

...

Volgens de informatie van BOSA bestaan er geen ondernemingen met meerdere contactgegevens van hetzelfde type. In de MAGDA XSD is voor elk type slechts 1 element voorzien. Door telkens het eerste gegeven van een bepaald type te mappen naar het respectievelijk MAGDA element kan dit probleem opgelost worden. Het probleem van de koppeling tussen de contactgegevens en het adres blijft echter bestaan. Er is op dit moment nog geen bevestiging of er ook slechts 1 adres per onderneming voorkomt in de database van KBO (zoals bij de contactgegevens ook het geval is). Indien dit het geval is is er op dit moment geen probleem.

De enigste werkbare oplossing voor dit probleem is voor elk adres telkens de eerste contactgegevens te gebruiken van elk type. Dit wil zeggen dat als er meerdere adressen zijn, deze dezelfde contactgegevens zullen krijgen. Dit is de enigste werkbare oplossing zonder expliciete chaos te creëren. De overgrote meerderheid van de bedrijven in de KBO database zullen slechts 1 adres hebben (nog te bevestigen) dus is dit probleem beperkt tot een kleine subset.

Logica

Loop over de ContactInformation elementen

Als de waarde van ValidityPeriod/End kleiner is dan "Vandaag" ga naar het volgende element. De data in dit element is immers niet meer geldig. De MAGDA contactinformatie kent geen historische data, dus mag vervallen data niet worden doorgegeven worden.
Controleer de waarde van het ContactType element
Map de waarde naar het juiste MAGDA element volgens de waarde van het ContactType element (zie lijst hieronder)
Indien het MAGDA element reeds ingevuld is, lees het volgende Contact element in.

Let op! Voor het adres in het Bijhuis element zijn aparte contactgegevens beschikbaar. Het spreekt voor zich dat deze contactgegevens bij het adres van het bijhuis horen.

Visueel KBO

Image Removed

Visueel MAGDA

Image Removed

Elementen

...

WSConsultKBO v3.0
../ContactInformation

...

Value[ContactType=’001’]

...

Value[ContactType=’002’]

...

Niet beschikbaar

...

Value[ContactType=’004’]

...

dienst in productie gaan die gebruik zal maken van de WSConsultKBO 3.0 dienst bij BOSA welke de R33 data gebruikt van KBO. Dit heeft gevolgen voor de contactgegevens. Zie op de "Update Q1 2019" pagina voor meer details!

Visueel

Image Added

Elementen

MAGDA 2.0 Onderneming/Adressen/Adres/Descripties/Descriptie/Contact Onderneming/Bijhuis/Adres/Descripties/Descriptie/Contact	Opmerking
Telefoonnummer	Telefoonnummer
FaxNummer	Faxnummer
GSM	GSMnummer
Email	Email
Website	Website

Namen

Een onderneming kan verschillende namen hebben, zoals een Maatschappelijke Naam of een Afgekorte Naam. Tevens kan het gebeuren dat een onderneming een naam heeft in verschillende talen.

Visueel

Image Added

Mapping

MAGDA /Namen/MaatschappelijkeNamen/MaatschappelijkeNaam of /Namen/AfgekorteNamen/AfgekorteNaam of /Namen/CommercieleNamen/CommercieleNaam of /Vestiging/Namen/MaatschappelijkeNamen/MaatschappelijkeNaam of /Vestiging/Namen/AfgekorteNamen/AfgekorteNaam of /Vestiging/Namen/CommercieleNamen/CommercieleNaam	Opmerking
@DatumBegin	Begindatum van de geldigheid van de gegevens Formaat : jjjj-mm-dd (geen verplicht element, kan ontbreken in het antwoord)
@DatumEinde	Einddatum van de geldigheid van de gegevens Formaat : jjjj-mm-dd (geen verplicht element, kan ontbreken in het antwoord)
Naam	Maatschappelijke naam, Afgekorte naam of commerciële naam
TaalCode	Taalcode waarin de naam wordt weergegeven

Voorbeelden

Expand

title	MaatschappelijkeNaam

Code Block

language	xml

<Namen>
	<MaatschappelijkeNamen>
		<MaatschappelijkeNaam>
			<Naam>Société industrielle métallurgique du Bavaisis</Naam>
			<Taalcode>xx</Taalcode>
		</MaatschappelijkeNaam>
	</MaatschappelijkeNamen>
</Namen>

Expand

title	CommercieleNaam

Code Block

language	xml

<Namen>
	<CommercieleNamen>
		<CommercieleNaam>
			<Naam>LIBERIA WORLD AIRLINES BELGIUM</Naam>
			<Taalcode>nl</Taalcode>
		</CommercieleNaam>
	</CommercieleNamen>
</Namen>

Op deze pagina

Table of Contents

maxLevel	2
minLevel	1

Binnen deze handleiding

Child pages (Children Display)

page	Type Onderneming-02.00

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

Versions Compared

Old Version 6

New Version Current

Key

AmbtshalveDoorhalingen en Doorhalingen

Filtering in logica

Visueel

Opmerking:

Visueel

Elementen

Voorbeeld

Adres

Visueel

Elementen

Voorbeeld

Contact

Opmerking:

Logica

Visueel KBO

Visueel MAGDA

Elementen

Visueel

Elementen

Namen

Visueel

Mapping

Voorbeelden

	Zie contactgegevens hieronder
Descripties/Descriptie/