DIGITAAL VLAANDEREN

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »


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
@DatumBeginBegindatum van de geldigheid van de gegevens
@DatumEindeEinddatum van de geldigheid van de gegevens
Reden/CodeDe reden van de doorhaling
Reden/OmschrijvingOmschrijving 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/CodeOvernemen
Straat/NaamNiet invullen. Waarde zit in Descripties
HuisnummerOvernemen
BusnummerOvernemen
Gemeente/NISCodeOvernemen
Gemeente/PostCodeOvernemen
Gemeente/Naam
Land/ISOCodeOvernemen
De documentatie van KBO vermeld hier dat de waarde ‘XZ’ mogelijks kan terugkomen indien de informatie niet beschikbaar is.
Land/NISCodeOvernemen
Land/Naam@runtime op basis van NISCode
StaatKomt alleen voor in foreign-address
Type/CodeOvernemen
Type/OmschrijvingOvernemen
Descripties/Descriptie-
Descripties/Descriptie/Adres/Straat-
Descripties/Descriptie/Adres/Straat/CodeKomt alleen voor in belgian-address.
Descripties/Descriptie/Adres/Straat/NaamOvernemen
Descripties/Descriptie/Adres/HuisnummerWordt niet ingevuld
Descripties/Descriptie/Adres/BusnummerWordt niet ingevuld
Descripties/Descriptie/Adres/Gemeente-
Descripties/Descriptie/Adres/Gemeente/NISCode

Overnemen
Komt alleen voor in belgian-address

Descripties/Descriptie/Adres/Gemeente/PostCodeWordt niet ingevuld
Descripties/Descriptie/Adres/Gemeente/NaamOvernemen
Descripties/Descriptie/Adres/Land/NISCodeWordt niet ingevuld
Descripties/Descriptie/Adres/Land/ISOCodeWordt niet ingevuld
Descripties/Descriptie/Adres/Land/NaamOvernemen
Descripties/Descriptie/Contact/TelefoonnummerMapping via logica vanuit contact info. Zie hieronder
Descripties/Descriptie/Contact/FaxnummerMapping via logica vanuit contact info. Zie hieronder
Descripties/Descriptie/Contact/GSMMapping via logica vanuit contact info. Zie hieronder
Descripties/Descriptie/Contact/EmailMapping via logica vanuit contact info. Zie hieronder
Descripties/Descriptie/Contact/WebsiteMapping via logica vanuit contact info. Zie hieronder
Descripties/Descriptie/TaalcodeOvernemen
Descripties/Descriptie/AanvullingOvernemen
DoorhalingenZie 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
../ContactInformation

Telefoonnummer

Value[ContactType=’001’]

FaxNummer

Value[ContactType=’002’]

GSM

Niet beschikbaar

Email

Value[ContactType=’004’]

Website

Value[ContactType=’003’]

  • No labels