- Created by Laurens Debackere, last modified by Pedro Devogelaere on 05 Aug, 2021
You are viewing an old version of this page. View the current version.
Compare with Current View Page History
« Previous Version 23 Next »
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 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.
Wijzigingshistoriek
Datum | Aanpassingen |
|---|---|
| Importeren van de handleiding in Confluence |
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.
Opmerking:
Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens.
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 gebruikt te kunnen maken van deze dienst dient men een machtiging te hebben die toegang geeft tot deze gegevens en een aansluitingsprocedure te doorlopen.
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.
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.
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
Binnen deze handleiding
- Type Onderneming-02.00
- Onderneming.GeefAdressenLocaties-02.00
- Onderneming.GeefBeschikbareJaarrekeningen-02.00
- Onderneming.GeefDeelnemingen-02.00
- Onderneming.GeefFiscaleInhoudingsplicht-02.01
- Onderneming.GeefFiscaleSchuld-02.00
- Onderneming.GeefFuncties-02.00
- Onderneming.GeefJaarrekeningen-02.00
- Onderneming.GeefOnderneming-02.00
- Onderneming.GeefOndernemingVKBO-02.00
- Onderneming.GeefOndernemingSignalen-02.00
- Onderneming.GeefPCenTW-02.00
- Onderneming.GeefSocialeSchuld-02.00
- Onderneming.GeefTewerkstelling-02.00
- Onderneming.PubliceerAdressenLocaties-02.00
- Onderneming.PubliceerAdressenLocaties-02.02
- Onderneming.PubliceerDeelnemingen-02.00
- Onderneming.PubliceerFaillisementsignalen-02.00
- Onderneming.PubliceerFuncties-02.00
- Onderneming.PubliceerGeannuleerdeOndernemingen-02.00
- Onderneming.PubliceerOndernemingVKBO-02.00
- Onderneming.PubliceerRSZDagvaarding-02.00
- Onderneming.PubliceerSocialeSchuld-02.00
- Onderneming.ZoekOnderneming-02.00
- Onderneming.ondernemingen/adressenLocaties - v1
- Company
Omgevingsinformatie
Domein | Onderneming |
|---|---|
Classificatie | Geen persoonsgegevens In geval Natuurlijke Personen: Persoonsgegevens |
Verwante diensten
-
Page:Onderneming.GeefOnderneming-02.00 (MAGDA Gebruikersomgeving) — 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.
-
Page:Onderneming.GeefOndernemingVKBO-02.00 (MAGDA Gebruikersomgeving) — De dienst ‘GeefOndernemingVKBO 2.0’ geeft de basis-identificatiegegevens van een onderneming of vestiging terug aan de hand van het ondernemingsnummer of het vestigingsnummer. De onderliggende data bevindt zich in de VKBO-databank die gevoed en beheerd wordt door de KBO-provisionering.
-
Page:Onderneming.GeefSocialeSchuld-02.00 (MAGDA Gebruikersomgeving) — Hoe weet u of uw onderaannemers al dan niet schulden hebben? Zijn ze niet in orde met de RSZ, dan is dat meestal een teken aan de wand en is voorzichtigheid meer dan geboden. Want u wil uw afspraken nakomen en met een onderneming op de rand van het bankroet doet u liever geen zaken.
U kunt hiermee de informatie van het attest 30 bis opvragen en zo te weten komen of er een inhoudingsplicht van kracht is.
-
Page:Onderneming.PubliceerGeannuleerdeOndernemingen-02.00 (MAGDA Gebruikersomgeving) — De PubliceerGeannuleerdeOndernemingen 2.0 laat toe om vanuit VKBO de bij KBO geannuleerde ondernemingen en vestigingen te publiceren in XML- als in CSV-formaat.
-
Page:Onderneming.PubliceerOndernemingVKBO-02.00 (MAGDA Gebruikersomgeving) — MAGDA ontvangt van dinsdag tot en met zaterdag vanuit KBO gegevens met betrekking tot ondernemingen. Deze gegevens worden binnen het MAGDA platform bewaard (in de VKBO-databank) en gepubliceerd naar geïnteresseerde afnemers toe met de dienst PubliceerOndernemingVKBO 02.00.
-
Page:Onderneming.ZoekOnderneming-02.00 (MAGDA Gebruikersomgeving) — De webservice ZoekOnderneming-02.00 laat de gebruiker toe rechtstreeks bij KBO ondernemingen en vestigingen op te zoeken op basis van naam of adres.
Met vragen kunt u steeds terecht bij de MAGDA Service Desk.
- No labels
