Regels verifiëren

Een API voor het verifiëren van toepasbare regel-bestanden zonder deze op te slaan in het digitaal stelsel.

Label: Toepasbare regels

Endpoint

https://service.pre.omgevingswet.overheid.nl/publiek/toepasbare-regels/api/verifierenregels/v1

Omschrijving

Om de geldende wet- en regelgeving voor een bepaalde activiteit en werkingsgebied te ontsluiten worden juridische regels vertaald naar zogeheten toepasbare regels. Deze toepasbare regels moeten worden aangeleverd volgens de Standaard Toepasbare Regels (STTR) en het onderliggende Informatiemodel Toepasbare Regels (IMTR).

Verificatie van de toepasbare regels

Om te verifiëren de opgestelde regels aan deze standaard voldoen kunnen de toepasbare regel-bestanden worden aangeboden aan de RegelsVerifiëren service, zonder dat deze bestanden worden verwerkt en opgeslagen.

Het toepasbare regel-bestand wordt op een aantal manieren geverifieerd. Er wordt gecontroleerd of het bestand voldoet aan de eisen van STTR/IMTR. De verificatie kent de volgende methoden:

  • Syntactisch – Tegen de XSD van DMN en de XSD’s van de + laag (Bedrijfsregels, Uitvoeringsregels, Interactieregels, Content). Hier wordt gecontroleerd of de structuur van het bestand correct is volgens de XSD’s.
  • Semantisch – Met behulp van Schematron (ISO Standaard). Hier wordt gecontroleerd of de onderlinge relaties in het bestand logisch en correct zijn en of het bestand consistent en volledig is.
  • Functionele verificatie – Door de achterliggende componenten. Bijvoorbeeld of de GEO gegevens vindbaar zijn in de ROD en opgeslagen kunnen worden in de Geo Component.

Voor de details van de verificatie zie hoofdstuk 11 van het IMTR document.

Terugkoppeling van de service

De service beantwoordt dit met één of meerdere verificatiemeldingen met als mogelijk:

  • de verificatiemethode
  • de reden van de melding en bijbehorende oplossing/eis
  • het element binnen het toepasbare regel-bestand

Documentatie

  • OpenAPI specification in JSON of gevisualiseerd via ReDoc

Standaarden

Informatiemodellen


Status

Versie 1 beschikbaar in béta in de pre-productieomgeving.

Versie 1.0 van de standaard (STTR).

Handleiding aansluiten (pdf) (STTR)

Meer informatie

Deze service is van belang in het proces toepasbare regels voor vragenbomen.

API-key

Om API's te gebruiken dient bij elke request een API-key meegegeven te worden. Alle API's werken met dezelfde key.

Feedback

Geef feedback op deze service. Ga naar het forum om je bevindingen te delen.