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

Visueel

Elementen

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

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 pagina Meervoudig voorkomende elementen	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 Vestigingen	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 : Vestiging
Code@Beschrijving	Onderneming of Vestiging

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	de verbindingscode, oorzaak van verbinding (fusies, splitsingen, overnames, …
Relatie/Omschrijving	de omschrijving van de verbindingscode
Ondernemingsnummer	Ondernemingsnummer van de maatschappelijke zetel. Indien 9 cijfers wordt een voorloopnul voorzien
Stopzetting	-
Stopzetting/Code	De stopzettingscode
Stopzetting/Omzetting	De omschrijving van de stopzettingscode

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

Voorbeeld

Geen voorbeeld 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	De NACEBEL code van de activiteit
Nace/Omschrijving	De omschrijving van de NACEBEL code van de activiteit.
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	code soort activiteit

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	de verbindingscode, oorzaak van verbinding (fusies, splitsingen, overnames, …
Relatie/Omschrijving	de omschrijving van de verbindingscode
Stopzetting/Code	De stopzettingscode
Stopzetting/Omschrijving	De omschrijving van de stopzettingscode

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	De code van de hoedanigheid
Inschrijving/Datum	Datum van inschrijving in format YYYY-MM-DD
Fase/Code	De code van de fase ( '001' =dossier in onderzoek, '002' =toelating verworven, …)
Duurtijd	Duurtijd van de hoedanigheid
InstrumenterendeAdministratie	Code van de instrumenterende administratie die de toelating gegeven heeft
Beeindiging/Code	De stopzettingscode van de toelating

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>

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

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

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