AmbtshalveDoorhalingen en Doorhalingen
Dit element komt op twee plaatsen voor in de XSD.
- /AmbtshalveDoorhalingen
- /Adressen/Adres/Doorhalingen
Filtering in logica
KBO heeft met het ExOfficioExecution element het mogelijk gemaakt om niet alleen doorhalingen door te geven, maar alle administratieve handelingen. Om de GeefOnderneming 2.0 dienst backwards compatibel te houden met de KBO R33 data filtert MAGDA alle handelingen uit die geen doorhalingen zijn.
Visueel
Elementen
MAGDA ../AmbtshalveDoorhalingen/AmbtshalveDoorhaling | Opmerking |
---|---|
@DatumBegin | Begindatum van de geldigheid van de gegevens |
@DatumEinde | Einddatum van de geldigheid van de gegevens |
Reden/Code | De reden van de doorhaling |
Reden/Omschrijving | Omschrijving van de doorhaling |
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
MAGDA Adres/ | Opmerking |
---|---|
@DatumBegin | Begindatum van geldigheid gegevens Formaat jjjj-mm-dd |
@DatumEinde | Einddatum geldigheid van gegevens Formaat jjjj-mm-dd |
Straat | - |
Straat/Code | Overnemen |
Straat/Naam | Niet invullen. Waarde zit in Descripties |
Huisnummer | Overnemen |
Busnummer | Overnemen |
Gemeente/NISCode | Overnemen |
Gemeente/PostCode | Overnemen |
Gemeente/Naam | |
Land/ISOCode | Overnemen De documentatie van KBO vermeld hier dat de waarde ‘XZ’ mogelijks kan terugkomen indien de informatie niet beschikbaar is. |
Land/NISCode | Overnemen |
Land/Naam | @runtime op basis van NISCode |
Staat | Komt alleen voor in foreign-address |
Type/Code | Overnemen |
Type/Omschrijving | Overnemen |
Descripties/Descriptie | - |
Descripties/Descriptie/Adres/Straat | - |
Descripties/Descriptie/Adres/Straat/Code | Komt alleen voor in belgian-address. |
Descripties/Descriptie/Adres/Straat/Naam | Overnemen |
Descripties/Descriptie/Adres/Huisnummer | Wordt niet ingevuld |
Descripties/Descriptie/Adres/Busnummer | Wordt niet ingevuld |
Descripties/Descriptie/Adres/Gemeente | - |
Descripties/Descriptie/Adres/Gemeente/NISCode | Overnemen |
Descripties/Descriptie/Adres/Gemeente/PostCode | Wordt niet ingevuld |
Descripties/Descriptie/Adres/Gemeente/Naam | Overnemen |
Descripties/Descriptie/Adres/Land/NISCode | Wordt niet ingevuld |
Descripties/Descriptie/Adres/Land/ISOCode | Wordt niet ingevuld |
Descripties/Descriptie/Adres/Land/Naam | Overnemen |
Descripties/Descriptie/Contact/Telefoonnummer | Mapping via logica vanuit contact info. Zie hieronder |
Descripties/Descriptie/Contact/Faxnummer | Mapping via logica vanuit contact info. Zie hieronder |
Descripties/Descriptie/Contact/GSM | Mapping via logica vanuit contact info. Zie hieronder |
Descripties/Descriptie/Contact/Email | Mapping via logica vanuit contact info. Zie hieronder |
Descripties/Descriptie/Contact/Website | Mapping via logica vanuit contact info. Zie hieronder |
Descripties/Descriptie/Taalcode | Overnemen |
Descripties/Descriptie/Aanvulling | Overnemen |
Doorhalingen | Zie Doorhalingen hierboven |
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
MAGDA 2.0 Onderneming/Adressen/Adres/Descripties/Descriptie/Contact | WSConsultKBO v3.0 |
---|---|
Telefoonnummer | Value[ContactType=’001’] |
FaxNummer | Value[ContactType=’002’] |
GSM | Niet beschikbaar |
Value[ContactType=’004’] | |
Website | Value[ContactType=’003’] |