...
...
...
...
...
| Table of Contents |
|---|
Visueel
...
GeefOnderneming02.00, ZoekOnderneming 02.00 webservice diensten |
| Excerpt | ||
|---|---|---|
| ||
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
...
...
...
...
...
J | J | ||
Bankrekeningen | J | J | |
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 | J | N | |
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
...
...
...
...
...
|
AuthentiekeBron
De bron waar de gegevens vandaan komen. Hier is dit steeds "KBO".
Visueel
Mapping
Element | Opmerking |
|---|---|
Code | ="3" |
Omschrijving | ="KBO" |
Voorbeeld
...
...
...
...
|
OndernemingOfVestiging
De code die duidt of het Ondernemingsobject een onderneming of een vestiging bevat.
Visueel
Mapping
Element | Opmerking |
|---|---|
Code | 1 : Onderneming |
...
...
...
...
...
...
...
...
|
StatusKBO
De status van de onderneming, bijvoorbeeld 'Actief'.
Visueel
Mapping
Element | 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
...
...
...
...
...
...
|
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 | Opmerking |
|---|---|
Code | Code mapping en Runtime mapping 1 : EPP |
Code@Beschrijving | Runtime mapping |
Voorbeeld
...
...
...
...
...
...
|
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 | 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 |
...
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
...
Begindatum van de geldigheid van de gegevens
Formaat : jjjj-mm-dd
...
Einddatum van de geldigheid van de gegevens
Formaat : jjjj-mm-dd
...
Mappen volgens pagina naar attributen in parent node
...
Voorbeeld
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
<Namen>
<MaatschappelijkeNamen>
<MaatschappelijkeNaam>
<Naam>Société industrielle métallurgique du Bavaisis</Naam>
<Taalcode>xx</Taalcode>
</MaatschappelijkeNaam>
</MaatschappelijkeNamen>
</Namen> |
| Code Block | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
<Namen>
<CommercieleNamen>
<CommercieleNaam>
<Naam>LIBERIA WORLD AIRLINES BELGIUM</Naam>
<Taalcode>nl</Taalcode>
</CommercieleNaam>
</CommercieleNamen>
</Namen> |
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 | Opmerking |
|---|---|
Datum | Datum van de start van het bedrijf Formaat : jjjj-mm-dd |
Voorbeeld
...
...
...
...
...
|
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 | Opmerking |
|---|---|
Datum | Datum van inschrijving Formaat : jjjj-mm-dd |
Voorbeeld
...
...
...
...
|
Duurtijd
De duur van de onderneming, in jaren. Komt meestal niet terug.
Visueel
Mapping
MAGDA | Opmerking |
|---|---|
Duurtijd | De duur van de onderneming |
...
...
voorbeeld beschikbaar
Afsluiting
De datum waarop de onderneming is afgesloten.
Visueel
Mapping
MAGDA | 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 | 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 | 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:
|
Type/Code | Mogelijke waarden:
|
Type/Omschrijving |
|
Groep |
...
...
...
...
...
...
...
...
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 | 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
...
...
...
...
...
...
...
Mapping
Voor elke Permission dient er een Hoedanigheid in Hoedanigheden gemaakt te worden
MAGDA | 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
...
...
...
...
...
...
...
/wiki/spaces/MDI/pages/786137649
...
/wiki/spaces/MDI/pages/785776955
...
/wiki/spaces/MDI/pages/785875188
Mapping van de Onderneming elementen (dit deel moet verhuizen naar de gegevensboekpagina na een opkuis)
...
MAGDA Onderneming 02.01
Onderneming/
...
Ondernemingsnummer
...
Number
...
AuthentiekeBron
...
StatusKBO
...
EntityCommoninfo/Status
...
De status van de onderneming, bijvoorbeeld ‘Actief’.
...
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.
...
SoortOnderneming
...
Type
...
De code die duidt op wat voor soort onderneming wordt gegeven: een natuurlijke of een rechtspersoon.
...
Indien Type = EPP: 1 invullen.
Indien Type = ELP: 2 invullen
...
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
...
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
...
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
...