Situering

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

Verwante diensten

• RegistreerInschrijving 2.01 : Voor het registreren (en verwijderen) van ondernemingen en vestigingen indien een publicatie op basis van de klantenlijst gewenst is.

• PubliceerOndernemingVKBO 2.0 : Publicatie (FTP) van de ondernemingsgegevens in OndernemingVKBO 2.0 formaat. De publicatie is beschikbaar in xml als csv

• ZoekOnderneming 2.0

• GeefOnderneming-02.00

Gegevensbronnen

De authentieke bron van de gegevens is de KBO. 

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.

Functionaliteiten

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

Met de OndernemingVKBO 2.0 streeft MAGDA VKBO naar éénzelfde formaat voor zowel de GeefOndernemingVKBO 02.00, PubliceerOndernemingVKBO 2.0 en de toekomstige ZoekOndernemingVKBO 2.0.

Ten opzicht van de vorige versies bevat de OndernemingVKBO 2.0 bijkomende informatie met betrekking tot de adresdoorhaling en ambtshalve doorhaling.

Vraag

De gebruiker voert een request uit op basis van het ondernemingsnummer of vestigingsnummer.

Antwoord

Als antwoord verkrijgt men de actuele gegevens van de gevraagde onderneming of vestiging.

Het antwoord bevat gegevens als

• De status van onderneming / vestiging

• Van de vestiging de maatschappelijke zetel (ondernemingsnummer)

• Rechtsvorm en rechtstoestand

• Adres (en adres doorhaling)

• Maatschappelijke naam, afgekorte naam, commerciële naam

• Ambtshalve doorhaling

Deze dienst vraagt de gegevens op in de MAGDA VKBO databank en niet rechtstreeks bij KBO.

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 XML 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. 

Bovendien gebeurt er een controle op het Ondernemingsnummer-element, namelijk dat dit voldoet aan het 97-controlecijder. Daarna worden de van het opgegeven nummer de gegevens in de VKBO-databank opgezocht.

Indien er geen gegevens gevonden werden voor de vraag verkrijgt men als fout 30001. Bekomt men gegevens, dan worden deze omgezet naar een Onderneming binnen het Antwoord/Inhoud-element.

Het antwoord wordt gevalideerd tegenover de xsd waarna het aan de afnemer ter beschikking gesteld wordt.

Responsetijden & Beschikbaarheid

De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar. Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht via mail.

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