====== BRP (GBA) bevraging ======

==== Waar vandaan aangeroepen ====

Vanuit het contactadresdetailscherm (zie [[openwave:1.29:applicatiebeheer:probleemoplossing:module_overstijgende_schermen:contact_adres|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).
<adm warning>
 **LET OP:** de SOAP-actions kunnen ingesloten moeten zijn met dubbele quootjes
</adm>
    

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: [[openwave:1.29:applicatiebeheer:probleemoplossing:portalen_en_moduleschermen:beheerportaal:tegels_onder_kolom_instellingen:gemeentes|Gemeentes]]) is een blok gegevens te vullen:

{{:openwave:applicatiebeheer:probleemoplossing:programmablokken:brp_gba_gmeente33t.png?600}}

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 [[openwave:1.29:applicatiebeheer:instellen_inrichten:2way_encryptie_externe_wachtwoorden|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 [[openwave:1.29:applicatiebeheer:instellen_inrichten:2way_encryptie_externe_wachtwoorden|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.