BRP (GBA) bevraging

Waar vandaan aangeroepen

Vanuit het contactadresdetailscherm (zie Contactadres) met de knop Controleer BRP/NHR.

Verplichte algemene instellingen

De instelling Sectie: KoppelingGBA en Item: Methode bestaat en is aangevinkt

EN kolom Tekst = StUF-BG 310

OF kolom Tekst = Competent

indien Competent dan moet de instelling Sectie: KoppelingBRP en Item: HTTPSoapActionStelGbavVraag bestaan waarbij kolom Tekst is gevuld met stelGbavVraag

indien Stuf-BG dan moet de instelling Sectie: KoppelingGBA en Item: HTTPSoapAction bestaan waarbij kolom Tekst is gevuld met http://www.egem.nl/StUF/sector/bg/0310/npsLv01.

EN de inlogger behoort tot een rechtengroep die wijzig BRP/NHR heeft op contactadressen (hoofdrechtengroep: tbrechten.dldcadbra).

Indien Competent zal voor elke gemeente waarvoor zaken of inrichtingen zijn gedefinieerd de organisatie een certificaat moeten bemachtigen bij Competent waarmee de organisatie gemachtigd is om voor die gemeente het BRP te bevragen.

Indien de instelling Sectie: KoppelingGBA en Item: AllowAllHostnameVerifier aangevinkt is zal de OpenWave Cloud instemmen met een self-signed of verlopen (server)certificaat bij een verbinding onder https (geldt voor zowel StUF BG als Competent).

Bij elke gemeente (beheerportaal-Nieuw: Gemeentes) is een blok gegevens te vullen:

Van boven naar beneden in blok GBAV/BRP bevraging (Competent en StUF-BG):

Endpoint voor BRP vraagberichten naar landelijke basisregistratie via Competent of endpoint van lokale makelaar bij StUF-BG bevraging

Client certificaatnaam: de naam van het client-certificaat zoals geïnstalleerd op de webserver (wsasmap conf). Het certificaat wordt door de systeembeheerder geplaatst op de webserver

Client certificaattype: certificaattype

Certificaat password (zie ook 2-way encryptie van externe wachtwoorden)

Https authenticatienaam: Indien geen certificaat (alleen mogelijk bij StUF-BG) dan kan de connectie beveiligd worden met naam en password

Password: (zie ook 2-way encryptie van externe wachtwoorden)

Methode: de authenticatie gegevens gaan weer bewerkt over het net. Ondersteund wordt momenteel Base (base64) en NTLM

Domein : Domein voor bovenstaande credentials.

Van boven naar beneden in blok BRP Competent stuurgegevens:

De indicatie van de afnemer zoals deze bepaald is door het Agentschap BRP

De (korte) naam van de gebruiker zoals deze bekend is in Competent.

Van boven naar beneden in blok Stuf-BG stuurgegevens:

afzender en ontvanger gegevens voor het stuurgedeelte van het stuf BG bericht. Ontvanger_Applicatie en Zender_Applicatie en Zender_Organisatie moeten gevuld zijn.

Facultatieve instellingen bij methode StUF-BG 310

In de kolom Getal2 van de instelling met Sectie: KoppelingGBA en Item: Zender_Applicatie kan het maximum aantal retourobjecten opgegeven worden (default 100).

In de kolom Tekst van de instelling met Sectie: KoppelingGBA en Item: Zender_Applicatie kan de sortering worden opgegeven (default: 2) van de stuurgegevens.

In de kolom Tekst van de instelling met Sectie: KoppelingGBA en Item: Charset kan opgegeven worden welke charset in de https header wordt gebruikt bijv. utf-8 (default is dat ook utf-8).

Indien zender-gebruiker op de gemeentetabelkaart (tb33gemeente.dvstufnhrzendergeb) in het blok GBAV/BPR Stuf BG stuurgegevens leeg is dan kijkt OpenWave naar de kolom Getal1 van de instelling Sectie: KoppelingGBA en Item: Zender_Gebruiker. Indien Getal1 de waarde 1 heeft, dan wordt in het StUF-bericht het stuurgegevens <zender> <gebruiker> gevuld met de loginnaam (tbmedewerkers.dvloginnaam) van de inlogger, indien 2 dan de email van de inlogger (tbmedewerkers.dvemail).

Bepaling van te gebruiken certificaat en authenticatiegegevens (zowel BRP als Stuf-BG)

Het programma zal het contactadres herleiden tot een locatie van een zaak of inrichting, waarbij dat contactadres een rol heeft vervuld. Die locatie heeft een gemeente-id. Zo weet OpenWave welk certificaat en endpoint gebruikt moet worden.

In geval dat de route naar het contactadresscherm via een specifieke zaak of inrichting loopt is er geen misverstand mogelijk namens welke gemeente de BRP of makelaar bevraagd gaat worden. Indien echter de route loopt via de tegel Adresboek op het openingsportaal kan het zijn dat het programma een willekeurige keuze moet doen uit meerdere zaken/inrichtingen waarbij het adres betrokken is.

Indien dat herleiden van een contactadres tot een zaak of inrichting mislukt dan wordt de melding Kan locatiegemeente niet achterhalen: geen zaak of inrichting verbonden aan contact getoond en gaat de bevraging niet door.

Is wel de gemeente-id op deze manier achterhaald, maar zijn de certificaat-kolommen van de gemeentetabel (beheer) niet goed gevuld bij de betreffende gemeente, of wordt het certificaat niet fysiek aangetroffen op de webserver dan wordt de melding Onvoldoende ssl/endpoint info bij gemeente X getoond en gaat de bevraging niet door.

Vraag en antwoordverwerking bij zowel methode Competent als StUf-BG 310

Voor het zoekvenster geldt dat minstens 1 van onderstaande beweringen waar moet zijn:

BSN is gevuld

postcode is gevuld (wordt default gevuld net de pc-waarde van vestigingsadres).

Er wordt case-sensitive gezocht en op de volledige waarden (dus niet: straatnaam begint met …).

De resultaat set bij Competent mag niet meer dan X items bedragen (standaard 6). Anders volgt een foutmelding en moet de zoekvraag aangepast worden.

Zo mogelijk worden naast BSN, geslacht, voorletters, tussenvoegsel en achternaam ook de geboortedatum en overlijdensdatum met de retourgegevens gevuld.

De kolom dvgebruiksnaam wordt als volgt gevuld op grond van tag aanduidinggebruik:

= 'V' dan ltrim(dvpartnervoorvoegsel + ' ' + dvpartnernaam + '-' + ltrim(dvvoorvoegsel + ' ' + dvachternaam

= 'N' dan ltrim(dvvoorvoegsel + ' ' + dvachternaam + '- ' + ltrim(dvpartnervoorvoegsel + ' ' + dvpartnernaam

= 'P' dan ltrim(dvpartnervoorvoegsel + ' ' + dvpartnernaam

= anders of leeg dan ltrim(dvvoorvoegsel + ' ' + dvachternaam

OpenWave kent bij een contact zowel een vestigingsadres als een postadres. De antwoorden op de BRP-bevraging kunnen voorzien zijn van verblijfsadres (altijd) en correspondentieadres (soms). OpenWave vraagt elke keer met radiobuttons hoe hier me om te gaan (en geeft aan of het correspondentieadres in het antwoordbericht gevuld is):

De keuze Verblijfsadres overnemen in zowel vestigingsadres als postadres bij ontbreken van correspondentieadres-gegevens heeft tot gevolg dat indien:

zowel verblijfsadres als correspondentieadres van het antwoord gevuld zijn, respectievelijk vestigingsadres en postadres daarmee gevuld worden

alleen verblijfsadres van het antwoord is gevuld, zowel het vestigingsadres als postadres daarmee gevuld worden.

De keuze Alleen verblijfsadres overnemen bij ontbreken van correspondentieadres-gegevens heeft tot gevolg dat indien:

zowel verblijfsadres als correspondentieadres van het antwoord gevuld zijn, respectievelijk vestigingsadres en postadres daarmee gevuld worden

alleen verblijfsadres van het antwoord is gevuld, alleen het vestigingsadres daarmee gevuld wordt.

De keuze Adresgegevens niet overnemen heeft tot gevolg dat zowel vestiging- als postadres niet worden overschreven.

Logging van vraag- en antwoordberichten

Loggen in tbMessagelog (beheertegel Messagelog) Deze logging staat aan indien de instelling aangevinkt is van Sectie: OWB en Item: MessageLog. In kolom Getal1 van deze instelling staat het aantal dagen dat de loggingskaarten bewaard moeten blijven. Default is dat 31.