Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

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.

<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 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


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