Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Interface (PubliceerFuncties-02.00)

Informatie:

De XML en CSV bestanden die via FTP gepubliceerd worden dienen te voldoen aan de MAGDA richtlijnen. Voor meer informatie over hoe een Publicatie-dienst algemeen gebruikt dient te worden, bekijk Bestandsuitwisseling (Publicaties/batchverwerking).

De gegevens zijn beschikbaar in zowel XML als CSV  en opgebouwd volgens de MAGDA richtlijnen.

Algemeen

In deze sectie bespreken we de praktische werking van deze publicatiedienst met eventuele specifieke opmerkingen.

Bestandsnaam

Opmerking:

De exacte bestandsnaam wordt pas meegedeeld tijdens het aansluitingsproces. De gegevens die u hier vindt kunnen dus mogelijk wijzigen.

De bestandsnaam is van de vorm prefix_publicatienaam_timestamp.extensie.

Voorbeeld

Pub_PubliceerFuncties_20140224155516000.xml

Publicatie in XML

Algemeen

De inhoud bestaat uit een publicatie van één of meerdere (gewijzigde) functies. Of in geval dat er een uitzonderingsbestand gevraagd werd, kan dit ook de Uitzondering 15015 bevatten (zie ook 3.3.4).

Informatie:

De publicatie in XML bevat een standaard context zoals de andere MAGDA publicaties. Dit naar analogie met de contextbeschrijving voor webservices, bekijk hiervoor eens de handleiding Webservices 02.00.

XSD

De bestanden die worden aangeboden op de outputfolder zijn gevalideerd volgens de service-xsd horende bij deze dienst. De actuele xsd is ter beschikking op aanvraag.

Elementen

Onderstaande afbeelding toont de elementen vanaf het Inhoud-element. Elke gepubliceerde functie komt in een nieuw Onderwerp-element. Er komen geen Metadata-gegevens terug in de publicatie.

Visueel

Detail

Element

Kardinaliteit

Beschrijving

DatumModificatie

Optioneel

Modificatiedatum van het record

AuthentiekeBron

Verplicht

Informatie over de authentieke bron

    Code

Verplicht

Bron van de gegevens. Altijd ‘03’

    Omschrijving

Optioneel

Naam van de bron. Altijd ‘KBO’

FunctiehouderVan

Verplicht

Het nummer van de onderneming voor dewelke de functie uitgeoefend wordt

AanduidingPersoonOnderneming

Verplicht

Geeft aan of de functie uitgeoefend wordt door een natuurlijke persoon en/of een onderneming

    Code

Verplicht

1, 2, 3 of 0 (zie omschrijving)

    Omschrijving

Optioneel

Indien Code 1: ‘Vertegenwoordiging door natuurlijke persoon’

Indien Code 2: ‘Vertegenwoordiging door onderneming’

Indien Code 3: ‘Vertegenwoordiging door natuurlijke persoon en onderneming’

Indien Code 0: ‘Geen vertegenwoordiging’

INSZ

Optioneel

Het rijksregisternummer van de functiehouder

Komt voor indien AanduidingPersoonOnderneming/Code = 1 of 3

Ondernemingsnummer

Optioneel

Het ondernemingsnummer van de functiehouder

Komt voor indien AanduidingPersoonOnderneming/Code = 2 of 3

VolgNummer

Verplicht

Volgnummer. Heeft geen echte betekenis. Voorbeelden: ‘001’, ‘002’

AardFunctie

Verplicht

Informatie over de aard van de functie

    Code

Verplicht

Code van de functie. Numerieke code van 5 cijfers. Zie 4.1 voor een lijst van functiecodes

    Omschrijving

Optioneel

Omschrijving van de functie.

AardFunctieCAC

Verplicht

Bevat de functie zoals die moet worden gelezen volgens de wet tot invoering van het WVV.

    Code

Verplicht

Code van de functie. Numerieke code van 5 cijfers. Zie 4.1 voor een lijst van functiecodes

    Omschrijving

Optioneel

Omschrijving van de functie.

Periode

Verplicht

Periode waarbinnen de functie geldig is

    Begin

Optioneel

Begindatum van de periode, formaat jjjj-mm-dd

    Einde

Optioneel

Einddatum van de periode, formaat jjjj-mm-dd. Heeft als waarde 9999-12-31 voor actieve functies

PeriodeCAC

Verplicht

Bevat de periode van de functie zoals die moet worden gelezen volgens de wet tot invoering van het WVV.

    Begin

Optioneel

Begindatum van de periode, formaat jjjj-mm-dd

    Einde

Optioneel

Einddatum van de periode, formaat jjjj-mm-dd. Heeft als waarde 9999-12-31 voor actieve functies

EindeFunctie

Optioneel

Informatie over de reden van beëindiging van de functie

    Code

Verplicht

Code van de reden van beëindiging. Numerieke code van 3 cijfers. Zie 4.2 voor een lijst van codes

    Omschrijving

Optioneel

Omschrijving van de reden

AanduidingVrijstelling

Verplicht

Informatie over een eventuele vrijstelling

    Code

Verplicht

Code van de vrijstelling. Bevat Y, N of 999 (zie omschrijving)

    Omschrijving

Optioneel

Indien Code Y: ‘vrijstelling bekomen’

Indien Code N: ‘geen vrijstelling bekomen’

Indien Code 999: ‘geen vrijstelling mogelijk’

SoortVrijstelling

Optioneel

Informatie over de soort van vrijstelling men bekomen heeft

    Code

Verplicht

Code van de soort vrijstelling. Numerieke code van 3 cijfers. Zie 4.3 voor een lijst van codes

    Omschrijving

Optioneel

Omschrijving van de soort vrijstelling

Uitzonderingen

Indien er gekozen werd om een uitzonderingsbestand te onvangen, komt er een Uitzondering terug met als foutcode 15015 – geen gegevens te publiceren.

<Uitzonderingen> <Uitzondering xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/"> <Identificatie>15015</Identificatie> <Oorsprong>MAGDA</Oorsprong> <Type>INFORMATIE</Type> <Tijdstip> <Datum>2014-02-24</Datum> <Tijd>15:56:16</Tijd> </Tijdstip> <Diagnose>Geen te publiceren gegevens</Diagnose> </Uitzondering> </Uitzonderingen>

Publicatie in CSV

Algemeen

De CSV bestanden voldoen aan de MAGDA richtlijnen voor publicatie diensten. De CSV één op één met de XSD vanaf het Deelneming-element. 

Voor de inhoudelijke beschrijving wordt bijgevolg verwezen naar de vorige sectie over publicatie in XML.

  • Al de elementen binnen de XSD zijn opgenomen in de CSV.

  • In geval dat er een uitzonderingsbestand gevraagd werd zal het CSV-bestand leeg zijn.

  • Elk Onderwerp-element in een XML resulteert in feite in één CSV-record.

Elementen

Kolomnummer in CSV

Overeenkomstig element in XML

(Te beginnen bij XXX)

1

DatumModificatie

2

AuthentiekeBron/Code

3

AuthentiekeBron/Code@Beschrijving

4

AuthentiekeBron/Omschrijving

5

AuthentiekeBron/Omschrijving/Oorsprong

6

AuthentiekeBron/Omschrijving/TaalCode

7

FunctiehouderVan

8

AanduidingPersoonOnderneming/Code

9

AanduidingPersoonOnderneming/Code@Beschrijving

10

AanduidingPersoonOnderneming/Omschrijving

11

AanduidingPersoonOnderneming/Omschrijving/Oorsprong

12

AanduidingPersoonOnderneming/Omschrijving/TaalCode

13

INSZ

14

Ondernemingsnummer

15

VolgNummer

16

AardFunctie/Code

17

AardFunctie/Code@Beschrijving

18

AardFunctie/Omschrijving

19

AardFunctie/Omschrijving/Oorsprong

20

AardFunctie/Omschrijving/TaalCode

21

AardFunctieCAC/Code

22

AardFunctieCAC/Code@Beschrijving

23

AardFunctieCAC/Omschrijving

24

AardFunctieCAC/Omschrijving/Oorsprong

25

AardFunctieCAC/Omschrijving/TaalCode

26

Periode/Begin

27

Periode/Einde

28

PeriodeCAC/Begin

29

PeriodeCAC/Einde

30

EindeFunctie/Code

31

EindeFunctie/Code@Beschrijving

32

EindeFunctie/Omschrijving

33

EindeFunctie/Omschrijving/Oorsprong

34

EindeFunctie/Omschrijving/TaalCode

35

AanduidingVrijstelling/Code

36

AanduidingVrijstelling/Code@Beschrijving

37

AanduidingVrijstelling/Omschrijving

38

AanduidingVrijstelling/Omschrijving/Oorsprong

39

AanduidingVrijstelling/Omschrijving/TaalCode

40

SoortVrijstelling/Code

41

SoortVrijstelling/Code@Beschrijving

42

SoortVrijstelling/Omschrijving

43

SoortVrijstelling/Omschrijving/Oorsprong

44

SoortVrijstelling/Omschrijving/TaalCode

Codetabellen

Aard functie codes

Code

Omschrijving

00001

Oprichter van een onderneming natuurlijk persoon

00002

Algemeen lasthebber

00003

Vennoot of lid

00004

Vertegenwoordiger van de BTW-eenheid

00006

Kermisuitbater

10001

Oprichter van een entiteit zonder rechtspersoonlijkheid

10002

Bestuurder

10003

Vast vertegenwoordiger rechtspersoon

10004

Persoon belast met dagelijks bestuur

10005

Lid Directiecomité

10006

Zaakvoerder

10007

Gedelegeerd bestuurder

10008

Syndicus

10010

Voorzitter

10011

Secretaris

10012

Penningmeester

10013

Directeur-Generaal

10014

Adjunct Directeur-Generaal

10015

Ondervoorzitter

10016

Lid van de toezichtsraad

10017

Lid van de directieraad

10020

Commissaris

10021

Vast vertegenwoordiger Commissaris

10022

Vertegenwoordiger (niet bestuurder)

10030

Vereffenaar

10031

Wettelijk vertegenwoordiger

10041

Burgemeester

10500

Contactpersoon EDRL

20001

Aannemer schrijnwerker-timmerman

20002

Installateur in centrale verwarming

20003

Aannemer plafonneerder-cementwerker

20005

Verzekeringsmakelaar

20006

Kapper

20007

Molenaar

20008

Aannemer van schilderwerken

20009

Handelaar in inlandse granen

20010

Slager-groothandelaar

20011

Opticien

20012

Fietsmecanicien

20013

Bromfietsmecanicien

20014

Motorfietsmecanicien

20015

Aannemer van metsel-en betonwerken

20016

Aannemer steenhouwer

20017

Fotograaf

20018

Kleinhandelaar in vaste brandstoffen

20019

Aannemer marmerbewerker

20020

Handelaar in fourage en stro

20021

Aannemer tegelzetter

20022

Elektrotechnisch installateur

20023

Behanger-plaatser van wand- en vloerbekleding

20024

Horlogemaker-hersteller

20025

Technicus in tandprothese

20026

Garagehouder hersteller

20027

Aannemer van glaswerken

20028

Kleinhandelaar in vloeibare brandstoffen

20029

Handelaar in tweedehandse autovoertuigen

20030

Sanitair installateur – loodgieter

20031

Install.van verwarming met gas met individuele toestellen

20032

Aann.van zinkw en met.dakbedek.van gebouwen

20033

Aann.van niet-metalen dakbedekkingen van gebouwen

20034

Installateur frigorist

20035

Droogkuiser-verver

20036

Wasser

20037

Carrossier-hersteller

20038

Begrafenisondernemer

20039

Fabrikant-installateur van lichtreclames

20040

Restaurateur of traiteur-banketaannemer

20041

Aann.voor het waterdichtmaken van bouwwerken

20042

Aannemer van sloopwerken

20043

Brood- en banketbakker

20044

Schoonheidsspecialist(e)

20045

Beenhouwer-spekslager

20046

Leurhandel

20047

Kleinhandelaar in vleesproducten

20050

Time sharing verkoper

20090

Basiskennis bedrijfsbeheer

20091

Detail handel

20099

Vrijstelling niet – KMO

20100

Motorvoertuigen intersectoraal

20101

Rijwielen

20102

Motorvoertuigen tot 3,5 ton

20103

Motorvoertuigen boven 3,5 ton

20201

Ruwbouw

20202

Stukadoor, cementeer-en dekvloeractiviteiten

20203

Tegel-, marmer en natuursteenactiviteiten

20204

Dakdekker en waterdichtmaken

20205

Plaatsen/herstellen van schrijnwerk - glazenmaker

20206

Algemeen schrijnwerk

20207

Eindafwerking (schilderen en behangen)

20208

Installatie (CV, klimaat, gas en sanitair)

20209

Elektrotechniek

20210

Algemeen aannemer

20301

Kapper/ kapster

20302

Schoonheidsspecialist(-e)

20303

Voetverzorg(st)er

20304

Masseur/masseuse

20305

Opticien

20306

Dentaaltechnicus

20307

Begrafenisondernemer

90000

Sekwester (aangeduid door rechtbank)

90001

Curator  (aanstelling door rechtbanken)

90002

Voorlopige bewindvoerder (aanstelling door rechtbanken)

90003

Commissaris opschorting (aanstelling door rechtbanken)

90004

Gerechtelijke raadsam (verkwisters)

90005

Gerechtsmandataris

Reden beëindiging functie codes

Code

Omschrijving

003

Overlijden

004

Ontslag

005

Einde opdracht

006

Stopzetting wegens vervanging dubbele onderneming

010

Ontbinding van rechtswege door het verlopen van de termijn

011

Stopzetting van de activiteiten in België (buitenl. ondern.)

012

Vervroegde ontbinding

013

Juridische ontbinding

014

Sluiting van de vereffening

015

Stop activiteit onderneming zonder rechtspersoonlijkheid

016

Stopzetting activiteit (ONP)

017

Overdracht van een onderneming natuurlijk persoon

018

Stopgezet in bekendmaking

019

Stopgezette EDRL of niet-EU onderneming

021

Fusie door overneming

022

Fusie door oprichting van een nieuwe vennootschap

023

Splitsing

024

Splitsing door opslorping

025

Splitsing door oprichting van nieuwe vennootschappen

026

Gemengde splitsing

030

Beroepsverbod

035

Stopzetting vrijstelling

050

Stopzetting in opening faillissement

051

Sluiting van het faillissement in geval verschoonbaarheid

052

Sluiting v/h faillissement met niet-verschoonbaarheid

053

Sluiting van het faillissement

054

Stopzetting in sluiting faillissement

080

Stopzetting vestigingseenheid

081

Overdracht VE

082

Overdracht onderneming

100

Ambtshalve doorhaling

999

Geannuleerd dossier

Soort vrijstelling codes

Code

Omschrijving

001

Verworven rechten:actief bij de start van de reglementering

002

de onderneming is geen kmo(art.2 kmo-pw 10/2/98)

003

Vrijstelling vastgoedmakelaar (art,4 kmo-pw 10/2/98)

004

Vrijstelling stagiair-vastgoedmakelaar(art.4 kmo-pw 10/2/98)

005

Vrijstelling verzekeringsagent (art.4 kmo-pw 10/2/98)

006

Vrijstelling verzekeringsmakelaar (art.4 kmo-pw 10/2/98)

007

Vrijstelling autorijschool (art.4 kmo-pw 10/2/98)

008

Vrijstelling personenvervoer (art.4 kmo-pw 10/2/98)

009

Vrijstelling goederenvervoer weg (art.4 kmo-pw 10/2/98)

010

Vrijstelling goederenvervoer water (art.4 kmo-pw 10/2/98)

011

Vrijstelling directe verkoop (art.4 kmo-pw 10/2/98)

012

Overlevende partner (art.10 kmo-pw 10/2/98)

013

Kind overleden ondernemingshoofd (art.11 kmo-pw 10/2/98)

014

Overnemer onderneming (art.11 kmo-pw 10/2/98)

015

Geen beslissing vestigingsraad (art.3§5 wet 26/6/02)

016

vrijstelling bank- en beleggingsdienst (art4 kmo-pw 10/2/98)


Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid

uitgegeven door Digitaal Vlaanderen