Instructie SOAP webservice (BHR-GT)

Je kunt volledig geautomatiseerd BRO-gegevens opvragen (via een SOAP XML-API). Dit is vooral handig als je regelmatig BRO-gegevens nodig heeft. Hieronder beschrijven we in 3 stappen hoe je kunt aansluiten op SOAP webservice van geotechnisch booronderzoek (BHR-GT) als onderdeel van het registratieobject booronderzoek en wat alternatieve mogelijkheden zijn om BRO-gegevens op te vragen.

Stap 3 is niet van toepassing als u software ontwikkelt en tegen de demo-omgeving aan wilt programmeren.

Stap 1: aansluiten op de demo-omgeving

Allereerst is aanmelden bij de BRO als data-afnemer noodzakelijk. Je ontvangt vervolgens van de Servicedesk een testcertificaat. Met dat certificaat en deze uitleg over de installatie van dat certificaat, kun je vervolgens aansluiten op de demo-omgeving van de SOAP webservice en een simpel request aanmaken. Na het aansluiten op de demo-omgeving, kun je verder met stap 2.

Om jouw software aan te passen om het juiste BRO-verzoekte laten genereren, zijn technische XML schema definities (XSD’s) beschikbaar. Vanuit dat schema zijn er de overige benodigde XML schema definities. Je vindt daar generieke BRO schema’s (brocommon) en specifieke (BHR-GT) schema’s (o.a. bhrgtcommon).

Je kunt ook gebruikmaken van voorbeeldberichten:

In de Berichtencatalogus uitgiftewebservice BHR-GT wordt beschreven hoe je als afnemer de gegevens van een geotechnisch booronderzoek (BHR-GT) kunt opvragen in een BRO-verzoek voor de Basisregistratie Ondergrond (BRO).

Stap 2: de inhoud van een BRO-verzoek maken

Zodra je aangesloten bent op de demo-omgeving, kun je de inhoud van een BRO-verzoek verder bepalen met de beschikbare gegevensstandaard:

Voor versie 2.1:

Je kunt kiezen uit:

Voor versie 1.1 (tot 1 januari 2022):

  1. Catalogus Geotechnisch booronderzoek (pdf, 2.9 MB) + aanvullende werkafspraak

Stap 3: aansluiten op de productieomgeving

Om daadwerkelijk gegevens op te kunnen vragen, moet je aansluiten op de productieomgeving. In die productieomgeving is het niet mogelijk om gebruik te maken van het testcertificaat. Je hebt dan een PKIoverheid services server certificaat nodig. Dit certificaat is te verkrijgen bij diverse leveranciers.

De overgang van de inregelomgeving naar de productieomgeving, is vervolgens niet meer dan het aanpassen van het endpoint. Gebruik dit endpoint voor productieomgeving van BHR-GT. Als het endpoint is aangepast, is de aansluiting op de SOAP webservice voor dit registratieobject gerealiseerd.

Andere mogelijkheden

  1. BRO-gegevens opvragen zonder PKI-certificaat met REST uitgifteservices. Voor een aantal registratieobjecten zijn deze REST services beschikbaar.  Deze service is zelf-beschrijvend volgens de OPEN API standaard. De swagger-ui pagina geeft de mogelijkheid tot het proberen van de service.
  2. BRO-gegevens online bekijken. Gegevens die geregistreerd worden in de BRO zijn een dag later beschikbaar via BROloket. Je kunt de gegevens op de kaart aan de hand van allerlei criteria bekijken en direct opvragen.

  3. BRO-gegevens voor uw database. Via het BROloket en PDOK (Publieke Dienstverlening op de Kaart), kun je bestanden met BRO-gegevens opvragen. Lees op het BROloket en PDOK wat de formaten en mogelijkheden zijn.