Basiswettenbestand Gebruikersdocumentatie SRU. Versie 1.0 Datum 4 juni 2015

Transcriptie

1 Basiswettenbestand Gebruikersdocumentatie SRU Versie 1.0 Datum 4 juni 2015

2 Inhoudsopgave 1 INLEIDING DOCUMENTHISTORIE ALGEMEEN ENDPOINT SCHEMA'S SRU-VERSIE CONFORMANCE REQUEST VELDEN RESPONSE VELDEN BIJLAGE - VOORBEELDEN USE CASE 1 - IND USE CASE 2 - BELASTINGDIENST USE CASE 3 - BELEIDSMEDEWERKER VWS USE CASE 4 - MONITORING DOOR V&J BIJLAGE - WAARDELIJSTEN REGELINGSOORT RECHTSGEBIED EERSTVERANTWOORDELIJKE VERDRAGSONDERWERP OVERHEIDSDOMEIN Pagina 2 van 16

3 1 Inleiding Het basiswettenbestand wordt dagelijks bijgewerkt. Voor afnemers is er daarom een service op basis van SRU beschikbaar waarmee de gewijzigde regelingen achterhaald kunnen worden. Dit document bevat de documentatie voor deze service. Het basiswettenbestand bevat ook nog twee web services voor het zoeken naar regelingen (OPId2BWBIdService en BWBIdService). Deze zijn beschreven in het document 'Basiswettenbestand - Gebruikersdocumentatie - Web services. 1.1 Documenthistorie Versie Datum Beschrijving Initiële versie Pagina 3 van 16

4 2 Algemeen 2.1 Endpoint Deze service heeft het volgende endpoint: Schema's Het response van de service voldoet aan de volgende schema's: In gzd.xsd worden de <record/>'s gedefinieerd. Deze zijn echter zeer vrij gedefinieerd, zodat deze eenvoudig uitgebreid kunnen worden. Voor de duidelijkheid staat de structuur in SRU-versie Binnen wetten.nl wordt versie 1.2 van SRU ondersteund. De documentatie staat op de site van de Library of Congress: Conformance We streven ernaar om te voldoen aan het SRU Base Profile: Kort gezegd houdt dat het volgende in: De operatie searchretrieve wordt ondersteund De operatie Explain wordt ondersteund Voor CQL staan de eisen hier: Hier wordt level 2 gehaald. Let op "Note that Level 2 does not require support for all of CQL, it requires that the server be able to parse all of CQL (and respond with proper diagnostics for the parts not supported.)." (bron: Gebruik Deze SRU-interface wordt voor verschillende collecties gebruikt. Een client moet daarom aangeven welke collectie er bevraagd wordt. Hiervoor is de parameter x-connection geïntroduceerd. De waarde voor het basiswettenbestand is 'BWB'. Een aanroep naar deze service heeft dus typisch de volgende vorm: Pagina 4 van 16

5 3 Request 3.1 Velden In deze paragraaf staan alle beschikbare zoekvelden beschreven. Tenzij anders gespecificeerd geldt voor elk veld het volgende: Het veld is optioneel in de interface Alleen de operatoren == en = worden ondersteund De implementatie van de = operator komt overeen met de == operator Veld Omschrijving Opmerking dcterms:identifier identificatie van de regeling Dit is niet de identificatie van een specifieke toestand dcterms:modified Tijdstip laatste wijziging Ook de operatoren <, >, <=, >= worden ondersteund. dcterms:type Soort regeling Mogelijke waarden staan in de bijlage overheid:authority Eerstverantwoordelijke Mogelijke waarden staan in de bijlage overheidbwb:rechtsgebied Rechtsgebied Mogelijke waarden staan in de bijlage overheidbwb:overheidsdomein Overheidsdomein Niet voor verdragen Mogelijke waarden staan in de bijlage overheidbwb:onderwerpverdrag Verdragsonderwerp Alleen voor verdragen Mogelijke waarden staan in de bijlage overheidbwb:titel overheidbwb:afkorting overheidbwb:wetsfamilie Citeertitel, officiële-titel niet-officiële-titel Afkorting Wetsfamilie In alle 3 de velden wordt gezocht De volgende operatoren worden ondersteund: =, adj, any, all. De operator == wordt dus niet ondersteund. De implementatie van de = operator komt overheen met de adj operator. Pagina 5 van 16

6 4 Response De response bevat een lijst van toestanden. 4.1 Velden Deze paragraaf beschrijft de velden van het response per record. Veld Omschrijving Opmerking dcterms:identifier Zie request dcterms:modified Zie request dcterms:type Zie request dcterms:title Citeertitel dcterms:languague Taal Altijd nl dcterms:creator Maker Altijd Ministerie van Binnenlandse Zaken en Koninkrijksrelaties overheid:authority Zie request overheidbwb:rechtsgebied Zie request Kan meerdere keren voorkomen overheidbwb:overheidsdomein Zie request Kan meerdere keren voorkomen overheidbwb:onderwerpverdrag Zie request Kan meerdere keren voorkomen overheidbwb:toestand Identifier van de toestand overheidbwb:locatie_toestand Locatie van de toestand op de repository overheidbwb:locatie_wti Locatie van de bijbehorende WTI op de repository overheidbwb:locatie_manifest Locatie van het manifest op de repository 4.2 Recordstructuur De structuur van een <record/> in het response is als volgt. <record> <recordschema/> <recordpacking/> <recorddata> <gzd> <originaldata> <overheidbwb:meta> <owmskern> <dcterms:identifier/> <dcterms:title/> <dcterms:type/> <dcterms:language/> <overheid:authority/> <dcterms:creator/> <dcterms:modified/> </owmskern> <owmsmantel> <dcterms:created/> </owmsmantel> <bwbipm> <overheidbwb:toestand/> <overheidbwb:rechtsgebied/> Pagina 6 van 16

7 <overheidbwb:overheidsdomein/> <overheidbwb:onderwerpverdrag/> </bwbipm> </overheidbwb:meta> </originaldata> <enricheddata> <overheidbwb:locatie_toestand/> <overheidbwb:locatie_wti/> <overheidbwb:locatie_manifest/> </enricheddata> </gzd> </recorddata> <recordposition/> </record> Pagina 7 van 16

8 5 Bijlage - Voorbeelden Hieronder staan 4 voorbeelden van use cases waarvoor de SRU interface gebruikt zou kunnen worden. Bij elk voorbeeld staat ook een voorbeeld request. 5.1 Use case 1 - IND De IND heeft een eigen systeem waarin de beleidsregels worden beheerd. In dit systeem willen zij van ongeveer 40 regelingen uit BWB alle versies hebben, zodat zij snel dingen kunnen opzoeken. Zij hebben van deze 40 regelingen de identifier. Via de SRU willen ze elke dag controleren of er nog nieuwe versies zijn. Voor de IND zijn de volgende velden nodig in het request: datum-laatste-wijziging bwbid Een request-url waarbij alle voor de IND relevante wijzigingen worden opgevraagd is als volgt. Aannames: De vorige bevraging was op 1 mei 2015 De relevante identifiers zijn BWBR , BWBR en BWBR and (dcterms.identifier == BWBR or dcterms.identifier == BWBR or dcterms.identifier == BWBR ) 5.2 Use case 2 - Belastingdienst De belastingdienst wil alle regelingen die te maken hebben met belastingen inlezen in een eigen system. Voor de belastingdienst zijn de volgende velden nodig in het request: datum-laatste-wijziging rechtsgebied Een request-url waarbij alle voor de belastingdienst relevante wijzigingen worden opgevraagd is als volgt. and overheidbwb.rechtsgebied == belastingrecht 5.3 Use case 3 - Beleidsmedewerker VWS Een beleidsmedewerker bij het Ministerie van Volksgezondheid, Welzijn en Sport (VWS) houdt in de gaten welke nieuwe regelingen worden gepubliceerd waarvoor het eigen departement verantwoordelijk is. Voor VWS zijn de volgende velden nodig in het request: datum-laatste-wijziging eerstverantwoordelijke Een request-url waarbij alle voor VWS relevante wijzigingen worden opgevraagd is als volgt. and overheid.authority == Volksgezondheid, Welzijn en Sport Pagina 8 van 16

9 5.4 Use case 4 - Monitoring door V&J Het ministerie van Veiligheid en Justitie monitort of alle departmenten zich houden aan de afspraken rondom het maken van wet- en regelgeving. Ze controleren bijvoorbeeld of het aantal regelingen omlaag gaat en of de inwerkingtredingsdatums van de regelingen samenvallen met de vaste verandermomenten. Ze monitoren niet alle regelgeving, alleen de hogere: wetten, AMvB's en ministeriele regelingen. Voor V&J zijn de volgende velden nodig in het request: datum-laatste-wijziging regelingsoort Een request-url waarbij alle voor de V&J relevante wijzigingen worden opgevraagd is als volgt. and (dcterms.type == wet or dcterms.type == AMvB or dcterms.type == ministeriele-regeling) Pagina 9 van 16

10 6 Bijlage - Waardelijsten 6.1 Regelingsoort Voorbeeld: dcterms.type == AMvB Mogelijke waarden AMvB AMvB-BES beleidsregel beleidsregel-bes circulaire circulaire-bes KB ministeriele-regeling ministeriele-regeling-archiefselectielijst ministeriele-regeling-bes pbo reglement rijkskb rijkswet verdrag wet wet-bes zbo 6.2 Rechtsgebied Voorbeeld: overheidbwb.rechtsgebied == Agarisch recht Binnen de rechtsgebieden zijn 2 niveaus: hoofdgebieden en specifieke-gebieden. Beide niveaus kunnen opgegeven worden n de interface. Wanneer gezocht wordt op een hoofdgebied, worden ook alle regelingen met onderliggende specifieke gebieden gezocht. Mogelijk waarden Agrarisch recht Arbitrage Arbeidsrecht en sociaal-zekerheidsrecht o Arbeidsrecht o Ambtenarenrecht o Militaire ambtenarenrecht o Pensioenrecht o Sociaal zekerheidsrecht Bank- en effectenrecht, financiering o Bankrecht o Effectenrecht o Financiering en zekerheden o Toezicht bank- en kredietwezen Belastingrecht o BTW en accijns o Milieubelasting o Successie- en schenkingsrecht o Vennootschapsbelastingrecht o Dividendbelasting o Formeel belastingrecht o Heffingen lokale overheden o Inkomstenbelasting Pagina 10 van 16

11 o Internationale regelingen o Invoer en douane o Invorderingsrecht o Loonbelasting en premieheffing Contracten, schade en aansprakelijkheid o Aansprakelijkheidsrecht o Consumentenrecht o Internationaal contractrecht o Verbintenissenrecht o Verzekeringsrecht Cultureel recht Financieel en economisch recht Gezondheidsrecht en farmaceutisch recht Goederenrecht o Eigendomsrecht o Erfdienstbaarheid o Erfpacht, vruchtgebruik o Hypotheekrecht en pandrecht (zekerheidsrechten) Intellectuele eigendom o Auteursrecht o Intellectueel eigendomsrecht o Octrooirecht Informatierecht o ICT-recht o Telecomrecht Insolventierecht o Faillissement o Surseance o Schuldsanering Internationaal privaatrecht Inclusief internationaal procesrecht Internationaal publiekrecht o Mensenrechten o Ontwikkelingssamenwerking o Volkenrecht Levensmiddelenrecht Mededingingsrecht Migratierecht o Nationaliteitsrecht o Vreemdelingenrecht Ondernemingspraktijk o Fusies en overnames o Ondernemingsrecht o Stichtingen en verenigingen o Vennootschapsrecht Onderwijsrecht Openbare orde en veiligheidsrecht o Personen- en familierecht o Echtscheiding o Erfrecht o Familierecht o Personenrecht o Jeugdrecht (m.u.v. jeugdstrafrecht) Procesrecht o Bestuursprocesrecht o Burgerlijk procesrecht o Strafprocesrecht Privacy Pagina 11 van 16

12 Ruimtelijke ordening en milieu o Milieurecht o Omgevingsrecht o Waterrecht Staats- en bestuursrecht o Bestuursrecht o Militair recht o Staatsrecht Strafrecht o Financieel-economisch strafrecht o Internationaal strafrecht o Jeugdstrafrecht o Milieustrafrecht o Penitentiair recht o Strafrecht (algemeen) o Verkeersrecht Sportrecht Tuchtrecht Vervoersrecht Wonen, onroerend goed, bouwrecht o Bouwrecht o Huurrecht o Internationaal onroerend goedrecht o Onroerend goedrecht 6.3 Eerstverantwoordelijke Voorbeeld: overheid.authority == Algemene Zaken Mogelijk waarden Ministeries Algemene Zaken Binnenlandse Zaken en Koninkrijksrelaties Buitenlandse Zaken Defensie Economische Zaken Financiën Infrastructuur en Milieu Onderwijs, Cultuur en Wetenschap Sociale Zaken en Werkgelegenheid Veiligheid en Justitie Volksgezondheid, Welzijn en Sport ZBO's Autoriteit Consument en Markt Bureau Architectenregister Bureau Financieel Toezicht CAK CEVO Centraal Bureau voor de Statistiek - Directeur-Generaal van de Statistiek Centraal Orgaan opvang Asielzoekers Centrale Organisatie Werk en Inkomen College Gerechtelijk deskundigen College Sanering Ziekenhuisvoorzieningen College bescherming persoonsgegevens College sanering zorginstellingen Pagina 12 van 16

13 College ter Beoordeling van Geneesmiddelen College van toezicht op de zorgverzekeringen College voor Examens College voor Toetsen en Examens College voor de toelating van gewasbeschermingmiddelen en biociden Commissariaat voor de Media Commissie Eindtermen Accountantsopleiding De Nederlandsche Bank N.V. Dienst Uitvoering Onderwijs Dienst Wegverkeer Faunafonds Fonds Podiumkunsten Fundeon KBBI Huurcommissie Innovam Kadaster Kamer van Koophandel Kamer voor de Binnenvisserij Kansspelautoriteit Kenniscentrum Handel Landelijk Orgaan Economische & Administratieve Beroepscategorieën Luchtverkeersleiding Nederland Mondriaan Fonds Nederlands-Vlaamse Accreditatieorganisatie hoger onderwijs Nederlandse Omroep Stichting Nederlandse Organisatie voor Wetenschappelijk Onderzoek Nederlandse Zorgautoriteit Nederlandse emissieautoriteit Raad van bestuur UWV Raad voor Accreditatie Raad voor Rechtsbijstand Raad voor Rechtsbijstand s-hertogenbosch Raad voor plantenrassen Registratiecommissies KNMG, KNMP en NMT (cluster) Sociale Verzekeringsbank Staten-Generaal Stichting Autoriteit Financiële Markten Stichting Bloembollenkeuringsdienst Stichting Centraal Bureau Rijvaardigheidsbewijzen Stichting Centraal Orgaan voor Kwaliteitsaangelegenheden in de Zuivel Stichting Controlebureau voor Pluimvee, Eieren en Eiproducten Stichting Donorgegevens Kunstmatige Bevruchting Stichting Fonds voor Cultuurparticipatie Stichting Fonds voor beeldende kunsten, vormgeving en bouwkunst Stichting Fonds voor de Letteren Stichting Fonds voor de Scheppende Toonkunst Stichting Hout & Meubel Stichting Kenniscentrum Beroepsonderwijs Bedrijfsleven PMLF Stichting Kwaliteits-Controle-Bureau Stichting Nationale en Internationale Wegvervoer Organisatie Stichting Nederlands Fonds voor de Film Stichting Nederlands Letterenfonds Stichting Nederlands Literair Productie- en Vertalingenfonds Stichting Nederlandse Algemene Keuringsdienst voor zaaizaad en pootgoed van landbouwgewassen Stichting Nederlandse Algemene Kwaliteitsdienst voor de Tuinbouw Stichting Participatiefonds voor het Onderwijs Pagina 13 van 16

14 Stichting Pensioen- & Verzekeringskamer Stichting Skal Stichting Stimuleringsfonds Creatieve Industrie Stichting Vervangingsfonds en Bedrijfsgezondheidszorg voor het Onderwijs Stimuleringsfonds voor de Journalistiek Stimuleringsfonds voor de Pers Uitvoeringsinstituut werknemersverzekeringen Vereveningsinstantie Verispect BV Vut-fonds Waarborginstellingen (Edelmetaal Waarborg Nederland) Ziekenfondsraad Zorginstituut Nederland PBO's Bedrijfschap Afbouw Bedrijfschap Horeca en Catering Bedrijfschap voor het Natuursteenbedrijf (Opgeheven) Bedrijfschap voor het Slagersbedrijf (Opgeheven) Bosschap Hoofdbedrijfschap Agrarische Groothandel Hoofdbedrijfschap Ambachten Hoofdbedrijfschap Detailhandel Hoofdproductschap Akkerbouw Kenniscentra beroepsonderwijs bedrijfsleven Koninklijk Nederlands Instituut van Registeraccountants Koninklijke Beroepsorganisatie van Gerechtsdeurwaarders Koninklijke Notariële Beroepsorganisatie Nederlandse Loodsencorporatie Nederlandse Orde van Accountants-Administratieconsulenten Nederlandse Orde van Advocaten Nederlandse beroepsorganisatie van accountants Productschap Akkerbouw Productschap Diervoeder Productschap Dranken Productschap Granen, Zaden en Peulvruchten Productschap Pluimvee en Eieren Productschap Tuinbouw Productschap Vee en Vlees Productschap Vis Productschap Wijn Productschap Zuivel Productschap voor Margarine, Vetten en Oliën Sociaal-Economische Raad 6.4 Verdragsonderwerp Voorbeeld: overheidbwb.onderwerpverdrag == Arbeid Mogelijk waarden Arbeid Arbitrage Belasting Burgerlijk Procesrecht Burgerlijke stand Cultuur Diplomatieke en consulaire betrekkingen Douane Pagina 14 van 16

15 Economische samenwerking Eigendom, intellectuele en industriële Energie Flora en Fauna Gerechtshoven, Internationale Geschillenregeling Gezondheid Grenzen Grondstoffen Instellingen en organisaties Investeringen Landbouw en visserij Luchtvaart Mensenrechten Milieu Militair Monetair Nationaliteit Nucleaire samenwerking Onderwijs Ontwikkelingssamenwerking Overname van personen Personen- en Familierecht Personenverkeer en migratie Post Privaatrecht Privileges en immuniteiten Rechtshulp Ruimte Scheepvaart Sociale Zekerheid Spoorwegen Strafrecht Technische samenwerking Telecommunicatie Terrorisme Toerisme Uitlevering Verdovende middelen Verdragenrecht Vervoer Visa en reisdocumenten Vluchtelingen Voortzetting van verdragen Vrede Vriendschapsverdrag Wapens Water Wegverkeer Wetenschappelijke samenwerking Zetelverdrag 6.5 Overheidsdomein Voorbeeld: overheidbwb.overheidsdomein == Defensie Mogelijk waarden Defensie Pagina 15 van 16

16 Internationale- en ontwikkelingssamenwerking Onderwijs en wetenschap Financiën Immigratie, integratie en inburgering Werk- en loopbaan Economie en ondernemen Milieu, ruimte en water Familie, jeugd en gezin Belastingen Overheid, bestuur en koninkrijk Subsidies, uitkeringen en toeslagen Gezondheid en zorg Cultuur, sport, vrije tijd Rechtspraak Landbouw, natuur en voedsel Openbare orde en veiligheid Bouwen, wonen en leefomgeving Verkeer en vervoer Pagina 16 van 16