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.
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:
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
Opties
Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:
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".