Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
| Info |
|---|
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. |
| Excerpt | ||
|---|---|---|
| ||
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. |
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.
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.
| Note |
|---|
Opmerking:Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens. |
| Info |
|---|
Informatie:Eind Q1 2019 zal een nieuwe versie van de GeefOnderneming 2.0 dienst in productie gaan die gebruik zal maken van de WSConsultKBO 3.0 (release 33) dienst bij BOSA. Deze versie is bijna volledig backwards compatibel. Zie op de "Update Q1 2019" pagina voor meer details! |
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.
| Info |
|---|
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 | GONK |
|---|---|
Voorbeeld | GONK_20131103115553530 |
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.
| Drawio | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
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
| Anchor | ||||
|---|---|---|---|---|
|
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.
| Note |
|---|
Opmerking:De MAGDA response tijden zijn heel sterk afhankelijk van de response tijden van de bron. Als de brongegevens heel traag worden aangeleverd kan het MAGDA antwoord niet snel worden aangeleverd. |
Logging
De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".
Op deze pagina
| Table of Contents | ||
|---|---|---|
|
Binnen deze handleiding
| Child pages (Children Display) |
|---|
Omgevingsinformatie
Domein | Onderneming |
|---|---|
Classificatie | Geen persoonsgegevens In geval Natuurlijke Personen: Persoonsgegevens |
Verwante diensten
| Child pages (Children Display) | ||
|---|---|---|
|
| Info |
|---|
Met vragen kunt u steeds terecht bij de MAGDA Service Desk. |