- Created by Laurens Debackere on 28 Aug, 2018
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
Version 1 Next »
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 in één taal
- 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
Detail
Enkel de gegevens die terugkomen in het antwoord zijn in onderstaand overzicht opgenomen.
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
Voorbeeld
<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
Voorbeeld
<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
Voorbeeld
<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
Voorbeeld
<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
Voorbeeld
<SoortOnderneming> <Code>2</Code> </SoortOnderneming>
Namen in detail
Namen/ |
|
---|---|
MaatschappelijkeNamen/ | Zie MaatschappelijkeNamen |
CommercieleNamen/ | Zie AfgekorteNamen |
CommercieleNamen/ | Zie CommercieleNamen |
Visueel
MaatschappelijkeNamen/ | Opmerking |
---|---|
MaatschappelijkeNaam/ | |
Naam | |
Taalcode | |
MaatschappelijkeNaam@DatumBegin | |
MaatschappelijkeNaam@DatumEinde | |
/MaatschappelijkeNaam |
Voorbeeld: MaatschappelijkeNamen
<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
<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 | |
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
Voorbeeld
<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
Voorbeeld
<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
Voorbeeld
<Rechtsvormen> <Rechtsvorm> <Code>014</Code> </Rechtsvorm> </Rechtsvormen>
Voorbeeld
<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
Codetabellen Antwoord
Zie ook de codetabellen onderaan op de pagina Beschrijving Vraag (ZoekOnderneming-02.00).
Op deze pagina
Binnen deze handleiding
- No labels