Interface (PubliceerGeannuleerdeOndernemingen-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_PubliceerGeannuleerdeOndernemingen_20140224155516000.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 bestaat uit een publicatie van één of meerdere geannuleerde ondernemingen of vestigingen. 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 service-xsd horende bij deze dienst. De actuele xsd is ter beschikking op aanvraag.
Elementen
Visueel
Onderstaande afbeelding toont de elementen vanaf het Inhoud-element. Elke gepubliceerde geannuleerde onderneming komt in een nieuw Onderwerp-element. Er komen geen Metadata-gegevens terug in de publicatie.
Detail
Element | Beschrijving |
---|---|
GeannuleerdeOnderneming/ | De annulatie van een onderneming of vestiging |
     Ondernemingsnummer | Het ondernemingsnummer of vestigingnummer van de geannuleerde onderneming / vestiging. Ondernemingsnummer is steeds met voorloopnul. |
     Datum          | Datum van annulatie, dit onder de vorm jjjj-mm-dd |
/GeannuleerdeOnderneming | - |
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 GeannuleerdeOnderneming-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 | Ondernemingsnummer |
2 | Datum |
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
Â
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