Dagelijks worden de gewijzigde adressen van ondernemingen en vestigingen uit KBO binnen MAGDA verrijkt met een GRAR adres en adreslocaties. Deze gegevens worden binnen het MAGDA platform bewaard en gepubliceerd naar geïnteresseerde afnemers toe. Deze publicatie levert KBO en GRAR adressen met bijhorende GRAR adrespositie. (GRAR staat voor Gebouwen- & AdressenRegister)

Situering

Dit document beschrijft het gebruik en de werking van PubliceerAdressenLocaties-02.02 zoals deze door MAGDA aangeboden wordt.

Het voornaamste verschil met de PubliceerAdressenLocaties 02.00 is dat deze gegevens gepubliceerd worden op basis van GRAR i.p.v. CRAB.

Een overzicht met de wijzigingen is verder in dit document terug te vinden.

De gepubliceerde gegevens zijn beschikbaar in XML en als CSV.

Verwante diensten

https://vlaamseoverheid.atlassian.net/wiki/spaces/MG/pages/6502350849 :  Deze dienst stelt de afnemer in staat om punctuele bevragingen uit te voeren op de door MAGDA bewaarde GRAR gegevens.

Gegevensbronnen

De oorspronkelijke bronnen van deze gegevens zijn KBO en GRAR. Digitaal Vlaanderen is dan ook afhankelijk van deze bronnen voor de kwaliteit en de aanlevering van de gegevens. Opmerking hierbij is dat GRAR momenteel een beperking heeft die maakt dat er max. 10 adressen per KBO adres teruggegeven kunnen worden.

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:

• Toelating tot de publicatie PubliceerAdressenLocaties 02.02

Batch

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.

Functionaliteiten

Dagelijks worden de gemuteerde KBO adressen binnen MAGDA verstuurd naar GRAR. GRAR zal deze adressen verrijken met een GRAR adres en adreslocatie. Deze gegevens worden binnen het MAGDA platform bewaard en gepubliceerd naar geïnteresseerde afnemers toe.

Elke afnemer heeft daarbij de mogelijkheid om in samenspraak met Digitaal Vlaanderen te bepalen welke gegevens gevraagd worden, op basis van welke criteria deze geselecteerd moeten worden en met welke frequentie die zouden moeten aangeleverd worden.

De gegevens zijn beschikbaar in XML als CSV en worden beschikbaar gesteld op de MAGDA FTP server.

De exacte locatie van deze folder en de naam wordt in samenspraak met Digitaal Vlaanderen bij aansluiting beslist. De folderstructuur en de manier waarop de gegevens opgehaald kunnen worden, wordt beschreven in de FTP richtlijnen [FTP].

In het geval er geen gegevens geselecteerd zouden worden, wordt er standaard geen bestand aangemaakt, tenzij de afnemer uitdrukkelijk vraagt om in dat geval toch een uitzonderingsbestand aan te leveren.

Werking

Opties

Volgende afleveropties zijn mogelijk:

• compressie van het bestand in .zip

• bundeling van bestanden (gezamelijke aflevering van meerdere publicaties)

• compressie van de bundeling

• borderelbestand (oplijsting afgeleverde bestanden, enkel mogelijk indien bundeling)

• uitzonderingsbestand / leeg bestand (indien er geen gegevens te publiceren zijn, verkrijgt men toch een bestand)

• controlebestand (bevat een md5, gebruikte encoding, gebruikte en volgende herstartdatum)

Voor meer informatie rondom deze afleveropties wordt verwezen naar de beschikbare documentatie.

Opvraging

De gegevens worden verdeeld op basis van de criteria die besproken worden tijdens het aansluitingsproces of voorafgaande gesprekken.

Verfijnde selecties zijn mogelijk, gelieve hiervoor contact op te nemen met de MAGDA Service Desk. Voorbeelden van dergelijke selecties: enkel ondernemingen uit eigen klantenlijst, ondernemingen uit bepaalde gemeente, …

Responsetijden & Beschikbaarheid

MAGDA verwerkt de door AGIV en KBO verkregen gegevens 7 dagen op 7.

De periodiciteit van aanlevering via MAGDA is te bespreken tijdens het aansluitingsproces of voorafgaande besprekingen. Algemeen beschouwd is het mogelijk de gegevens dagelijks, wekelijks, … aan te bieden.

Logging

De gegevens in het bestand worden bewaard zoals beschreven in het document "MAGDA logging" [ML].

Bestanden worden gedurende een beperkte tijd aangeboden op de FTP folder zoals beschreven in de FTP richtlijnen. [FTP]

Ondersteunde talen

MAGDA ondersteunt de Nederlandse taal.

Indien in de brongegevens de Nederlandse tekst niet beschikbaar is voor een bepaald element zal de eerste vertaling van de tekst in de brongegevens gebruikt worden, onafhankelijk van de taal waarin dit gegeven beschikbaar is.

Op deze pagina

Binnen deze handleiding

Omgevingsinformatie

Verwante diensten