Meermalig gebruikte elementen - Type Onderneming 02.00

ValidityPeriod

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

Visueel

Elementen

De attributen zijn van toepassing op het parent element van het ValidityPeriod element.

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

• Enterprise/EntityCommonInfo/ExofficieExecution  wordt gemapt naar AmbtshalveDoorhalingen
• Enterprise/EntityCommonInfo/Address/ExOfficioExecution wordt gemapt naar Adressen/Adres/Doorhalingen

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

Elementen

Address

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

Contact

Dit element wordt gebruikt in het Adres element, welke voorkomt onder Adressen/Adres en Bijhuis/Adres.

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

• In de GeefOnderneming 2.0 XSD is slechts 1 element van elk type beschikbaar. Niet alle informatie kan dus overgenomen worden
• Er is geen koppeling tussen de contact informatie en de adres informatie.

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