De webservice GeefOnderneming 2.0 laat de afnemer van het MAGDA platform toe de ondernemingsgegevens rechtstreeks bij KBO op te vragen aan de hand van het KBOnummer. 

Situering

Deze dienst kadert binnen het domein Onderneming van het MAGDA platform.

Verwante diensten

De afnemer kan gebruik maken van de dienst ZoekOnderneming 02.00 om ondernemingen en vestigingen bij de KBO op te zoeken, gegevens uit deze dienst kunnen dan weer gebruikt worden om GeefOnderneming te consumeren.

• GeefOndernemingVKBO-2.0

• ZoekOnderneming 2.0

• PubliceerOndernemingVKBO

Gegevensbronnen

De gegevens zijn deze 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 WSConsultKBO webservice bij BOSA.

Huidige KBO versie: release 29.

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.

Functionaliteiten

De webservice GeefOnderneming 2.0 laat de afnemer van het MAGDA platform toe de ondernemingsgegevens rechtstreeks bij KBO op te vragen.

Vraag

In de vraag kan de afnemer opgegeven welke gegevens gewenst zijn, of omschrijvingen al dan niet mee moeten komen en of de geldigheidsdatums van gegevens moeten terugkomen.

Antwoord

De gegevens worden opgevraagd bij KBO, omgezet naar een antwoord conform de MAGDA richtlijnen en doorgegeven aan de afnemer. 

Werking

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.

Hierna vindt er een functionele validatie plaats van de vraag. Voldoet er één element niet aan de opgelegde functionele criteria, stopt de verwerking en bekomt men een uitzondering.

Bij succesvolle functionele validatie 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 validaties succesvol, dan verkrijgt MAGDA de gegevens 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

Verwante diensten