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.
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
- 1 Algemeen
- 2 Bestandsnaam
- 3 Publicatie in XML
- 3.1 Algemeen
- 3.2 XSD
- 3.3 Elementen
- 3.4 Uitzonderingen
- 4 Publicatie in CSV
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