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 4 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/

KBO
Address/
Opmerking
@DatumBeginValidityPeriod/BeginOvernemen in formaat jjjj-mm-dd
@DatumEindeValidityPeriod/EndOvernemen in formaat jjjj-mm-dd
Straat-Niet invullen. Waarde zit in Descripties
Straat/CodeAddress/Address/belgian-address/streetcodeOvernemen
Straat/Naam-Niet invullen. Waarde zit in Descripties
HuisnummerAddress/Address/belgian-address/house-number
Address/foreign-address/house-number
Overnemen
BusnummerAddress/belgian-address/postbox
Address/foreign-address/postbox
Overnemen
Gemeente/NISCodeAddress/Address/belgian-address/niscodeOvernemen
Gemeente/PostCodeAddress/belgian-address/postcode
Address/foreign-address/postcode
Overnemen
Gemeente/Naam

Land/ISOCodeAddress/belgian-address/country-code
Address/foreign-address/country-code
Overnemen
De documentatie van KBO vermeld hier dat de waarde ‘XZ’ mogelijks kan terugkomen indien de informatie niet beschikbaar is.
Land/NISCodeAddress/belgian-address/country-code@CBEoldCountryCode
Address/foreign-address/country-code@CBEoldCountryCode
Overnemen
Land/Naam
@runtime op basis van NISCode
StaatAddress/foreign-address/stateKomt alleen voor in foreign-address
Type/CodeAddress/belgian-address/kboUsage/address-type (nieuw element)
Address/foreign-address/kboUsage/address-type (nieuw element)
Overnemen
Type/OmschrijvingAddress/belgian-address/kboUsage/description (nieuw element)
Address/foreign-address/kboUsage/description (nieuw element)
Overnemen
Descripties/Descriptie--
Descripties/Descriptie/Adres/Straat--
Descripties/Descriptie/Adres/Straat/CodeAddress/belgian-address/streetcodeKomt alleen voor in belgian-address.
Descripties/Descriptie/Adres/Straat/NaamAddress/belgian-address/descriptions/street
Address/foreign-address/descriptions/street
Overnemen
Descripties/Descriptie/Adres/Huisnummer-Wordt niet ingevuld
Descripties/Descriptie/Adres/Busnummer-Wordt niet ingevuld
Descripties/Descriptie/Adres/Gemeente--
Descripties/Descriptie/Adres/Gemeente/NISCodeAddress/belgian-address/NISCode

Overnemen
Komt alleen voor in belgian-address

Descripties/Descriptie/Adres/Gemeente/PostCode-Wordt niet ingevuld
Descripties/Descriptie/Adres/Gemeente/NaamAddress/belgian-address/descriptions/municipalityOvernemen
Descripties/Descriptie/Adres/Land/NISCode-Wordt niet ingevuld
Descripties/Descriptie/Adres/Land/ISOCode-Wordt niet ingevuld
Descripties/Descriptie/Adres/Land/NaamAddress/belgian-address/descriptions/country
Address/foreign-address/descriptions/country
Overnemen
Descripties/Descriptie/Contact/TelefoonnummerZie Contactgegevens elementMapping via logica vanuit contact info. Zie hieronder
Descripties/Descriptie/Contact/FaxnummerZie Contactgegevens elementMapping via logica vanuit contact info. Zie hieronder
Descripties/Descriptie/Contact/GSMZie Contactgegevens elementMapping via logica vanuit contact info. Zie hieronder
Descripties/Descriptie/Contact/EmailZie Contactgegevens elementMapping via logica vanuit contact info. Zie hieronder
Descripties/Descriptie/Contact/WebsiteZie Contactgegevens elementMapping via logica vanuit contact info. Zie hieronder
Descripties/Descriptie/TaalcodeAddress/belgian-address/descriptions/language
Address/foreign-address/descriptions/language
Overnemen
Descripties/Descriptie/AanvullingAddress/belgian-address/descriptions/details
Address/foreign-address/descriptions/details
Overnemen
DoorhalingenExOfficioExecutionZie Doorhalingen op de meermaals gebruikte elementen pagina

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