| Table of Contents |
|---|
...
...
...
Visueel
Elementen
De attributen zijn van toepassing op het parent element van het ValidityPeriod element.
...
KBO
../ValidityPeriod
...
ExOfficioExecution
Dit element komt op heel veel plaatsen voor in de XSD. Er zal steeds naar deze omschrijving gerefereerd worden in plaats van het steeds de dochter elementen te omschrijven.
Er zijn slechts twee elementen die gemapt worden
...
Alle andere ExOfficioExecution elementen worden niet overgenomen.
Filtering in logica
KBO heeft met het ExOfficioExecution element het mogelijk gemaakt om niet alleen doorhalingen door te geven, maar alle administratieve handelingen. Daar versie 1.6 van de WSConsultKBO dienst enkel doorhalingen doorgeeft is het noodzakelijk om in de 3.0 versie enkel deze handelingen eruit te filteren en door te geven. Deze filtering kan gebeuren op het ActionCode element. Als dit element gelijk is aan '001' dient het element overgenomen te worden volgens onderstaande specificaties.
Visueel KBO
Visueel MAGDA
| Note |
|---|
Opmerking:Eind Q1 2019 is een nieuwe versie van de GeefOnderneming 2.0 dienst in productie gegaan die gebruik maakt van de WSConsultKBO 3.0 dienst bij BOSA welke de R33 data gebruikt van KBO. Dit heeft gevolgen voor de contactgegevens. Zie op de "Update Q1 2019" pagina voor meer details! |
Visueel
Elementen
MAGDA |
|---|
...
...
...
Address
Dit element wordt gebruikt in
- Bijhuis/Adres
- Adressen/Adres
Visueel KBO
Address
belgian-address
foreign-address
Visueel MAGDA
Elementen
De tekstuele elementen van het adres zijn opgenomen in het Descriptions element. Dit om vertalingen mogelijk te maken. Numerieke elementen zitten gewoon in het adres zelf.
...
MAGDA
Adres/
...
De reden van de doorhaling CODE OMSCHRIJVING | |
Reden/Omschrijving | Omschrijving van de doorhaling |
Voorbeeld
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
Adres
In een Belgisch adres komt mogelijks een straatcode of NIScode van de gemeente terug en in het buitenlandse adres is er mogelijks nog een extra melding van de staat (alleen in bepaalde gevallen, zoals bv. de naam van een staat in de VSA).
Er kunnen in het antwoord mogelijks 0 tot meerdere ‘descriptions’ staan. Deze descriptions geven o.m. de naam van de straat in een taal en mogelijke contactinformatie
Dit element wordt gebruikt in
Bijhuis/Adres
Adressen/Adres
Visueel
Elementen
MAGDA Adres/ | Opmerking |
|---|---|
@DatumBegin | Begindatum van geldigheid gegevens Formaat jjjj-mm-dd |
@DatumEinde |
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
KBO heeft de contactinformatie uit het adres gehaald zonder enige referentie ernaartoe. Daarenboven is het contact element genormaliseerd en kunnen verschillende types van data (faxnummer, telefoonnummer, etc.) verschillende malen voorkomen. Dit genereert twee problemen
...
...
Volgens de informatie van BOSA bestaan er geen ondernemingen met meerdere contactgegevens van hetzelfde type. In de MAGDA XSD is voor elk type slechts 1 element voorzien. Door telkens het eerste gegeven van een bepaald type te mappen naar het respectievelijk MAGDA element kan dit probleem opgelost worden. Het probleem van de koppeling tussen de contactgegevens en het adres blijft echter bestaan. Er is op dit moment nog geen bevestiging of er ook slechts 1 adres per onderneming voorkomt in de database van KBO (zoals bij de contactgegevens ook het geval is). Indien dit het geval is is er op dit moment geen probleem.
De enigste werkbare oplossing voor dit probleem is voor elk adres telkens de eerste contactgegevens te gebruiken van elk type. Dit wil zeggen dat als er meerdere adressen zijn, deze dezelfde contactgegevens zullen krijgen. Dit is de enigste werkbare oplossing zonder expliciete chaos te creëren. De overgrote meerderheid van de bedrijven in de KBO database zullen slechts 1 adres hebben (nog te bevestigen) dus is dit probleem beperkt tot een kleine subset.
Logica
Loop over de ContactInformation elementen
- Als de waarde van ValidityPeriod/End kleiner is dan "Vandaag" ga naar het volgende element. De data in dit element is immers niet meer geldig. De MAGDA contactinformatie kent geen historische data, dus mag vervallen data niet worden doorgegeven worden.
- Controleer de waarde van het ContactType element
- Map de waarde naar het juiste MAGDA element volgens de waarde van het ContactType element (zie lijst hieronder)
- Indien het MAGDA element reeds ingevuld is, lees het volgende Contact element in.
Let op! Voor het adres in het Bijhuis element zijn aparte contactgegevens beschikbaar. Het spreekt voor zich dat deze contactgegevens bij het adres van het bijhuis horen.
Visueel KBO
Visueel MAGDA
Elementen
...
WSConsultKBO v3.0
../ContactInformation
...
Value[ContactType=’001’]
...
Value[ContactType=’002’]
...
Niet beschikbaar
...
Value[ContactType=’004’]
...
dienst in productie gaan die gebruik zal maken van de WSConsultKBO 3.0 dienst bij BOSA welke de R33 data gebruikt van KBO. Dit heeft gevolgen voor de contactgegevens. Zie op de "Update Q1 2019" pagina voor meer details! |
Visueel
Elementen
MAGDA 2.0 Onderneming/Bijhuis/Adres/Descripties/Descriptie/Contact | Opmerking |
|---|---|
Telefoonnummer | Telefoonnummer |
FaxNummer | Faxnummer |
GSM | GSMnummer |
Website | Website |
Namen
Een onderneming kan verschillende namen hebben, zoals een Maatschappelijke Naam of een Afgekorte Naam. Tevens kan het gebeuren dat een onderneming een naam heeft in verschillende talen.
Visueel
Mapping
MAGDA | Opmerking |
|---|---|
@DatumBegin | Begindatum van de geldigheid van de gegevens Formaat : jjjj-mm-dd (geen verplicht element, kan ontbreken in het antwoord) |
@DatumEinde | Einddatum van de geldigheid van de gegevens Formaat : jjjj-mm-dd (geen verplicht element, kan ontbreken in het antwoord) |
Naam | Maatschappelijke naam, Afgekorte naam of commerciële naam |
TaalCode | Taalcode waarin de naam wordt weergegeven |
Voorbeelden
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
| Expand | |||||
|---|---|---|---|---|---|
| |||||
|
Op deze pagina
| Table of Contents | ||||
|---|---|---|---|---|
|
Binnen deze handleiding
| Child pages (Children Display) | ||
|---|---|---|
|
| Info |
|---|
Met vragen kunt u steeds terecht bij de MAGDA Service Desk. |