Versions Compared

Old Version 4

changes.mady.by.user Jan Willem

Saved on

compared with

New Version Current

changes.mady.by.user Bram Van Helleputte

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

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

Note

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

Info

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

Info

Informatie:

Voor een overzicht van alle elementen die in de gevraagde XML staan en eventuele beperkingen wordt er verwezen naar de XSD.

Visueel

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

Image RemovedImage Added

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.

Expand
titleVoorbeeld
Code Block
languagexml
<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


7783

AmbtshalveDoorhaling Reden Code


7884

AmbtshalveDoorhaling Reden Beschrijving

Komt niet terug

7985

AmbtshalveDoorhaling Reden Omschrijving


8086

AmbtshalveDoorhaling Reden Oorsprong

Komt niet terug

8187

AmbtshalveDoorhaling Reden TaalCode

Komt niet terug

8288

AmbtshalveDoorhaling Periode Begin


8389

AmbtshalveDoorhaling Periode Einde


8490

Stopzetting Datum


8591

Stopzetting Reden Code


8692

Stopzetting Reden Beschrijving

Komt niet terug

8793

Stopzetting Reden Omschrijving


8894

Stopzetting Reden Omschrijving Oorsprong

Komt niet terug

8995

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.

Note

Opmerking:

De codes van Adresdoorhaling, Rechtsvorm, Rechtstoestand, Ambtshalve doorhaling en Stopzetting zijn niet opgenomen in dit document. Indien nodig kunnen deze aangeleverd worden via een generiek publicatiebestand. Neem hiervoor contact op met de MAGDA Service Desk.

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

Op deze pagina

Table of Contents
maxLevel2
minLevel1

Binnen deze handleiding

Child pages (Children Display)
pageOnderneming.PubliceerGeannuleerdeOndernemingen-02.00
Info

Met vragen kunt u steeds terecht bij de MAGDA Service Desk.