Deze pagina bevat al de informatie gerelateerd aan het Onderneming 2.00 object zoals gebruikt in de MAGDA GeefOnderneming, ZoekOnderneming webservice diensten

Visueel

Elementen

Een Onderneming bevat meer informatie dan een Vesting. In het antwoord zijn de elementen die in beiden kunnen terugkomen samengenomen maar er is een element voorzien, OndernemingOfVesting, dat aanduidt of het antwoord gegevens van een onderneming bevat, of gegevens van een vesting.

Wordt in dit document gerefereerd naar de Onderneming in het MAGDA antwoord kan dit dus zowel een onderneming als een vestiging betekenen.

Element /	Opmerking	Mogelijk in Onderneming	Mogelijk in Vestiging
Ondernemingsnummer	Ondernemingsnummer. Indien 9 cijfers wordt een voorloopnul voorzien	J	J
AuthentiekeBron	-	J	J
AuthentiekeBron/Code	Vaste waarde, ="3"	J	J
AuthentiekeBron/Omschrijving	Vaste waarde, ="KBO"	J	J
OndernemingOfVestiging	Zie hieronder bij OndernemingOfVestiging	J	J
StatusKBO	Zie hieronder bij StatusKBO	J	J
SoortOnderneming	Zie hieronder bij SoortOnderneming	J	N
MaatschappelijkeZetel	Zie hieronder bij Maatschappelijke zetel	N	J
Namen	Zie hieronder bij Namen	J	J
Adressen	Zie pagina Meervoudig voorkomende elementen	J	J
Start	Zie hieronder bij Start	J	J
Inschrijving	Zie hieronder bij Inschrijving	J	N
Duurtijd	Zie hieronder bij Duurtijd	J	N
Afsluiting	Zie hieronder bij Afsluiting	J	N
Stopzetting	Zie hieronder bij Stopzetting	J	N
Rechtsvormen	Zie pagina Rechtsvormen	J	N
Rechtstoestanden	Zie pagina Rechtstoestanden	J	J
Vestigingen	Zie pagina Vestingen	J	J
Bankrekeningen	Zie pagina Bankrekeningen	J	J
Functies	Zie pagina Functies	J	Deels
Activiteiten	Zie hieronder bij Activiteiten	J	J
GerelateerdeOndernemingen	Zie hieronder bij GerelateerdeOndernemingen	J	J
Hoedanigheden	Zie hieronder bij Hoedanigheid	J	J
ExterneIdentificaties	Zie pagina ExterneIdentificaties	J	N
Bijhuis	Zie pagina Bijhuis	J	N
AmbtshalveDoorhalingen	Zie pagina Meervoudig voorkomende elementen	J	N

Overzicht van elementen

Ondernemingsnummer

Dit is het nummer van de onderneming of het nummer van de vestiging.

Visueel

Mapping

Element /	Opmerking
Ondernemingsnummer	Ondernemingsnummer. Indien 9 lang wordt een voorloopnul toegevoegd

Voorbeeld

Ondernemingsnummer

<Ondernemingsnummer>2208955165</Ondernemingsnummer>

AuthentiekeBron

De bron waar de gegevens vandaan komen. Hier is dit steeds "KBO".

Visueel

Mapping

Element AuthentiekeBron	Opmerking
Code	="3"
Omschrijving	="KBO"

Voorbeeld

AuthentiekeBron

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

OndernemingOfVestiging

De code die duidt of het Ondernemingsobject een onderneming of een vestiging bevat.

Visueel

Mapping

Element OndernemingOfVestiging	Opmerking
Code	1 : Onderneming 2 : Vesting
Code@Beschrijving	Onderneming of Vesting

Voorbeeld

OndernemingOfVesting

<OndernemingOfVestiging>
	<Code Beschrijving="Vestiging">2</Code>
</OndernemingOfVestiging>

StatusKBO

De status van de onderneming, bijvoorbeeld 'Actief'.

Visueel

Mapping

Element StatusKBO	Opmerking
Code	Dit is de code die de status van de onderneming aanduidt, bijvoorbeeld AC (actief)
Omschrijving	KBO geeft een omschrijving door in de taal waarin het verzoek aan hun dienst werd gedaan.

Voorbeeld

StatusKBO

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

SoortOnderneming

De code die duidt op wat voor soort onderneming wordt gegeven: een natuurlijke of een rechtspersoon.

Zie ook de Runtime Mapping pagina

Visueel

Mapping

Element
SoortOnderneming

Opmerking

Code

Code mapping en Runtime mapping

1 : EPP
2 : ELP

Code@Beschrijving

Runtime mapping
1 : Natuurlijke persoon
2 : Rechtspersoon

Voorbeeld

SoortOnderneming

<SoortOnderneming>
	<Code Beschrijving="Rechtspersoon">2</Code>
</SoortOnderneming>

MaatschappelijkeZetel

De maatschappelijke zetel wordt alleen weergegeven indien het een vestiging betreft.

Zijn er voor een onderneming relaties met andere ondernemingen, dan worden deze in het element ‘gerelateerde ondernemingen’ gegeven.

Visueel

Mapping

Element MaatschappelijkeZetel/	Opmerking
@DatumBegin	Begindatum van de geldigheid Formaat : jjjj-mm-dd
@DatumEinde	Einddatum van de geldigheid Formaat : jjjj-mm-dd
Relatie
Relatie/Code
Relatie/Omschrijving
Ondernemingsnummer	Ondernemingsnummer van de maatschappelijke zetel. Indien 9 cijfers wordt een voorloopnul voorzien
Stopzetting
Stopzetting/Code
Stopzetting/Omzetting

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

Mapping

MAGDA Namen/MaatschappelijkeNamen/MaatschappelijkeNaam of Namen/AfgekorteNamen/AfgekorteNaam of Namen/CommercieleNamen/CommercieleNaam	Opmerking
@DatumBegin	Begindatum van de geldigheid van de gegevens Formaat : jjjj-mm-dd
@DatumEinde	Einddatum van de geldigheid van de gegevens Formaat : jjjj-mm-dd
Naam	Maatschappelijke naam, Afgekorte naam of commerciële naam
TaalCode	Taalcode waarin de naam wordt weergegeven
Mappen volgens pagina naar attributen in parent node	/wiki/spaces/MDI/pages/637765842

Voorbeeld

MaatschappelijkeNaam

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

CommercieleNaam

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

Start

De datum van start is de datum waarop de onderneming werd opgericht.
Voor rechtspersonen die opgericht worden met een authentieke akte, is dit de datum waarop de akte gedagtekend wordt. Voor rechtspersonen zonder authentieke akte (onderhands, bepaald bij wet of KB’s, …) is dit de datum waarop de rechtspersonen erkend worden ten opzichte van derden. Voor ondernemingen van natuurlijke personen is dit de datum waarop de natuurlijke persoon met de onderneming zal starten.

Deze datum is niet te verwarren met de datum van inschrijving in de databank van KBO, die in de praktijk doorgaans later ligt.

Visueel

Mapping

De andere elementen in Validity worden elders gemapt.

MAGDA
Start

Opmerking

Datum

Datum van de start van het bedrijf

Formaat : jjjj-mm-dd

Voorbeeld

Start

<Start>
	<Datum>1977-04-21</Datum>
</Start>

Inschrijving

De datum van inschrijving is de datum waarop de onderneming werd opgenomen in de KBO databank. Niet te verwarren met de datum van start.

Visueel

Mapping

MAGDA
Inschrijving

Opmerking

Datum

Datum van inschrijving

Formaat : jjjj-mm-dd

Voorbeeld

Inschrijving

<Inschrijving>
	<Datum>2003-01-18</Datum>
</Inschrijving>

Duurtijd

De duur van de onderneming, in jaren. Komt meestal niet terug.

Visueel

Mapping

MAGDA /	Opmerking
Duurtijd	De duur van de onderneming is jaren

Voorbeeld

Geen voorbeel beschikbaar

Afsluiting

De datum waarop de onderneming is afgesloten.

Visueel

Mapping

MAGDA
Afsluiting

Opmerking

Datum

De datum van afsluiting van de onderneming

Formaat : jjjj-mm-dd

Voorbeeld

Er is geen voorbeeld beschikbaar

Stopzetting

Dit is de datum waarop een onderneming of vestiging is stopgezet, met de code van de reden van stopzetting.

Visueel

Mapping

MAGDA
Stopzetting

Opmerking

Datum

Datum van stopzetting

Formaat YYYY-MM-DD

Code

Code van stopzetting

Omschrijving

Omschrijving van de stopzetting

Voorbeeld

Er is geen voorbeeld beschikbaar

Activiteiten

Een onderneming kan 0 tot meerdere activiteiten hebben.

Visueel

Mapping

MAGDA Activiteiten/Activiteit	Opmerkingen
@DatumBegin	Begindatum van de geldigheid van de gegevens
@DatumEinde	Einddatum van de geldigheid van de gegevens
Nace/Code
Nace/Omschrijving
Nace/Versie	Mogelijke waarden: 2003 2008
Type/Code	Mogelijke waarden: P : Principal Activity S : Secondary Activity H : Help Activity
Type/Omschrijving	Principal Activity Secondary Activity Help Activity
Groep

Voorbeeld

Activiteit

<Activiteiten>
	<Activiteit>
		<Nace>
			<Code>64110</Code>
			<Versie>2008</Versie>
		</Nace>
		<Type>
			<Code Beschrijving="Hoofdactiviteit">P</Code>
		</Type>
		<Groep>006</Groep>
	</Activiteit>
	<Activiteit>
		<Nace>
			<Code>65110</Code>
			<Versie>2003</Versie>
		</Nace>
		<Type>
			<Code Beschrijving="Hoofdactiviteit">P</Code>
		</Type>
		<Groep>006</Groep>
	</Activiteit>
</Activiteiten>

GerelateerdeOndernemingen

Een onderneming kan 0 tot meerdere GerelateerdeOndernemingen hebben.

Visueel

Mapping

Voor elke LinkedEnterprise dient er een GerelateerdeOnderneming in GerelateerdeOndernemingen gemaakt te worden, behalve wanneer het gaat om de maatschappelijke zetel van een vestiging.

MAGDA GerelateerdeOndernemingen/GerelateerdeOnderneming//	Opmerking
@DatumBegin	Begindatum van de geldigheid van de onderneming
@DatumEinde	Einddatum van de geldigheid van de onderneming
Ondernemingsnummer	Ondernemingsnummer, indien 9 lang wordt een voorloopnul toegevoegd
Relatie/Code
Relatie/Omschrijving
Stopzetting/Code
Stopzetting/Omschrijving

Voorbeeld

GerelateerdeOnderneming

<GerelateerdeOndernemingen>
	<GerelateerdeOnderneming>
		<Relatie IsDochter="1">
			<Code>003</Code>
			<Omschrijving>Is opgeslorpt door</Omschrijving>
		</Relatie>
		<Ondernemingsnummer>0204360192</Ondernemingsnummer>
	</GerelateerdeOnderneming>
	<GerelateerdeOnderneming>
		<Relatie IsDochter="1">
			<Code>003</Code>
			<Omschrijving>Is opgeslorpt door</Omschrijving>
		</Relatie>
		<Ondernemingsnummer>0204360390</Ondernemingsnummer>
	</GerelateerdeOnderneming>
	<GerelateerdeOnderneming>
		<Relatie IsDochter="1">
			<Code>004</Code>
			<Omschrijving>Is vervangen door (enkel bij dubbels)</Omschrijving>
		</Relatie>
		<Ondernemingsnummer>0870006361</Ondernemingsnummer>
	</GerelateerdeOnderneming>
</GerelateerdeOndernemingen>

Hoedanigheden

De hoedanigheden (of ook ‘Toelatingen’ genoemd) zijn de officiële erkenningen, labels,

vergunningen… die een onderneming of vestiging bezit, zoals geregistreerd in KBO door de

bevoegde “administrerende overheid” . Dit beperkt zich voorlopig tot RSZ (en RSZPPO)- en/of

BTW-inschrijvingen of handelaar (Ondernemingsloket) of erkenning Vrij beroep of de Vlaamse

Instellingen-databank van Onderwijs (SCO).

Visueel

Mapping

Voor elke Permission dient er een Hoedanigheid in Hoedanigheden gemaakt te worden

MAGDA Hoedanigheden/Hoedanigheid/	Opmerking
@DatumBegin	Beginddatum van de geldigheid van de gegevens
@DatumEinde	Einddatum van de geldigheid van de gegevens
Code
Inschrijving/Datum	Datum van inschrijving in format YYYY-MM-DD
Fase/Code
Duurtijd
InstrumenterendeAdministratie
Beeindiging/Code

Voorbeeld

Voorbeeld

<Hoedanigheden>
	<Hoedanigheid>
		<Code Beschrijving="Onderneming onderworpen aan BTW">00084</Code>
		<InstrumenterendeAdministratie>BTW001</InstrumenterendeAdministratie>
		<Inschrijving>
			<Datum>2003-01-19</Datum>
		</Inschrijving>
		<Duurtijd>0.0</Duurtijd>
		<Fase>
			<Code Beschrijving="hoedanigheid/Toelating verworven">002</Code>
		</Fase>
	</Hoedanigheid>
	<Hoedanigheid>
		<Code Beschrijving="Handelsonderneming">00293</Code>
		<InstrumenterendeAdministratie>OLK001</InstrumenterendeAdministratie>
		<Inschrijving>
			<Datum>2003-01-27</Datum>
		</Inschrijving>
		<Duurtijd>0.0</Duurtijd>
		<Fase>
			<Code Beschrijving="hoedanigheid/Toelating verworven">002</Code>
		</Fase>
	</Hoedanigheid>
	<Hoedanigheid>
		<Code Beschrijving="Werkgever RSZ">00070</Code>
		<InstrumenterendeAdministratie>RSZ001</InstrumenterendeAdministratie>
		<Inschrijving>
			<Datum>2003-01-20</Datum>
		</Inschrijving>
		<Duurtijd>0.0</Duurtijd>
		<Fase>
			<Code Beschrijving="hoedanigheid/Toelating verworven">002</Code>
		</Fase>
	</Hoedanigheid>
</Hoedanigheden>

Mapping van de Onderneming elementen (dit deel moet verhuizen naar de gegevensboekpagina na een opkuis)

MAGDA Onderneming 02.01 Onderneming/	KBO element Enterprise/ or BusinessUnit	Omschrijving
Ondernemingsnummer	Number	Overnemen, indien 9 lang wordt een voorloopnul toegevoegd
AuthentiekeBron		Wordt vast gemapt
AuthentiekeBron/Code	="03"
AuthentiekeBron/Omschrijving	="KBO" (exacte waarde nog te bepalen volgens nieuwe normen)
StatusKBO	EntityCommoninfo/Status	De status van de onderneming, bijvoorbeeld ‘Actief’.
StatusKBO/Code	EntityCommoninfo/Status/StatusCode	Overnemen
StatusKBO/Omschrijving	EntityCommonInfo/Status/CodeDescription	Overnemen
OndernemingOfVestiging		De code die duidt of het Ondernemingsobject een onderneming of een vestiging bevat. Deze wordt eenvoudig afgeleid uit het bestaan van het element Enterprise of BusinessUnit in het antwoord van KBO.
OndernemingOfVestiging/Code	Wordt logisch afgeleid	1 : Bestaan van Entity/Enterprise 2 : Bestaan van Entity/BusinessUnit
SoortOnderneming	Type	De code die duidt op wat voor soort onderneming wordt gegeven: een natuurlijke of een rechtspersoon.
SoortOnderneming/Code		Indien Type = EPP: 1 invullen. Indien Type = ELP: 2 invullen
SoortOnderneming/Description		Runtime mapping invoeren
MaatschappelijkeZetel	EntityCommonInfo/LinkedEnterprise/ Enkel indien dochter dan bij vestigingen te mappen naar Maatschappelijke Zetel, anders naar Gerelateerde Ondernemingen	De maatschappelijke zetel wordt alleen weergegeven indien het een vestiging betreft. Zijn er voor een onderneming relaties met andere ondernemingen, dan worden deze in het element ‘gerelateerde ondernemingen’ gegeven.
Namen	EntityCommoninfo/Denomination	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.
Adressen	EntityCommoninfo/Address	Een onderneming kan meerdere adressen hebben. In het Magda antwoord kan een adres zowel een Belgisch als een buitenlands adres zijn.
Start	EntityCommoninfo/Validity	De datum van start is de datum waarop de onderneming werd opgericht. Voor rechtspersonen die opgericht worden met een authentieke akte, is dit de datum waarop de akte gedagtekend wordt. Voor rechtspersonen zonder authentieke akte (onderhands, bepaald bij wet of KB’s, …) is dit de datum waarop de rechtspersonen erkend worden ten opzichte van derden. Voor ondernemingen van natuurlijke personen is dit de datum waarop de natuurlijke persoon met de onderneming zal starten. Deze datum is niet te verwarren met de datum van inschrijving in de databank van KBO, die in de praktijk doorgaans later ligt (zie verder.)
Inschrijving	Date/Inscription	De datum van inschrijving is de datum waarop de onderneming werd opgenomen in de KBO databank. Niet te verwarren met de datum van start (zie vorige.)
Duurtijd	Date/Duration	De duur van de onderneming, in jaren. In de aangeleverde voorbeelden van KBO kwam deze doorgaans niet terug maar het element is hier voor de zekerheid toch voorzien.
Vestigingen	BusinessUnit	In een onderneming bestaat de mogelijkheid om ook de mogelijk verschillende vestigingen met elk een bepaalde hoeveelheid informatie te laten zien.
Rechtstoestanden	JuridicalSituation	De rechtstoestanden van een onderneming komen alleen voor bij een onderneming, niet bij een vestiging. De mapping kan dus alleen gebeuren als er een Enterprise terugkomt van KBO en niet bij een BusinessUnit. Er kunnen meerdere rechtstoestanden zijn voor 1 onderneming.
Rechtsvormen	JuridicalForm	De rechtsvormen komen alleen voor bij een onderneming, niet bij een vestiging. Er kunnen (historisch !?) meerdere rechtsvormen zijn per onderneming. Voor de code zijn meerdere omschrijvingen voorzien die door KBO worden doorgestuurd.
Stopzetting	EntityCommoninfo/Validity	Dit is de datum waarop een onderneming of vestiging is stopgezet, met de code van de reden van stopzetting.
Afsluiting	EntityCommoninfo/Validity	De datum waarop de onderneming is afgesloten.
Bankrekeningnummers	BankAccount	Een onderneming kan 0 tot meerdere bankrekeningnummers hebben. Dit kunnen zowel Belgische als Europese of internationale rekeningnummers zijn. Bij elk bankrekeningnummer is er ook een mogelijke ‘doelcode’ die het doel duidt waarvoor dit rekeningnummer wordt gebruikt. KBO geeft geen verklarend veld mee voor deze code. Deze code komt wel verplicht altijd terug indien er een bankrekeningnummer aanwezig is.
Functies	EntityCommoninfo/Functions en Enterprisefunctions (enkel voor KBOEnterprise)	In de GeefOnderneming-02.01 kan mogelijks een lijst van functies terugkomen. Het gaat hier enkel om functies uitgeoefend in deze onderneming of door de onderneming in andere ondernemingen. Via dit element zullen geen functies terugkomen door natuurlijke personen uitgeoefend in andere ondernemingen dan de opgevraagde onderneming.
Activiteiten	EntityCommonInfo/Activity	Een onderneming kan 0 tot meerdere activiteiten hebben.
GerelateerdeOndernemingen	EntityCommonInfo/LinkedEnterprise	Een onderneming kan 0 tot meerdere GerelateerdeOndernemingen hebben.
Hoedanigheden	EntityCommonInfo/Permission	Een onderneming kan 0 tot meerdere Hoedanigheden hebben.
ExterneIdentificaties	ExternalIdentification	De Externe Identificatie van een onderneming bevat een EDRL (Europese Dienstenrichtlijn) identificatie en een naam van deze identificatie. Een onderneming kan meerdere Externe Identificaties bevatten.
Bijhuis	ForeignBranchOffice	Dit bevat het maatschappelijke adres van een onderneming als de onderneming een bijhuis is in België voor een buitenlandse onderneming. Dit element bevat naast 1 adres mogelijks ook informatie sinds wanneer dit bijhuis actief is en wanneer en waarom het gestopt is. Het adres volgt de structuur van het algemene adres van een onderneming; dit omwille van het potentieel voorkomen van deze elementen in het antwoord dat KBO verstuurt.
AmbsthalveDoorhalingen	EntityCommonInfo/ExOfficioStrinkingOff	Zie ExOfficioStrikingOff element op Gemeenschappelijke elementen pagina

Type Onderneming 02.00

Visueel

Elementen

Overzicht van elementen

Ondernemingsnummer

Visueel

Mapping

Voorbeeld

AuthentiekeBron

Visueel

Mapping

Voorbeeld

OndernemingOfVestiging

Visueel

Mapping

Voorbeeld

StatusKBO

Visueel

Mapping

Voorbeeld

SoortOnderneming

Visueel

Mapping

Voorbeeld

MaatschappelijkeZetel

Visueel

Mapping

Namen

Visueel

Mapping

Voorbeeld

Start

Visueel

Mapping

Voorbeeld

Inschrijving

Visueel

Mapping

Voorbeeld

Duurtijd

Visueel

Mapping

Voorbeeld

Afsluiting

Visueel

Mapping

Voorbeeld

Stopzetting

Visueel

Mapping

Voorbeeld

Activiteiten

Visueel

Mapping

Voorbeeld

GerelateerdeOndernemingen

Visueel

Mapping

Voorbeeld

Hoedanigheden

Visueel

Mapping

Voorbeeld

ExterneIdentificaties

Bijhuis

AmbtshalveDoorhalingen

Mapping van de Onderneming elementen (dit deel moet verhuizen naar de gegevensboekpagina na een opkuis)

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