Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Beschrijving Vraag (GeefOnderneming-02.00)

XSD Visueel

Detail

Enkel de elementen vanaf Criteria zijn in onderstaand overzicht opgenomen.

Element

Opmerking

Criteria

 



Ondernemingsnummer

Het ondernemingsnummer, of vestigingseenheidnummer. Checksum 97.



Basisgegevens

Geeft al dan niet de ‘basis’ ondernemingsgegevens:

  • StatusKBO

  • SoortOnderneming

  • Namen

  • Adressen (inclusief adresdoorhalingen)

  • Inschrijving

  • Start

  • Rechtsvormen



Rechtstoestanden

Geeft Rechtstoestanden

0 of 1



Vestigingen







Aanduiding

Geeft basisgegevens van Vestigingen

  • Startdatum

  • Stopzettingsdatum

  • Reden van stopzetting

  • Benamingen

  • Recente adresgegevens

Er wordt nooit een historiek meegegeven.

0 of 1





Details

Indien deze vlag op 1 gezet wordt wordt moet Aanduiding ook op 1 gezet worden.

Geeft details over de vestigingen:

  • Benamingen met historiek

  • Historiek van de adressen (kan time-outs geven bij een groot aantal adressen)

  • Contactinformatie en hun historiek (in het adres)

0 of 1



Bankrekeningen

Geeft Bankrekeningen



Functies







Aanduiding

Geeft Functies (maar enkel de functies in de onderneming, niet de functies die de onderneming in een andere onderneming eventueel uitoefent). Kan enkel op 1 gezet worden bij gebruik van filtering op ondernemingsnummer.

0 of 1

Bij de bevraging van een vestigingsnummer moet de waarde '0' zijn. Bij een andere waarde zal er de foutmelding  'Fout in autorisatie' gegeven worden.





Soort

Geeft aan wel soort functies in het antwoord gewenst zijn.

      1 =  “Ondernemingsvaardigheden”

      2 =  “WettelijkeFuncties”

Dit is een optioneel veld en als het niet opgegeven is, worden beide soorten doorgegeven.





Onderneming

Geeft de functies weer die de onderneming in andere ondernemingen uitoefent.

0 of 1

Niet functioneel op dit moment.



Activiteiten

Geeft Activiteiten

0 of 1



GerelateerdeOndernemingen







Aanduiding

geeft gerelateerde ondernemingen

0 of 1





Vestigingen

Geeft GerelateerdeOndernemingen van vestigingen (Belangrijk indien een vestiging wordt gezocht en men wil de maatschappelijke zetel kennen!)

0 of 1

Voor het opvragen van de maatschappelijke zetel van een vestiging moet deze parameter op 1 staan



Hoedanigheden







Aanduiding

Geeft Hoedanigheden

0 of 1





Soort

Indien aanwezig dan

      1 = “Hoedanigheden”

      2 = “Toelatingen.



ExterneIdentificaties

Geeft ExterneIdentificatie

0 of 1



Bijhuis

Geeft Bijhuis

0 of 1



AmbtshalveDoorhalingen

Geeft ambthalve doorhalingen terug.

0 of 1



Omschrijvingen







Aanduiding

Of KBO beschikbare omschrijvingen moet toevoegen aan bepaalde codes. (Dit zijn omschrijvingen die worden weergegeven in de gekozen taal)

0 of 1



Datums







Aanduiding

Geeft de geldigheidsdatums van bepaalde elementen indien aanwezig. Belangrijk: als er een begin en eind-datum wordt ingevuld in het verzoek naar KBO zal er geen rekening gehouden worden met deze flag.

0 of 1





Periode









Begin

De DatumBegin en DatumEinde maken het mogelijk om gegevens te zoeken in een bepaalde tijdsvork. Worden ze niet meegegeven naar de KBO, dan komt enkel de huidge toestand terug.

Ter info: De KBO webservice zal op volgende manier omgaan met de aanwezigheid van deze datums:

  1. als zowel de begindatum als de einddatum van de snapshotperiod NIET ingevuld zijn:
    dan ontvangt men enkel de actuele gegevens geldig op de datum van de aanvraag (= de datum waarop men de web services oproept)

  2. als de begin- of de einddatum of beide ingevuld zijn:
    krijgt men historische gegevens te zien, namelijk: alle gegevens waarvan de geldigheidsperiode binnen de opgegeven snapshotperiode vallen.

  • Het is toegestaan enkel de begindatum op te geven en de einddatum niet op te geven; de niet ingevulde einddatum zal door de web service geïnterpreteerd worden als de grootst mogelijke einddatum (9999-12-31)

  • Het is toegestaan enkel de einddatum op te geven en de begindatum niet op te geven; de niet ingevulde begindatum zal door de web service geïnterpreteerd worden als de kleinst mogelijke begindatum (0001-01-01)

  • Als men een volledige historiek wil opvragen, kan men best 0001-01-01 opgeven als begindatum en 9999-12-31 als einddatum

  • Als zowel begin-als einddatum ingevuld worden, moet de begindatum kleiner zijn dan de einddatum

  • Het opvragen van historische gegevens via het invullen van begin- of einddatum of beide heeft als gevolg dat de begin- en einddatum van de opgevraagde gegevens in het antwoord zullen opgenomen worden, zelfs indien de includeDates vlag op ‘false’ zou staan.







Einde



Taal

De taal waarin de velden inhoudelijk zullen terugkomen indien het veld een vertaling heeft in de gekozen taal.

De toegelaten waardes voor taal zijn volgende:

  • nl : Nederlands

  • fr : Frans

  • de : Duits

  • en : Engels


De beschrijvingen van codes en uitzonderingen zullen altijd in het Nederlands doorkomen.

Validaties op vraag

Element

Omschrijving van de validatie

Mogelijke Foutcodes

Ondernemingsnummer

Checksum 97 validatie op het ingegeven ondernemingsnummer

20007

Datums/Periode/Begin

Validatie of de begindatum kleiner is of gelijk aan de einddatum

20003

Datums/Periode/Begin

Geldige datum controle

20001

Datums/Periode/Einde

Validatie of de einddatum recenter is gelijk is aan de begindatum

20003

Datums/Periode/Einde

Geldige datum controle

20001

Voorbeeld

<Inhoud> <Criteria> <Ondernemingsnummer>0400853488</Ondernemingsnummer> <Basisgegevens>1</Basisgegevens> <Omschrijvingen> <Aanduiding>0</Aanduiding> </Omschrijvingen> </Criteria> <Taal>nl</Taal> </Inhoud>
<Inhoud> <Criteria> <Ondernemingsnummer>0400853488</Ondernemingsnummer> <Basisgegevens>1</Basisgegevens> <Vestigingen> <Aanduiding>1</Aanduiding> <Details>0</Details> </Vestigingen> </Criteria> <Taal>nl</Taal> </Inhoud>
<Inhoud> <Criteria> <Ondernemingsnummer>0400853488</Ondernemingsnummer> <Basisgegevens>1</Basisgegevens> <Datums> <Aanduiding>0</Aanduiding> </Datums> </Criteria> <Taal>nl</Taal> </Inhoud>

Op deze pagina


Binnen deze handleiding


Met vragen kunt u steeds terecht bij de MAGDA Service Desk.

 


Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren

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

uitgegeven door Digitaal Vlaanderen