DIGITAAL VLAANDEREN

Interface (PubliceerDeelneming-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).

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

Publicatie in XML

Algemeen

De publicatie 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 bestaat uit een publicatie van één of meerdere (gewijzigde) deelnemingen. Of in geval dat er een uitzonderingsbestand gevraagd werd, kan dit ook de Uitzondering 15015 bevatten.

XSD

De bestanden die worden aangeboden op de outputfolder zijn gevalideerd volgens de
PubliceerDeelnemingen 02.00 Service xsd. De actuele xsd is ter beschikking op aanvraag.

Elementen

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

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

Visueel

Detail

Element

Beschrijving

Deelneming/

De eigenlijke deelneming van een bedrijf in een ander bedrijf

      Deelnemer/

Gegevens van de onderneming of vereniging die een jaarrekening heeft neergelegd waarin een deelneming is vermeld

                  Ondernemingsnummer

Ondernemingsnummer van de vennootschap of vereniging die een jaarrekening heeft neergelegd waarin een deelneming is vermeld. Dit is inclusief voorloopnul.

                  Jaarrekening/

Jaarrekening gegevens van de vermelder

                        Referentienummer

Referentienummer toegekend aan de jaarrekening in de NBB-gegevensbank. Vijf posities, gevolgd door een "-" en een volgnummer.

                              DatumAfsluiting

Afsluitingsdatum van de jaarrekening (in de vorm jjjj-mm-dd vb 2012-12-30)

                  /Jaarrekening

-

      /Deelnemer

-

      DeelnemingIn/

Identificatiegegevens van de onderneming waarin deelnemingen worden aangehouden

                  Ondernemingsnummer

Ondernemingsnummer. Voor zowel buitenlandse als Belgische ondernemingen die geen jaarrekening volgens een gestandaardiseerd model moeten neerleggen, wordt een bijzonder identificatienummer aangebracht.

                  Naam

Naam van de onderneming. Zowel voor de Belgische als voor de buitenlandse ondernemingen.

                  Adres/

Adresgegevens van de onderneming waarin deelnemingen worden aangehouden

                              Straat/

Straatgegevens van de onderneming

                                            Code

Komt niet terug in de publicatie

                                            Naam

Straat, huisnummer en eventueel busnummer (zoals aangeleverd door NBB)

                              /Straat

-

                              Huisnummer

Komt terug in Straat/Naam

                              Busnummer

Komt terug in Straat/Naam

                              Gemeente/

Gemeentegegevens van de onderneming

                                            NISCode

Komt niet terug in de publicatie

                                            Postcode

Postcode. Voor buitenlandse ondernemingen enkel in de mate dat deze informatie beschikbaar is.

                                            Naam

Gemeentenaam

                              /Gemeente

-

                              Staat

Komt niet terug in de publicatie

                              Land/

Landgegevens van de onderneming

                                            NISCode

Komt niet terug in de publicatie

                                            ISOCode

ISO-landocode: 2 letterig

                                            Naam

Komt niet terug in de publicatie

                              /Land

-

                  /Adres



                  Jaarrekening/

Gegevens geput uit de laatst beschikbare jaarrekening van de onderneming waarin deelnemingen worden aangehouden.

                              Munt

ISO-munteenheid. Kan niet aanwezig zijn.

                              EigenVermogen

Eigen vermogen: Getal met teken; de informatie m.b.t. het teken is verwerkt in de laatste positie rechts. Als het bedrag positief (negatief) is en het laatste cijfer 0, 1, 2, 3, 4, 5, 6, 7, 8 of 9 is, zal de laatste positie respectievelijk de waarde {, A, B, C, D, E, F, G, H of I (}, J, K, L, M, N, O, P, Q of R) hebben.

                              Nettoresultaat

Nettoresultaat: Getal met teken; de informatie m.b.t. het teken is verwerkt in de laatste positie rechts. Als het bedrag positief (negatief) is en het laatste cijfer 0, 1, 2, 3, 4, 5, 6, 7, 8 of 9 is, zal de laatste positie respectievelijk de waarde {, A, B, C, D, E, F, G, H of I (}, J, K, L, M, N, O, P, Q of R) hebben.

                              DatumAfsluiting

Afsluitingsdatum van de jaarrekening. Kan 0000-00-00 zijn.

                  /Jaarrekening

-

      /DeelnemingIn

-

      Soort/

Het soort deelneming

                  Code

Komt niet terug in de publicatie

                  Code@Beschrijving

Komt niet terug in de publicatie

                  Omschrijving

Omschrijving zoals die door de neerleggende onderneming of vereniging in haar jaarrekening werd vermeld (in de taal waarin de jaarrekening werd opgesteld). Kan in sommige gevallen niet aanwezig zijn.

            Omschrijving@TaalCode

Komt niet terug in de publicatie

            Omschrijving@Oorsprong

Komt niet terug in de publicatie

      /Soort

-

      Neergelegd/

Gegevens over de deelnemingen

                  Rechtstreeks/

Rechtstreeks door de neerleggende onderneming of

vereniging aangehouden deelnemingen

                              Aantal

Getal met teken; de informatie m.b.t. het teken is verwerkt in de laatste positie rechts. Als het bedrag positief (negatief) is en het laatste cijfer 0, 1, 2, 3, 4, 5, 6, 7, 8 of 9 is, zal de laatste positie respectievelijk de waarde {, A, B, C, D, E, F, G, H of I (}, J, K, L, M, N, O, P, Q of R) hebben.

                              Percentage

Drie numerieke posities gevolgd door een komma en twee numerieke posities. 000,00 indien geen percentage.

                  /Rechtstreeks

-

            DoorDochteronderneming/

Door dochterondernemingen van de neerleggende

onderneming aangehouden deelnemingen:

                              Percentage

Drie numerieke posities gevolgd door een komma en twee numerieke posities. 000,00 indien geen percentage.

            /DoorDochteronderneming

-

/Deelneming

-

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 komt één op één overeen 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 Deelneming/)

1

Deelnemer/Ondernemingsnummer

2

Deelnemer/Jaarrekening/Referentienummer

3

Deelnemer/Jaarrekening/DatumAfsluiting

4

DeelnemingIn/Ondernemingsnummer

5

DeelnemingIn/Naam     

6

DeelnemingIn/Adres/Straat/Code

7

DeelnemingIn/Adres/Straat/Naam

8

DeelnemingIn/Adres/Huisnummer

9

DeelnemingIn/Adres/Busnummer

10

DeelnemingIn/Adres/Gemeente/NISCode

11

DeelnemingIn/Adres/Gemeente/Postcode

12

DeelnemingIn/Adres/Gemeente/Naam

13

DeelnemingIn/Adres/Staat

14

DeelnemingIn/Adres/Land/NISCode

15

DeelnemingIn/Adres/Land/ISOCode

16

DeelnemingIn/Adres/Land/Naam

17

DeelnemingIn/Jaarrekening/Munt

18

DeelnemingIn/Jaarrekening/EigenVermogen

19

DeelnemingIn/Jaarrekening/Nettoresultaat

20

DeelnemingIn/Jaarrekening/DatumAfsluiting

21

Soort/Code

22

Soort/Code@Beschrijving

23

Soort/Omschrijving

24

Soort/Omschrijving@Oosprong

25

Soort/Omschrijving@Taalcode

26

Neergelegd/Rechtstreeks/Aantal

27

Neergelegd/Rechtstreeks/Percentage

28

Neergelegd/DoorDochteronderneming/Percentage

Op deze pagina


Binnen deze handleiding


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

 


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