DIGITAAL VLAANDEREN

Skip to end of metadata
Go to start of metadata

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


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