GEBRUIKERSHANDLEIDING DOMEIN ONDERNEMING ZOEKONDERNEMING 2.0. Versie /// 2.0 Publicatiedatum /// /// Gebruikershandleiding

Transcriptie

1 /// Gebruikershandleiding GEBRUIKERSHANDLEIDING DOMEIN ONDERNEMING ZOEKONDERNEMING 2.0 Versie /// 2.0 Publicatiedatum ///

2 Informatie Vlaanderen /// Auteur: Elin Vanlierde Datum aanmaak: Wijzigingsdatum: Datum afdruk: Interne bestandsnaam: Gebruikershandleiding ZoekOnderneming 2.0 Documenthistoriek: Versie Opmerking Datum Auteur Status 0.1 Eerste versie Michaël Loedts Concept 0.2 Update naar KBO Release Michaël Loedts Concept 1.0 Publicatie Michaël Loedts Finale versie 2.0 Nieuwe lay-out Elin Vanlierde Finale versie 2 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

3 /// Informatie Vlaanderen INHOUD Inhoud... 1 Inleiding Doel Opbouw document Algemeen Omgevingsinformatie Functionaliteiten Leverancier van de gegevens Gebruiksvoorwaarden Verwante diensten GeefOnderneming Batch... 7 Interface Vraag Algemeen Functionele validaties XSD visueel Detail Voorbeeld Antwoord Algemeen Detail Ondernemingsnummer Authentieke bron Onderneming of vestiging Status KBO Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

4 Informatie Vlaanderen /// Soort onderneming Namen Adressen Adres doorhalingen Rechtsvormen XSD visueel Voorbeeld Belangrijke opmerkingen Overzicht foutcodes Codetabellen OndernemingOfVestiging SoortOnderneming Rechtsvormen Werking Opvraging Opties Logging Beschikbaarheid Gekende problemen Testgegevens Wijzigingen januari Samenvatting Vraag Antwoord Contactgegevens /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

5 /// Informatie Vlaanderen 1 INLEIDING 1.1 DOEL Dit document beschrijft het gebruik en de werking van de webservice ZoekOnderneming 2.0 zoals deze door Informatie Vlaanderen op het MAGDA platform aangeboden wordt. De webservice laat de gebruiker toe rechtstreeks bij KBO (Kruispuntbank Ondernemingen) ondernemingen en vestigingen op te zoeken. MAGDA (afnemer) Applicatie MAGDA Gatewayplatform ZoekOnderneming GW MAGDA Businessdienstplatform ZoekOnderneming BD Externe partij: KBO WSConsultKBO 1.2 OPBOUW DOCUMENT Het algemeen overzicht van de functionaliteiten en het gebruik van deze webservice is opgenomen in hoofdstuk 2. Hoofdstuk behandelt de interface van de webservice, dit zowel de Vraag als Antwoord inclusief voorbeelden en bevindingen. Hoofstuk 4 bevat de codetabellen. Hoofdstuk 5 geeft meer informatie over de werking. Hierbij worden onder meer enkele aandachtspunten, de configuratieparameters, de beschikbaarheid en de gekende problemen aangehaald. Hoofdstuk 6 beschrijft welke testgegevens er beschikbaar zijn. Hoofdstuk 7 bevat de wijzigingen doorgevoerd in januari 16 aan deze versie van de dienst De contactgegevens zijn opgenomen in hoofdstuk 7. Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

6 Informatie Vlaanderen /// 2 ALGEMEEN 2.1 OMGEVINGSINFORMATIE Naam: ZoekOnderneming Versie: Classificatie: niet privacy gevoelig 2.2 FUNCTIONALITEITEN De webservice ZoekOnderneming 2.0 laat de afnemer van het MAGDA platform om op basis van verschillende criteria ondernemingen en vestigingseenheden op te zoeken bij KBO. Het aantal gegevens dat terugkomt is echter beperkt. Wenst men de volledige set van ondernemingsgegevens moet men nog aan de hand van het ondernemingsnummer via de GeefOnderneming 2.0 een bijkomende oproep uitvoeren. Concreet worden deze elementen teruggeven in het antwoord: - Het ondernemingsnummer - Aanduiding onderneming of vestiging - Het soort onderneming - De status van de onderneming - De maatschappelijke naam in één taal - Het maatschappelijk adres - De rechtsvorm Opmerking: indien de basisgegevens niet opgevraag worden (= 0) komen enkel volgende gegevens terug: - Ondernemingsnummer - Aanduiding onderneming of vestiging - Soort onderneming - Rechtsvorm (komt niet terug indien vestigingseenheid) 6 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

7 /// Informatie Vlaanderen 2. LEVERANCIER VAN DE GEGEVENS De gegevens zijn afkomsting uit de federale Kruispuntbank voor ondernemingen (KBO), d.i. de centrale Belgische Bedrijvendatabank waar de Belgische economische actoren (Rechtspersonen, Werkgevers, Handelaars, BTW-plichtigen ) eenmalig worden geregistreerd. KBO wordt gehost door FOD Economie (Federale Overheidsdienst Economie, K.M.O., Middenstand en Energie). Om de gegevens bij KBO op te halen wordt gebruik gemaakt van de KBO Consult webservice release GEBRUIKSVOORWAARDEN Afnemers moeten aan volgende voorwaarden voldoen om deze webservice te mogen gebruiken: Toelating tot het MAGDA platform Toelating tot het gebruik van de webservice ZoekOnderneming 2.0 Meer informatie over deze voorwaarden is terug te vinden in het document Machtigingen en toelatingen [MT]. 2.5 VERWANTE DIENSTEN GeefOnderneming 2.0 GeefOnderneming 2.0: voor het ophalen van de gegevens van ondernemingen en vestigingseenheden bij KBO, dit op basis van het ondernemingsnummer of vestigingseenheidnummer. 2.6 BATCH Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

8 Informatie Vlaanderen /// Hiervoor moet men de Service-xsd gebruiken en niet de Webservice. Door de Service-xsd te gebruiken zijn er meerdere vragen mogelijk in één bestand. De vraag-bestanden worden op de MAGDA FTP geplaatst in een afnemer specifieke folder. Deze folder wordt tijdens het aansluitingsproces toegekend. Als prefix voor de batchbestanden wordt voorgesteld ZOND (ZoekONdernemingDienst) te gebruiken. Meer informatie hierover kan u vinden via Aansluiting op het MAGDA-platform in het document MS Gebruikershandleiding_WebserviceInBatch, of neem contact op met helpdesk.magda@vlaanderen.be. 8 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

9 /// Informatie Vlaanderen INTERFACE.1 VRAAG.1.1 Algemeen Algemeen kan een onderneming gezocht worden op: Zoeknaam, eventueel gecombineerd met status en/of soort onderneming Zoeknaam + plaats, eventueel gecombineerd met status en/of soort onderneming. Plaats, eventueel gecombineerd met status en/of soort onderneming. Rechtsvorm + plaats, eventueel gecombineerd met status Een vestigingseenheid kan gezocht worden op: Zoeknaam eventueel gecombineerd met status. Zoeknaam + plaats, eventueel gecombineerd met status. Plaats, eventueel gecombineerd met status. Wat betreft plaats gelden de volgende regels: Indien Landcode = 150, dan zijn volgende combinaties toegelaten: Postcode NISCode Postcode+Straatcode NISCode +Straatcode Postcode+Straatcode + Huisnummer (geen wildcart mogelijkheid) NISCode +Straatcode +Huisnummer Indien Landcode verschillend is van 150, dan is enkel een zoekopdracht op basis van postcode mogelijk. Opmerking bij zoeken op naam: KBO voorziet geen specifieke wildcards maar op de naam wordt wel gezocht volgens een similarity principe..1.2 Functionele validaties Geen functionele validaties. Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

10 Informatie Vlaanderen ///.1. XSD visueel.1.4 Detail Enkel de elementen vanaf Criteria zijn in onderstaan overzicht opgenomen. Element Criteria/ Basisgegevens Resultaten OndernemingOfVestiging/Code chrijving StatusKBO SoortOnderneming Opmerking 0 of 1. Aanduiding of de basisgegevens van een onderneming al dan niet gewenst zijn. Het maximaal aantal resultaten dat men wil terugkrijgen, functioneel door de bron gelimiteerd tot 60 1 voor enkel ondernemingen te zoeken of 2 voor enkel vestigingen (of niet invullen om op beide te zoeken) Dient men niet op te geven in de vraag Momenteel een 2 lettercode die de status bij KBO duidt 1 of 2 in te vullen om het ondernemingstype te bepalen.(1 voor een natuurlijk persoon, 2 voor een rechtspersoon) Wordt dit element hier gebruikt, dan wordt er automatisch gezocht op enkel Ondernemingen. 10 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

11 /// Informatie Vlaanderen Naam Rechtsvorm Adres/ StraatCode Huisnummer GemeenteNISCode GemeentePostCode LandNISCode /Adres Omschrijvingen /Criteria Taal De naam of een deel van de naam van de onderneming die men zoekt. De te zoeken rechtsvorm van de onderneming. Een driecijferige code (zie codelijsten). Wordt dit element gebruikt, dan wordt er automatisch gezocht op enkel Ondernemingen. De Rijksregister straatcode; een 4 cijferige code Huisnummer, hier kan ook ZN ; ingevuld worden NISCode van de Belgische gemeente, normaal een 5 cijferige code Postcode van de gemeente; buitenlandse postcodes zijn ook mogelijk NIS landcode (vb 150) 0 of 1. Aanduiding of de basisgegevens van de onderneming gewenst zijn. Alleen nl toegelaten.1.5 Voorbeeld Voorbeeld 1 <Vragen> <Vraag> <Referte>695</Referte> <Inhoud> <Criteria> <Basisgegevens>0</Basisgegevens> <Resultaten>01</Resultaten> <Naam>brussels airlines</naam> <Omschrijvingen> <Aanduiding>1</Aanduiding> </Omschrijvingen> Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

12 Informatie Vlaanderen /// </Criteria> <Taal>nl</Taal> </Inhoud> </Vraag> </Vragen> Voorbeeld 2 <Vragen> <Vraag> <Referte> </Referte> <Inhoud> <Criteria> <Basisgegevens>1</Basisgegevens> <Resultaten>05</Resultaten> <OndernemingOfVestiging> <Code>1</Code> </OndernemingOfVestiging> <StatusKBO>AC</StatusKBO> <Naam>Belgacom</Naam> <Adres> <LandNISCode>150</LandNISCode> </Adres> </Criteria> <Taal>nl</Taal> </Inhoud> </Vraag> </Vragen> 12 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

13 /// Informatie Vlaanderen.2 ANTWOORD.2.1 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. Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

14 Informatie Vlaanderen ///.2.2 Detail Enkel de gegevens die terugkomen in het antwoord zijn in onderstaand overzicht opgenomen Ondernemingsnummer Het ondernemingsnummer of vestigingsnummer van de gevonden onderneming / vestigingseenheid. Steeds 10 lang. Visueel: Voorbeeld: <Ondernemingsnummer> </Ondernemingsnummer> Authentieke bron Onderneming/ Opmerking AuthentiekeBron/ Code Altijd 0 Code/@Beschrijving Omschrijving Omschrijving/@Oorsprong Omschrijving/@TaalCode /AuthentiekeBron Altijd KBO Komt niet terug in het antwoord Komt niet terug in het antwoord Komt niet terug in het antwoord 14 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

15 /// Informatie Vlaanderen Visueel Voorbeeld <AuthentiekBron> <Code>0</Code> <Omschrijving>KBO</Omschrijving> </AuthentiekBron>.2.2. Onderneming of vestiging Onderneming/ Opmerking OndernemingOfVestiging/ Code /OndernemingOfVestiging 1 = Onderneming 2 = Vestiging Komt niet terug in het antwoord Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

16 Informatie Vlaanderen /// Visueel Voorbeeld: <OndernemingOfVestiging> <Code>2</Code> </OndernemingOfVestiging> Status KBO Onderneming/ Opmerking StatusKBO/ Code Omschrijving Dit is de code die de status van de onderneming aanduidt, bijvoorbeeld AC (actief) KBO geeft een omschrijving door in de taal waarin het verzoek aan hun dienst werd gedaan. Komt niet terug in het antwoord Komt niet terug in het antwoord Komt niet terug in het antwoord /StatusKBO 16 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

17 /// Informatie Vlaanderen Visueel Voorbeeld <StatusKBO> <Code>AC</Code> <Omschrijving>Actief</Omschrijving> </StatusKBO> Soort onderneming Onderneming/ Opmerking SoortOnderneming/ Code Omschrijving De code die duidt op wat voor soort onderneming wordt gegeven: 1 of 2 (een natuurlijke of een rechtspersoon) Komt niet terug in het antwoord Komt niet terug in het antwoord Komt niet terug in het antwoord Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

18 Informatie Vlaanderen /// /SoortOnderneming Komt niet terug in het antwoord Visueel Voorbeeld <SoortOnderneming> <Code>2</Code> </SoortOnderneming> Namen Namen/ MaatschappelijkeNamen/ CommercieleNamen/ CommercieleNamen/ Zie MaatschappelijkeNamen Zie AfgekorteNamen Zie CommercieleNamen 18 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

19 /// Informatie Vlaanderen Visueel MaatschappelijkeNamen/ Opmerking MaatschappelijkeNaam/ Naam Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

20 Informatie Vlaanderen /// Taalcode /MaatschappelijkeNaam Voorbeeld <Namen> <MaatschappelijkeNamen> <MaatschappelijkeNaam> <Naam>Société industrielle métallurgique du Bavaisis</Naam> <Taalcode>xx</Taalcode> </MaatschappelijkeNaam> </MaatschappelijkeNamen> </Namen> AfgekorteNamen/ Opmerking AfgekorteNaam/ Naam Taalcode /AfgekorteNaam Voorbeeld Geen voorbeeld beschikbaar CommercieleNamen/ CommercieleNaam/ Naam Opmerking 20 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

21 /// Informatie Vlaanderen Taalcode /CommercieleNaam Voorbeeld <Namen> <CommercieleNamen> <CommercieleNaam> <Naam>LIBERIA WORLD AIRLINES BELGIUM</Naam> <Taalcode>nl</Taalcode> </CommercieleNaam> </CommercieleNamen> </Namen> Adressen 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/ Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

22 Informatie Vlaanderen /// 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 Komt niet terug in het antwoord Omschrijving /Type Descripties/ Descriptie/ Komt niet terug in het antwoord Komt niet terug in het antwoord 22 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

23 /// Informatie Vlaanderen Adres/ Straat/Code Straat/Naam Huisnummer Busnummer Gemeente/ NISCode PostCode Naam /Gemeente Staat Land/ NISCode ISOCode Naam /Land /Adres Contact/ Telefoonnummer Faxnummer GSM Website /Contact /Descriptie Taalcode Aanvulling Indien de informative bij KBO niet beschikbaar is, geeft KBO hier soms xx terug. Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

24 Informatie Vlaanderen /// /Descripties /Adres Doorhalingen Zie Adresdoorhalingen Visueel 24 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

25 /// Informatie Vlaanderen 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> Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

26 Informatie Vlaanderen /// <Code>0001</Code> </Straat> <Huisnummer>2-4</Huisnummer> <Gemeente> <NISCode>56022</NISCode> <PostCode>6560</PostCode> </Gemeente> <Land> <NISCode>150</NISCode> <ISOCode>BE</ISOCode> <Naam>BELGIE</Naam> </Land> <Type> <Code>00</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> 26 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

27 /// Informatie Vlaanderen </Adres> </Adressen> </Descripties> Adres doorhalingen 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. Voorbeeld <Adressen> <Adres> <Straat> <Code>560</Code> </Straat> Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

28 Informatie Vlaanderen /// <Huisnummer></Huisnummer> <Gemeente> <NISCode>2096</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> 28 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

29 /// Informatie Vlaanderen <Doorhalingen> <Doorhaling DatumBegin=" "> <Reden> <Code>002</Code> <Omschrijving>Doorhaling door P-V</Omschrijving> </Reden> </Doorhaling> </Doorhalingen> </Adres> </Adressen> Rechtsvormen 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 Rechtsvorm@DatumEinde Code Code@Beschrijving Omschrijving Omschrijving@Oorsprong Omschrijving@TaalCode Afkorting /Rechtsvorm Komt niet terug in het antwoord Komt niet terug in het antwoord Code rechtsvorm Komt niet terug in het antwoord Komt niet terug in het antwoord Komt niet terug in het antwoord Komt niet terug in het antwoord Komt niet terug in het antwoord Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

30 Informatie Vlaanderen /// Visueel Voorbeeld <Rechtsvormen> <Rechtsvorm> <Code>014</Code> </Rechtsvorm> </Rechtsvormen>.2. XSD visueel Voor een overzicht met alle elementen wordt verwezen naar de xsd zelf. 0 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

31 /// Informatie Vlaanderen.2.4 Voorbeeld <Antwoorden> <Antwoord> <Referte>696</Referte> <Inhoud> <Ondernemingen> <Onderneming> <Ondernemingsnummer> </Ondernemingsnummer> <AuthentiekBron> Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

32 Informatie Vlaanderen /// <Code>0</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>10</Huisnummer> <Gemeente> <NISCode>21001</NISCode> 2 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

33 /// Informatie Vlaanderen <PostCode>1070</PostCode> </Gemeente> <Land> <NISCode>150</NISCode> adres</omschrijving> <ISOCode>BE</ISOCode> <Naam>BELGIE</Naam> </Land> <Type> <Code>001</Code> <Omschrijving>Maatschappelijk </Type> <Descripties> <Descriptie> <Adres> <Straat> <Naam>Walcourtstraat</Naam> </Straat> <Gemeente> <Naam>Anderlecht</Naam> </Gemeente> <Land> <NISCode>150</NISCode> <Naam>België</Naam> </Adres> </Land> Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

34 Informatie Vlaanderen /// </Descriptie> </Descripties> </Adres> </Adressen> <Rechtsvormen> <Rechtsvorm> <Code>124</Code> <Omschrijving>Openbare instelling</omschrijving> <Afkorting>OI</Afkorting> </Rechtsvorm> </Rechtsvormen> </Onderneming> <Onderneming> <Ondernemingsnummer> </Ondernemingsnummer> <AuthentiekBron> <Code>0</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> 4 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

35 /// Informatie Vlaanderen <MaatschappelijkeNaam> <Naam>Fabrique d'eglise Saint François- Xavier (BR-Anderlecht)</Naam> <Taalcode>fr</Taalcode> (BR-Anderlecht)</Naam> </MaatschappelijkeNaam> <MaatschappelijkeNaam> <Naam>Kerkfabriek Sint-Franciscus-Xaverius <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> Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

36 Informatie Vlaanderen /// <Omschrijving>Maatschappelijk adres</omschrijving> </Type> <Descripties> Moreaustraat</Naam> <Descriptie> <Adres> <Straat> <Naam>Georges </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> 6 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

37 /// Informatie Vlaanderen </Rechtsvorm> </Rechtsvormen> </Onderneming> </Ondernemingen> </Inhoud> </Antwoord> </Antwoorden>.2.5 Belangrijke opmerkingen Overzicht foutcodes Vanuit de beschikbare documentatie van KBO is het onduidelijk in welke omstandigheden volgende codes allemaal kunnen terugkomen en of ze allemaal kunnen terugkomen in de manier waarop de KBO service in dit document wordt opgevraagd. Voor de veiligheid wordt de complete lijst hier wel hernomen. Enkel de dienst specifieke foutcodes zijn opgenomen in het overzicht. Voor een volledig overzicht van de MAGDA foutcodes wordt verwezen naar de generieke handleiding. Identificatie Niveau Type Diagnose Oorsprong FOUT Adrescode is niet actief in KBO MAGDA FOUT Landcode bestaat niet in KBO MAGDA FOUT Adrescode bestaat niet in KBO MAGDA FOUT Straatcode bestaat niet in KBO MAGDA FOUT Rechtsvorm niet gekend door KBO MAGDA FOUT Rechtsvorm niet actief in KBO MAGDA FOUT Gevraagde ondernemingsnummer bestaat niet in MAGDA KBO FOUT NIS Gemeentecode bestaat niet in KBO MAGDA FOUT De opgevraagde onderneming is een vestiging MAGDA FOUT De opgevraagde vestiging is geen vestiging MAGDA Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

38 Informatie Vlaanderen /// FOUT Geen relatie tussen de onderneming en de vestiging MAGDA FOUT Geen Ondernemingsnummer ingevuld MAGDA FOUT De onderneming is geannuleerd MAGDA FOUT Niet alle gegevens konden opgehaald worden MAGDA FOUT Onvoldoende gegevens om de operatie uit te voeren MAGDA FOUT Ongeldige combinatie van selectiecriteria MAGDA FOUT Code van type adres is niet ingevuld MAGDA FOUT Postcode van adres is niet ingevuld MAGDA FOUT Landcode van een adres is niet ingevuld MAGDA FOUT Einddatum van een adres niet ingevuld MAGDA FOUT Begindatum van de periode moet kleiner of gelijk MAGDA zijn aan de einddatum FOUT Ontbrekende taalcode MAGDA FOUT Straatnaam is niet ingevuld MAGDA FOUT Geen gegevens gevonden MAGDA FOUT Vestiging is geannuleerd MAGDA FOUT Ontbrekende rol MAGDA FOUT Ontbrekende instrumenterende administratie MAGDA FOUT Ondernemingstype bestaat niet MAGDA FOUT De postcode en NIS gemeentecode mogen niet MAGDA samen ingevuld zijn FOUT De postcode of NIS-gemeentecode is niet ingevuld MAGDA FOUT De postcode bestaat niet in KBO MAGDA FOUT Ongeldige combinatie van selectie MAGDA FOUT Geen selectiecriteria aanwezig MAGDA FOUT Interne fout bij verwerking door KBO MAGDA 8 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

39 /// Informatie Vlaanderen FOUT Onderneming/Vestiging status niet toegelaten MAGDA FOUT Ongekende foutcode van de bron, contacteer VIP MAGDA Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

40 Informatie Vlaanderen /// 4 CODETABELLEN 4.1 ONDERNEMINGOFVESTIGING MAGDA Code MAGDA beschrijving 1 Onderneming 2 Vestiging 4.2 SOORTONDERNEMING MAGDA Code MAGDA beschrijving 1 Natuurlijke Persoon 2 Rechtspersoon 4. RECHTSVORMEN Bron (KBO) KBO omschrijving KBO korte omschrijving 001 Europese Coöperatieve Vennootschap SCE 002 Organisme van de financiering van Pensioenen OFP 00 BTW-Eenheid BTWE 006 Coöperatieve vennootschap met onbeperkte hoofdelijke aansprakelijkheid 007 Coöperatieve vennootschap met onbeperkte hoofdelijke aansprakelijkheid, bij wijze van deelneming CVOA CVOHACD 40 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

41 /// Informatie Vlaanderen 008 Coöperatieve vennootschap met beperkte aansprakelijkheid 009 Coöperatieve vennootschap met beperkte aansprakelijkheid, bij wijze van deelneming 010 Eenmans Besloten Vennootschap met beperkte aansprakelijkheid CVBA CVBA CD EBVBA 011 Vennootschap onder firma VOF 012 Gewone commanditaire vennootschap Comm.V 01 Commanditaire vennootschap op aandelen Comm.VA 014 Naamloze vennootschap NV 015 Besloten vennootschap met beperkte BVBA aansprakelijkheid 016 Coöperatieve Vennootschap CV 017 Vereniging zonder winstoogmerk VZW 018 Instelling van openbaar nut Inst OpN 019 Mutualiteit Mutualit 020 Beroepsvereniging BV 021 Onderlinge verzekeringsmaatschappij OVZM 022 Internationale wetenschappelijke organisaties van Belgisch recht 02 Buitenlandse privaatrechtelijke verenigingen met vestiging, agentschap, kantoor of bijhuis in België IWO BR BPR 025 Landbouwvennootschap LBV 026 Private stichting PRIV ST. 027 Europese Vennootschap (Societas Europaea) SE 028 Instelling zonder winstoogmerk IZW 029 Stichting van openbaar nut SON 00 Buitenlandse onderneming BO Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

42 Informatie Vlaanderen /// 040 Kongolese Vennootschap KONG VEN 051 Andere Privaatrechtelijke Vorm met PRV rechtspersoonlijkheid 060 Economisch samenwerkingsverband met zetel in ESV België 065 Europees economisch samenwerkingsverband met EESV zetel in België 070 Vereniging van Mede-eigenaars VME 106 Coöperatieve vennootschap met onbeperkte CVOHA OR aansprakelijkheid (publiek recht) 107 Coöperatieve vennootschap met onbeperkte CVOA CD aansprakelijkheid, bij wijze van deelneming (publiek recht) 108 Coöperatieve vennootschap met beperkte CVBA OR aansprakelijkheid (publiek recht) 109 Coöperatieve vennootschap met beperkte CVBA CD aansprakelijkheid, bij wijze van deelneming 110 Rijk, Provincie, Gewest, Gemeenschap RPGG 114 Naamloze vennootschap (Publiek recht) NV OR 116 Coöperatieve Vennootschap (Publiek recht) CV OR 117 Vereniging zonder winstoogmerk (Publiek recht) VZW OR 121 Onderlinge verzekeringsmaatschappij OVZ OP 12 Beroepsverenigingen - Orden BV ORDEN 124 Openbare instelling OI 125 Internationale Vereniging zonder winst IVZW 126 Openbaar centrum voor maatschappelijk welzijn OCMW 127 Berg van Barmhartigheid BVB 128 Eredienst EREDIENS 42 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

43 /// Informatie Vlaanderen 129 Polders en Wateringen PW 151 Andere Rechtsvormen AV 155 Lokale politiezone LOKPOL 160 Buitenlandse of Internationale Publieke Organisaties BIPO 200 Vennootschap in vorming VV 206 Burgerlijke Vennootschap onder vorm van CV met onbeperkte aansprakelijkheid 208 Burgerlijke Vennootschap onder vorm van CV met beperkte aansprakelijkheid 211 Burgerlijke Vennootschap onder vorm van Vennootschap onder firma 212 Burgerlijke Vennootschap onder vorm van Gewone Commanditaire Vennootschap 21 Burgerlijke Vennootschap onder vorm van Commanditaire Vennootschap op Aandelen (BV Comm VA) 214 Burgerlijke vennootschap onder vorm van naamloze vennootschap 215 Burgerlijke vennootschap onder vorm van besloten vennootschap met beperkte aansprakelijkheid 225 Burgerlijke Vennootschap onder vorm van Landbouwvennootschap (BV LV) 20 Buitenlandse onderneming met onroerend goed in België (met juridische persoonlijkheid) 25 Buitenlandse onderneming zonder Belgische vestiging met vertegenwoordiger voor BTW 260 Economisch samenwerkingsverband zonder zetel met vestiging in België BV CVOA BV CVBA BV VOF BV GCV BV CVA BV NV BV BVBA BV LV BOOGBJP BOZBVBTW ESV Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

44 Informatie Vlaanderen /// 265 Europees economisch samenwerkingsverband zonder zetel met vestiging in België (EESV) EESV 01 Federale overheidsdienst FOD 02 Programmatorische federale overheidsdienst POD 0 Andere federale diensten FEDEDIEN 10 Overheden van het Vlaams Gewest en Vlaams Gemeenschap VLGEWGEM 20 Overheden van het Waals Gewest WG 0 Overheden van het Brussels hoofdstedelijk gewest BRUHOOGE 40 Overheden van de Franse gemeenschap FRAGEMEE 50 Overheden van de Duitstalige Gemeenschap DUITGEME 70 Ministerie van Economische Zaken ECOZAKEN 71 Ministerie van Buitenlandse Zaken, Buitenlandse BZ handel en Ontwikkelingssamenwerking 72 Ministerie van Landbouw LANDMIN 7 Ministerie van Middenstand MIDDENST 74 Ministerie van Verkeerswerken VERKEER 75 Ministerie van Landsverdediging MLV 76 Ministerie van Nationale Opvoeding en Cultuur MNOC 77 Ministerie van Tewerkstelling en Arbeid MTA 78 Ministerie van Financiën MINFIN 79 Ministerie van Binnenlandse Zaken MBZ 80 Ministerie van Justitie MINJUST 81 Ministerie van Sociale Voorzorg MSV 82 Ministerie van Volksgezondheid en Gezin MVG 8 Diensten van de Eerste Minister FIRSTMIN 84 Ministerie van Verkeer en Infrastructuur MVI 85 Ministerie van de Vlaamse Gemeenschap MVG 44 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

45 /// Informatie Vlaanderen 86 Ministerie van de Franse Gemeenschap MFG 87 Ministerie van het Brusselse Hoofdstedelijk Gewest MBHG 88 Ministerie van het Waalse Gewest MWG 89 Ministerie van de Duitse Gemeenschap MDG 90 Ministerie van Ambtenarenzaken MAZ 91 Ministerie van Middenstand en Landbouw MML 92 Ministerie van Sociale Zaken, Volksgezondheid en MSZVL Leefmilieu 9 Andere ANDERE 400 Provinciale Overheden PROVOVER 401 Organismen ingeschreven door de RSZ PPO ORG PPO 411 Steden en gemeenten GEMEENTE 412 Openbaar centrum voor maatschappelijk welzijn OCMW 41 Lokale Politie LOKPOL 414 Intercommunale IC 415 Projectvereniging (Vlaams Gewest) proj ver 416 Dienstverlenende vereniging (Vlaams Gewest) dienstv. 417 Opdrachthoudende vereniging (Vlaams Gewest) OPDRAVER 418 Autonoom Gemeentebedrijf AUTOGEMB 419 Autonoom provinciebedrijf AUTOPRB 420 Vereniging van openbare centra voor maatschappelijk Ver.OCMW welzijn 451 Organismen ingeschreven voorde R.V.P. RVP 452 Organismen ingeschreven voor de Administratie van OIAP de Pensioenen 45 Buitenlandse onderneming zonder Belgische vestiging genoteerd op de beurs BOZBVGB Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

46 Informatie Vlaanderen /// 454 Buitenlandse ondernemingen met onroerend goed in België (zonder juridische persoonlijkheid) 506 Coöperatieve vennootschap met onbeperkte aansprakelijkheid met sociaal oogmerk 508 Coöperatieve vennootschap met beperkte aansprakelijkheid met sociaal oogmerk BOOGBE CVOHA SO CVBA SO 510 Eenpersoons BVBA met sociaal oogmerk EBVBA SO 511 Vennootschap onder firma met sociaal oogmerk VOF SO 512 Gewone commanditaire vennootschap à finalité GCW SO sociale 51 Commanditaire vennootschap op aandelen met CVA SO sociaal oogmerk 514 Naamloze vennootschap met sociaal oogmerk NV SO 515 Besloten vennootschap met beperkte BVBA SO aansprakelijkheid met sociaal oogmerk 560 Economisch samenwerkingsverband met sociaal ESV SO oogmerk 606 Coöperatieve vennootschap met onbeperkte CVOHA SO aansprakelijkheid met sociaal oogmerk 608 Coöperatieve vennootschap met beperkte CVBA SO aansprakelijkheid met sociaal oogmerk 614 Naamloze vennootschap met sociaal oogmerk NV SO 651 Andere vorm met Sociaal Oogmerk VORM SO 701 Onrechtmatige handelsvennootschap OMHV 702 Maatschap MS 70 Tijdelijke handelsvennootschap TH 704 Stille handelsvennootschap SH 46 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

47 /// Informatie Vlaanderen 721 Vennootschap of vereniging zonder rechtspersoonlijkheid VVZRL 722 Tijdelijke vereniging TV 72 Kostendelende vereniging KV 724 Vakbond VAKBOND 790 Diversen zonder Rechtspersoonlijkheid DZRL 999 Ongekende rechtsvorm RSZ OUTRSZ Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

48 Informatie Vlaanderen /// 5 WERKING 5.1 OPVRAGING Van zodra de vraag gesteld is wordt er een XSD-validatie uitgevoerd. Is de ontvangen vraag niet geldig tegenover het schema, dan stopt de verwerking en wordt een foutmelding aangemaakt, anders gaat de verwerking verder. Na de XSD-validatie vinden de nodige authenticatie- en autorisatiecontroles plaats. Bij succesvolle xsd validatie en andere controles wordt de vraag omgezet naar en KBO-xml en wordt de vraag uiteindelijk aan KBO voorgelegd. KBO voert de nodige validaties en autorisaties uit. Indien bij KBO hier een fout optreedt wordt de verwerking stop gezet en verkrijgt de afnemer een foutmelding. Zijn de autorisatie en andere validatieslangs de kant van KBO succesvol, dan verkrijgt MAGDA de gegevens van KBO, zet deze om in een antwoord xml en geeft ze door aan de afnemer. 5.2 OPTIES Volgende configuratieparameters kunnen op het MAGDA platform ingesteld worden in functie van de machtigingen en de wensen van de afnemer: geen 5. LOGGING De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven in het document MAGDA logging [ML]. 5.4 BESCHIKBAARHEID De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar. 5.5 GEKENDE PROBLEMEN Er zijn geen gekende problemen. 48 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

49 /// Informatie Vlaanderen 6 TESTGEGEVENS De testomgeving bevat productieve data, bijgevolg zijn in principe alle ondernemingen en vestigingseenheden opvraagbaar. Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

50 Informatie Vlaanderen /// 7 WIJZIGINGEN JANUARI SAMENVATTING Naar aanleiding van KBO Release 29 eind november 2015 is beslist om de ZoekOnderneming 2.0 aan te passen zodanig deze compatibel wordt met de KBO webservice release 29. Aangebrachte wijzigingen: - Vraag: o o o Toevoeging vlag of de basisgegevens al dan niet gewenst zijn in het antwoord Toevoeging aanduiding of codeomschrijving al dan niet gewenst zijn in het antwoord (naar analogie met de GeefOnderneming 2.0) Verwijdering Bron - Antwoord: o Adres: zie GeefOnderneming VRAAG Toevoeging Basisgegevens Verplicht: 0 of 1. Aanduiding of de basisgegevens in het antwoord al dan niet gewenst zijn. Toevoeging Omschrijvingen Optioneel: 0 of 1. Aanduiding of de Omschrijvingen bij code-elementen in het antwoord al dan niet gewenst zijn. Verwijdering Bron Element verwijderd wegens overbodig. 50 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0

51 /// Informatie Vlaanderen 7. ANTWOORD Zie aanpassingen GeefOnderneming 2.0 Gebruikershandleiding - Domein Onderneming ZoekOnderneming 2.0 /// /// 52

52 Informatie Vlaanderen /// 8 CONTACTGEGEVENS Informatie Vlaanderen is elke werkdag bereikbaar van 9.00 tot uur. Postadres: Herman Teirlinckgebouw - Havenlaan 88, 1000 Brussel Virginie Lovelinggebouw - Koningin Maria Hendrikaplein 70, 9000 Gent Tel: 02/ helpdesk.magda@vlaanderen.be 52 /// /// Gebruikershandleiding Domein Onderneming ZoekOnderneming 2.0