ConsultService V2

De Consult Service, kort voor consultatie service, laat toe om de inhoud van de Navigator Wetgeving Leefmilieu, Natuur en Energie te raadplegen.

Deze webservice is gebaseerd op het SOAP protocol, en biedt verscheidene mogelijkheden om de service te bevragen.

Een logische volgorde is

  • opvragen van de beschikbare boeken
  • voor een gevonden boek de inhoudstafel opvragen
  • voor een gevonden boek, of voor een gevonden boek onderdeel, de inhoud ophalen
  • voor een gevonden boek, of voor een gevonden boek onderdeel, de gerelateerde wetteksten ophalen

De service heeft een verplichte authenticatie. Dit dient niet om de data af te schermen, maar om toezicht te kunnen houden op overdadig gebruik van de webservice. Voor vragen in verband met de login gegevens mag u ons steeds contacteren.

Version: 2

Service Description File: https://ws.navigator.emis.vito.be/milnav-ws/consultService/v2

SoapUI Project:  consultService-v2.xml

Toggle all items

getRegulationDesignationList

Geeft een lijst terug van alle beschikbare wetboeken.

Deze lijst bevat naast een titel en een omschrijving ook het unieke identificatie nummer, de ID.

Aan de hand van deze ID kan de verdere inhoud van een wetboek of wettekst opgehaald worden.

Version: 2

Type: SOAP

Method: POST

Authentication: Plaintext

Link: https://ws-navigator.emis.vito.be/milnav-ws/consultService/v2

Code: 

Headers

[geshifilter-pre type="text"] Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 SOAPAction: "" Authorization: Basic XXXXXXXXXXXXXXXXXXXX Content-Length: 257 Host: ws-navigator.emis.vito.be:80 Proxy-Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) [/geshifilter-pre]

Content

[geshifilter-pre type="xml"] <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://server.ws.milieunavigator.prj.hemmis.com/"> <soapenv:Header/> <soapenv:Body> <ser:getRegulationDesignationList/> </soapenv:Body> </soapenv:Envelope> [/geshifilter-pre]

getRegulationDesignationListResponse

Version: 2

Een voorstelling van de inhoudstafel van een wetboek.

Dit formaat is gebaseerd op de MetaLex standaard

Bevat een lijst van RegulationDesignation objecten

RegulationDesignation

De voorstelling van een wetboek zoals deze voorkomt in de navigator.

Attributen

Attributen Type Cardinality Omschrijving
id

ID

1

De unieke ID van een wet object.

Formattering: prefix "id" + nummer

voorbeeld: id623

Veld Type Cardinality Omschrijving

CitationDesignation

 

 

CitationDesignation

1

De omschrijving van het wetboek

CiteerTitle

CiteerTitle

1

De titel van het wetboek

CitationDesignation

De omschrijving van het wetboek.

Veld Type Cardinality Omschrijving
TextVersion

TextVersion

1...*

De tekst


CiteerTitle

De titel van het wetboek

Veld Type Cardinality Omschrijving
TextVersion

TextVersion

1...*

De tekst


TextVersion

Een tekst in een bepaalde taal. Kan html entiteiten bevatten. Bijvoorbeeld: &amp;

Attribuut Type Cardinality Omschrijving
lang

Tekst

1

De taal van de tekst

Mogelijke waarde:

  • nl
  • en
  • fr
  • de

Example: 

[geshifilter-code type="xml"] <env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"> <env:Header/> <env:Body> <ns3:getRegulationDesignationListResponse xmlns:ns2="http://www.emis.vito.be/navigator/milnav-toc" xmlns:ns3="http://server.ws.milieunavigator.prj.hemmis.com/"> <return> <ns2:RegulationDesignation id="id323"> <ns2:CitationDesignation> <ns2:TextVersion xml:lang="nl">Wet van 28 december 1964 op de bestrijding van de luchtverontreiniging.</ns2:TextVersion> </ns2:CitationDesignation> <ns2:CiteerTitle> <ns2:TextVersion xml:lang="nl">Wet luchtverontreiniging</ns2:TextVersion> </ns2:CiteerTitle> </ns2:RegulationDesignation> </return> </ns3:getRegulationDesignationListResponse> </env:Body> </env:Envelope> <.code>[/geshifilter-code]

getRegulationToC

Geeft de inhoudstafel van een specifiek wetboek terug, geldig op een specifieke datum.

De gebruikte datum is standaard de huidige datum, maar kan ook expliciet als parameter meegegeven worden, om een versie uit het verleden op te halen.

Parameters

Name Parameter  Type Cardinality Omschrijving
date content

Datum

0...1

De datum waarop de inhoudstafel van het wetboek in werking is of was.

Formaat: jjjj-mm-dd

Bijvoorbeeld: 2013-03-13

wetboekId content

Nummer

1

De id van het wetboek waarvoor je de inhoudstafel wil opvragen. 

Formaat is enkel het nummer, dus zonder "id" prefix.

Bijvoorbeeld: 623

 

Version: 2

Type: SOAP

Method: POST

Authentication: Plaintext

Link: https://ws-navigator.emis.vito.be/milnav-ws/consultService/v2

Code: 

Headers

[geshifilter-pre type="text"] Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 SOAPAction: "" Authorization: Basic XXXXXXXXXXXXXXXXXXXXX Content-Length: 359 Host: ws-navigator.emis.vito.be:80 Proxy-Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) [/geshifilter-pre]

Content

[geshifilter-pre type="xml"] <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://server.ws.milieunavigator.prj.hemmis.com/"> <soapenv:Header/> <soapenv:Body> <ser:getRegulationToC> <wetboekId>263</wetboekId> <!--Optional:--> <date></date> </ser:getRegulationToC> </soapenv:Body> </soapenv:Envelope> [/geshifilter-pre]

getRegulationToCResponse

Version: 2

Een voorstelling van de inhoudstafel van een wetboek.

Dit antwoord is gebaseerd op de MetaLex standaard

Bevat een RegulationToCType object

RegulationToCType

Attributen

Attributen Type Cardinality Omschrijving
id

Datum

1

De unieke ID van een wet object.

Formattering: prefix "id" + nummer

voorbeeld: id623

permanent-id

Tekst

1

De unieke ID van een wetobject. Blijft bestaan tijdens verplaatsingen in de boomstructuur. (een verplaatsing wordt intern gerealiseerd via een stopzetting en aanmaken van een nieuwe record)
date-version

Datum

1

Datum van kracht

Formaat: jjjj-mm-ddZ

date-publication

Datum

1

Datum van publicatie

Formaat: jjjj-mm-ddZ

date-enacted

Datum

1

Datum van in werking treding

Formaat: jjjj-mm-ddZ

date-repealed

Datum

0...1

Datum van opheffing

Formaat: jjjj-mm-ddZ

 

Veld Type Cardinality Omschrijving

CitationDesignation

 

 

CitationDesignation

1

De titel van het wetboek

PartDesignation

 

PartDesignation

0...*

 
ArticleDesignation

ArticleDesignation

0...*

 

CitationDesignation

Veld Type Cardinality Omschrijving
TextVersion

TextVersion

1...*

 

PartDesignation

Attributen

Attributen Type Cardinality Omschrijving
id

Datum

1

De unieke ID van een wet object.

Formattering: prefix "id" + nummer

voorbeeld: id623

permanent-id

Tekst

1

De unieke ID van een wetobject. Blijft bestaan tijdens verplaatsingen in de boomstructuur. (een verplaatsing wordt intern gerealiseerd via een stopzetting en aanmaken van een nieuwe record)
date-version

Datum

1

Datum van kracht

Formaat: jjjj-mm-ddZ

date-publication

Datum

1

Datum van publicatie

Formaat: jjjj-mm-ddZ

date-enacted

Datum

1

Datum van in werking treding

Formaat: jjjj-mm-ddZ

date-repealed

Datum

0...1

Datum van opheffing

Formaat: jjjj-mm-ddZ

 

Veld Type Cardinality Omschrijving

IndexDesignation

 

 

IndexDesignation

1

 

Title

 

Title

1

 
ArticleDesignation

ArticleDesignation

0...*

 
PartDesignation

PartDesignation

0...*

 

ArticleDesignation

Attributen

Attributen Type Cardinality Omschrijving
id

Datum

1

De unieke ID van een wet object.

Formattering: prefix "id" + nummer

voorbeeld: id623

permanent-id

Tekst

1

De unieke ID van een wetobject. Blijft bestaan tijdens verplaatsingen in de boomstructuur. (een verplaatsing wordt intern gerealiseerd via een stopzetting en aanmaken van een nieuwe record)
date-version

Datum

1

Datum van kracht

Formaat: jjjj-mm-ddZ

date-publication

Datum

1

Datum van publicatie

Formaat: jjjj-mm-ddZ

date-enacted

Datum

1

Datum van in werking treding

Formaat: jjjj-mm-ddZ

date-repealed

Datum

0...1

Datum van opheffing

Formaat: jjjj-mm-ddZ

 

Veld Type Cardinality Omschrijving
IndexDesignation

IndexDesignation

1

 
Title

Title

1

 
SubPartDesignation

SubPartDesignation

0...*

 

SubPartDesignation

Attributen

Attributen Type Cardinality Omschrijving
id

ID

1

De unieke ID van een wet object.

Formattering: prefix "id" + nummer

voorbeeld: id623

permanent-id

Tekst

1

De unieke ID van een wetobject. Blijft bestaan tijdens verplaatsingen in de boomstructuur. (een verplaatsing wordt intern gerealiseerd via een stopzetting en aanmaken van een nieuwe record)
date-version

Datum

1

Datum van kracht

Formaat: jjjj-mm-ddZ

date-publication

Datum

1

Datum van publicatie

Formaat: jjjj-mm-ddZ

date-enacted

Datum

1

Datum van in werking treding

Formaat: jjjj-mm-ddZ

date-repealed

Datum

0...1

Datum van opheffing

Formaat: jjjj-mm-ddZ

 

Veld Type Cardinality Omschrijving
IndexDesignation

IndexDesignation

1

 
Title

Title

1

 
SubPartDesignation

SubPartDesignation

0...*

 

IndexDesignation

Veld Type Cardinality Omschrijving
Category

Category

0...1

 
Index

Index

1

 

Title

Veld Type Cardinality Omschrijving
TextVersion

TextVersion

1...*

 

Category

Veld Type Cardinality Omschrijving
TextVersion

TextVersion

1...*

 

Index

Veld Type Cardinality Omschrijving
TextVersion

TextVersion

1...*

 

TextVersion

Attribuut Type Cardinality Omschrijving
lang

Tekst

1

De taal van de tekst

Mogelijke waarde:

  • nl
  • en
  • fr
  • de

Example: 

[geshifilter-pre type="xml"] <env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/"> <env:Header/> <env:Body> <ns3:getRegulationToCResponse xmlns:ns2="http://www.emis.vito.be/navigator/milnav-toc" xmlns:ns3="http://server.ws.milieunavigator.prj.hemmis.com/"> <return date-enacted="1995-08-01Z" date-publication="1995-07-31Z" date-version="2013-05-13Z" id="id263"> <ns2:CitationDesignation> <ns2:TextVersion xml:lang="nl">Besluit van de Vlaamse regering van 1 juni 1995 houdende algemene en sectorale bepalingen inzake milieuhygiëne</ns2:TextVersion> <ns2:TextVersion xml:lang="en">Order of the Flemish Government of 1 June 1995 concerning General and Sectoral provisions relating to Environmental Safety</ns2:TextVersion> </ns2:CitationDesignation> <ns2:PartDesignation date-enacted="1995-08-01Z" date-publication="1995-07-31Z" date-version="2013-05-13Z" id="id7911"> <ns2:IndexDesignation> <ns2:Category> <ns2:TextVersion xml:lang="nl">Deel</ns2:TextVersion> <ns2:TextVersion xml:lang="en">Part</ns2:TextVersion> </ns2:Category> <ns2:Index> <ns2:TextVersion xml:lang="nl">1.</ns2:TextVersion> <ns2:TextVersion xml:lang="en">1.</ns2:TextVersion> </ns2:Index> </ns2:IndexDesignation> <ns2:Title> <ns2:TextVersion xml:lang="nl">ALGEMENE BEPALINGEN</ns2:TextVersion> <ns2:TextVersion xml:lang="en">GENERAL PROVISIONS</ns2:TextVersion> </ns2:Title> </ns2:PartDesignation> </return> </ns3:getRegulationToCResponse> </env:Body> </env:Envelope> [/geshifilter-pre]

getRegulation

Geeft de inhoud  terug van een specifiek wetobject, en alle onderliggende wetobjecten, geldig op een specifieke datum.

De gebruikte datum is standaard de huidige datum, maar kan ook expliciet als parameter meegegeven worden, om een versie uit het verleden op te halen.  

Parameters

Name Parameter  Type Cardinality Omschrijving
date content

Datum

0...1

 

De datum waarop de inhoudstafel van het wetboek in werking is of was.

 

Formaat: jjjj-mm-dd

 

Bijvoorbeeld: 2013-03-13

id content

Nummer

1

De id van het wetobject waarvoor je de inhoud wil opvragen. 

 

Formaat is enkel het nummer, dus zonder "id" prefix.

 

Bijvoorbeeld: 623

Version: 2

Type: SOAP

Method: POST

Authentication: Plaintext

Link: https://ws-navigator.emis.vito.be/milnav-ws/consultService/v2

Code: 

Headers

[geshifilter-pre type="text"] Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 SOAPAction: "" Authorization: Basic XXXXXXXXXXXXXXXXXXXXX Content-Length: 366 Host: ws-navigator.emis.vito.be:80 Proxy-Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) [/geshifilter-pre]

Content

[geshifilter-pre type="xml"] <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://server.ws.milieunavigator.prj.hemmis.com/"> <soapenv:Header/> <soapenv:Body> <ser:getRegulation> <!--Optional:--> <id>632</id> <!--Optional:--> <date>?</date> </ser:getRegulation> </soapenv:Body> </soapenv:Envelope> [/geshifilter-pre]

getRegulationResponse

Version: 2

Een voorstelling van de inhoud van een wetobject, geldig op een specifieke datum.

Een wetobject kan een volledig wetboek zijn, een onderdeel van een wetboek, een specifiek artikel of zelfs een paragraaf.

De gebruikte datum is standaard de huidige datum, maar kan ook expliciet als parameter meegegeven worden, om een versie uit het verleden op te halen.

Let op, het antwoord is een apart xml bestand, waarvan de inhoud volledig meegegeven is. Dit wordt gedaan door de gehele inhoud als een CDATA blok mee te geven. De inhoud hiervan volgt de indeling van een RegulationToCType

getRegulationListByIndex

Geeft alle gekoppelde wetteksten terug, die gerelateerd zijn aan een specifieke thematische index.

De meest gebruikte thematische index, is deze van de rubrieken. Hierbij is de indexId gelijk aan de rubriekId. 

De lijst van rubrieken, met daarin de rubriekId, kan je terugvinden via de RubriekService

Parameters

indexId content

Nummer

1

De id van de rubriek waarvoor je de gerelateerde wetteksten wil opvragen. 

 

Bijvoorbeeld: 3151

Version: 2

Type: SOAP

Method: POST

Authentication: Plaintext

Link: https://ws-navigator.emis.vito.be/milnav-ws/consultService/v2

Code: 

Headers

[geshifilter-pre type="text"] Accept-Encoding: gzip,deflate Content-Type: text/xml;charset=UTF-8 SOAPAction: "" Authorization: Basic XXXXXXXXXXXXXXXXXXXXX Content-Length: 366 Host: ws-navigator.emis.vito.be:80 Proxy-Connection: Keep-Alive User-Agent: Apache-HttpClient/4.1.1 (java 1.5) [/geshifilter-pre]

Content

[geshifilter-pre type="xml"] <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://server.ws.milieunavigator.prj.hemmis.com/"> <soapenv:Header/> <soapenv:Body> <ser:getRegulationListByIndex> <indexId>623</indexId> </ser:getRegulationListByIndex> </soapenv:Body> </soapenv:Envelope> [/geshifilter-pre]

getRegulationListByIndexResponse

Version: 2

Een voorstelling van de gekoppelde wetgeving behorend tot een thematische index.

Let op, het antwoord is een apart xml bestand, waarvan de inhoud volledig meegegeven is. Dit wordt gedaan door de gehele inhoud als een CDATA blok mee te geven. De inhoud hiervan volgt de indeling van een getRegulationType