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. |
Doel: Met dit sjabloon kan u eenvoudig een nieuwe diensthandleiding aanmaken in Confluence. Gebruik de onderstaande knoppen om nieuwe componenten binnen de handleiding aan te maken. To do: - Vul de onderstaande handleidingsparagrafen in - Maak o.b.v. de specificaties van de dienst relevante subpagina's aan - Verwijder lege of niet-gebruikte paragrafen & pagina's - Let op: Gebruik de volledige naam van de dienst (Domein.DienstNaam-Versie).
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. |
Deze dienst kadert binnen het domein Onderneming van het MAGDA platform.
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
Van waar komen de gegevens in deze dienst? NOOT: Verwijder indien er geen externe gegevensbronnen zijn of deze mededeling niet relevant is onderstaande informatiebel.
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.
Opmerking:Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens. |
Heeft de afnemer speciale toelatingen / machtigingen nodig voor consumeren van deze dienst?
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.
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. |
Is deze dienst in batchvorm beschikbaar? Zo ja, laat deze paragraaf staan met generieke informatie over batchdiensten en voeg eventueel relevante dienstspecifieke informatie toe.
Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.
Prefix | GOND |
---|---|
Voorbeeld | GOND_20131103115553530.xml |
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.
De gebruiker voert een request uit op basis van het ondernemingsnummer of vestigingsnummer.
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.
Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:
Zijn er specifieke parameters die ingesteld kunnen worden?
Configuratieparameters op het MAGDA platform zijn voor deze dienst niet van toepassing
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.
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.
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. |
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 |
Verwante diensten
Met vragen kunt u steeds terecht bij de MAGDA Service Desk. |