Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Interface (PubliceerOndernemingVKBO-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.

Binnen de 2.0 zijn enkele gegevens toegevoegd (ambtshalve doorhaling en adresdoorhaling) maar ook enkele kleinere aanpassingen. De aanpassingen tegenover de versie 1.03 zijn op de pagina "Verschillen tegenover vorige versie" uitgelegd.

In grote lijnen bevat de OndernemingVKBO 2.0 volgende gegevens:

  • Ondernemingsnummer

  • Authentieke bron

  • Status KBO

  • Aanduiding onderneming of vestiging

  • Soort onderneming (indien onderneming)

  • Maatschappelijke zetel (indien vestiging)

  • Namen

    • Maatschappelijke naam

    • Afgekorte naam

    • Commerciële naam

  • Adres en adres doorhaling

  • Contactgegevens

  • Startdatum, datum inschrijving, datum afsluiting

  • Rechtstoestand

  • Rechtsvorm

  • RechtsvormCAC

  • Ambtshalve doorhaling

  • Datum en reden stopzetting

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_PubliceerOndernemingVKBO_20130429143246000.xml

Publicatie in XML

Algemeen

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.

De inhoud van de publicatie-XML bestaat uit een publicatie van één of meerdere ondernemingen.

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

Visueel

Onderstaande afbeelding toont een globaal overzicht van de verschillende gegevens in het antwoord. Er komen geen Metadata-gegevens terug in de publicatie.

Detail

Element

Beschrijving

@DatumModificatie

Meest recente datum laatste wijziging over de volledige onderneming / vestiging heen. Formaat: jjjj-mm-dd.

Ondernemingsnummer

Ondernemingsnummer of vestigingsnummer zoals opgegeven in de vraag. Ondernemingsnummer is steeds met een voorloopnul.

AuthentiekeBron

Bron van de gegevens.

OndernemingOfVestiging

Aanduiding of het een onderneming of vestiging betreft. Enkel Code, @Beschrijving en @DatumModificiatie komen terug. @DatumModificatie is onder de vorm jjjj-mm-dd

StatusKBO

Status zoals in KBO gekend is. Enkel Code en Omschrijving komen terug.

SoortOnderneming

Aanduiding welk soort onderneming het betreft. Komt enkel terug indien Onderneming, nooit bij een vestiging. Enkel Code en Beschrijving komen terug.

MaatschappelijkeZetel

Komt enkel terug bij een vestiging. Dit element bevat het ondernemingsnummer van de maatschappelijke zetel van de vestiging. DatumModificatie is onder de vorm jjjj-mm-dd.

Namen

Drie mogelijke namen kunnen terugkomen. De drie hebben dezelfde structuur:

  • MaatschappelijkeNaam

  • AfgekorteNaam

  • CommercieleNaam

@TaalCode en @DatumModificatie komen terug. Datummodificatie is onder de vorm jjjj-mm-dd. Opgelet: in zeer uitzonderlijke omstandigheden is er geen TaalCode bekend.

Mogelijke taalcodes: fr, nl, de, en

Adres en adresdoorhaling

De adresgegevens alsook eventueel de gegevens betreffende de doorhaling van het adres.

  • @DatumModificatie: onder de vorm jjjj-mm-dd

  • Straat: rijksregisterstraatcode en straatnaam

  • Huisnummer

  • Busnummer

  • Gemeente: Niscode, postcode en gemeentenaam

  • Land: Niscode, ISOCode. Landnaam komt momenteel niet terug.

  • Aanvullingen:

    • Staat

    • Tekst: vrij tekstveld. Vb. Bloc 7, Haven 1062

    • TaalCode: fr, nl, de, en

  • Doorhaling: aanduiding dat het adres doorgehaald werd. Gegevens die terugkomen:

    • Code

    • Omschrijving

    • Datum: onder de vorm jjjj-mm-dd

Contact

Enkel Telefoonnummer, Faxnummer en Email kunnen terugkomen.

DatumStart

Oprichtingsdatum van de onderneming / vestiging. Formaat: jjjj-mm-dd

DatumInschrijving

Datum van inschrijving in KBO. Formaat: jjjj-mm-dd

DatumAfsluiting

Datum van afsluiting onderneming of vestiging.  Indien 9999-12-31: onderneming of vestiging is niet afgesloten.

Rechtstoestand

Enkel gekend bij een onderneming. Enkel Code en Omschrijving komen terug. @DatumModificatie is onder de vorm jjjj-mm-dd

Rechtsvorm

Enkel gekend bij een onderneming. Enkel Code en Omschrijving komen terug. @DatumModificatie is onder de vorm jjjj-mm-dd

RechtsvormCAC

Vernieuwde rechtsvorm (2020). Enkel gekend bij een onderneming. Enkel Code en Omschrijving komen terug. @DatumModificatie is onder de vorm jjjj-mm-dd

Ambtshalve doorhaling

Periode en reden van ambtshalve doorhaling. Enkel bij een onderneming.

Komen terug:

      DatumModificatie (jjjj-mm-dd)

      Code

      Omschrijving

      Periode/Begin en indien gekend ook Periode/Einde. Beide onder de vorm jjjj-mm-dd.

Stopzetting

Datum en reden van stopzetting

Komen terug:

      Datum (jjjj-mm-dd)

      Code

      Omschrijving              

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 is gebaseerd op de XML vanaf het Onderneming-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

Kolom nummer

Element binnen xsd

Bijkomende informatie

1

DatumModificatie



2

Ondernemingsnummer



3

AuthentiekeBron Code



4

AuthentiekeBron Code Beschrijving



5

AuthentiekeBron Omschrijving

Komt niet terug

6

AuthentiekeBron Oorsprong

Komt niet terug

7

AuthentiekeBron TaalCode

Komt niet terug

8

OndernemingOfVestiging DatumModificatie



9

OndernemingOfVestiging Code



10

OndernemingOfVestiging Code Beschrijving



11

OndernemingOfVestiging Omschrijving

Komt niet terug

12

OndernemingOfVestiging Omschrijving Oorsprong

Komt niet terug

13

OndernemingOfVestiging Omschrijving TaalCode

Komt niet terug

14

StatusKBO Code



15

StatusKBO Code Beschrijving

Komt niet terug

16

StatusKBO Omschrijving



17

StatusKBO Omschrijving Oorsprong

Komt niet terug

18

StatusKBO Omschrijving TaalCode

Komt niet terug

19

SoortOnderneming Code



20

SoortOnderneming Code Beschrijving



21

SoortOnderneming Omschrijving

Komt niet terug

22

SoortOnderneming Omschrijving Oorsprong

Komt niet terug

23

SoortOnderneming Omschrijving TaalCode

Komt niet terug

24

MaatschappelijkeZetel



25

MaatschappelijkeZetel DatumModificatie



26

MaatschappelijkeNaam



27

MaatschappelijkeNaam TaalCode



28

MaatschappelijkeNaam DatumModificatie



29

AfgekorteNaam



30

AfgekorteNaam TaalCode



31

AfgekorteNaam DatumModificatie



32

CommercieleNaam



33

CommercieleNaam TaalCode



34

CommercieleNaam DatumModificatie



35

Adres DatumModificatie



36

Adres Straat Code



37

Adres Straat Naam



38

Adres Huisnummer



39

Adres Busnummer



40

Adres Gemeente NISCode



41

Adres Gemeente Postcode



42

Adres Gemeente Naam



43

Adres Land NISCode



44

Adres Land ISOCode



45

Adres Land Naam



46

Adres Aanvullingen Staat



47

Adres Aanvullingen Tekst



48

Adres Aanvullingen TaalCode



49

Adres Doorhaling DatumModificatie



50

Adres Doorhaling Code



51

Adres Doorhaling Code Beschrijving

Komt niet terug

52

Adres Doorhaling Omschrijving



53

Adres Doorhaling Omschrijving Oorspong

Komt niet terug

54

Adres Doorhaling Omschrijving TaalCode

Komt niet terug

55

Adres Doorhaling Datum



56

Contact Telefoonnummer



57

Contact Faxnumer



58

Contact Gsm

Komt niet terug

59

Contact Email



60

Contact Website

Komt niet terug

61

DatumStart



62

DatumInschrijving



63

DatumAfsluiting



64

Rechtstoestand DatumModificatie



65

Rechtstoestand Code



66

Rechtstoestand Code Beschrijving

Komt niet terug

67

Rechtstoestand Omschrijving



68

Rechtstoestand Omschrijving Oorsprong

Komt niet terug

69

Rechtstoestand Omschrijving TaalCode

Komt niet terug

70

Rechtsvorm DatumModificatie



71

Rechtsvorm Code



72

Rechtsvorm Code Beschrijving

Komt niet terug

73

Rechtsvorm Omschrijving



74

Rechtsvorm Omschrijving Oorsprong

Komt niet terug

75

Rechtsvorm Omschrijving TaalCode

Komt niet terug

76

RechtsvormCAC DatumModificatie

 

77

RechtsvormCAC Code

 

78

RechtsvormCAC Code Beschrijving

 

79

RechtsvormCAC Omschrijving

 

80

RechtsvormCAC Omschrijving Oorsprong

 

81

RechtsvormCAC Omschrijving TaalCode

 

82

AmbtshalveDoorhaling DatumModificatie



83

AmbtshalveDoorhaling Reden Code



84

AmbtshalveDoorhaling Reden Beschrijving

Komt niet terug

85

AmbtshalveDoorhaling Reden Omschrijving



86

AmbtshalveDoorhaling Reden Oorsprong

Komt niet terug

87

AmbtshalveDoorhaling Reden TaalCode

Komt niet terug

88

AmbtshalveDoorhaling Periode Begin



89

AmbtshalveDoorhaling Periode Einde



90

Stopzetting Datum



91

Stopzetting Reden Code



92

Stopzetting Reden Beschrijving

Komt niet terug

93

Stopzetting Reden Omschrijving



94

Stopzetting Reden Omschrijving Oorsprong

Komt niet terug

95

Stopzetting Reden Omschrijving TaalCode

Komt niet terug

Codetabellen

Dit zijn de voor VKBO op dit moment gekende codes (mei 2015). Hou er rekening mee dat codes en omschrijvingen (of Beschrijvingen) kunnen wijzigen.

Authentieke Bron

Code

@Beschrijving

03

KBO

OndernemingOfVestiging

Code

@Beschrijving

1

Onderneming

2

Vestiging

StatusKBO

Code

Omschrijving

AC

Actief

ST

Stopgezet

AF

Afgesloten

JU

Juridisch

AN

Geannuleerd

BK

Bekendgemaakt

SoortOnderneming

Code

@Beschrijving

1

Natuurlijk persoon

2

Rechtspersoon


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