Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Onderneming.ZoekOnderneming-02.00

Om gebruik te kunnen maken van deze dienst dient men een machtiging te hebben die toegang geeft tot deze gegevens en een aansluitingsprocedure te doorlopen.

Informatie:

Voor de ontsluiting van een MAGDA 2.0 webservice, alsook het generieke proces binnen een 2.0 webservice, wordt verwezen naar Werking en gebruik MAGDA 2.0 Webservices.

De webservice ZoekOnderneming-02.00 laat de gebruiker toe rechtstreeks bij KBO ondernemingen en vestigingen op te zoeken op basis van naam of adres.

Situering

Verwante diensten

Gegevensbronnen

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 29.

Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.

Opmerking:

Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens. 

Gebruiksvoorwaarden

Om gebruik te kunnen maken van deze dienst dient men een machtiging te hebben die toegang geeft tot deze gegevens en een aansluitingsprocedure te doorlopen:

  • Toelating tot het gebruik van de webservice ZoekOnderneming 2.0

Informatie:

Meer informatie over deze voorwaarden is terug te vinden op de pagina “Machtigingen en toelatingen”.

Meer informatie over het aansluitingsproces is terug te vinden op deze webpagina.

Batch

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.

Prefix

ZOND

Voorbeeld

ZOND_20131103115553530.

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.

Vraag

Voor meer informatie in verband met de mogelijke criteria in de vraagstelling, raadpleeg de pagina "Beschrijving Vraag".

Antwoord

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

Werking

Aandachtspunten

  • 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. Zie de pagina "Verschillen tegenover vorige versie" voor meer informatie hierover.

Opties

Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:

  • Configuratieparameters op het MAGDA platform zijn voor deze dienst niet van toepassing

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.

Responsetijden & Beschikbaarheid

De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar.

Logging

De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".

Op deze pagina


Binnen deze handleiding


Omgevingsinformatie

Domein

Onderneming

Classificatie

Geen persoonsgegevens


Verwante diensten



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