Algemeen

Het antwoord bestaat uit een Onderneming-element met hierin al de gegevens met betrekking gezochte onderneming of vestiging. Het antwoord xsd is in feite identiek aan deze van de GeefOnderneming 2.0, echter er komen maar een beperkt aantal gegevens terug.

Enkel de gegevens die effectief terugkomen worden besproken in dit document. Indien meer details gewenst zijn van de onderneming of vestiging dan dient de afnemer nog een aparte vraag te doen op basis van het nummer via de GeefOnderneming 2.0.

Concreet worden deze elementen teruggeven:

Het ondernemingsnummer
Het soort onderneming
De maatschappelijke naam, mogelijk in
één taal
verschillende talen
Het maatschappelijk adres
De rechtsvorm
De status van de onderneming.

Naargelang de status van de onderneming worden de volgende gegevens opgehaald:

in het geval de onderneming ‘juridisch gecreëerd’ (‘JU’), ‘bekend’ (‘BK’) of ‘actief’ (‘AC’) is, worden de actuele gegevens opgehaald.
in het geval de onderneming ‘stopgezet’ (‘ST’) of ‘afgesloten’ (‘AF’) is, worden de gegevens, die actief waren bij stopzetting of afsluiting, opgehaald.

Voor een vestiging worden deze gegevens teruggegeven:

Het ondernemingsnummer van de onderneming waaraan de vestigingseenheid is gekoppeld;
Het vestigingseenheidsnummer;
De handelsnaam van de vestigingseenheid;
Het vestigingseenheidsadres;
De huidige status van de vestigingseenheid.

Naargelang de status van de vestigingseenheid worden de volgende gegevens opgehaald:

in het geval de vestigingseenheid ‘actief’ (‘AC’) is, worden de actuele gegevens opgehaald.
in het geval de vestigingseenheid ‘stopgezet’ (‘ST’) of ‘afgesloten’ (‘AF’) is, worden de gegevens, die actief waren bij stopzetting of afsluiting, opgehaald.

XSD Visueel

Info

Image Removed

Detail

Enkel de gegevens die terugkomen in het antwoord zijn in onderstaand overzicht opgenomen.

title

Note

Informatie:

De resultaten worden door KBO geordend op inschrijvingsdatum. Hierdoor is het mogelijk dat u bij bijvoorbeeld een bevraging enkel op naam voornamelijk resultaten krijgt van ondernemingen die reeds zijn stopgezet. Wij raden dus aan om zoveel mogelijk criteria in te vullen bij de vraag zodat het resultaat het meest accuraat is.

XSD Visueel

Image Added

Detail

Note

Opmerking:

Het antwoord bestaat standaard uit Context, Referte en Antwoord zoals beschreven in het document Gebruik Magda Webservices 02.00. Verder zal enkel aandacht besteed worden aan het specifieke Antwoord element.

Ondernemingsnummer in detail

Het ondernemingsnummer of vestigingsnummer van de gevonden onderneming / vestigingseenheid. Steeds 10 lang.

Visueel

Image Removed

Voorbeeld

Code Block

language	xml
linenumbers	true

<Ondernemingsnummer>2208955165</Ondernemingsnummer>

AuthentiekeBron in detail

Onderneming/

Opmerking

AuthentiekeBron/

Code

Altijd ‘03’

Code/@Beschrijving

Altijd ‘KBO’

Omschrijving

Komt niet terug in het antwoord

Omschrijving/@Oorsprong

Komt niet terug in het antwoord

Omschrijving/@TaalCode

Komt niet terug in het antwoord

/AuthentiekeBron

Visueel

Image Removed

Voorbeeld

Code Block

language	xml
title	Voorbeeld
linenumbers	true

<AuthentiekBron>
	<Code>03</Code>
	<Omschrijving>KBO</Omschrijving>
</AuthentiekBron>

OndernemingOfVestiging in detail

Onderneming/

Opmerking

OndernemingOfVestiging/

Code

1 = Onderneming

2 = Vestiging

Code@Beschrijving

Komt niet terug in het antwoord

/OndernemingOfVestiging

Visueel

Image Removed

Voorbeeld

Code Block

language	xml
linenumbers	true

<OndernemingOfVestiging>
	<Code>2</Code>
</OndernemingOfVestiging>

StatusKBO in detail

Onderneming/

Opmerking

StatusKBO/

Code

Dit is de code die de status van de onderneming aanduidt, bijvoorbeeld AC (actief)

Code@Beschrijving

KBO geeft een omschrijving door in de taal waarin het verzoek aan hun dienst werd gedaan.

Omschrijving

Komt niet terug in het antwoord

Omschrijving@Oorsprong

Komt niet terug in het antwoord

Omschrijving@TaalCode

Komt niet terug in het antwoord

/StatusKBO

Visueel

Image Removed

Voorbeeld

Code Block

language	xml
linenumbers	true

<StatusKBO>
	<Code>AC</Code>
	<Omschrijving>Actief</Omschrijving>
</StatusKBO>

SoortOnderneming in detail

Onderneming/

Opmerking

SoortOnderneming/

Code

De code die duidt op wat voor soort onderneming wordt gegeven: 1 of 2 (een natuurlijke of een rechtspersoon)

Code@Beschrijving

Komt niet terug in het antwoord

Omschrijving

Komt niet terug in het antwoord

Omschrijving@Oorsprong

Komt niet terug in het antwoord

Omschrijving@TaalCode

Komt niet terug in het antwoord

/SoortOnderneming

Visueel

Image Removed

Voorbeeld

Code Block

language	xml
linenumbers	true

<SoortOnderneming>
	<Code>2</Code>
</SoortOnderneming>

Namen in detail

Namen/

MaatschappelijkeNamen/

Zie MaatschappelijkeNamen

CommercieleNamen/

Zie AfgekorteNamen

CommercieleNamen/

Zie CommercieleNamen

Visueel

Image Removed

MaatschappelijkeNamen/

Opmerking

MaatschappelijkeNaam/

Naam

Taalcode

MaatschappelijkeNaam@DatumBegin

MaatschappelijkeNaam@DatumEinde

/MaatschappelijkeNaam

Voorbeeld: MaatschappelijkeNamen

Code Block

language	xml
title	Voorbeeld: MaatschappelijkeNamen
linenumbers	true

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

AfgekorteNamen/

Opmerking

AfgekorteNaam/

Naam

Taalcode

AfgekorteNaam@DatumBegin

AfgekorteNaam@DatumEinde

/AfgekorteNaam

Voorbeeld: Afgekorte Namen

Geen voorbeeld beschikbaar

CommercieleNamen/

Opmerking

CommercieleNaam/

Naam

Taalcode

CommercieleNaam@DatumBegin

CommercieleNaam@DatumEinde

/CommercieleNaam

Voorbeeld: Commerciële Namen

Code Block

language	xml
linenumbers	true

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

Adressen in detail

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

Adressen/

Adres/

Adres@DatumBegin

Adres@DatumEinde

Straat/

Code

Kan mogelijks de waarde ‘ZN’ (zonder naam) aannemen

Naam

/Straat

Huisnummer

Busnummer

Gemeente/

NISCode

PostCode

Naam

/Gemeente

Staat

Land/

NISCode

ISOCode

KBO vermeldt hier dat de waarde ‘XZ’ mogelijks kan terugkomen indien de informatie niet beschikbaar is

Naam

/Land

Type/

Code

Code@Beschrijving

Komt niet terug in het antwoord

Omschrijving

Omschrijving@Oorsprong

Komt niet terug in het antwoord

Omschrijving@TaalCode

Komt niet terug in het antwoord

/Type

Descripties/

Descriptie/

Adres/

Straat/Code

Straat/Naam

Huisnummer

Busnummer

Gemeente/

NISCode

PostCode

Naam

/Gemeente

Staat

Land/

NISCode

NIS

ISOCode

Naam

/Land

/Adres

Contact/

Telefoonnummer

Faxnummer

GSM

Email

Website

/Contact

Taalcode

Indien de informative bij KBO niet beschikbaar is, geeft KBO hier soms xx terug.

Aanvulling

/Descriptie

/Descripties

Doorhalingen

Zie Adresdoorhalingen

/Adres

Visueel

Image Removed

Voorbeeld

Code Block

language	xml
title	Voorbeeld: Adressen
linenumbers	true
collapse	true

<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>

Adres doorhalingen in detail

Een adresdoorhaling behoort tot de basisgegevens van een onderneming. Dit gegeven komt terug binnen het Adres-element.

Voor een detail van de xsd wordt naar de xsd zelf verwezen.

Visueel

Image Removed

Voorbeeld

Code Block

language	xml
title	Voorbeeld: Adres doorhaling
linenumbers	true
collapse	true

<Adressen>
	<Adres>
		<Straat>
			<Code>3560</Code>
		</Straat>
		<Huisnummer>3</Huisnummer>
		<Gemeente>
			<NISCode>23096</NISCode>
			<PostCode>1981</PostCode>
		</Gemeente>
		<Land>
			<NISCode>150</NISCode>
			<ISOCode>BE</ISOCode>
			<Naam>BELGIE</Naam>
		</Land>
		<Type>
			<Code>001</Code>
			<Omschrijving>Maatschappelijk adres</Omschrijving>
		</Type>
		<Descripties>
			<Descriptie>
				<Adres>
					<Straat>
						<Naam>Zemstsesteenweg</Naam>
					</Straat>
					<Gemeente>
						<Naam>Zemst</Naam>
					</Gemeente>
					<Land>
						<NISCode>150</NISCode>
						<Naam>België</Naam>
					</Land>
				</Adres>
			</Descriptie>
		</Descripties>
		<Doorhalingen>
			<Doorhaling DatumBegin="2010-10-05">
				<Reden>
					<Code>002</Code>
					<Omschrijving>Doorhaling door P-V</Omschrijving>
				</Reden>
			</Doorhaling>
		</Doorhalingen>
	</Adres>
</Adressen>

Rechtsvormen in detail

Een onderneming bevat mogelijks 1 tot meerdere rechtsvormen. De rechtsvormen komen alleen voor bij een onderneming, niet bij een vestigingseenheid.

Voorbeelden van rechtsvormen: ‘Naamloze Vennootschap’, ‘Vennootschap onder firma’, ‘Buitenlandse privaatrechtelijke verenigingen met vestiging, agentschap, kantoor of bijhuis in België’,…

Rechtsvormen

Rechtsvorm/

Rechtsvorm@DatumBegin

Komt niet terug in het antwoord

Rechtsvorm@DatumEinde

Komt niet terug in het antwoord

Code

Code rechtsvorm

Code@Beschrijving

Komt niet terug in het antwoord

Omschrijving

Komt niet terug in het antwoord

Omschrijving@Oorsprong

Komt niet terug in het antwoord

Omschrijving@TaalCode

Komt niet terug in het antwoord

Afkorting

Komt niet terug in het antwoord

/Rechtsvorm

Visueel

Image Removed

Voorbeeld

Code Block

language	xml
title	Voorbeeld: Rechtsvorm
linenumbers	true

<Rechtsvormen>
	<Rechtsvorm>
		<Code>014</Code>
	</Rechtsvorm>
</Rechtsvormen>

Voorbeeld

Code Block

language	xml
title	Voorbeeld: Volledig Antwoord
linenumbers	true
collapse	true

<Antwoorden>
	<Antwoord>
		<Referte>6396</Referte>
		<Inhoud>
			<Ondernemingen>
				<Onderneming>
					<Ondernemingsnummer>0211122082</Ondernemingsnummer>
					<AuthentiekBron>
						<Code>03</Code>
						<Omschrijving>KBO</Omschrijving>
					</AuthentiekBron>
					<OndernemingOfVestiging>
						<Code Beschrijving="Onderneming">1</Code>
					</OndernemingOfVestiging>
					<StatusKBO>
						<Code>AC</Code>
						<Omschrijving>Actief</Omschrijving>
					</StatusKBO>
					<SoortOnderneming>
						<Code Beschrijving="Rechtspersoon">2</Code>
					</SoortOnderneming>
					<Namen>
						<MaatschappelijkeNamen>
							<MaatschappelijkeNaam>
								<Naam>Consistoire de la Paroisse Evanglique Protestante à Anderlecht (E.P.U.B.)</Naam>
								<Taalcode>fr</Taalcode>
							</MaatschappelijkeNaam>
						</MaatschappelijkeNamen>
					</Namen>
					<Adressen>
						<Adres>
							<Straat>
								<Code>0457</Code>
							</Straat>
							<Huisnummer>103</Huisnummer>
							<Gemeente>
								<NISCode>21001</NISCode>
								<PostCode>1070</PostCode>
							</Gemeente>
							<Land>
								<NISCode>150</NISCode>
								<ISOCode>BE</ISOCode>
								<Naam>BELGIE</Naam>
							</Land>
							<Type>
								<Code>001</Code>
								<Omschrijving>Maatschappelijk adres</Omschrijving>
							</Type>
							<Descripties>
								<Descriptie>
									<Adres>
										<Straat>
											<Naam>Walcourtstraat</Naam>
										</Straat>
										<Gemeente>
											<Naam>Anderlecht</Naam>
										</Gemeente>
										<Land>
											<NISCode>150</NISCode>
											<Naam>België</Naam>
										</Land>
									</Adres>
								</Descriptie>
							</Descripties>
						</Adres>
					</Adressen>
					<Rechtsvormen>
						<Rechtsvorm>
							<Code>124</Code>
							<Omschrijving>Openbare instelling</Omschrijving>
							<Afkorting>OI</Afkorting>
						</Rechtsvorm>
					</Rechtsvormen>
				</Onderneming>
				<Onderneming>
					<Ondernemingsnummer>0211202256</Ondernemingsnummer>
					<AuthentiekBron>
						<Code>03</Code>
						<Omschrijving>KBO</Omschrijving>
					</AuthentiekBron>
					<OndernemingOfVestiging>
						<Code Beschrijving="Onderneming">1</Code>
					</OndernemingOfVestiging>
					<StatusKBO>
						<Code>AC</Code>
						<Omschrijving>Actief</Omschrijving>
					</StatusKBO>
					<SoortOnderneming>
						<Code Beschrijving="Rechtspersoon">2</Code>
					</SoortOnderneming>
					<Namen>
						<MaatschappelijkeNamen>
							<MaatschappelijkeNaam>
								<Naam>Fabrique d'Eglise Saint François-Xavier (BR-Anderlecht)</Naam>
								<Taalcode>fr</Taalcode>
							</MaatschappelijkeNaam>
							<MaatschappelijkeNaam>
								<Naam>Kerkfabriek Sint-Franciscus-Xaverius (BR-Anderlecht)</Naam>
								<Taalcode>nl</Taalcode>
							</MaatschappelijkeNaam>
						</MaatschappelijkeNamen>
					</Namen>
					<Adressen>
						<Adres>
							<Straat>
								<Code>0191</Code>
							</Straat>
							<Huisnummer>102</Huisnummer>
							<Gemeente>
								<NISCode>21001</NISCode>
								<PostCode>1070</PostCode>
							</Gemeente>
							<Land>
								<NISCode>150</NISCode>
								<ISOCode>BE</ISOCode>
								<Naam>BELGIE</Naam>
							</Land>
							<Type>
								<Code>001</Code>
								<Omschrijving>Maatschappelijk adres</Omschrijving>
							</Type>
							<Descripties>
								<Descriptie>
									<Adres>
										<Straat>
											<Naam>Georges Moreaustraat</Naam>
										</Straat>
										<Gemeente>
											<Naam>Anderlecht</Naam>
										</Gemeente>
										<Land>
											<NISCode>150</NISCode>
											<Naam>België</Naam>
										</Land>
									</Adres>
								</Descriptie>
							</Descripties>
						</Adres>
					</Adressen>
					<Rechtsvormen>
						<Rechtsvorm>
							<Code>124</Code>
							<Omschrijving>Openbare instelling</Omschrijving>
							<Afkorting>OI</Afkorting>
						</Rechtsvorm>
					</Rechtsvormen>
				</Onderneming>
			</Ondernemingen>
		</Inhoud>
	</Antwoord>
</Antwoorden>

Opmerkingen

De details van de onderdelen die worden teruggegeven kunnen gevonden worden in het Type Onderneming 02.00 onderdeel

Codetabellen Antwoord

Zie ook de codetabellen onderaan op de pagina Beschrijving Vraag (ZoekOnderneming-02.00).

Op deze pagina

Table of Contents

maxLevel	2
minLevel	1

Binnen deze handleiding

Page Treeroot@parent

Child pages (Children Display)

page	Onderneming.ZoekOnderneming-02.00

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

Page Comparison

Versions Compared

Old Version 1

New Version Current

Key

Algemeen

Detail

Informatie:

XSD Visueel

Detail

Opmerking:

Ondernemingsnummer in detail

Visueel

Voorbeeld

AuthentiekeBron in detail

Visueel

Voorbeeld

OndernemingOfVestiging in detail

Visueel

Voorbeeld

StatusKBO in detail

Visueel

Voorbeeld

SoortOnderneming in detail

Visueel

Voorbeeld

Namen in detail

Visueel

Voorbeeld: MaatschappelijkeNamen

Voorbeeld: Afgekorte Namen

Voorbeeld: Commerciële Namen

Adressen in detail

Visueel

Voorbeeld

Adres doorhalingen in detail

Visueel

Voorbeeld

Rechtsvormen in detail

Visueel

Voorbeeld

Voorbeeld

Opmerkingen

Codetabellen Antwoord