Kruimelpad

Wet- en regelgeving

Instellingen (nu: volledige regeling), opent een nieuw venster

Zoek opnieuw

Regeling burgerservicenummer

Geldend op 09-02-2012

De regeling die nu getoond wordt is dermate groot van omvang dat automatisch is overgeschakeld naar artikelsgewijze weergave. Klik op de knop hiernaast om over te schakelen naar complete weergave van de regeling. Let op: voor navigatie door de tekst in artikelsgewijze weergave maakt u gebruik van in de balk hierboven.

Bijlage , bedoeld in artikel 3 van de Regeling Burgerservicenummer

Het Logisch Ontwerp BSN

Versie 1.2

Inleiding

Leeswijzer

Het Logisch Ontwerp BSN bestaat uit vijf delen en vijf bijlagen. Het eerste deel bestaat uit de inleiding, de leeswijzer en de beschrijving van de context. Het tweede deel beschrijft de hoofdlijnen van de inrichting. In het derde deel wordt de werking van het systeem beschreven. Het vierde deel bevat informatie over de foutafhandeling. Het vijfde en laatste deel beschrijft de operationele eisen aan de Beheervoorziening BSN.

De eerste bijlage bevat een gegevenswoordenboek. Hierin zijn voor elk gegeven dat binnen de diensten van de Beheervoorziening BSN (BV BSN) wordt gebruikt de naam, de eisen (zoals bijvoorbeeld de elfproef1 en (indien aanwezig) een verwijzing naar de naam en definitie binnen het LO GBA opgenomen. De tweede bijlage bevat een dienstenboek waarin per dienst een vraag- en antwoordbeschrijving is opgenomen tezamen met de mogelijke inhoud. De derde bijlage beschrijft de aanlevering van de gegevens voor de interne registers van de BV BSN. De vierde bijlage beschrijft het zoekmechanisme dat binnen het stelsel gebruikt wordt om verschillende vragen te beantwoorden. De vijfde bijlage bevat een verklarende woordenlijst.

In het Logisch Ontwerp BSN wordt onderscheid gemaakt tussen de actoren ‘gebruikers’ en ‘registerhouders’. Omdat niet alle functies van de BV BSN van belang zijn voor alle actoren, is hieronder een overzicht opgenomen dat per hoofdstuk aangeeft welke delen van belang zijn voor welke actor(en).

Tabel 1.1a – Leeswijzer LO BSN
	Gebruikers	Registerhouders
0. Inleiding	Geheel	Geheel
0. Hoofdlijnen inrichting	Geheel	Geheel
0. Werking van de Beheervoorziening BSN
0. Aansluiten op de Beheervoorziening BSN	Geheel	Geheel
0. Functies van de Beheervoorziening BSN	0 t/m 0	Geheel, m.u.v. 0
0. Gegevens in de Beheervoorziening BSN	Geheel	Geheel
0. Foutafhandeling	Geheel	Geheel
0. Operationele eisen Beheervoorziening BSN	Geheel	Geheel

Context

Het burgerservicenummer (BSN) is een uniek identificerend nummer voor iedereen die een relatie heeft met de Nederlandse overheid.

Met dit nummer kan men bij elk (digitaal) loket in de publieke sector terecht. Het BSN heeft binnen de gegevenshuishouding van de overheid een spilfunctie. Met dit persoonsnummer kunnen persoonsgebonden gegevens doelmatig en betrouwbaar uitgewisseld worden binnen de overheid en tussen de overheid en burgers. Een adequaat persoonsnummerbeleid is een belangrijke voorwaarde om te komen tot een verbetering van de (elektronische) dienstverlening van de overheid. Ook draagt invoering van het BSN bij aan de bestrijding van identiteitsfraude.

Getalsmatig is het BSN identiek aan het Sofi-nummer. Het verschil tussen het BSN en het Sofi-nummer ligt in het bereik ervan en de wijze waarop wettelijk is vastgelegd wat met behulp van het BSN mag gebeuren. Het BSN wordt door (overheids)organisaties gebruikt voor de communicatie met de burger en, daar waar dat wettelijk is toegestaan, voor de uitwisseling van persoonsgegevens tussen (overheids)organisaties onderling.

De BV BSN is het geheel van voorzieningen dat zorgt voor het genereren, distribueren, beheren en raadplegen van het BSN. De Beheervoorziening regelt ook de toegang tot de identificerende gegevens van een persoon in de achterliggende registraties.

Het Logisch Ontwerp BSN

De BV BSN biedt voorzieningen die ervoor zorgen dat het genereren, het distribueren en het toekennen van het BSN goed verlopen. Hierbij wordt onder andere ondersteuning geboden om te voorkomen dat één persoon meerdere nummers toegekend kan krijgen. Verder biedt de BV BSN voorzieningen voor het stellen van verificatievragen over de identiteit en Nederlandse identiteitsdocumenten van een persoon.

Voor een aantal van deze voorzieningen wordt gebruik gemaakt van persoonsgegevens die zijn opgeslagen in andere registraties. Communicatie met deze registraties verloopt via technische voorzieningen waarmee een tweetal registraties worden ontsloten: de ‘Gemeentelijke Basisadministratie’ (GBA) en het ‘Beheer van Relaties’ (BvR, van de Belastingdienst). Voor de verificatie van de geldigheid van een identiteitsdocument (paspoort, identiteitskaart, rijbewijs of vreemdelingenkaart) is er communicatie met de registers die deze informatie beheren.

In het ontwerp van het BSN-stelsel is al rekening gehouden met de nog te vormen Registratie Niet-Ingezetenen (RNI). In het Logisch Ontwerp BSN is deze registratie echter nog niet beschreven. Wanneer de RNI operationeel is, zal dit leiden tot een herziening van het LO BSN.

De elektronische samenwerking (voor het genereren, distribueren, beheren en raadplegen van het BSN) geschiedt op basis van berichtenuitwisselingen. Om deze samenwerking te ondersteunen binnen het BSN-stelsel, is gekozen voor een eenduidige technische beschrijving in het Logisch Ontwerp BSN.

Dit document bevat een volledig overzicht van die onderdelen die noodzakelijk zijn voor de elektronische samenwerking tussen geautomatiseerde systemen van gebruikers en registraties enerzijds en de BV BSN, anderzijds. Daarbij worden de functionaliteiten van het systeem beschreven. Voor een gedetailleerde beschrijving van het systeem kunt u contact opnemen met het agentschap BPR.

Uitgangsdocumentatie

• Logisch Ontwerp GBA versie 3.7: Een systeembeschrijving van systemen die aansluiten op het GBA-stelsel.
• Wet algemene bepalingen burgerservicenummer (Wabb): de wet betreffende de toekenning, het beheer en het gebruik van het BSN.
• Besluit BSN

Hoofdlijnen inrichting

De BV BSN communiceert met verschillende onderdelen. Hierin zijn de volgende onderdelen te identificeren:

• Gebruikers (deels via een Sectorale Berichtenvoorziening – SBV)
• GBA systemen bij gemeenten
• BvR (Belastingdienst)
• Verificatieregister (Nederlandse identiteitskaart, paspoorten)
• Rijbewijsregister (Nederlandse rijbewijzen)
• Kaartregister (Vreemdelingenkaarten)

Deze onderdelen zullen achtereenvolgens behandeld worden.

Figuur 2.2a – Overzicht Beheervoorziening BSN-stelsel

De Gebruikers

Gebruikers kunnen de Beheervoorziening rechtstreeks of via een Sectorale Berichtenvoorziening (SBV) benaderen. Het initiatief voor het instellen van een sectorale berichtenvoorziening ligt bij de voor die sector verantwoordelijke Minister. Tot de primaire taak van een sectorale berichtenvoorziening behoort het vaststellen of een organisatie die zich meldt, daadwerkelijk een gebruiker is binnen de sector (autorisatie en authenticatie) en het routeren van het berichtenverkeer tussen de BV BSN en de gebruikers. Een SBV maakt het in combinatie met de BV BSN mogelijk om grote aantallen gebruikers toegang te verschaffen tot de functies van de BV BSN zonder dat daarvoor bij de BV BSN individuele autorisaties moeten worden verleend.

Redenen voor beëindiging aansluiting

De aansluiting op de BV BSN kan om de volgende redenen worden opgeschort of beëindigd:

• Beveiligingsincident
De Beheerorganisatie kan de toegang tot de BV BSN tijdelijk opschorten indien er sprake is van mogelijk misbruik of een ander beveiligingsincident.
• Eigen verzoek
De gebruikersorganisatie die de aansluiting op de BV BSN wenst te beëindigen dient hiertoe, met inachtneming van een opzegtermijn van één maand, een schriftelijk verzoek in te dienen bij de beheerorganisatie.
• Oprichting sectorale berichtenvoorziening (SBV)
De dienstverlening van BV BSN wordt stopgezet, indien een sectorale berichtenvoorziening wordt ontwikkeld waarop de gebruikersorganisatie verplicht dient aan te sluiten. Wanneer deze verplichting eerst na de rechtstreekse aansluiting op de BV BSN ontstaat, zal de gebruiker moeten overstappen op de SBV.

GBA-systemen bij gemeenten

De BV BSN ondersteunt de functionaliteit voor het verifiëren van de identiteit van een persoon binnen de GBA en het matchen van persoonsgegevens van personen die zijn ingeschreven in de GBA, teneinde vast te stellen of aan deze persoon reeds een BSN is toegekend.

De BV BSN houdt gegevens uit de GBA-V aan, ten behoeve van een optimale bevraging van het systeem. Meer informatie over de gegevensset is te vinden in bijlage 0.

De Belastingdienst

De Belastingdienst, onderdeel van het BSN-stelsel biedt de mogelijkheid voor het matchen van persoonsgegevens binnen een deelverzameling van het bestand Beheer van Relaties (BvR) teneinde vast te stellen of aan een persoon reeds een sofi-nummer is toegekend.

Ten behoeve van een optimale bevraging van het systeem houdt de BV BSN tijdelijk gegevens aan uit het BvR. Dit maakt het mogelijk om voor levende natuurlijke personen waarvan in BvR geen A-nummer is geregistreerd het sofi-nummer ‘op te waarderen’ tot BSN.

De Documentregisters

Deze componenten bestaan uit een aantal registers en ondersteunen functionaliteiten voor het verifiëren van de mogelijke ongeldigheid van de volgende Nederlandse identiteitsdocumenten van een persoon:

• Paspoorten en Nederlandse identiteitskaarten
• Rijbewijzen
• Vreemdelingenkaarten

Bij communicatie vanuit de BV BSN naar deze registers wordt gebruik gemaakt van reeds beschikbare communicatiemogelijkheden.

Er is bij de verificatie van identiteitsdocumenten gekozen om vanuit de BV BSN één mechanisme te gebruiken voor alle documenttypen (paspoorten, rijbewijzen, identiteitskaarten en vreemdelingenkaarten). Het systeem geeft op basis van een documentnummer en documenttype antwoord op de vraag of een document al dan niet gebruikt kan worden als identiteitsdocument volgens de Wet op de identificatieplicht, artikel 1, eerste lid onder 1, 2 en 4. Afhankelijk van het gekozen type wordt één van de volgende registers bevraagd:

• Verificatieregister, beheerd door het agentschap Basisadministratie Persoonsgegevens en Reisdocumenten (BPR)
• Rijbewijsregister, beheerd door de Rijksdienst voor het Wegverkeer (RDW)
• Kaartregister van de Basisvoorziening Vreemdelingen, beheerd door het Ministerie van Justitie

Verificatieregister

Het verificatieregister is een hit/no hit register en geeft bij het opgeven van het nummer van een reisdocument informatie over de geldigheid van het document. In het register wordt bijgehouden welke Nederlandse reisdocumenten (paspoorten en Nederlandse identiteitskaarten) niet in het vrije verkeer mogen voorkomen, in het bijzonder:

• Reisdocumenten die zijn ontvreemd of anderszins als vermist zijn opgegeven;
• Reisdocumenten met een nog geldige looptijd waarvan de houder is overleden;
• Reisdocumenten die van rechtswege zijn vervallen (door verlies van de Nederlandse nationaliteit, verblijfsstatus of diplomatieke status, wijziging van de naam, geboortedatum of geslacht), dan wel doordat zij op grond van onjuistegegevens blijken te zijn verstrekt.

Rijbewijsregister

In het Rijbewijsregister zijn gegevens met betrekking tot verstrekte rijbewijzen opgeslagen. Hieruit kan worden opgevraagd welke rijbewijzen uit verkeer zijn gehaald en dus niet als identiteitsbewijs kunnen worden gebruikt.

BVV-Kaartregister

In het kaartregister van de Basisvoorziening Vreemdelingen (BVV) worden de gegevens van de uitgegeven vreemdelingenkaarten door het Ministerie van Justitie vastgelegd. Uit deze gegevens kan worden afgeleid of een vreemdelingenkaart als identiteitsbewijs mag worden gebruikt.

Werking van de Beheervoorziening BSN

Aansluiten op de Beheervoorziening BSN

Voor organisaties die aansluiten op de BV BSN is een aansluitprocedure2 opgesteld.

De volgende aspecten zijn bij communicatie met de BV BSN van belang:

• Authenticatie en autorisatie
• Communicatieprotocol
• Lijnvoorwaarden
• Gegevensstandaarden

Authenticatie en autorisatie

De berichtenuitwisseling is beveiligd volgens de richtlijnen van de ‘PKI voor de Overheid’ waarbij het volgende geldt:

1. Authenticatie vindt plaats op basis van PKIOverheid (X.509) certificaten;
2. Voor authenticatie (en gegevensversleuteling) op netwerkniveau wordt gebruik gemaakt van SSL (Secure Sockets Layer);
3. De BV BSN toetst de geldigheid van het certificaat van de gebruiker aan de hand van de geldigheidsdatum van het certificaat en de ‘Certificate Revocation List’;
4. Er wordt een SSL-sessie opgezet, waarbinnen meerdere berichten tussen gebruiker en BV BSN kunnen worden uitgewisseld, met een instelbare ‘time-out’ (tijd van inactiviteit waarna het authenticatieproces opnieuw dient plaats te vinden).
5. Na een vaste (instelbare) tijdsperiode (levensduur) dient de SSL-sessie hoe dan ook te worden vernieuwd.

Bij registratie van de gebruikers worden gegevens rond het te gebruiken PKI Overheid-certificaat uitgewisseld. Deze dient voor de beveiliging van communicatie tussen BV BSN en de aansluitende gebruiker of SBV. De SBV zal de achterliggende gebruikers moeten authenticeren en autoriseren via een zelf in te richten beveiligingsmechanisme.

Het systeem bepaalt aan de hand van de identiteit, die tijdens de authenticatie is vastgesteld, de autorisatie. Aan de hand van de ‘Distinguished Name’ uit het digitale certificaat dat voor authenticatie is gebruikt wordt de rol van de afzender bepaald. Deze rol, samen met een indicatie van de gevraagde dienst, bepaalt of de afzender geautoriseerd is voor het gebruik van de gevraagde dienst.

Communicatieprotocol

Voor het mogelijk maken van berichtenverkeer met de BV BSN worden webservices toegepast die communiceren op basis van het TCP/IP protocol over HTTPS (poort 443). De webservices van de BV BSN maken gebruik van het SOAP-protocol.

De BV BSN conformeert zich aan Basic profile versie 1.0 van de WS-I standaarden. Conform Basic profile 1.0 gebruikt de BV BSN SOAP versie 1.1 en SOAP berichttype ‘document / literal’.

Transportnetwerk

Een lijst met transportnetwerken die beschikbaar zijn voor toegang tot de BV BSN, is opvraagbaar bij het agentschap BPR. De term ‘transportnetwerk’ wordt gebruikt voor het netwerk dat door eindsystemen wordt gebruikt om verbinding te leggen met het BV BSN netwerk.

De BV BSN is niet aangesloten op het internet.

Gegevensstandaarden

In de onderstaande tabel zijn de verschillende standaarden weergegeven die betrekking hebben op de gegevens binnen het Beheervoorziening BSN-stelsel.

Tabel 3.1.3a – Beheervoorziening BSN gebruikte standaarden
Standaard	Opmerkingen
GBA Logisch ontwerp 3.7	Conformering door beheervoorziening aan gegevensset en tabellen
Teletex GBA	Tekenset van bronregistratie. Subset van ISO 6937 (292 tekens). Deze tekenset wordt gebruikt ten behoeve van de uitwisseling van GBA-berichten.
Unicode, ISO 10646 UTF-8	Tekenset in gebruik door Beheervoorziening BSN voor de uitwisseling van berichten via de webservices.

Functies van de Beheervoorziening BSN

Aanmaken van nummers

Het BSN is een uniek identificerend persoonsnummer. De BV BSN voorziet toekennende organisaties van een voorraad BSN’s.

Voor het aanmaken en opslaan van nieuwe nummers zijn twee componenten van belang:

• De Nummergenerator
• Het Nummerregister

De Nummergenerator

De Nummergenerator verzorgt het proces waarbij nieuwe nummers worden gegenereerd (die als BSN kunnen worden toegekend) en in het Nummerregister worden opgenomen. De aangemaakte nummers liggen in een ingesteld interval en worden direct na het aanmaken in het Nummerregister (zie paragraaf ‘Het Nummerregister’) opgeslagen met de status ‘aangemaakt’.

Om als BSN te kunnen worden toegekend moeten de gegenereerde nummers aan bepaalde eisen voldoen. Voor de nummers gelden de volgende eisen:

• Ieder gegenereerd nummer moet uniek zijn;
• Ieder gegenereerd nummer moet 9-cijferig zijn en aan de 11-proef3 voldoen;
• Ieder gegenereerd nummer moet informatieloos zijn;
• Er mag geen volgordelijkheid uit de nummers blijken;
• Het nummer moet binnen het ingestelde interval liggen.

Het Nummerregister

Het Nummerregister is een registratie waarin de status van alle nummers wordt vastgelegd. Per nummer wordt vastgelegd:

• in welke status het nummer zich bevindt (aangemaakt, gedistribueerd, in verkeer of uit verkeer)
• aan welke instantie het nummer gedistribueerd is
• welke instantie het nummer heeft opgewaardeerd
• de instantie die een wijziging van de achterliggende registratie, waarin de persoonsgegevens zijn opgeslagen, heeft doorgevoerd (het omhangen van een nummer)
• welke instantie het nummer uit verkeer heeft gehaald.

Naast bovenstaande gegevens wordt bijgehouden op welke tijdstippen de verschillende acties zijn uitgevoerd en wordt er een indicatie aangehouden waarmee wordt aangegeven in welke registratie de persoonsgegevens behorende bij het nummer zijn terug te vinden.

Naast de actuele nummergegevens worden tevens, bij een mutatie, alle historische gegevens van het BSN opgeslagen.

Distribueren van nummers

Instanties die BSN’s kunnen toekennen beschikken over een voorraad BSN’s die de status ‘Gedistribueerd’ in het Nummerregister van de BV BSN hebben. Deze instanties verkrijgen deze nummers door deze aan te vragen bij de BV BSN met behulp van de dienst ‘Aanvragen BSN voorraad4 ’. De BV BSN dienst levert uit het Nummerregister het gewenste aantal nummers, of het maximum aantal dat geldt voor de betreffende instantie. Nadat de nummers aan de instantie geleverd zijn, wordt de status van de gedistribueerde nummers in het Nummerregister gewijzigd van ‘Aangemaakt’ naar ‘Gedistribueerd’.

Toekennen van nummers

Een instantie beschikt over een aantal nummers dat de status ‘Gedistribueerd’ heeft in het nummerregister. Deze nummers kunnen door de instantie als BSN worden toegekend aan personen. Nadat een nummer is toegekend aan een persoon, wordt daarvan melding gemaakt aan de BV BSN door middel van een vulbericht.5

Voorafgaand aan het toekennen van een BSN moet de instantie een presentievraag uitvoeren, door middel van de dienst ‘Presentievraag6 ’, bij de BV BSN. Gebruik van deze dienst is noodzakelijk bij een eerste inschrijving en vervolginschrijvingen waarbij sprake is van een tussentijds verblijf.

Het doel van de presentievraag is het voorkomen dat een persoon aan wie al een sofi-nummer is toegekend, nog een ander nummer toegewezen krijgt. De BV BSN registreert de toekenning van het BSN door de status van het nummer in het Nummerregister te wijzigen van ‘Gedistribueerd’ naar ‘In verkeer’.

De Belastingdienst kent geen BSN’s toe. Wel geeft de Belastingdienst sofi-nummers uit aan belastingplichtigen die geen BSN hebben. Als deze personen later een BSN toegekend krijgen dan is het de bedoeling dat bij de betreffende gemeente van inschrijving (of andere toekennende instantie) het sofi-nummer wordt ‘opgewaardeerd’ naar een BSN. Via de BV BSN kan de toekennende instantie opvragen of de persoon reeds een sofi-nummer bezit. Deze werkwijze wordt mogelijk gemaakt door een courante registratie van sofi-nummers zonder ‘A-nummer’ (dat wil zeggen personen zonder koppeling met GBA-gegevens) van nog levende personen in de gegevensset binnen de BV BSN.

Wijzigen van nummergegevens

Een instantie kan het BSN dat toegewezen is aan een persoon wijzigen, bijvoorbeeld wanneer aan een en dezelfde persoon twee verschillende nummers zijn toegekend.

Met behulp van de dienst ‘Wijzigen BSN7 ’ kan het oude (foutieve) nummer van de persoon ‘uit verkeer’ gehaald worden, en een nieuw BSN op basis van dezelfde persoonslijst ‘in verkeer’ genomen worden.

Uit verkeer nemen van nummers

Instanties kunnen BSN’s uit verkeer halen met behulp van de dienst ‘Afvoeren PL8 ’. In het nummerregister krijgt het BSN door het gebruik van deze dienst de status ‘uit verkeer’.

Verificatie

De BV BSN voorziet in functionaliteiten voor het verifiëren van nummers, persoonsgegevens en documenten:

• Toets nummer
• Toets document
• Opvragen identificerende gegevens op basis van een BSN
• Opvragen BSN op basis van identificerende gegevens
• Toetsen van de combinatie BSN en identificerende gegevens

1. Toets nummer

Alle aangesloten gebruikers kunnen bij de BV BSN de geldigheid van een BSN toetsen met behulp van de dienst ‘Toets of nummer een BSN is9 ’. Op basis van het invoeren van een nummer wordt door het bevragen van het nummerregister bepaald of het nummer een bestaand BSN is. Het nummer wordt uitsluitend als een geldig BSN aangegeven als het in het nummerregister geregistreerd is met de status ‘In verkeer’.

2. Toets Document

Alle aangesloten gebruikers kunnen het in verkeer zijn van een identiteitsdocument toetsen met behulp van de dienst ‘Verificatie van identiteitsdocumenten10 ’. Omdat het principe geldt dat bij aanvang van de dienstverlening op basis van het BSN vergewisplicht wenselijk is, moeten de gebruikers van het stelsel in staat worden gesteld om te verifiëren of het Nederlandse document, waarmee de identiteit wordt geverifieerd, in omloop mag zijn. Het verifiëren vindt plaats op basis van het identiteitsdocumentnummer en -type.

De verificatievraag geeft enkel antwoord op de vraag of het document dat bij het documentnummer hoort in verkeer is en zegt niets over de echtheid van het aangeboden document. Het is aan de gebruiker om te bepalen of het document aan de echtheidskenmerken voldoet en of deze wordt aangeboden door de rechtmatige houder.

3. Opvragen identificerende gegevens op basis van een BSN

Met de dienst ‘Opvragen identificerende gegevens op basis van een BSN11 ’ is het mogelijk om een unieke set identificerende gegevens behorende bij een BSN uit de registratie GBA op te vragen.

4. Opvragen BSN op basis van identificerende gegevens

De dienst ‘Opvragen BSN op basis van identificerende gegevens12 ’ maakt het voor de gebruiker mogelijk om op basis van een minimale set van identificerende gegevens een BSN en de in de GBA opgenomen gegevens op te vragen.

5. Toetsen van de combinatie BSN en identificerende gegevens

Gebruikers kunnen aan de hand van de dienst ‘Toetsen van de combinatie BSN en identificerende gegevens13 ’ controleren of de set van identificerende gegevens in de registratie GBA behorende bij een gegeven BSN, overeenkomt met de opgegeven set identificerende gegevens in het bericht.

Foutdetectie

Tijdens de verwerking van de verschillende aanvragen van gebruikers, voert de BV BSN geautomatiseerd een aantal controles uit. Als gevolg van deze controles kunnen logische fouten ontdekt worden. Deze worden vastgelegd in het nummerfoutenlogboek14 . Aan de hand van de foutvermoedens in het nummerfoutenlogboek zal het Foutenmeldpunt de foutafhandelingsprocedure opstarten.

Naast de nummerfoutvermoedens worden technische problemen vastgelegd in het systeemfoutenlogboek15 . De beheerder van de BV BSN kan dit logboek inzien en desgewenst actie ondernemen.

Misbruikdetectie

Misbruik van het systeem kan leiden tot een verminderde prestatie van het systeem. Om misbruik van het systeem te kunnen onderzoeken wordt afwijkend gebruik16 van de BV BSN gesignaleerd. Hierbij kan gedacht worden aan niet toegestaan gebruik van de gebruikersfuncties of foutief gebruik als gevolg van storingen.

Wordt er een functie aangesproken waarvoor de gebruiker geen autorisatie heeft, dan zal dit in het auditlog worden vastgelegd. Door analyse van de gegevens in de audit- en berichtenlogboeken kan bepaald worden welke situatie zich voordoet en welke acties hierop worden genomen.

Gegevens in de Beheervoorziening BSN

Via de BV BSN worden persoons-, nummer- of documentgegevens opgevraagd uit de verschillende registers. Daarnaast worden binnen de BV BSN gegevens tijdelijk aangehouden om een optimale bevraging van het systeem te kunnen waarborgen. Tenslotte worden er ook enkele logboeken binnen de BV BSN aangehouden.

Persoonsgegevens

De set persoonsgegevens die door de BV BSN gebruikt wordt, is tweeledig. Enerzijds zijn er de gegevens die gebruikt worden bij de bepaling of er al een BSN of een sofi-nummer is toegekend aan een persoon, anderzijds is er de set gegevens ter beantwoording van de gebruikersvraag of aan een bepaald persoon een BSN is toegekend en welk BSN dat is of aan welke persoon een bepaald BSN is toegekend.

Gegevens met behulp waarvan kan worden vastgesteld of aan een persoon al een BSN is toegekend en welk nummer aan de betrokken persoon is toegekend zijn:

• het burgerservicenummer;
• geslachtsnaam;
• voornamen;
• adellijke titel of predikaat;
• geboortedatum;
• geboorteplaats;
• geboorteland;
• geslacht;
• nationaliteit of nationaliteiten;
• datum overlijden;
• omschrijving reden opschorting;
• indicatie geheim;
• adresgegevens;
• vorig land van verblijf;
• datum vertrek uit Nederland;
• aanduiding gegevens in onderzoek;
• datum ingang onderzoek;
• registratie waarvan de gegevens zijn betrokken;
• aanduiding van de mate waarin de gegevens overeenkomen met de gevraagde gegevens17 .

Gegevens waarmee kan worden vastgesteld of aan een persoon al een sofi-nummer is toegekend en welk nummer aan de betrokken persoon is toegekend:

• het sofi-nummer;
• geslachtsnaam;
• voornamen of voorletters;
• adellijke titel of predikaat;
• geboortedatum;
• geslacht;
• adres;
• woonplaats;
• land;
• emigratiedatum;
• registratie waarvan de gegevens zijn betrokken;
• aanduiding van de mate waarin de gegevens overeenkomen met de gevraagde gegevens.

De gegevens die aan een gebruiker worden verstrekt ter beantwoording van de vraag of aan een bepaald persoon een BSN is toegekend en welk BSN dat is en de vraag aan welk persoon een bepaald BSN is toegekend:

• het burgerservicenummer;
• geslachtsnaam;
• voornamen;
• adellijke titel of predikaat;
• geboortedatum;
• geboorteplaats;
• geboorteland;
• geslacht;
• datum overlijden;
• aanduiding gegevens in onderzoek;
• datum ingang onderzoek;
• omschrijving reden opschorting;
• indicatie geheim.

Tenzij er sprake is van een aanduiding over het niet-verstrekken van gegevens aan derden op grond van artikel 102 van de Wet gemeentelijke basisadministratie persoonsgegevens, worden ook de volgende gegevens verstrekt:

• gemeente van inschrijving;
• adresgegevens.

Nummergegevens

In het nummerregister worden over de daarin opgenomen nummers de volgende administratieve gegevens opgenomen:

• de datum waarop het nummer is aangemaakt;
• de status van het nummer;
• instantie waaraan het nummer is gedistribueerd;
• de datum waarop het nummer ter beschikking is gesteld;
• instantie die het nummer heeft toegekend;
• de datum waarop het nummer is toegekend;
• instantie die het nummer uit het verkeer heeft genomen;
• de datum waarop het nummer uit het verkeer is genomen;
• het type registratie waarin gegevens over het nummer zijn opgenomen.

Logging en protocollering

Zowel de BV BSN als haar gebruikers dienen te voorzien in opslag van een aantal gegevens. Hierbij kan een onderscheid worden gemaakt in loggegevens en protocolgegevens.

Voor logging bestaan binnen de BV BSN verschillende registers.

• Auditlogboek
• Berichtenlogboek
• Nummerfoutenlogboek
• Systeemfoutenlogboek

Auditlogboek

In dit logboek wordt alle informatie over de verwerking van berichten vastgelegd. Op basis van deze gegevens kan de correcte werking van het systeem worden vastgesteld.

In het logboek wordt voor elk bericht vastgelegd of het correct is afgehandeld. Indien een bericht niet succesvol afgehandeld is, worden voor dat bericht ook alle tussentijdse verwerkingsstappen vastgelegd.

Berichtenlogboek

In het berichtenlogboek worden alle binnengekomen en verzonden berichten vastgelegd. Elk inkomend bericht krijgt een uniek berichtnummer; het bijbehorende uitgaande bericht heeft hetzelfde nummer. Naast de inhoud van het bericht worden gegevens als afzender, berichttype, datum en tijd vastgelegd. Het totaal aan informatie wordt opgeslagen in het berichtenlogboek.

Nummerfoutenlogboek

Er is een aantal mogelijke situaties die (functioneel gezien) niet voor zou mogen komen. Om het Foutenmeldpunt18 in de gelegenheid te stellen de gevonden fout(en) te onderzoeken, worden deze functionele nummerfouten vastgelegd in het nummerfoutenlogboek. Hiertoe worden bij (meldingen van) nummerfouten het berichtnummer, het BSN waar het bericht op van toepassing is, een indicatie van de fout, het tijdstip en een indicatie of het foutvermoeden in behandeling is genomen vastgelegd.

Systeemfoutenlogboek

Als er een systeemfout (een technische fout) optreedt dan wordt deze weggeschreven in het systeemfoutenlogboek. Door het raadplegen van deze informatie kan door de beheerorganisatie de oorzaak van de technische fout worden achterhaald. In het systeemfoutenlogboek wordt naast het berichtnummer en het tijdstip, tevens een beschrijving van de systeemfout opgeslagen.

BV BSN protocolgegevens (Protocol)

Protocolleren is het vastleggen van alle bevragingen die door gebruikers worden gedaan op BSNs. Met het protocollogboek kan (door de beheerder) worden voldaan aan de wettelijke eis om burgers, die daarom vragen, te informeren over de gegevens die over hen zijn verstrekt.

In het protocollogboek worden toekenningen van een BSN aan een persoon vastgelegd en aan wie informatie van een BSN (en aanvullende persoonlijke gegevens) is verstrekt.

Naast de afzender van een bericht (het verzoek om persoonsgegevens), het tijdstip en het betrokken BSN, wordt tevens het type vraag vastgelegd. Aan de hand van de gevraagde dienst kan worden herleid welke gegevens er verstrekt zijn aan de afzender.

Bewaar- en Schoningstermijn voor log- en protocolgegevens

Vanuit logging en protocollering worden gegevens voor een bepaalde (minimale) bewaartermijn opgeslagen. Gedurende deze periode mag men erop vertrouwen dat de gegevens nog binnen de BV BSN beschikbaar zijn. Verder zijn er ook schoningstermijnen vastgesteld. Na het verstrijken van de betreffende schoningstermijn worden de gegevens verwijderd. In onderstaande tabel zijn de afgesproken termijnen vermeld.

Tabel 3.3.4a – Bewaar- en Schoningstermijnen
Doel	Bewaartermijn	Schoningstermijn
Protocol	1 jaar	1,5 jaar
Berichtlogboek	4 weken	6 weken
Auditlog	1 jaar	1,5 jaar
Foutlogboek	1 jaar	1,5 jaar

Foutafhandeling

Het is mogelijk dat er nummerfouten ontdekt worden. Gebruikers mogen foutvermoedens direct melden bij het Foutenmeldpunt van de BV BSN of deze melden aan een registerhouder. Registerhouders moeten geconstateerde foutvermoedens aan het Foutenmeldpunt melden. Het Foutenmeldpunt verzorgt het afhandelen van de nummerfoutvermoedens.

Bij de nummerfoutvermoedens worden drie categorieën onderkend:

1. Situaties waarbji aan één persoon meerdere nummers zijn toegekend.
2. Situaties waarbij hetzelfde nummer aan meerdere persoon is toegekend.
3. Overige fouten met betrekking tot nummergegevens, zoals inconsistentie tussen de verschillende registraties. Fouten met betrekking tot persoonsgegevens vallen niet binnen het werkgebied van het Foutenmeldpunt.

Het foutafhandelingsproces bestaat uit vijf stappen:

1. Signaleren foutvermoeden
2. Intake van foutvermoeden
3. Onderzoeken foutmelding
4. Oplossen fout
5. Afsluiten foutmelding

Signaleren foutvermoeden

Gebruikers en registerhouders kunnen hun foutvermoedens melden bij een van de registerhouders of bij het Foutenmeldpunt.

Intake van foutvermoeden

Bij de melding bij het Foutenmeldpunt wordt het foutvermoeden direct geregistreerd. Het Foutenmeldpunt voert vervolgens een korte analyse uit op de foutmelding om te beoordelen of het een fout is voor het foutenmeldpunt. Een medewerker van het Foutenmeldpunt zet de foutmelding voor onderzoek uit bij de betreffende gemeente(n). Wanneer de fout niet binnen de werkzaamheden van het Foutenmeldpunt behoort, wordt het foutvermoeden niet verder in behandeling genomen.

Onderzoeken foutmelding

Naar aanleiding van de foutmelding zal de gemeente beslissen of het betreffende BSN in onderzoek wordt geplaatst. De gemeente onderzoekt de foutmelding, waarbij gebruik wordt gemaakt van brondocumenten en wordt er eventueel contact opgenomen met de burger. Wanneer inderdaad sprake is van een foutsituatie stelt de gemeente (eventueel in overleg met andere betrokken registerhouders) vast op welke wijze de fout wordt hersteld. Wanneer de medewerker van de gemeente vaststelt dat er geen sprake is van een foutsituatie wordt de foutmelding afgemeld bij het Foutenmeldpunt.

Oplossen fout

In deze fase wordt de fout opgelost door de betrokken gemeente of het Foutenmeldpunt.

Afsluiten foutmelding

De gemeente meldt de fout af bij het Foutenmeldpunt. Van de afsluiting wordt door het Foutenmeldpunt melding gedaan aan de melder. Indien de afhandeling van een nummerfout leidt tot wijziging van een BSN, zal de registerhouder de persoon waarop het BSN betrekking heeft, daarover informeren.

Operationele eisen Beheervoorziening BSN

De BV BSN levert dienstverlening van 7 maal 24 uur, waarbij een een beschikbaarheid van 99,8% op jaarbasis gehanteerd wordt. Er dient dus rekening te worden gehouden met (on)voorzien niet operationeel zijn van de BV BSN van ongeveer 17,5 uur op jaarbasis. Dit percentage is berekend op basis van een maximale uitval van het systeem van 2 uur, met een maximum van 17,5 uur op jaarbasis. Hierbij geldt dat uitval van het systeem ten hoogste tweemaal per maand voor mag komen. Voor calamiteiten geldt een maximale uitval van de dienstverlening van 24 uur.

De gemiddelde responsetijd19 van het systeem bedraagt 1 seconde; maximaal te verwachten responsetijd zal 3 seconden bedragen.

De helpdesk voor vragen is tijdens werkdagen beschikbaar van 8.00-18.00 uur. Vragen aan de helpdesk moeten in 95% van de gevallen binnen 4 uur zijn afgehandeld (beantwoord), 98% binnen 24 uur en 100% binnen 7 dagen. Voor vragen buiten kantoortijden is er een voorziening welke vragen van kritisch belang voor de continuïteit van de dienstverlening van de BV BSN doorspeelt aan technisch beheer.

I. Gegevenswoordenboek

I.1. Inleiding

De Beheervoorziening BSN maakt gebruik van een deelverzameling van de GBA-gegevens volgens de GBA-standaard. Het binnen de Beheervoorziening BSN gebruikte deel van het teletex-repertoire maakt volledig deel uit van de 10646 UTF-8 tekenset. Coderingen Teletex kunnen één op één overgezet worden naar coderingen UTF-8 en andersom. De translatie tussen de coderingen in het GBA systeem en de UTF standaard wordt bij het inlezen van de gegevens (vanuit de GBA) in de Beheervoorziening BSN uitgevoerd.

I.2. Gegevens in de BV BSN

De gegevens in de Beheervoorziening BSN zijn ingedeeld in twee lijsten. Binnen deze lijsten bestaat een hiërarchische structuur van categorieën, groepen en elementen.

De twee lijsten die binnen de Beheervoorziening BSN worden onderkend zijn:

• Persoonsgegevens
• Berichtgegevens

I.2.1. Beschrijving van de categorieën

De lijsten binnen de Beheervoorziening BSN zijn opgedeeld in categorieën. Hieronder wordt een overzicht gegeven van deze onderverdeling.

De categorieën van de persoonsgevens

Categorienaam	Persoon
Toelichting	Gegevens over de ingeschrevene
Groepen	Identificatienummer Naam Geboorte Geslacht Onderzoek

Categorienaam	Nationaliteit
Toelichting	Gegevens over een nationaliteit van de ingeschrevene.
Groepen	Nationaliteit Onderzoek

Categorienaam	Overlijden
Toelichting	Gegevens over het overlijden van de ingeschrevene.
Groepen	Overlijden Onderzoek

Categorienaam	Inschrijving
Toelichting	Gegevens over de opneming en de status van de Persoonslijst.
Groepen	Opschorting Geheim

Categorienaam	Verblijfplaats
Toelichting	Gegevens over het verblijf en adres van de ingeschrevene.
Groepen	Gemeente Adreshouding Adres Locatie Emigratie Landvaninschrijving Onderzoek

De categorieën van de berichtgevens

Categorienaam	Afzender
Toelichting	Gegevens over de afzender van het bericht.
Groepen	Afzender Bericht Eindgebruiker

Categorienaam	Status
Toelichting	Gegevens over de status van het bericht.
Groepen	Vraagresultaat Berichtresultaat

Categorienaam	Beheervoorziening
Toelichting	Gegevens over de Beheervoorziening met betrekking tot het bericht.
Groepen	Bericht

Categorienaam	Beheercomponent
Toelichting	Gegevens over de beheercomponent met betrekking tot het bericht.
Groepen	Organisatie Match Nummers

Categorienaam	Verzoek
Toelichting	Gegevens over het verzoek (de verzoeken) ingesloten in het bericht.
Groepen	Behandelnummer Identificatienummer Vraag Verzoek

I.2.2. Beschrijving van de groepen

Opsomming van de groepen binnen de persoonsgegevens:

Persoon	Identificatienummer
	Naam
	Geboorte
	Geslacht
	Onderzoek

Nationaliteit	Nationaliteit
	Onderzoek

Overlijden	Overlijden
	Onderzoek

Inschrijving	Opschorting
	Geheim

Verblijfplaats	Gemeente
	Adreshouding
	Adres
	Locatie
	Emigratie
	Landvaninschrijving
	Onderzoek

Groepnaam	Identificatienummer
Categorie	Persoon
Toelichting	Gegevens over het identificatienummer van de persoon.
Soort	Algemene of verwijsgegevens
Elementopsomming	BSN

Groepnaam	Naam
Categorie	Persoon
Toelichting	Gegevens over de naam van de persoon.
Soort	Algemene of verwijsgegevens
Elementopsomming	Voornamen Adellijke Titel of Predikaat Voorvoegsel Geslachtsnaam Geslachtsnaam

Groepnaam	Geboorte
Categorie	Persoon
Toelichting	Gegevens over de geboorte van de persoon.
Soort	Algemene of verwijsgegevens
Elementopsomming	Geboortedatum Geboorteplaats Geboorteland

Groepnaam	Geslacht
Categorie	Persoon
Toelichting	Gegevens over het geslacht van de persoon.
Soort	Algemene of verwijsgegevens
Elementopsomming	Geslachtsaanduiding

Groepnaam	Onderzoek
Categorie	Persoon
Toelichting	Gegevens over lopende onderzoeken naar de gegevens van de persoon.
Soort	Algemene of verwijsgegevens
Elementopsomming	Aanduiding Gegevens In Onderzoek Persoon Datum Ingang Onderzoek Persoon

Groepnaam	Nationaliteit
Categorie	Nationaliteit
Toelichting	Gegevens over de nationaliteit van de persoon.
Soort	Algemene gegevens
Elementopsomming	Nationaliteit

Groepnaam	Onderzoek
Categorie	Nationaliteit
Toelichting	Gegevens over lopende onderzoeken naar de nationaliteit van de persoon.
Soort	Algemene gegevens
Elementopsomming	Aanduiding Gegevens In Onderzoek Nationaliteit Datum Ingang Onderzoek Nationaliteit

Groepnaam	Overlijden
Categorie	Overlijden
Toelichting	Gegevens over het overlijden
Soort	Algemene gegevens
Elementopsomming	Datum Overlijden

Groepnaam	Onderzoek
Categorie	Overlijden
Toelichting	Gegevens over lopende onderzoeken naar het overlijden
Soort	Algemene gegevens
Elementopsomming	Aanduiding Gegevens In Onderzoek Overlijden Datum Ingang Onderzoek Overlijden

Groepnaam	Opschorting
Categorie	Inschrijving
Toelichting	Gegevens over het stoppen van de bijhouding van de Persoonslijst.
Soort	Administratieve gegevens
Elementopsomming	Omschrijving Reden Opschorting

Groepnaam	Geheim
Categorie	Inschrijving
Toelichting	Gegevens over eventuele geheimhouding van de inschrijving
Soort	Administratieve gegevens
Elementopsomming	Indicatie Geheim

Groepnaam	Gemeente
Categorie	Verblijfplaats
Toelichting	Gegevens over de gemeente van inschrijving, de gemeente waarnaar is uitgeschreven of de gemeente van eerste inschrijving.
Soort	Algemene of verwijsgegevens
Elementopsomming	Gemeente Van Inschrijving

Groepnaam	Adreshouding
Categorie	Verblijfplaats
Toelichting	Gegevens over de functie van het adres, het gemeentedeel en de datum van inschrijving op het adres of de lokatie.
Soort	Algemene gegevens
Elementopsomming	Functie Adres Gemeentedeel

Groepnaam	Adres
Categorie	Verblijfplaats
Toelichting	Gegevens over het adres.
Soort	Algemene of verwijsgegevens
Elementopsomming	Straatnaam Huisnummer Huisletter Huisnummertoevoeging Aanduiding Bij Huisnummer Postcode

Groepnaam	Locatie
Categorie	Verblijfplaats
Toelichting	Gegevens over de plaatsbepaling van een adres.
Soort	Algemene of verwijsgegevens
Elementopsomming	Locatiebeschrijving

Groepnaam	Emigratie
Categorie	Verblijfplaats
Toelichting	Gegevens over het vertrek uit Nederland.
Soort	Algemene gegevens
Elementopsomming	Datum Vertrek Uit Nederland

Groepnaam	Landvaninschrijving
Categorie	Verblijfplaats
Toelichting	Gegevens over het land waar de ingeschrevene verblijf hield voor (her)vestiging in Nederland.
Soort	Algemene gegevens
Elementopsomming	Land Vanwaar Ingeschreven

Groepnaam	Onderzoek
Categorie	Verblijfplaats
Toelichting	Gegevens over lopende onderzoeken naar de verplijfplaats van de ingeschrevene.
Soort	Algemene gegevens
Elementopsomming	Aanduiding Gegevens In Onderzoek Adres Datum Ingang Onderzoek Adres

Opsomming van de groepen binnen de berichtgegevens:

Afzender	Afzender
	Bericht
	Eindgebruiker

Status	Vraagresultaat
	Berichtresultaat

Beheervoorziening	Bericht

Beheercomponent	Organisatie
	Match
	Nummers

Verzoek	Behandelnummer
	Identificatienummer
	Vraag
	Verzoek

Groepnaam	Afzender
Categorie	Afzender
Toelichting	Gegevens over de afzender van het bericht
Soort	Algemene gegevens
Elementopsomming	Afzender

Groepnaam	Bericht
Categorie	Afzender
Toelichting	Gegevens over het bericht.
Soort	Algemene gegevens
Elementopsomming	Bericht Nummer

Groepnaam	Eindgebruiker
Categorie	Afzender
Toelichting	Gegevens over de eindgebruiker van het bericht.
Soort	Algemene gegevens
Elementopsomming	Indicatie Eindgebruiker

Groepnaam	Vraagresultaat
Categorie	Status
Toelichting	Gegevens over het resultaat van de vraag
Soort	Algemene gegevens
Elementopsomming	Resultaat Omschrijving Resultaat Code

Groepnaam	Berichtresultaat
Categorie	Status
Toelichting	Gegevens over het resultaat van het bericht
Soort	Algemene gegevens
Elementopsomming	Bericht Resultaat Omschrijving Bericht Resultaat Code

Groepnaam	Bericht
Categorie	Beheervoorziening
Toelichting	Gegevens over het bericht voor de BV BSN
Soort	Administratieve gegevens
Elementopsomming	BV BSN Bericht Nummer Hashtotal

Groepnaam	Organisatie
Categorie	Beheercomponent
Toelichting	Gegevens over de organisatie achter de beheercomponent.
Soort	Algemene gegevens
Elementopsomming	Instantie

Groepnaam	Match
Categorie	Beheercomponent
Toelichting	Gegevens over de match van identificerende gegevens.
Soort	Algemene gegevens
Elementopsomming	Score Registratie Match Nummer

Groepnaam	Nummers
Categorie	Beheercomponent
Toelichting	Gegevens over het genereren en distribueren van nummers.
Soort	Algemene gegevens
Elementopsomming	Nummers Aantal Batchnummer Hashtotal

Groepnaam	Behandelnummer
Categorie	Verzoek
Toelichting	Aanduiding ter referentie van de gestelde bulkvraag.
Soort	Verwijsgegevens
Elementopsomming	Burgerservicenummer
Opmerking	Wordt slechts gebruikt in de tijdelijke diensten ‘Stellen bulkvraag’ en ‘Opvragen antwoord bulkvraag’

Groepnaam	Identificatienummer
Categorie	Verzoek
Toelichting	Gegevens over het id.nummer horende bij een verzoek.
Soort	Verwijsgegevens
Elementopsomming	Burgerservicenummer

Groepnaam	Vraag
Categorie	Verzoek
Toelichting	Gegevens over de vraag
Soort	Algemene gegevens
Elementopsomming	Vraagnummer

Groepnaam	Verzoek
Categorie	Verzoek
Toelichting	Gegevens over het verzoek
Soort	Algemene gegevens
Elementopsomming	Afzender Bericht Nummer Document Type Document Nummer

I.2.3. Beschrijving van de elementen

Opsomming van de elementen binnen de persoonsgegevens:

Persoon	Identificatienummer	BSN

	Naam	Voornamen
		Adellijke Titel of Predikaat
		Voorvoegsel Geslachtsnaam
		Geslachtsnaam

	Geboorte	Geboortedatum
		Geboorteplaats
		Geboorteland

	Geslacht	Geslachtsaanduiding

	Onderzoek	Aanduiding Gegevens In Onderzoek Persoon
		Datum Ingang Onderzoek Persoon


Nationaliteit	Nationaliteit	Nationaliteit

	Onderzoek	Aanduiding Gegevens In Onderzoek Nationaliteit
		Datum Ingang Onderzoek Nationaliteit


Overlijden	Overlijden	Datum Overlijden

	Onderzoek	Aanduiding Gegevens In Onderzoek Overlijden
		Datum Ingang Onderzoek Overlijden


Inschrijving	Opschorting	Omschrijving Reden Opschorting

	Geheim	IndicatieGeheim


Verblijfplaats	Gemeente	Gemeente Van Inschrijving

	Adreshouding	Functie Adres Gemeentedeel

	Adres	Straatnaam
		Huisnummer
		Huisletter
		Huisnummertoevoeging
		Aanduiding Bij Huisnummer
		Postcode

	Locatie	Locatiebeschrijving

	Emigratie	Datum Vertrek Uit Nederland

	Landvaninschrijving	Land Vanwaar Ingeschreven

	Onderzoek	Aanduiding Gegevens In Onderzoek Adres
		Datum Ingang Onderzoek Adres

Elementnaam	BSN
Groepnaam	Identificatienummer
Categorie	Persoon
Toelichting	Burgerservicenummer behorende bij de persoonsgegevens. Het nummer moet aan de elfproef20 voldoen.
Lengte	9
Type	Numeriek
WSDLnaam	BSN

Elementnaam	Voornamen
Groepnaam	Naam
Categorie	Persoon
Toelichting	De verzameling namen die, gescheiden door spaties, aan de geslachtsnaam voorafgaat.
Lengte	200
Type	Alfanumeriek
WSDLnaam	Voornamen
Opmerking	Indien het gegeven afkomstig is uit het BvR, bevat dit gegevens de voorletters indien de voornaam leeg is bij het BvR.

Elementnaam	Adellijke Titel of Predikaat
Groepnaam	Naam
Categorie	Persoon
Toelichting	Een code die aangeeft welke titel of welk predikaat behoort tot de naam (bij adellijke titel geslachtsnaam, bij predikaat voornaam).
Lengte	2 (indien afkomstig uit de GBA en gebruikt in een sPd-bericht) 10 (indien gebruikt in de webservices)
Type	Alfanumeriek indien het gegeven gebruikt wordt in een sPd- bericht: – Code voorkomend in Tabel 38 (GBA), Tabel Adellijke titel/predikaat, indien het gegeven afkomstig is uit de GBA. Alfanumeriek indien het gegeven gebruikt wordt in de webservices: – De volledige titel van de persoon.
WSDLnaam	AdellijkeTitelPredikaat
Opmerking	Indien de gebruikte code binnen het BVR niet bekend is binnen het GBA, wordt dit veld leeg gelaten.

Elementnaam	Voorvoegsel Geslachtsnaam
Groepnaam	Naam
Categorie	Persoon
Toelichting	Het voorvoegsel, gescheiden door een spatie voorgaand gaat aan de rest van de geslachtsnaam.
Lengte	10
Type	Alfanumeriek – Komt voor in Tabel 36 (GBA), Voorvoegseltabel, indien het gegeven afkomstig is uit de GBA. – Komt voor in Tabel Voorvoegsels, indien het gegeven afkomstig is uit het BvR.
WSDLnaam	VoorvoegselGeslachtsnaam

Elementnaam	Geslachtsnaam
Groepnaam	Naam
Categorie	Persoon
Toelichting	De (geslachts)naam waarvan de eventuele aanwezige voorvoegsels en adellijke titel/predikaat zijn afgesplitst.
Lengte	200 (indien afkomstig uit de GBA) 108 (indien afkomstig uit het BvR)
Type	Alfanumeriek
WSDLnaam	Geslachtsnaam

Elementnaam	Geboortedatum
Groepnaam	Geboorte
Categorie	Persoon
Toelichting	De datum waarop de persoon is geboren.
Lengte	8
Type	Numeriek Formaat: ‘jjjjmmdd’
WSDLnaam	Geboortedatum

Elementnaam	Geboorteplaats
Groepnaam	Geboorte
Categorie	Persoon
Toelichting	Een aanduiding die de plaatsnaam aangeeft waar de persoon is geboren.
Lengte	40
Type	Alfanumeriek
WSDLnaam	Geboorteplaats

Elementnaam	Geboorteland
Groepnaam	Geboorte
Categorie	Persoon
Toelichting	Een aanduiding die het land aangeeft waar de persoon is geboren.
Lengte	4, indien het gegeven gebruikt wordt in een sPd bericht. 40, indien het gegeven gebruikt wordt in de webservices.
Type	Alfanumeriek – Code uit Tabel 34 (GBA), Landentabel, indien het gegeven gebruikt wordt in een sPd bericht. – Volledige omschrijving van het land, indien het gegeven gebruikt wordt in de webservices.
WSDLnaam	Geboorteland

Elementnaam	Geslachtsaanduiding
Groepnaam	Geslacht
Categorie	Persoon
Toelichting	Een aanduiding die aangeeft dat de ingeschrevene een man of vrouw is, of dat het geslacht (nog) onbekend is.
Lengte	1
Type	Alfanumeriek: O (=Onbekend) M (=Man) V (=Vrouw)
WSDLnaam	Geslachtsaanduiding

Elementnaam	Aanduiding Gegevens In Onderzoek Persoon
Groepnaam	Onderzoek
Categorie	Persoon
Toelichting	Aanduiding die aangeeft op er een lopend onderzoek is naar de gegevens van de persoon.
Lengte	6, indien het gegeven gebruikt wordt in een sPd bericht. 50, indien het gegeven gebruikt wordt in de webservices.
Type	Alfanumeriek
WSDLnaam	AanduidingGegevensInOnderzoekPersoon
Opmerking	Indien het gegeven gebruikt wordt in de webservices, bevat dit veld de volledige omschrijving.

Elementnaam	Datum Ingang Onderzoek Persoon
Groepnaam	Onderzoek
Categorie	Persoon
Toelichting	De datum waarop het onderzoek naar de gegevens van de persoon is aangevangen.
Lengte	8
Type	Numeriek Formaat: ‘jjjjmmdd’
WSDLnaam	DatumIngangOnderzoekPersoon

Elementnaam	Nationaliteit
Groepnaam	Nationaliteit
Categorie	Nationaliteit
Toelichting	De nationaliteiten van de persoon, gescheiden door een puntkomma.
Lengte	4, indien het gegeven gebruikt wordt in een sPd bericht. 255, indien het gegeven gebruikt wordt in de webservices.
Type	Alfanumeriek – Code uit Tabel 32 (GBA), Nationaliteitentabel, indien het gegeven gebruikt wordt in een sPd bericht. – Volledige omschrijving van de nationaliteit, indien het gegeven gebruikt wordt in de webservices.
WSDLnaam	Nationaliteit

Elementnaam	Aanduiding Gegevens In Onderzoek Nationaliteit
Groepnaam	Onderzoek
Categorie	Nationaliteit
Toelichting	Aanduiding die aangeeft op er een lopend onderzoek is naar de gegevens m.b.t. de nationaliteit van de persoon.
Lengte	6, indien het gegeven gebruikt wordt in een sPd bericht. 50, indien het gegeven gebruikt wordt in de webservices.
Type	Alfanumeriek
WSDLnaam	AanduidingGegevensInOnderzoekNationaliteit
Opmerking	Indien het gegeven gebruikt wordt in de webservices, bevat dit veld de volledige omschrijving.

Elementnaam	Datum Ingang Onderzoek Nationaliteit
Groepnaam	Onderzoek
Categorie	Nationaliteit
Toelichting	De datum waarop het onderzoek naar de gegevens m.b.t. de nationaliteit van de persoon is aangevangen.
Lengte	8
Type	Numeriek Formaat: ‘jjjjmmdd’
WSDLnaam	DatumIngangOnderzoekNationaliteit

Elementnaam	Datum Overlijden
Groepnaam	Overlijden
Categorie	Overlijden
Toelichting	De datum van overlijden.
Lengte	8
Type	Numeriek Formaat: ‘jjjjmmdd’
WSDLnaam	DatumOverlijden

Elementnaam	Aanduiding Gegevens In Onderzoek Overlijden
Groepnaam	Onderzoek
Categorie	Overlijden
Toelichting	Aanduiding die aangeeft op er een lopend onderzoek is naar de gegevens met betrekking tot het overlijden van de persoon.
Lengte	6, indien het gegeven gebruikt wordt in een sPd bericht. 50, indien het gegeven gebruikt wordt in de webservices.
Type	Alfanumeriek
WSDLnaam	AanduidingGegevensInOnderzoekOverlijden
Opmerking	Indien het gegeven gebruikt wordt in de webservices, bevat dit veld de volledige omschrijving.

Elementnaam	Datum Ingang Onderzoek Overlijden
Groepnaam	Onderzoek
Categorie	Overlijden
Toelichting	De datum waarop het onderzoek naar de gegevens met betrekking tot het overlijden van de persoon is aangevangen.
Lengte	8
Type	Numeriek Formaat: ‘jjjjmmdd’
WSDLnaam	DatumIngangOnderzoekOverlijden

Elementnaam	Omschrijving Reden Opschorting
Groepnaam	Opschorting
Categorie	Inschrijving
Toelichting	Een aanduiding van de reden waarom de bijhouding van de Persoonslijst is opgeschort.
Lengte	1
Type	Alfanumeriek: O (=Overlijden) E (=Emigratie) M (=Ministerieel besluit)
WSDLnaam	OmschrijvingRedenOpschorting

Elementnaam	IndicatieGeheim
Groepnaam	Geheim
Categorie	Inschrijving
Toelichting	Aanduiding of de gegevens van deze persoon geheim zijn.
Lengte	1, indien het gegeven gebruikt wordt in een sPd-bericht of in de dienst ‘realtime presentievraag’. 50, indien het gegeven gebruikt wordt in de webservices.
Type	Numeriek, indien het gegeven gebruikt wordt in een sPd-bericht of in de dienst ‘realtime presentievraag’: 0: Geen beperking 1: Niet zonder toestemming aan derden ter uitvoering van een algemeen verbindend voorschrift 2: Niet aan kerken 3: Niet aan vrije derden 4: Niet zonder toestemming aan derden ter uitvoering van een algemeen verbindend voorschrift en niet aan kerken. 5: Niet zonder toestemming aan derden ter uitvoering van een algemeen verbindend voorschrift en niet aan vrije derden. 6: Niet aan kerken en niet aan vrije derden 7: Niet zonder toestemming aan derden ter uitvoering van een algemeen verbindend voorschrift en niet aan vrije derden en niet aan kerken. Alfanumeriek indien het gegeven gebruikt wordt in de webservices: ‘ja’ of ‘nee’
WSDLnaam	IndicatieGeheim

Elementnaam	Gemeente Van Inschrijving
Groepnaam	Gemeente
Categorie	Verblijfplaats
Toelichting	Aanduiding die aangeeft bij welke gemeente de persoon ingeschreven is.
Lengte	4, indien het gegeven gebruikt wordt in een sPd bericht. 40, indien het gegeven gebruikt wordt in de webservices.
Type	Alfanumeriek – Code uit Tabel 33 (GBA), Gemeententabel, indien het gegeven gebruikt wordt in een sPd bericht. – Volledige omschrijving van de gemeente, indien het gegeven gebruikt wordt in de webservices.
WSDLnaam	GemeenteVanInschrijving

Elementnaam	Functie Adres
Groepnaam	Adreshouding
Categorie	Verblijfplaats
Toelichting	De aanduiding die aangeeft of het adres de functie heeft van woonadres of briefadres.
Lengte	1
Type	Alfanumeriek: B (=Briefadres) W (=Woonadres)
WSDLnaam	FunctieAdres
Opmerking	Indien het geegven afkomstig is uit het BVR, wordt dit veld leeg gelaten.

Elementnaam	Gemeentedeel
Groepnaam	Adreshouding
Categorie	Verblijfplaats
Toelichting	Een geografisch gebied dat een deel is van het gemeentelijk grondgebied.
Lengte	24
Type	Alfanumeriek
WSDLnaam	Gemeentedeel

Elementnaam	Straatnaam
Groepnaam	Adres
Categorie	Verblijfplaats
Toelichting	De officiële straatnaam zoals door het gemeentebestuur is vastgesteld, zo nodig ingekort cf. de BOCO-norm.
Lengte	24, indien het gegeven gebruikt wordt in een sPd bericht. 34, indien het gegeven gebruikt wordt in de webservices.
Type	Alfanumeriek
WSDLnaam	Straatnaam

Elementnaam	Huisnummer
Groepnaam	Adres
Categorie	Verblijfplaats
Toelichting	De numerieke aanduiding zoals deze door het gemeentebestuur aan het object is toegekend.
Lengte	5
Type	Numeriek
WSDLnaam	Huisnummer

Elementnaam	Huisletter
Groepnaam	Adres
Categorie	Verblijfplaats
Toelichting	Een alfabetisch teken achter het huisnummer zoals dit door het gemeentebestuur is toegekend.
Lengte	1
Type	Alfanumeriek
WSDLnaam	Huisletter
Opmerking	De BVR kent niet het verschil tussen huisletter en huisnummer toevoeging.

Elementnaam	Huisnummertoevoeging
Groepnaam	Adres
Categorie	Verblijfplaats
Toelichting	Die letters of tekens die noodzakelijk zijn om, naast huisnummer en -letter, de brievenbus te vinden.
Lengte	4, indien het gegeven gebruikt wordt in een sPd bericht. 12, indien het gegeven gebruikt wordt in de webservices.
Type	Alfanumeriek
WSDLnaam	Huisnummertoevoeging
Opmerking	De BVR kent niet het verschil tussen huisletter en huisnummer toevoeging.

Elementnaam	Aanduiding Bij Huisnummer
Groepnaam	Adres
Categorie	Verblijfplaats
Toelichting	De aanduiding die wordt gebruikt voor adressen die niet zijn voorzien van de gebruikelijke straatnaam en huisnummeraanduidingen.
Lengte	2
Type	Alfanumeriek: By (=bij) To (=tegenover)
WSDLnaam	AanduidingBijHuisnummer

Elementnaam	Postcode
Groepnaam	Adres
Categorie	Verblijfplaats
Toelichting	De door de PTT vastgestelde code behorend bij de straatnaam en het huisnummer.
Lengte	6
Type	Alfanumeriek Formaat: ‘AAAA99’
WSDLnaam	Postcode

Elementnaam	Locatiebeschrijving
Groepnaam	Locatie
Categorie	Verblijfplaats
Toelichting	Een geheel of gedeeltelijke omschrijving van de ligging van een object, indien dit niet kan worden aangegeven in de groep Adres
Lengte	35, indien het gegeven gebruikt wordt in een sPd bericht of in de webservices voor gebruikers. 108, indien het gegeven gebruikt wordt in de webservices voor gemeenten.
Type	Alfanumeriek
WSDLnaam	Locatiebeschrijving

Elementnaam	Datum Vertrek Uit Nederland
Groepnaam	Emigratie
Categorie	Verblijfplaats
Toelichting	De datum van vertrek naar het buitenland. Bij ambtshalve uitschrijving is dit de datum waarop de betrokkene schriftelijk van het voornemen tot ambtshalve uitschrijving mededeling is gedaan. Bij uitschrijving wegens het ingaan van een Ministerieel besluit is dat de datum van dat besluit. In alle andere gevallen is dit de datum waarop de aangifte is ontvangen.
Lengte	8
Type	Numeriek Formaat: ‘jjjjmmdd’
WSDLnaam	DatumVertrekUitNederland

Elementnaam	Land Vanwaar Ingeschreven
Groepnaam	Landvaninschrijving
Categorie	Verblijfplaats
Toelichting	Aanduiding die het land aangeeft waar de ingeschreven verblijf hield voor (her)vestiging in Nederland.
Lengte	40
Type	Alfanumeriek Komt voor in Tabel 34, Landentabel
WSDLnaam	LandVanwaarIngeschreven

Elementnaam	Aanduiding Gegevens In Onderzoek Adres
Groepnaam	Onderzoek
Categorie	Verblijfplaats
Toelichting	Aanduiding die aangeeft of er een lopend onderzoek is naar de gegevens met betrekking tot de adresgegevens van de persoon.
Lengte	6
Type	Alfanumeriek
WSDLnaam	AanduidingGegevensInOnderzoekAdres

Elementnaam	Datum Ingang Onderzoek Adres
Groepnaam	Onderzoek
Categorie	Verblijfplaats
Toelichting	Datum waarop een eventueel lopend onderzoek naar de gegevens met betrekking tot de adresgegevens van de persoon is aangevangen.
Lengte	8 Formaat: ‘jjjjmmdd’
Type	Alfanumeriek
WSDLnaam	DatumIngangOnderzoekAdres

Opsomming van de elementen binnen de berichtgegevens:

Afzender	Afzender	Afzender

	Bericht	BerichtNr

	Eindgebruiker	Indicatie Eindgebruiker


Status	Vraagresultaat	Resultaat Omschrijving
		Resultaat Code

	Berichtresultaat	Bericht Resultaat Omschrijving
		Bericht Resultaat Code


Beheervoorziening	Bericht	BV BSN Bericht Nummer


Beheercomponent	Organisatie	Instantie

	Match	Score
		Registratie
		Match Nummer

	Nummers	Nummers
		Aantal
		Batchnummer
		Hashtotal


Verzoek	Behandelnummer	Behandelnummer

	Identificatienummer	BurgerServiceNr

	Vraag	Vraagnummer

	Verzoek	Afzender Bericht Nummer
		Document Type
		Document Nummer

Elementnaam	Afzender
Groepnaam	Afzender
Categorie	Afzender
Toelichting	Aanduiding van de afzender van het bericht.
Lengte	4, indien het gegeven gebruikt wordt in een sPd bericht of in de webservices voor gemeenten. 50, indien het gegeven gebruikt wordt in de webservices voor gebruikers.
Type	Alfanumeriek – Code uit Tabel Gemeentetabel, indien het gegeven gebruikt wordt in een sPd bericht. – De ‘distinguished name’, indien het gegeven gebruikt wordt in de webservices.
WSDLnaam	Afzender

Elementnaam	Bericht Nummer
Groepnaam	Bericht
Categorie	Afzender
Toelichting	De voor de afzender geldende identificatie van het bericht.
Lengte	50, indien het veld gebruikt wordt in de webservices voor gebruikers. 12, indien het veld gebruikt wordt in de webservices voor gemeenten.
Type	Alfanumeriek
WSDLnaam	BerichtNr

Elementnaam	Indicatie Eindgebruiker
Groepnaam	Eindgebruiker
Categorie	Afzender
Toelichting	Een indicatie van de achterliggende vraagsteller. Dit veld is opgenomen ten behoeve van protocollering en traceerbaarheid.
Lengte	50
Type	Alfanumeriek
WSDLnaam	IndicatieEindgebruiker

Elementnaam	Resultaat Omschrijving
Groepnaam	Vraagresultaat
Categorie	Status
Toelichting	Fout- of succesomschrijving bij een enkele vraag.
Lengte	100
Type	Alfanumeriek
WSDLnaam	ResultaatOmschrijving

Elementnaam	Resultaat Code
Groepnaam	Vraagresultaat
Categorie	Status
Toelichting	Fout- of succescode bij een enkele vraag.
Lengte	6
Type	Numeriek
WSDLnaam	ResultaatCode

Elementnaam	Bericht Resultaat Omschrijving
Groepnaam	Berichtresultaat
Categorie	Status
Toelichting	Fout- of succesomschrijving bij een bericht.
Lengte	100
Type	Alfanumeriek
WSDLnaam	BerichtResultaatOmschrijving

Elementnaam	Bericht Resultaat Code
Groepnaam	Berichtresultaat
Categorie	Status
Toelichting	Fout- of succescode bij een bericht.
Lengte	6
Type	Numeriek
WSDLnaam	BerichtResultaatCode

Elementnaam	BV BSN BerichtNummer
Groepnaam	Bericht
Categorie	Beheervoorziening
Toelichting	Berichtnummer Beheervoorziening BSN
Lengte	50
Type	GUID
WSDLnaam	BvBsnBerichtNr

Elementnaam	Instantie
Groepnaam	Organisatie
Categorie	Beheercomponent
Toelichting	Aanduiding van de organisatie achter de beheercomponent.
Lengte	4
Type	Alfanumeriek – Code uit Tabel Gemeentetabel
WSDLnaam	Instantie

Elementnaam	Score
Groepnaam	Match
Categorie	Beheercomponent
Toelichting	De score die de match met de identificerende gegevens aanduidt.
Lengte	4
Type	Numeriek
WSDLnaam	Score

Elementnaam	Registratie
Groepnaam	Match
Categorie	Beheercomponent
Toelichting	Aanduiding van het register waar de match met de identificerende gegevens is gemaakt of van de gemeente die al eerder een identieke vraag gesteld heeft.
Lengte	4
Type	Alfanumeriek: ‘Geen’ ‘RNI’ ‘GBA’ ‘BVR’ <gemeentecode>
WSDLnaam	Registratie

Elementnaam	Match Nummer
Groepnaam	Match
Categorie	Beheercomponent
Toelichting	Het volgnummer van de gevonden matches.
Lengte	3
Type	Numeriek
WSDLnaam	VolgnummerMatch

Elementnaam	Nummers
Groepnaam	Nummers
Categorie	Beheercomponent
Toelichting	Verzameling aangemaakte of gedistribueerde nummers.
Lengte	Niet gelimiteerd (veelvoud van 9)
Type	Numeriek
WSDLnaam	Nummers

Elementnaam	Aantal
Groepnaam	Nummers
Categorie	Beheercomponent
Toelichting	Het aantal aangemaakte of gedistribueerde nummers
Lengte	6
Type	Numeriek
WSDLnaam	Aantal

Elementnaam	Batchnummer
Groepnaam	Nummers
Categorie	Beheercomponent
Toelichting	Nummer van de voorraad aangeleverde nummers
Lengte	5
Type	Numeriek
WSDLnaam	BatchNr

Elementnaam	Hashtotal
Groepnaam	Nummers
Categorie	Beheercomponent
Toelichting	Een controlegetal voor de som van de geleverde nummers.
Lengte	15
Type	Numeriek
WSDLnaam	Hashtotal

Elementnaam	Behandelnummer
Groepnaam	Behandelnummer
Categorie	Verzoek
Toelichting	Identificatienummer van de gestelde bulkvraag.
Lengte	50
Type	Numeriek
WSDLnaam	Behandelnummer
Opmerking	Dit veld wordt enkel gebruikt in de tijdelijke diensten ‘Stellen bulkvraag’ en ‘Ophalen antwoord bulkvraag’

Elementnaam	Burgerservicenummer
Groepnaam	Identificatienummer
Categorie	Verzoek
Toelichting	Het burgerservicenummer waarmee gezocht wordt. Het nummer moet aan de elfproef voldoen.
Lengte	9
Type	Numeriek
WSDLnaam	BurgerServiceNr

Elementnaam	Vraagnummer
Groepnaam	Vraag
Categorie	Verzoek
Toelichting	Aanduiding van het nummer van de vraag indien er meer vragen binnen het bericht worden gesteld.
Lengte	50
Type	Numeriek
WSDLnaam	Vraagnummer

Elementnaam	AfzenderBerichtNr
Groepnaam	Verzoek
Categorie	Verzoek
Toelichting	Aanduiding van het berichtnummer dat gebruikt is door de instelling bij het verzenden van het gezochte bericht.
Lengte	50
Type	Alfanumeriek
WSDLnaam	BerichtNrAfzender

Elementnaam	Document Type
Groepnaam	Verzoek
Categorie	Verzoek
Toelichting	Aanduiding van het type document dat gebruikt wordt voor de verificatie van het document.
Lengte	50
Type	Alfanumeriek: 1: Reisdocument 2: Rijbewijs 3: Vreemdelingendocument
WSDLnaam	DocumentType

Elementnaam	Document Nummer
Groepnaam	Verzoek
Categorie	Verzoek
Toelichting	Het nummer van het document dat gebruikt wordt voor de verificatie van het document.
Lengte	50
Type	Alfanumeriek
WSDLnaam	DocumentNummer

II. Dienstenboek

II.1. Inleiding

In dit hoofdstuk worden de verschillende diensten beschreven voor zowel de gebruikers als de registerhouders. Er wordt per vraag- en antwoordbericht een overzicht gegeven van de gegevenssets en de mogelijke foutmeldingen. Tevens is een grafische weergave van de berichtcyclus opgenomen. Voor weergave van de foutmeldingen in de berichtcycli wordt een prefix ‘FCB’ gebruikt als het een fout op berichtniveau betreft en een prefix ‘FCA’ als het een fout op vraagniveau betreft. Voor deze fouten geldt dat de code tussen haakjes de werkelijke code is zoals deze in het bericht wordt opgenomen. Systeemfouten worden in een apart register opgeslagen en worden niet weergegeven in de berichtcycli.

II.2. Berichtenvoorziening diensten

In de volgende paragrafen wordt de inhoud weergegeven van de vraag- en antwoordberichten van de webservices gericht op gebruikers.

Tabel II.2a geeft een overzicht van de diensten voor een gebruiker.

Tabel II.2a – Beheervoorziening BSN SBV diensten
Dienstomschrijving
‘Toetsen van de combinatie BSN en identificerende gegevens’
‘Opvragen identificerende gegeven op basis van een BSN’
‘Toetsen geldigheid BSN’
‘Opvragen BSN op basis van identificerende gegevens’
‘Toetsen in verkeer zijn van het identiteitsdocument’

II.2.1. Toetsen van de combinatie BSN en identificerende gegevens

In de WSDL zijn de volgende elementen gedefinieerd die overeenkomen met het vraag- en antwoordbericht:

• ContrBsnIdenGegSoapIn
• ContrBsnIdenGegSoapOut

Tabel II.2.1.a wordt de gegevensset weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Tabel II.2.1a – ‘Toetsen van de combinatie BSN en identificerende gegevens’ berichten
ContrBsnIdenGegSoapIn		ContrBsnIdenGegSoapOut
Vraagbericht zoekpad 1	Vraagbericht zoekpad 2	Antwoordbericht
Algemeen deel	Algemeen deel	Algemeen deel
Afzender*	Afzender*	BerichtNr
BerichtNr*	BerichtNr*	BvBsnBerichtNr
IndicatieEindgebruiker*	IndicatieEindgebruiker*	BerichtResultaatCode
		OmschrijvingBerichtResultaat
1 of meerdere vragen	1 of meerdere vragen	1 of meerdere antwoorden
Vraagnummer*	Vraagnummer*	Vraagnummer
BurgerServiceNr*	BurgerServiceNr*	BurgerServiceNr
Voornamen	Voornamen	Voornamen
VoorvoegselGeslachtsnaam	VoorvoegselGeslachtsnaam	AdellijkeTitelPredikaat
Geslachtsnaam	Geslachtsnaam*	VoorvoegselGeslachtsnaam
Geboortedatum*	Geboortedatum*	Geslachtsnaam
Geboorteplaats	Geboorteplaats	Geboortedatum
Geboorteland	Geboorteland	Geboorteplaats
Geslachtsaanduiding*	Geslachtsaanduiding*	Geboorteland
GemeenteVanInschrijving	GemeenteVanInschrijving	Geslachtsaanduiding
Straatnaam	Straatnaam	GemeenteVanInschrijving i
Huisnummer*	Huisnummer	Straatnaam i
Huisnummertoevoeging	Huisnummertoevoeging	Huisnummer i
Huisletter	Huisletter	Huisnummertoevoeging i
AanduidingBijHuisnummer	AanduidingBijHuisnummer	Huisletter i
Postcode*	Postcode	AanduidingBijHuisnummer i
Locatiebeschrijving	Locatiebeschrijving	Postcode i
LandVanwaarIngeschreven	LandVanwaarIngeschreven	Locatiebeschrijving i
		LandVanwaarIngeschreven i
		FunctieAdres i
		Gemeentedeel i
		IndicatieGeheim
		AanduidingGegevensInOnderzoekPersoon
		DatumIngangOnderzoekPersoon
		AanduidingGegevensInOnderzoekAdres i
		DatumIngangOnderzoekAdres i
		OmschrijvingRedenOpschorting
		DatumOverlijden
		AanduidingGegevensInOnderzoekOverlijden
		DatumIngangOnderzoekOverlijden
		ResultaatCode
		OmschrijvingResultaat

Opmerkingen:

1. Als in de registratie de indicatie geheim ongelijk is aan ‘0’, worden de verblijfplaatsgegevens (gegevens aangeduid met een ‘ⁱ’) niet doorgegeven.

2. Indien een gegeven in onderzoek is (‘aanduiding gegevens in onderzoek’ van groep persoon, overlijden of verblijfplaats), wordt dit attribuut gevuld met een melding zoals omschreven in ‘Meldingen gegevens in onderzoek’.

3. Indien ‘Omschrijving reden opschorting’ in het GBA-systeem is ‘E’ (Emigratie) of ‘M’ (Ministerieel besluit), dan worden de verblijfplaatsgegevens (gegevens aangeduid met een ‘i’) niet doorgegeven.

4. Alleen als het ‘Omschrijving resultaat’ is ‘Resultaat gevonden’, wordt de gegevensset gevuld.

5. In tabel II.2.1b wordt de vulling voor de velden ‘BerichtResultaatCode’, ‘OmschrijvingBerichtResultaat’, ‘ResultaatCode’ en ‘OmschrijvingResultaat’ gegeven.

Tabel II.2.1b – Vulling voor de velden ‘BerichtResultaatCode’, ‘OmschrijvingBerichtResultaat’, ‘ResultaatCode’ en ‘OmschrijvingResultaat’
Situatie	BerichtResultaatCode		OmschrijvingBerichtResultaat
Vastleggen bericht in berichtenlogboek mislukt	FCB01	(2)	‘Er is een fout opgetreden’
De afzender van het bericht is niet geautoriseerd	FCB02	(4)	‘Afzender niet geautoriseerd’
De afzender van het bericht is niet gevuld	FCB03	(8)	‘De afzender van het bericht moet gevuld zijn’
Indicatie eindgebruiker is niet gevuld	FCB04	(10)	‘De indicatie eindgebruiker van het bericht moet gevuld zijn’
Het berichtnummer van de afzender is niet gevuld	FCB05	(9)	‘Het berichtnummer van de afzender moet gevuld zijn’
Bericht bevat meer vragen dan het toegestane maximum (vooralsnog 1)	FCB06	(6)	‘Het bericht bevat meer vragen dan het toegestane maximum’
Vraagnummer begint niet bij nummer 1	FCB07	(13)	‘Vraagnummer begint niet bij nummer 1’
Vraagnummers zijn niet oplopend	FCB08	(14)	‘Vraagnummers zijn niet oplopend’
Bericht bevat geen vraag	FCB09	(7)	‘Het bericht moet minimaal één vraag bevatten’
Eén of meer vraagnummers niet gevuld	FCB10	(11)	‘De vraagnummers moeten gevuld zijn’
Fout bij bijwerken auditlog	FCB11	(2)	‘Er is een fout opgetreden’
Fout bij ophalen gegevens	FCB12	(2)	‘Er is een fout opgetreden’
Goede verwerking		(2000)	‘Verwerking bericht succesvol’

Situatie	ResultaatCode		OmschrijvingResultaat
Set van identificerende gegevens niet valide	FCA01	(2004)	‘Vraag voldoet niet aan een toegestaan zoekpad’
Fout bij controleren van het nummer	FCA02	(2002)	‘Nummer is geen BSN’
Geen of meerdere resultaten gevonden	FCA03	(2001)	‘Vraag heeft niet tot één persoon geleid’
Succes		(2003)	‘Resultaat gevonden’

In de onderstaande figuur II.2.1c wordt de berichtcyclus weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Figuur II.2.1c – Cyclus ‘Toetsen van de combinatie BSN en identificerende gegevens’

II.2.2. Opvragen identificerende gegevens op basis van een BSN

In de WSDL zijn de volgende elementen gedefinieerd die overeenkomen met het vraag- en antwoordbericht:

• HaalOpIdenGegArSoapIn
• HaalOpIdenGegArSoapOut

In tabel II.2.2a wordt de gegevensset weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Tabel II.2.2a – Gegevens voor dienst ‘Opvragen identificerende gegeven op basis van een BSN’
HaalOpIdenGegSoapIn	HaalOpIdenGegSoapOut
Vraagbericht	Antwoordbericht
Algemeen deel	Algemeen deel
Afzender*	BerichtNr
BerichtNr*	BvBsnBerichtNr
IndicatieEindgebruiker*	BerichtResultaatCode
	OmschrijvingBerichtResultaat
1 of meerdere vragen	1 of meerdere antwoorden
Vraagnummer*	Vraagnummer
BurgerServiceNr*	Bsn
	Voornamen
	AdellijkeTitelPredikaat
	VoorvoegselGeslachtsnaam
	Geslachtsnaam
	Geboortedatum
	Geboorteplaats
	Geboorteland
	Geslachtsaanduiding
	AanduidingGegevensInOnderzoekPersoon
	DatumIngangOnderzoekPersoon
	DatumOverlijden
	AanduidingGegevensInOnderzoekOverlijden
	DatumIngangOnderzoekOverlijden
	OmschrijvingRedenOpschorting
	IndicatieGeheim
	GemeenteVanInschrijving i
	Straatnaam i
	Huisnummer i
	Huisletter i
	Huisnummertoevoeging i
	AanduidingBijHuisnummer i
	Postcode i
	Locatiebeschrijving i
	LandVanwaarIngeschreven i
	FunctieAdres i
	Gemeentedeel i
	AanduidingGegevensInOnderzoekAdres i
	DatumIngangOnderzoekAdres i
	ResultaatCode
	OmschrijvingResultaat

Tabel II.2.2b – Vulling voor de velden ‘BerichtResultaatCode’, ‘OmschrijvingBerichtResultaat’, ‘ResultaatCode’ en ‘OmschrijvingResultaat’
Situatie	BerichtResultaatCode		OmschrijvingBerichtResultaat
Vastleggen bericht in berichtenlogboek mislukt	FCB01	(2)	‘Er is een fout opgetreden’
De afzender van het bericht is niet geautoriseerd	FCB02	(4)	‘Afzender niet geautoriseerd’
De afzender van het bericht is niet gevuld	FCB03	(8)	‘De afzender van het bericht moet gevuld zijn’
Indicatie eindgebruiker is niet gevuld	FCB04	(10)	‘De indicatie eindgebruiker van het bericht moet gevuld zijn’
Het berichtnummer van de afzender is niet gevuld	FCB05	(9)	‘Het berichtnummer van de afzender moet gevuld zijn’
Bericht bevat meer vragen dan het toegestane maximum (vooralsnog 1)	FCB06	(6)	‘Het bericht bevat meer vragen dan het toegestane maximum’
Bericht bevat geen vraag	FCB07	(7)	‘Het bericht moet minimaal één vraag bevatten’
Eén of meer vraagnummers niet gevuld	FCB08	(11)	‘De vraagnummers moeten gevuld zijn’
Vraagnummer begint niet bij nummer 1	FCB09	(13)	‘Vraagnummer begint niet bij nummer 1’
Vraagnummers zijn niet oplopend	FCB10	(14)	‘Vraagnummers zijn niet oplopend’
Fout bij ophalen gegevens	FCB11	(2)	‘Er is een fout opgetreden’
Fout bij bijwerken auditlog	FCB12	(2)	‘Er is een fout opgetreden’
Goede verwerking		(3000)	‘Verwerking bericht succesvol’

Situatie	ResultaatCode		OmschrijvingResultaat
Fout bij controleren van het nummer	FCA01	(3003)	‘Nummer is geen BSN’
Geen of meerdere resultaten gevonden	FCA02	(3001)	‘Vraag heeft niet tot één persoon geleid’
BSN is niet gevuld	FCA04	(3004)	‘BSN moet gevuld zijn’
Succes		(3002)	‘Resultaat gevonden’

In de onderstaande figuur II.2.2c wordt de berichtcyclus weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Figuur II.2.2c – Cyclus ‘Opvragen identificerende gegeven op basis van een BSN’

II.2.3. Toetsen geldigheid BSN

In de WSDL zijn de volgende elementen gedefinieerd die overeenkomen met het vraag- en antwoordbericht:

• ZoekNrSoapIn
• ZoekNrSoapOut

In tabel II.2.3a wordt de gegevensset weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Tabel II.2.3a – Gegevens voor dienst ‘Toetsen geldigheid BSN’
ZoekNrSoapIn	ZoekNrSoapOut
Vraagbericht	Antwoordbericht
Algemeen deel	Algemeen deel
Afzender*	BerichtNr
BerichtNr*	BvBsnBerichtNr
IndicatieEindgebruiker*	BerichtResultaatCode
	OmschrijvingBerichtResultaat
1 of meerdere vragen	1 of meerdere antwoorden
Vraagnummer*	Vraagnummer
BurgerServiceNr*	OmschrijvingResultaat
	ResultaatCode

Tabel II.2.3b – BerichtResultaatCodes, -omschrijvingen en resultaten
Situatie	BerichtResultaatCode		OmschrijvingBerichtResultaat
Vastleggen bericht in berichtenlogboek mislukt	FCB01	(2)	‘Er is een fout opgetreden’
De afzender van het bericht is niet geautoriseerd	FCB02	(4)	‘Afzender niet geautoriseerd’
De afzender van het bericht is niet gevuld	FCB03	(8)	‘De afzender van het bericht moet gevuld zijn’
Indicatie eindgebruiker is niet gevuld	FCB04	(10)	‘De indicatie eindgebruiker van het bericht moet gevuld zijn’
Het berichtnummer van de afzender is niet gevuld	FCB05	(9)	‘Het berichtnummer van de afzender moet gevuld zijn’
Bericht bevat meer vragen dan het toegestane maximum (vooralsnog 1)	FCB06	(6)	‘Het bericht bevat meer vragen dan het toegestane maximum’
Bericht bevat geen vraag	FCB07	(7)	‘Het bericht moet minimaal één vraag bevatten’
Vraagnummer begint niet bij nummer 1	FCB08	(13)	‘Vraagnummer begint niet bij 1’
Vraagnummers zijn niet oplopend	FCB09	(14)	‘Vraagnummers zijn niet oplopend’
Eén of meer vraagnummers niet gevuld	FCB10	(11)	‘De vraagnummers moeten gevuld zijn’
Fout bij bijwerken auditlog	FCB12	(2)	‘Er is een fout opgetreden’
Goede verwerking		(16000)	‘Verwerking bericht succesvol’

Situatie	ResultaatCode		OmschrijvingResultaat
Opgegeven nummer voldoet niet aan de 11-proef	FCA01	(16001)	‘Nummer is geen BSN’
Nummer is niet aanwezig in het nummerregister	FCA02	(16001)	‘Nummer is geen BSN’
BSN is niet gevuld	FCA03	(16003)	‘BSN moet gevuld zijn’
Succes		(16002)	‘Nummer is een BSN’

In de onderstaande figuur II.2.3c wordt de berichtcyclus weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Figuur II.2.3c – Cyclus ‘Toetsen geldigheid BSN’

II.2.4. Opvragen BSN op basis van identificerende gegevens

In de WSDL zijn de volgende elementen gedefinieerd die overeenkomen met het vraag- en antwoordbericht:

• OpvrBsnIdenGegSoapIn
• OpvrBsnIdenGegSoapOut

In tabel II.2.4a wordt de gegevensset weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Tabel II.2.4a – Gegevens voor dienst ‘Opvragen BSN op basis van identificerende gegevens’
OpvrBsnIdenGegSoapIn		OpvrBsnIdenGegSoapOut
Vraagbericht zoekpad 1	Vraagbericht zoekpad 2	Antwoordbericht
Algemeen deel	Algemeen deel	Algemeen deel
Afzender*	Afzender*	BerichtNr
BerichtNr*	BerichtNr*	BvBsnBerichtNr
IndicatieEindgebruiker*	IndicatieEindgebruiker*	BerichtResultaatCode
		OmschrijvingBerichtResultaat
1 of meerdere vragen	1 of meerdere vragen	1 of meerdere antwoorden
Vraagnummer*	Vraagnummer*	Vraagnummer
Voornamen	Voornamen	Bsn
VoorvoegselGeslachtsnaam	VoorvoegselGeslachtsnaam	Voornamen
Geslachtsnaam	Geslachtsnaam*	AdellijkeTitelPredikaat
Geboortedatum*	Geboortedatum*	VoorvoegselGeslachtsnaam
Geboorteplaats	Geboorteplaats	Geslachtsnaam
Geboorteland	Geboorteland	Geboortedatum
Geslachtsaanduiding*	Geslachtsaanduiding*	Geboorteplaats
GemeenteVanInschrijving	GemeenteVanInschrijving	Geboorteland
Straatnaam	Straatnaam	Geslachtsaanduiding
Huisnummer*	Huisnummer	GemeenteVanInschrijving i
Huisletter	Huisletter	Straatnaam i
Huisnummertoevoeging	Huisnummertoevoeging	Huisnummer i
AanduidingBijHuisnummer	AanduidingBijHuisnummer	Huisletter i
Postcode*	Postcode	Huisnummertoevoeging i
Locatiebeschrijving	Locatiebeschrijving	AanduidingBijHuisnummer i
LandVanwaarIngeschreven	LandVanwaarIngeschreven	Postcode i
		Locatiebeschrijving i
		LandVanwaarIngeschreven i
		FunctieAdres i
		Gemeentedeel i
		IndicatieGeheim
		OmschrijvingRedenOpschorting
		AanduidingGegevensInOnderzoek Persoon
		DatumIngangOnderzoekPersoon
		DatumOverlijden
		AanduidingGegevensInOnderzoek Overlijden
		DatumIngangOnderzoekOverlijden
		AanduidingGegevensInOnderzoekAdres i
		DatumIngangOnderzoekAdres i
		ResultaatCode
		OmschrijvingResultaat

Tabel II.2.4b – Vulling voor de velden ‘BerichtResultaatCode’, ‘OmschrijvingBerichtResultaat’, ‘ResultaatCode’ en ‘OmschrijvingResultaat’
Situatie	BerichtResultaatCode		OmschrijvingBerichtResultaat
Vastleggen bericht in berichtenlogboek mislukt	FCB01	(2)	‘Er is een fout opgetreden’
De afzender van het bericht is niet geautoriseerd	FCB02	(4)	‘Afzender niet geautoriseerd’
De afzender van het bericht is niet gevuld	FCB03	(8)	‘De afzender van het bericht moet gevuld zijn’
Indicatie eindgebruiker is niet gevuld	FCB04	(10)	‘De indicatie eindgebruiker van het bericht moet gevuld zijn’
Het berichtnummer van de afzender is niet gevuld	FCB05	(9)	‘Het berichtnummer van de afzender moet gevuld zijn’
Vraagnummer begint niet bij nummer 1	FCB06	(13)	‘Vraagnummer begint niet bij nummer 1’
Vraagnummers zijn niet oplopend	FCB07	(14)	‘Vraagnummers zijn niet oplopend’
Bericht bevat meer vragen dan het toegestane maximum (vooralsnog 1)	FCB08	(6)	‘Het bericht bevat meer vragen dan het toegestane maximum’
Bericht bevat geen vraag	FCB09	(7)	‘Het bericht moet minimaal één vraag bevatten’
Eén of meer vraagnummers niet gevuld	FCB10	(11)	‘De vraagnummers moeten gevuld zijn’
Fout bij bijwerken auditlog	FCB11	(2)	‘Er is een fout opgetreden’
Fout bij ophalen gegevens	FCB12	(2)	‘Er is een fout opgetreden’
Goede verwerking		(23000)	‘Verwerking bericht succesvol’

Situatie	ResultaatCode		OmschrijvingResultaat
Set van identificerende gegevens niet valide	FCA01	(23004)	‘Vraag voldoet niet aan een toegestaan zoekpad’
Geen resultaten gevonden	FCA03	(23001)	‘Geen resultaat gevonden’
Meerdere resultaten gevonden (met verschillende BSN’s)	FCA04	(23006)	‘Vraag heeft niet tot één persoon geleid’
Meerdere resultaten gevonden (met hetzelfde BSN)	FCA05	(23006)	‘Vraag heeft niet tot één persoon geleid’
Succes		(23002)	‘Resultaat gevonden’

In de onderstaande figuur II.2.4c wordt de berichtcyclus weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Figuur II.2.4c – Cyclus ‘Opvragen BSN op basis van identificerende gegevens’

II.2.5. Toetsen in verkeer zijn van het identiteitsdocument

In de WSDL zijn de volgende elementen gedefinieerd die overeenkomen met het vraag- en antwoordbericht:

• VerificatieIdentiteitsDocumentSoapIn
• VerificatieIdentiteitsDocumentSoapOut

In tabel II.2.5a wordt de gegevensset weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Tabel II.2.5a – Gegevens voor dienst ‘Toetsen in verkeer zijn van het identiteitsdocument’
VerificatieIdentiteitsDocumentSoapIn	VerificatieIdentiteitsDocumentSoapOut
Vraagbericht	Antwoordbericht
Algemeen deel	Algemeen deel
Afzender*	BerichtNr
BerichtNr*	BvBsnBerichtNr
IndicatieEindgebruiker*	BerichtResultaatCode
	OmschrijvingBerichtResultaat
1 of meerdere vragen	1 of meerdere antwoorden
Vraagnummer*	Vraagnummer
DocumentType*	ResultaatCode
DocumentNummer*	OmschrijvingResultaat

Tabel II.2.5b – Vulling voor de velden ‘BerichtResultaatCode’, ‘OmschrijvingBerichtResultaat’, ‘ResultaatCode’ en ‘OmschrijvingResultaat’
Situatie	BerichtResultaatCode		OmschrijvingBerichtResultaat
Vastleggen bericht in berichtenlogboek mislukt	FCB01	(2)	‘Er is een fout opgetreden’
De afzender van het bericht is niet geautoriseerd	FCB02	(4)	‘Afzender niet geautoriseerd’
De afzender van het bericht is niet gevuld	FCB03	(8)	‘De afzender van het bericht moet gevuld zijn’
Indicatie eindgebruiker is niet gevuld	FCB04	(10)	‘De indicatie eindgebruiker van het bericht moet gevuld zijn’
Het berichtnummer van de afzender is niet gevuld	FCB05	(9)	‘Het berichtnummer van de afzender moet gevuld zijn’
Vraagnummer begint niet bij nummer 1	FCB06	(13)	‘Vraagnummer begint niet bij nummer 1’
Vraagnummers zijn niet oplopend	FCB07	(14)	‘Vraagnummers zijn niet oplopend’
Bericht bevat meer vragen dan het toegestane maximum (vooralsnog 1)	FCB08	(6)	‘Het bericht bevat meer vragen dan het toegestane maximum’
Bericht bevat geen vraag	FCB09	(7)	‘Het bericht moet minimaal één vraag bevatten’
Eén of meer vraagnummers niet gevuld	FCB10	(11)	‘De vraagnummers moeten gevuld zijn’
Vraagnummers niet uniek	FCB11	(12)	‘De vraagnummers moeten uniek zijn’
Fout bij bijwerken auditlog	FCB12	(2)	‘Er is een fout opgetreden’
Fout bij het ophalen gegevens	FCB13	(2)	‘Er is een fout opgetreden’
Goede verwerking		(24000)	‘Verwerking bericht succesvol’

Situatie	ResultaatCode		OmschrijvingResultaat
Documenttype is niet gevuld	FCA02	(24003)	‘Documenttype is niet gevuld
Documentnummer is niet gevuld	FCA03	(24004)	’Documentnummer is niet gevuld’
Document geen identiteitsdocument		(24001)	‘Document met nummer <<documentnummer>> kan niet gebruikt worden als identiteitsdocument volgens de WID artikel 1’
Document identiteitsdocument		(24002)	‘Document met nummer <<documentnummer>> kan gebruikt worden als identiteitsdocument volgens de WID artikel 1’

In de onderstaande figuur II.2.5c wordt de berichtcyclus weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Figuur II.2.5c – Cyclus ‘Toetsen in verkeer zijn van het identiteitsdocument’

II.3. Registerhouder diensten

In de volgende paragrafen wordt de inhoud van de vraag- en antwoordberichten van de webservices voor de registerhouders weergegeven.

Tabel II.3a geeft een overzicht van diensten voor de registerhouders.

Tabel II.3a – Beheervoorziening BSN Registerhouder diensten
Dienstomschrijving
‘Presentievraag’
‘Vulbericht’
‘Afvoeren PL’
‘Wijzigen BSN’
‘Wijzigen A-nummer’
‘Realtime presentievraag op basis van identificerende gegevens’
‘Aanvragen BSN voorraad’
‘Herstelbericht’

Een aantal diensten komt overeen met de diensten vermeld bij de gebruikers. Deze worden hier niet opnieuw beschreven omdat ze identiek zijn. In de volgende paragrafen worden de diensten voor de registerhouders verder toegelicht.

De diensten voor registerhouders zijn enkelvoudige vragen. Om de berichtfoutcodes overeen te laten komen met de foutcodes van de berichten voor gebruikers, worden bij deze berichten de foutcodes die specifiek op de vraag zelf betrekking hebben en niet op het bericht aangeduid met de prefix ‘FCA’.

II.3.1. Presentievraag

Dit bericht is opgemaakt volgens het sPd-protocol, bericht ‘Presentievraag’ (Bq11). Voor de beschrijving van de sPd-berichten wordt verwezen naar het LO GBA, waarin in bijlage IV het sPd-protocol is uitgewerkt, en in bijlage III specifieke informatie over de berichtopbouw van de verschillende onderkende berichten.

II.3.2. Vulbericht

Dit bericht is opgemaakt volgens het sPd-protocol, bericht ‘Vulbericht’ (Ag11). Voor de beschrijving van de sPd-berichten wordt verwezen naar het LO GBA, waarin in bijlage IV het sPd-protocol is uitgewerkt, en in bijlage III specifieke informatie over de berichtopbouw van de verschillende onderkende berichten.

II.3.3. Afvoeren PL

Dit bericht is opgemaakt volgens het sPd-protocol, bericht ‘Afvoeren PL’ (Ng01). Voor de beschrijving van de sPd-berichten wordt verwezen naar het LO GBA, waarin in bijlage IV het sPd-protocol is uitgewerkt, en in bijlage III specifieke informatie over de berichtopbouw van de verschillende onderkende berichten.

II.3.4. Wijzigen BSN

Dit bericht is opgemaakt volgens het sPd-protocol, bericht Gv01 ‘Wijzigen BSN’. Voor de beschrijving van de sPd-berichten wordt verwezen naar het LO GBA, waarin in bijlage IV het sPd-protocol is uitgewerkt, en in bijlage III specifieke informatie over de berichtopbouw van de verschillende onderkende berichten.

II.3.5. Wijzigen A-nummer

Dit bericht is opgemaakt volgens het sPd-protocol, bericht Wa11 ‘Wijzigen A-nummer’. Voor de beschrijving van de sPd-berichten wordt verwezen naar het LO GBA, waarin in bijlage IV het sPd-protocol is uitgewerkt, en in bijlage III specifieke informatie over de berichtopbouw van de verschillende onderkende berichten.

II.3.6. Realtime presentievraag van identificerende gegevens

In de WSDL zijn de volgende elementen gedefinieerd die overeenkomen met het vraag- en antwoordbericht:

• MatchIdenGegSoapIn
• MatchIdenGegSoapOut

In tabel II.3.6a wordt de gegevensset weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Tabel II.3.6a – Gegevens voor dienst ‘Realtime presentievraag van identificerende gegevens’
MatchIdenGegSoapIn	MatchIdenGegSoapOut
Vraagbericht	Antwoordbericht
Algemeen deel	Algemeen deel
Identificatie afzender*	Identificatie afzender*
Berichtnummer afzender*	Berichtnummer afzender
Instantie*	BC GBA Berichtnummer
	Berichtresultaatcode
	Omschrijving berichtresultaat
1 of meerdere vragen	Per antwoord
Vraagnummer*	Vraagnummer
Voornamen	Resultaatcode
Voorvoegsel Geslachtsnaam	Omschrijving resultaat
Geslachtsnaam*	Per gevonden match
Geboortedatum*	Volgnummer match
Geboorteplaats	BSN
Geboorteland	Voornamen
Geslachtsaanduiding*	Adellijke titel/predikaat
Nationaliteit	Voorvoegsels geslachtsnaam
Gemeente van inschrijving	Geslachtsnaam
Datum vertrek uit Nederland	Geboortedatum
	Geboorteplaats
	Geboorteland
	Geslachtsaanduiding
	Aanduiding gegevens in onderzoek persoon
	Datum ingang onderzoek persoon
	Nationaliteit
	Aanduiding gegevens in onderzoek nationaliteit
	Datum ingang onderzoek nationaliteit
	Datum overlijden
	Aanduiding gegevens in onderzoek overlijden
	Datum ingang onderzoek overlijden
	Omschrijving reden opschorting
	Indicatie geheim
	Gemeente van inschrijving
	Functie adres
	Gemeentedeel
	Straatnaam
	Huisnummer
	Huisletter
	Huisnummertoevoeging
	Aanduiding bij huisnummer
	Postcode
	Locatiebeschrijving
	Datum vertrek uit Nederland
	Land vanwaar ingeschreven
	Aanduiding gegevens in onderzoek adres
	Datum ingang onderzoek adres
	Registratie
	Score

Tabel II.3.6b – Vulling voor de velden ‘BerichtResultaatCode’, ‘OmschrijvingBerichtResultaat’, ‘ResultaatCode’ en ‘OmschrijvingResultaat’
Situatie	BerichtResultaatCode		OmschrijvingBerichtResultaat
Vastleggen bericht in berichtenlogboek mislukt	FCB01	(2)	‘Er is een fout opgetreden’
Autorisatie mislukt	FCB02	(4)	‘Afzender niet geautoriseerd’
Raadplegen PVR kon niet succesvol worden uitgevoerd.	FCB03	(2)	‘Er is een fout opgetreden’
Presentievraag kon niet succesvol worden geregistreerd in PVR	FCB04	(2)	‘Er is een fout opgetreden’
Matchingsvraag kon niet worden doorgezet naar BV BSN	FCB05	(2)	‘Er is een fout opgetreden’
Vraag kon niet succesvol door BV BSN worden uitgevoerd	FCB06	(2)	‘Er is een fout opgetreden’
Fout bij vullen auditlog	FCB07	(2)	‘Er is een fout opgetreden’
Goede verwerking		(12000)	‘Verwerking bericht succesvol’

Situatie	ResultaatCode		OmschrijvingResultaat
Set van identificerende gegevens niet valide	FCA01	(12004)	‘Vraag voldoet niet aan een toegestaan zoekpad’
Geen resultaten gevonden	FCA02	(12001)	‘Geen resultaten gevonden’
Te veel resultaten gevonden	FCA03	(12003)	‘Te veel resultaten gevonden’
Twee personen met hetzelfde BSN gevonden	FCA04	(12005)	‘Uniciteitsprobleem geconstateerd’
1 of meerdere resultaten gevonden		(12002)	‘Resultaat gevonden’

In de onderstaande figuur wordt de berichtencyclus weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Figuur II.3.6c – Cyclus ‘Realtime presentievraag op basis van identificerende gegevens’

II.3.7. Aanvragen BSN voorraad

In de WSDL zijn de volgende elementen gedefinieerd die overeenkomen met het vraag- en antwoordbericht:

• GenereerDistribueerNrSoapIn
• GenereerDistribueerNrSoapOut

In tabel II.3.7a wordt de gegevensset weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Tabel II.3.7a – Gegevens voor dienst ‘Aanvragen BSN voorraad’
GenereerDistribueerNrSoapIn	GenereerDistribueerNrSoapOut
Vraagbericht	Antwoordbericht
Identificatie afzender	Identificatie afzender
Berichtnummer afzender	Berichtnummer afzender
Aantal nummers	BC GBA Berichtnummer
	Berichtresultaatcode
	Omschrijving berichtresultaat
	Batchnummer
	Aantal nummers
	Nummers
	Hashtotal

Tabel II.3.7b – Vulling voor de velden ‘BerichtResultaatCode’, ‘OmschrijvingBerichtResultaat’, ‘ResultaatCode’ en ‘OmschrijvingResultaat’
Situatie	BerichtResultaatCode		OmschrijvingBerichtResultaat
Vastleggen bericht in berichtenlogboek mislukt	FCB01	(2)	‘Er is een fout opgetreden’
Autorisatie mislukt	FCB02	(4)	‘Afzender niet geautoriseerd’
Identificatie afzender bij vraagbericht is niet gevuld	FCB03	(8)	‘De identificatie afzender van het bericht moet gevuld zijn’
Berichtnummer afzender bij vraagbericht is niet gevuld	FCB04	(9)	‘Het berichtnummer van de afzender moet gevuld zijn’
Aantal nummers is niet gevuld	FCB06	(4002)	‘Het gewenst aantal nummers moet opgegeven worden’
Vraag kon niet worden doorgezet naar BV BSN	FCB07	(2)	‘Er is een fout opgetreden’
Vraag kon niet succesvol door BV BSN worden uitgevoerd	FCB08	(2)	‘Er is een fout opgetreden’
Fout bij vullen auditlog	FCB09	(2)	‘Er is een fout opgetreden’
Gemeentecode onjuist	FCB10	(4001)	‘De ingevoerde gemeentecode is niet conform de gemeentetabel’
Goede verwerking		(4000)	‘Verwerking bericht succesvol’

In de onderstaande figuur wordt de berichtencyclus weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Figuur II.3.7c – Cyclus ‘Aanvragen BSN voorraad’

II.3.8. Herstelbericht

Dit bericht is opgemaakt volgens het sPd-protocol, bericht Ag31 ‘Herstelbericht’. Voor de beschrijving van de sPd-berichten wordt verwezen naar het LO GBA, waarin in bijlage IV het sPd-protocol is uitgewerkt, en in bijlage III specifieke informatie staat over de berichtopbouw van de verschillende onderkende berichten.

II.4. Beheerdiensten

In de volgende paragrafen wordt de inhoud weergegeven van de vraag- en antwoordberichten van de diensten ten behoeve van beheer met betrekking tot de begeleidende gegevens.

Tabel II.4a geeft een overzicht van de beheerdiensten.

Tabel II.4a – Overzicht beheervoorziening beheerdiensten
Dienstomschrijving
‘Opvragen berichten’
‘Opvragen audittrail’

II.4.1. Opvragen berichten

In de WSDL zijn de volgende elementen gedefinieerd die overeenkomen met het vraag- en antwoordbericht:

• VraagBerichtLogOpSoapIn
• VraagBerichtLogOpSoapOut

In tabel II.4.1a wordt de gegevensset weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Tabel II.4.1a – Gegevens voor dienst ‘Opvragen berichten’
VraagBerichtLogOpSoapIn	VraagBerichtLogOpSoapOut
Vraagbericht	Antwoordbericht
Algemeen deel	Algemeen deel
Afzender*	BerichtNr
BerichtNr*	BvBsnBerichtNr
IndicatieEindgebruiker*	OmschrijvingBerichtResultaat
	BerichtResultaatCode
	Aantal
Zoekcriteria	1 of meerdere antwoorden
BvBsnBerichtNr	Volgnummer
AfzenderBerichtNr	BvBsnBerichtNr
WelkeAfzender	Afzender
SelectieDtBegin	AfzenderBerichtNr
SelectieDtEind	Inhoud
Dienstsoort	Dienstsoort
Vanafvolgnummer	Gewijzigd
	Berichtsoort

Tabel II. 4.1b – Vulling voor de velden ‘BerichtResultaatCode’, ‘OmschrijvingBerichtResultaat’, ‘ResultaatCode’ en ‘OmschrijvingResultaat’
Situatie	BerichtResultaatCode		OmschrijvingBerichtResultaat
Vastleggen bericht in berichtenlogboek mislukt	FCB01	(2)	‘Er is een fout opgetreden’
De afzender van het bericht is niet geautoriseerd	FCB02	(4)	‘Afzender niet geautoriseerd’
De afzender van het bericht is niet gevuld	FCB03	(8)	‘De afzender van het bericht moet gevuld zijn’
Indicatie eindgebruiker is niet gevuld	FCB04	(10)	‘De indicatie eindgebruiker van het bericht moet gevuld zijn’
Het berichtnummer van de afzender is niet gevuld	FCB05	(9)	‘Het berichtnummer van de afzender moet gevuld zijn’
Vraagbericht bevat geen zoekcriterium	FCB06	(7001)	‘ Vraag moet minimaal één zoekcriterium’
Geen resultaten gevonden	FCB07	(7002)	‘ Geen resultaat gevonden’
Fout bij ophalen gegevens	FCB08	(2)	‘Er is een fout opgetreden’
Fout bij bijwerken auditlog	FCB09	(2)	‘Er is een fout opgetreden’
Goede verwerking		(7000)	‘Verwerking bericht succesvol’

In de onderstaande figuur II. 4.1wordt de berichtcyclus weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Figuur II.4.1c – Cyclus ‘Opvragen berichten’

II.4.2. Opvragen audittrail

In de WSDL zijn de volgende elementen gedefinieerd die overeenkomen met het vraag- en antwoordbericht:

• VraagAuditLogOpSoapIn
• VraagAuditLogOpSoapOut

In tabel II.4.2a wordt de gegevensset weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Tabel II.4.2a – Gegevens voor dienst ‘Opvragen audittrail’
VraagAuditLogOpSoapIn	VraagAuditLogOpSoapOut
Vraagbericht	Antwoordbericht
Algemeen deel	Algemeen deel
Afzender*	BerichtNr
BerichtNr*	BvBsnBerichtNr
IndicatieEindgebruiker*	BerichtResultaatCode
	OmschrijvingBerichtResultaat
	Aantal
Zoekcriteria	1 of meerdere antwoorden
AfzenderBerichtNr	Volgnummer
BvBsnBerichtNr	BvBsnBerichtNr
Afzender	AfzenderBerichtNr
IndicatieEindgebruiker / Instantie	Afzender
SelectieDtBegin	IndicatieEindgebruiker / Instantie
SelectieDtEind	Gewijzigd
Vanafvolgnummer	Actie
	ResultaatActie
	ResultaatCode

Tabel II.4.2b – Vulling voor de velden ‘BerichtResultaatCode’, ‘OmschrijvingBerichtResultaat’, ‘ResultaatCode’ en ‘OmschrijvingResultaat’
Situatie	BerichtResultaatCode		OmschrijvingBerichtResultaat
Vastleggen bericht in berichtenlogboek mislukt	FCB01	(2)	‘Er is een fout opgetreden’
De afzender van het bericht is niet geautoriseerd	FCB02	(4)	‘Afzender niet geautoriseerd’
De afzender van het bericht is niet gevuld	FCB03	(8)	‘De afzender van het bericht moet gevuld zijn’
Indicatie eindgebruiker is niet gevuld	FCB04	(10)	‘De indicatie eindgebruiker van het bericht moet gevuld zijn’
Het berichtnummer van de afzender is niet gevuld	FCB05	(9)	‘Het berichtnummer van de afzender moet gevuld zijn’
Vraagbericht bevat geen zoekcriterium	FCB06	(8001)	‘Vraag moet minimaal één zoekcriterium bevatten’
Geen resultaten gevonden	FCB07	(8002)	‘Vraag heeft niet tot één of meer berichten geleid’
Fout bij het ophalen van de gegevens	FCB08	(2)	‘Er is een fout opgetreden’
Fout bij bijwerken auditlog	FCB09	(2)	‘Er is een fout opgetreden’
Goede verwerking		(8000)	‘Verwerking bericht succesvol’

In de onderstaande figuur II.4.2c wordt de berichtcyclus weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Figuur II.4.2c – Cyclus ‘Opvragen audittrail’

II.5. Tijdelijke diensten

De BV BSN voorziet vanaf de inwerktreding van het BSN-stelsel in enkele tijdelijke diensten. Deze diensten zijn een aanvulling op de diensten beschreven in bijlage 0 en zullen beschikbaar zijn tot een door de Minister van BZK nader te bepalen datum. Tabel II.5a geeft een overzicht van de tijdelijke diensten voor een gebruiker.

Dienstomschrijving
‘Stellen bulkvraag’
‘Ophalen antwoord bulkvraag’
‘Opvragen BSN t.b.v. schoning en initiële vulling’

Voor de tijdelijke diensten is het Bulkvragenregister opgericht, waarin de bulkvragen en de antwoorden daarop worden opgeslagen door de BV BSN. Dit register kent een opschoningstermijn van 2 weken. Het is dan ook belangrijk dat gebruikers het antwoord op een gestelde bulkvraag binnen deze termijn opvragen uit de BV BSN.

II.5.1. Stellen bulkvraag

In de WSDL zijn de volgende elementen gedefinieerd die overeenkomen met het vraag- en antwoordbericht:

• StelBulkvraagSoapIn
• StelBulkvraagSoapOut

In tabel II.5.1a wordt de gegevensset weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Tabel II.5.1a – Gegevens voor dienst ‘Stellen bulkvraag’
StelBulkvraagSoapIn	StelBulkvraagSoapOut
Vraagbericht	Antwoordbericht
Algemeen deel
Identificatie afzender	Berichtnummer afzender
Berichtnummer afzender	BV BSN Berichtnummer
Indicatie eindgebruiker	Berichtresultaatcode
1 of meerdere vragen	Omschrijving berichtresultaat
Vraagnummer	Behandelnummer
Voornamen
Voorvoegsel Geslachtsnaam
Geslachtsnaam
Geboortedatum
Geboorteplaats
Geboorteland
Geslachtsaanduiding
Gemeente van inschrijving
Straatnaam
Huisnummer
Huisletter
Huisnummertoevoeging
Aanduiding bij huisnummer
Postcode
Locatiebeschrijving
Land vanwaar ingeschreven

Tabel II.5.1b – Vulling voor de velden ‘BerichtResultaatCode’, ‘OmschrijvingBerichtResultaat’, ‘ResultaatCode’ en ‘OmschrijvingResultaat’
Situatie	BerichtResultaatCode		OmschrijvingBerichtResultaat
Vastleggen bericht in berichtenlogboek mislukt	FCB01	(2)	‘Er is een fout opgetreden’
Autorisatie mislukt	FCB02	(4)	‘Afzender niet geautoriseerd’
De afzender van het bericht is niet gevuld	FCB03	(8)	‘De afzender van het bericht moet gevuld zijn’
Indicatie eindgebruiker is niet gevuld	FCB04	(10)	‘De indicatie eindgebruiker van het bericht moet gevuld zijn’
Het berichtnummer van de afzender is niet gevuld	FCB05	(9)	‘Het berichtnummer van de afzender moet gevuld zijn’
Vraagnummer begint niet bij 1	FCB06	(13)	‘Vraagnummer begint niet bij nummer 1’
Vraagnummers zijn niet oplopend	FCB07	(14)	‘Vraagnummers zijn niet oplopend’
Bericht bevat meer vragen dan het toegestane maximum	FCB08	(6)	‘Het bericht bevat meer vragen dan het toegestane maximum’
Bericht bevat geen vragen	FCB09	(7)	‘Het bericht moet meerdere vragen bevatten’
Eén of meer vraagnummers niet gevuld	FCB10	(11)	‘De vraagnummers moeten gevuld zijn’
Fout bij bijwerken auditlog	FCB11	(2)	‘Er is een fout opgetreden’
Goede verwerking		(33000)	‘Verwerking bericht succesvol’

In de onderstaande figuur II.5.1c wordt de berichtcyclus weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Figuur II.5.1c – Cyclus ‘Stellen bulkvraag’

II.5.2. Ophalen antwoord bulkvraag

In de WSDL zijn de volgende elementen gedefinieerd die overeenkomen met het vraag- en antwoordbericht:

• HaalOpAntwBulkvrgSoapIn
• HaalOpAntwBulkvrgSoapOut

In tabel II.5.2a wordt de gegevensset weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Tabel II.5.2a – Gegevens voor dienst ‘Ophalen antwoord bulkvraag’
HaalOpAntwBulkvrgSoapIn	HaalOpAntwBulkvrgSoapOut
Vraagbericht	Antwoordbericht
Algemeen deel	Algemeen deel
Identificatie afzender	Berichtnummer afzender
Berichtnummer afzender	BV BSN Berichtnummer
Indicatie eindgebruiker	Berichtresultaatcode
Behandelnummer	Omschrijving berichtresultaat
	1 of meerdere antwoorden
	Vraagnummer
	Resultaatcode
	Omschrijving resultaat
	BSN
	Voornamen
	Adellijke titel/predikaat
	Voorvoegsels geslachtsnaam
	Geslachtsnaam
	Geboortedatum
	Geboorteplaats
	Geboorteland
	Geslachtsaanduiding
	Aanduiding gegevens in onderzoek persoon
	Datum ingang onderzoek persoon
	Datum overlijden
	Aanduiding gegevens in onderzoek overlijden
	Datum ingang onderzoek overlijden
	Omschrijving reden opschorting
	Indicatie geheim
	Gemeente van inschrijving
	Functie adres
	Gemeentedeel
	Straatnaam
	Huisnummer
	Huisletter
	Huisnummertoevoeging
	Aanduiding bij huisnummer
	Postcode
	Locatiebeschrijving
	Land vanwaar ingeschreven
	Aanduiding gegevens in onderzoek adres
	Datum ingang onderzoek adres

Tabel II.5.2b – Vulling voor de velden ‘BerichtResultaatCode’, ‘OmschrijvingBerichtResultaat’, ‘ResultaatCode’ en ‘OmschrijvingResultaat’
Situatie	BerichtResultaatCode		OmschrijvingBerichtResultaat
Autorisatie mislukt	FCB01	(4)	‘Afzender niet geautoriseerd’
Identificatie afzender in vraagbericht is niet gevuld	FCB02	(8)	‘De afzender van het bericht moet gevuld zijn’
Berichtnummer afzender in vraagbericht is niet gevuld	FCB03	(9)	‘Het berichtnummer van de afzender moet gevuld zijn’
Indicatie eindgebruiker in vraagbericht is niet gevuld	FCB04	(10)	‘De indicatie eindgebruiker van het bericht moet gevuld zijn’
Behandelnummer moet ingevuld zijn	FCB05	(34001)	‘Het behandelnummer moet gevuld zijn’
(Nog) geen antwoord beschikbaar bij opgegeven behandelnummer	FCB06	(34002)	‘(Nog) geen antwoord beschikbaar’
De combinatie afzender-behandelnummer komt niet voor	FCB07	(34003)	‘Het opgegeven behandelnummer is onjuist’
Afzender komt niet overeen met afzender van de bulkvraag	FCB08	(34004)	‘De afzender komt niet overeen met de afzender van de bulkvraag’
Fout bij vullen auditlog	FCB09	(2)	‘Er is een fout opgetreden’
Fout bij ophalen gegevens	FCB010	(2)	‘Er is een fout opgetreden’
Verwerking succesvol	FCB011	(37000)	(‘Verwerking bericht succesvol’

Situatie	ResultaatCode		OmschrijvingResultaat
Set van identificerende gegevens niet valide	FCA01	(37004)	‘Vraag voldoet niet aan een toegestaan zoekpad’
Geen resultaten gevonden	FCA02	(37001)	‘Geen resultaat gevonden’
Meerdere resultaten met hetzelfde BSN gevonden	FCA03	(37006)	‘Vraag heeft niet tot één persoon geleid’
Meerdere resultaten met verschillende BSN’s gevonden	FCA04	(37006)	‘Vraag heeft niet tot één persoon geleid’
Verwerking succesvol	FCA05	(37002)	‘Resultaat gevonden’

In de onderstaande figuur II.5.2c wordt de berichtcyclus weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Figuur II.5.2c – Cyclus ‘Ophalen antwoord bulkvraag’

II.5.3. Opvragen BSN tbv opschoning en initiële vulling

In de WSDL zijn de volgende elementen gedefinieerd die overeenkomen met het vraag- en antwoordbericht:

• OpvrBsnTbvVullingSoapIn
• OpvrBsnTbvVullingSoapOut

In tabel II.5.3a wordt de gegevensset weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Tabel II.5.3a – Gegevens voor dienst ‘Opvragen BSN tbv opschoning en initiële vulling’
OpvrBsnTbvVullingSoapIn		OpvrBsnTbvVullingSoapOut
Vraagbericht zoekpad 1	Vraagbericht zoekpad 2	Antwoordbericht
Algemeen deel	Algemeen deel	Algemeen deel
Identificatie afzender*	Identificatie afzender*	Berichtnummer afzender
Berichtnummer afzender*	Berichtnummer afzender*	BV BSN Berichtnummer
Indicatie eindgebruiker*	Indicatie eindgebruiker*	Berichtresultaatcode
		Omschrijving berichtresultaat
1 of meerdere vragen	1 of meerdere vragen	1 of meerdere antwoorden
Vraagnummer	Vraagnummer	Vraagnummer
Voornamen	Voornamen	Resultaatcode
Voorvoegsel Geslachtsnaam	Voorvoegsel Geslachtsnaam	Omschrijving resultaat
Geslachtsnaam	Geslachtsnaam*	BSN
Geboortedatum*	Geboortedatum*	Voornamen
Geboorteplaats	Geboorteplaats	Adellijke titel/predikaat
Geboorteland	Geboorteland	Voorvoegsels geslachtsnaam
Geslachtsaanduiding*	Geslachtsaanduiding*	Geslachtsnaam
Gemeente van inschrijving	Gemeente van inschrijving	Geboortedatum
Straatnaam	Straatnaam	Geboorteplaats
Huisnummer*	Huisnummer	Geboorteland
Huisletter	Huisletter	Geslachtsaanduiding
Huisnummertoevoeging	Huisnummertoevoeging	Aanduiding gegevens in onderzoek persoon
Aanduiding bij huisnummer	Aanduiding bij huisnummer	Datum ingang onderzoek persoon
Postcode*	Postcode	Datum overlijden
Locatiebeschrijving	Locatiebeschrijving	Aanduiding gegevens in onderzoek overlijden
Land vanwaar ingeschreven	Land vanwaar ingeschreven	Datum ingang onderzoek overlijden
		Omschrijving reden opschorting
		Indicatie geheim
		Gemeente van inschrijving
		Functie adres
		Gemeentedeel
		Straatnaam
		Huisnummer
		Huisletter
		Huisnummertoevoeging
		Aanduiding bij huisnummer
		Postcode
		Locatiebeschrijving
		Land vanwaar ingeschreven
		Aanduiding gegevens in onderzoek adres
		Datum ingang onderzoek adres

Tabel II.5.3b – Vulling voor de velden ‘BerichtResultaatCode’, ‘OmschrijvingBerichtResultaat’, ‘ResultaatCode’ en ‘OmschrijvingResultaat’
Situatie	BerichtResultaatCode		OmschrijvingBerichtResultaat
Autorisatie mislukt	FCB01	(4)	‘Afzender niet geautoriseerd’
Vraagnummer begint niet bij nummer 1	FCB02	(13)	‘Vraagnummer begint niet bij 1’
Vraagnummers zijn niet oplopend	FCB03	(14)	‘Vraagnummers zijn niet oplopend’
Bericht bevat geen vragen	FCB04	(7)	‘Het bericht moet minimaal één vraag bevatten’
Bericht bevat teveel vragen	FCB05	(6)	‘Het bericht bevat meer vragen dan het toegestane maximum’
Identificatie afzender in vraagbericht is niet gevuld	FCB06	(8)	‘De afzender van het bericht moet gevuld zijn’
Berichtnummer afzender in vraagbericht is niet gevuld	FCB07	(9)	‘Het berichtnummer van de afzender moet gevuld zijn’
Indicatie eindgebruiker in vraagbericht is niet gevuld	FCB08	(10)	‘De indicatie eindgebruiker van het bericht moet gevuld zijn’
Eén of meer vraagnummers niet ingevuld	FCB09	(11)	‘De vraagnummers moeten gevuld zijn’
Fout bij ophalen gegevens	FCB10	(2)	‘Er is een fout opgetreden’
Fout bij vullen auditlog	FCB11	(2)	‘Er is een fout opgetreden’

Situatie	ResultaatCode		OmschrijvingResultaat
Set van identificerende gegevens niet valide	FCA01	(35004)	‘Vraag voldoet niet aan een toegestaan zoekpad’
Geen resultaten gevonden	FCA02	(35001)	‘Geen resultaat gevonden’
Meerdere resultaten met hetzelfde BSN gevonden	FCA03	(35006)	‘Vraag heeft niet tot één persoon geleid’
Meerdere resultaten met verschillende BSN’s gevonden	FCA04	(35006)	‘Vraag heeft niet tot één persoon geleid’

In de onderstaande figuur II.5.3c wordt de berichtcyclus weergegeven voor zowel het vraagbericht als het antwoordbericht van deze dienst.

Figuur II.5.3c – Cyclus ‘Opvragen BSN tbv opschoning en initiële vulling’

II.6. Meldingen gegevens in onderzoek

Indien gegevens in onderzoek zijn, worden de betreffende codes binnen de BV BSN vertaald naar de volgende meldingen:

‘Aanduiding gegevens in onderzoek’	Melding
010000	‘Persoonsgegevens zijn in onderzoek’
010100	‘Identificatienummergegevens zijn in onderzoek’
010120	‘BSN is in onderzoek’
010200	‘Naamgegevens zijn in onderzoek’
010210	‘Voornamen zijn in onderzoek’
010220	‘Adellijke titel/predikaat is in onderzoek’
010230	‘Voorvoegsel geslachtsnaam is in onderzoek’
010240	‘Geslachtsnaam is in onderzoek’
010300	‘Geboortegegevens zijn in onderzoek’
010310	‘Geboortedatum is in onderzoek’
010320	‘Geboorteplaats is in onderzoek’
010330	‘Geboorteland is in onderzoek’
010400	‘Geslachtsgegevens zijn in onderzoek’
010410	‘Geslachtsaanduiding is in onderzoek’
040000	‘Nationaliteitsgegevens zijn in onderzoek’
040500	‘Nationaliteitsgegevens zijn in onderzoek’
040510	‘Nationaliteit is in onderzoek’
060000	‘Overlijdensgegevens zijn in onderzoek’
060800	‘Overlijdensgegevens zijn in onderzoek’
060810	‘Datum overlijden is in onderzoek’
080000	‘Verblijfplaatsgegevens zijn in onderzoek’
080900	‘Gemeentegegevens zijn in onderzoek’
080910	‘Gemeente van inschrijving is in onderzoek’
081000	‘Adreshoudingsgegevens zijn in onderzoek’
081010	‘Functie adres is in onderzoek’
081020	‘Gemeentedeel is in onderzoek’
081100	‘Adresgegevens zijn in onderzoek’
081110	‘Straatnaam is in onderzoek’
081120	‘Huisnummer is in onderzoek’
081130	‘Huisletter is in onderzoek’
081140	‘Huisnummertoevoeging is in onderzoek’
081150	‘Aanduiding bij huisnummer is in onderzoek’
081160	‘Postcode is in onderzoek’
081200	‘Locatiegegevens zijn in onderzoek’
081210	‘Locatiebeschrijving is in onderzoek’
081300	‘Emigratiegegevens zijn in onderzoek’
081320	‘Datum vertrek uit Nederland is in onderzoek’
081400	‘Immigratiegegevens zijn in onderzoek’

III. Aanleveren Gegevenssets

III.1. Inleiding

De BV BSN maakt gebruik van interne registers om haar taken uit te kunnen voeren. Deze registers bevatten gegevens van persoonslijsten in het GBA (GBA-V) en de Belastingdienst (BvR). Het dagelijks bijhouden van de GBA-V door de gemeenten en van de BvR door de Belastingdienst heeft tot gevolg dat er periodiek (dagelijks) nieuwe registers moeten worden opgebouwd waar de BV BSN gebruik van kan maken. De beschreven registers binnen de BV BSN worden de GBA-V’ en de BvR’ genoemd. Het aanleveren van de gegevens van de GBA-V’ en BvR’ is in dit document beschreven.

III.2. Bijwerken van de GBA-V’

Binnen de BV BSN wordt een kopie van de GBA-V database bijgehouden. Deze kopie wordt GBA-V’ genoemd en wordt dagelijks bijgewerkt. Elke dag ontvangt de BV BSN een afslagbestand vanuit GBA-V welke geconverteerd wordt naar de GBA-V’ database.

Bij het ontvangen van het afslagbestand GBA-V worden de volgende gegevens aangeleverd.

Tabel III.2a – Overzicht van de aangeleverde gegevens in GBA-V’
Gegevens GBA-V’
Recordid	Gemeente van inschrijving
A-nummer	Functie adres
BSN	Gemeentedeel
Voornamen	Straatnaam
Adellijke titel/predikaat	Huisnummer
Voorvoegsels geslachtsnaam	Huisletter
Geslachtsnaam	Huisnummertoevoeging
Geboortedatum	Aanduiding bij huisnummer
Geboorteplaats	Postcode
Geboorteland	Locatiebeschrijving
Geslachtsaanduiding	Datum vertrek uit Nederland
Aanduiding gegevens in onderzoek persoon	Aanduiding gegevens in onderzoek adres
Datum ingang onderzoek persoon	Datum ingang onderzoek adres
Datum einde onderzoek persoon	Datum einde onderzoek adres
Nationaliteit	Aanduiding bijzonder Nederlanderschap
Aanduiding gegevens in onderzoek nationaliteit	Datum opschorting bijhouding
Datum ingang onderzoek nationaliteit	Aanduiding verblijfstitel
Datum einde onderzoek nationaliteit	Datum einde verblijfstitel
Datum overlijden	Ingangsdatum verblijfstitel
Aanduiding gegevens in onderzoek overlijden
Datum ingang onderzoek overlijden
Datum einde onderzoek overlijden
Omschrijving reden opschorting
Indicatie geheim

III.3. Bijwerken van de BvR’

Binnen de BV BSN wordt een kopie van de BvR-database bijgehouden. Deze kopie wordt BvR’ genoemd en wordt dagelijks bijgewerkt. Elke dag wordt de BvR geconverteerd naar de BVR’-database.

Bij het ontvangen van de BvR dienen de gegevens in tabel Tabel III.3a te worden aangeleverd.

Tabel III.3a – Overzicht van de aangeleverde gegevens in BvR’
Te ontvangen gegevensset
Voorlooprecord	Sluitrecord
Verwerkingsdatum	Verwerkingsaantal
Bestandsnaam	Hashtotaal sofinummer
Filler	Hashtotaal geboortedatum
Detailrecord	Hashtotaal sofinummer alfanumeriek
Sofi-nummer	Hashtotaal geboortedatum alfanumeriek
Voornamen	Filler
Voorletters
Voorvoegsels
Adellijke titel
Geslachtsnaam
Geboortedatum
Geslachtsaanduiding
Emigratiedatum
Adressoort
Straatnaam
Huisnummer
Huisnummertoevoeging
Postcode
Woonplaats
Adres buitenland 1
Adres buitenland 2
Adres buitenland 3
Land

IV. Werking zoekmechanisme

De Beheervoorziening BSN biedt gebruikers onder meer de mogelijkheid om te vragen welk BSN bij de opgegeven identificerende gegevens hoort. Daarnaast hebben toekennende instanties de mogelijkheid om een matchingsfunctie te gebruiken om te voorkomen dat een persoon meer dan één nummer krijgt én om te voorkomen dat een nummer aan meer dan één persoon wordt toegekend. Voor beide functies zet de beheervoorziening een zoekvraag uit bij de verschillende registraties. Omdat er geen één op één relatie bestaat tussen de gegevensset die wordt aangeboden om mee te zoeken en de gegevens die zijn opgeslagen in de registraties, wordt een combinatie van exact zoeken en intelligent zoeken gebruikt.

Bij het zoeken in de achterliggende registraties wordt eerst op basis van één van de verplichte zoekpaden getracht om een zo breed mogelijk resultaat te vinden binnen de vastgestelde zoekmethoden. Het resultaat wordt verkregen door combinatie van de vastgestelde zoekmethoden voor die velden. Als er hierna meer resultaten zijn dan gewenst, wordt de zoekvraag verfijnd door een extra veld aan de zoekvraag toe te voegen. Met deze verfijnde zoekvraag wordt in het zoekresultaat van de vorige stap gezocht. Als er hierna nog steeds te veel resultaten zijn, wordt de verfijningstap herhaald.

In de bijgaande figuur wordt het zoekproces voor verificatievragen waarbij één resultaat is gewenst globaal weergegeven. Indien het zoekmechanisme gebruikt wordt bij een door een gemeente uitgevoerde presentievraag, worden maximaal 10 resultaten teruggegeven.

Figuur IVa – Zoekproces verificatievragen voor één resultaat

Per veld is een keuze gemaakt welke zoekmethode gebruikt wordt. De volgende zoekmethoden kunnen onderscheiden worden:

1. Exacte match: Het opgegeven veld komt exact overeen met het gevonden veld. Deze zoekmethode wordt voor alle velden gebruikt.
2. Diakrietentransformatie: Het opgegeven veld komt, na diakrietentransformatie, exact overeen met het gevonden veld. In paragraaf 0 ‘Diakrieten en bekende schrijfwijzen’ is beschreven hoe moet worden omgegaan met de transformatie van diakrieten.
3. Transcriptie en transliteratie: Het opgegeven veld komt, na het volgen van de gestelde transcriptie- en transliteratieregels, exact overeen met het gevonden veld.
4. Overige zoekmethoden: Er wordt bij de overige zoekmethoden onderscheid gemaakt tussen het zoeken door gebruikers ten behoeve van verificatie en het zoeken door instanties ten behoeve van toekenning, omdat het doel van het zoeken verschilt. Bij het zoeken ten behoeve van verificatie van de identiteit moet het risico op een onjuiste match zo klein mogelijk zijn. Bij het zoekproces ten behoeve van de toekenning van burgerservicenummers is het vooral belangrijk dat de juiste match ertussen zit.

IV.1. Diakrieten en bekende schrijfwijzen

Binnen de Beheervoorziening wordt gebruik gemaakt van de ISO-standaard 10646 UTF-8 tekenset. In deze tekenset worden ook de GBA-gegevens, waar de Teletex standaard wordt gebruikt, één op één gerepresenteerd. In het Logisch Ontwerp GBA is een weergave van de Teletex tekenset terug te vinden.

Om te komen tot een match zijn er verschillende zoekmethoden. Eén daarvan is de transformatie van diakrieten. Bij het intelligent zoeken door de Beheervoorziening BSN in de registers wordt onderstaande diakriettransformatie toegepast.

De diakrietentransformatie wordt als volgt uitgevoerd:

• Alle diakritische tekens worden verwijderd en een aantal bijzondere lettertekens (bv.

) wordt omgezet naar een corresponderend teken of tekens in de range ‘a’ tot en met ‘z’. Dit gebeurt volgens een vertaaltabel (zie conversietabellen).
• Alle (normale) hoofdletters A tot en met Z worden omgezet naar de overeenkomstige kleine letters.
• Alle resterende karakters, niet zijnde de cijfers ‘0’ tot en met ‘9’ en de letters ‘a’ tot en met ‘z’, worden omgezet naar spaties waarna alle spaties worden verwijderd.

Nadat zowel de zoekopdracht als de gegevens zijn getransformeerd wordt op basis van een exacte match getransformeerd. Door het gebruik van diakriettransformatie is het mogelijk om verschillende notaties van hetzelfde gegeven in verschillende registers te vinden.

IV.2. Wegingsfactor

Zoals hiervoor beschreven, wordt eerst op basis van één van de verplichte zoekpaden getracht een zo breed mogelijk resultaat te verkrijgen. Als er teveel resultaten zijn, wordt daarna stapsgewijs de zoekvraag verfijnd. De volgorde van de verfijningstappen wordt bepaald door de wegingsfactor. Per mogelijk veld is een waarde (tussen 0 en 1) opgenomen waarbij, na het verplichte zoekpad, de velden met de hoogste factor eerst worden genomen.

IV.3. Matchwaarde

Om de vraagsteller van de matchingsvraag ten behoeve van toekenning te ondersteunen bij de afweging tussen verschillende resultaten wordt een score berekend. Daarbij wordt, naast de wegingsfactor, gebruik gemaakt van de matchwaarde. Voor iedere zoekmethode op een veld wordt een matchwaarde ingevuld.

De formule voor het berekenen van de score is:

De velden die wel in de vraag zijn opgenomen maar niet bij het zoeken zijn gebruikt, worden ook niet in de berekening van de score meegenomen. Als op basis van een verplicht zoekpad door middel van een exacte match een resultaat wordt gevonden, dan is de score 100%. Dit geldt ook als andere velden niet overeenkomen met het gevonden resultaat.

V. Beschrijvende woordenlijst

Begrip	Omschrijving
Afzender	Met de ‘identificatie van de afzender’ wordt bedoeld degene van wie een bericht afkomstig is. De afzender mag zelf een unieke logische naam van zijn entiteit kiezen. De ‘Distinguished Name’ uit gebruikte digitale certificaat kan als suggestie dienen.
AR	Authentieke registratie. Een kwalitatief hoogwaardig en met expliciete garanties voor de borging van die kwaliteit omkleed bestand van, gezien het geheel van wettelijke taken, vitale en/of veelvuldig en om uiteenlopende redenen benodigde gegevens over personen, instellingen, zaken, verrichtingen of gebeurtenissen, dat bij wet als de enig officieel erkende registratie voor de betreffende gegevens is aangemerkt en dat in het gehele land verplicht wordt gebruikt door alle overheidsinstanties, alsook zo mogelijk door private organisaties, tenzij het gebruik om zwaarwegende redenen zoals privacybescherming expliciet is uitgesloten.
BC	Beheercomponent
Bericht	Een bericht bestaat uit een vraagbericht (afkomstig van de afzender) en een antwoordbericht (dat gestuurd wordt vanuit BV BSN, n.a.v. informatie die verkregen is uit de bronsystemen)
BPR	Agentschap Basisadministratie Persoonsgegevens en Reisdocumenten. BPR is een agentschap van het Ministerie van Binnenlandse Zaken en Koninkrijksrelaties (BZK). http://www.bprbzk.nl/
Bronsysteem	Bronsysteem is het systeem waarnaar de BV BSN een vraagbericht verstuurt en waarvan de BV BSN een antwoordbericht krijgt. Bronsystemen zijn GBA, RNI, BvR, RDW, BVV, etc.
BSN	Burgerservicenummer
BSN-stelsel	Procedures, afspraken en functionaliteiten rondom het burgerservicenummer
BV BSN	Beheervoorziening BSN
BvR	Beheer van Relaties, het registratiesysteem van de Belastingdienst
BVV	Basis Voorziening Vreemdelingen
FTP	File Transfer Protocol. Het protocol om bestanden tussen computers versturen via een TCP/IP netwerk. De naam wordt ook wel gebruikt voor het programma om de bestanden over te halen.
GBA	Gemeentelijke Basisadministratie persoonsgegevens
GBA-V	Gemeentelijke Basisadministratie persoonsgevens -Verstrekkingen Online
HTML	HyperText Markup Language. Het formaat om documenten op te maken op het WWW.
HTTP	HyperText Transfer Protocol. Een protocol om HTML-documenten via het WWW uit te wisselen.
HTTPS	HyperText Transfer Protocol Secure
Identiteitsdocument	Een identiteitsdocument is een bewijsstuk om aan te kunnen tonen wie je bent. In Nederland onderkennen we de volgende soort identiteitsdocumenten:Paspoort, Rijbewijs, Identiteitskaart, Vreemdelingenkaart
Instantie	Hiermee wordt bedoeld: een instantie die bevoegd is om nummers toe te kennen. Toekennende instanties verkrijgen toegang tot de beheervoorziening via beheercomponenten (bijvoorbeeld een gemeente, de gemeente ‘buitenland’, een diplomatieke post). De volgende instantie wordt geregistreerd ten behoeve van validatie en traceerbaarheid: • instantie aan wie nummers worden gedistribueerd, • instantie die een BSN heeft toegekend, • instantie die een omhanging heeft uitgevoerd, • instantie die een nummer uit verkeer heeft gehaald, • instantie die een sofi-nummer heeft opgewaardeerd tot een BSN. In alle gevallen moet het een geldige toekennende instantie betreffen waarbij de controle op de juistheid en geldigheid door de beheercomponent wordt uitgevoerd. De Beheervoorziening valideert of de bij het BSN geregistreerde instantie overeenkomt met de gewenste actie.
IP	Internet Protocol is het protocol voor de netwerklaag van het internet.
LBV	Lokale beheervoorziening
LRD	Landelijk Raadpleegbare Deelverzameling; een tijdelijke voorziening van de GBA om online een deelverzameling van de gegevens in de GBA te kunnen raadplegen.
NVF	Nationale Vertrouwensfunctie. De NVF is geen aparte organisatie, maar een verzameling taken en bevoegdheden die waarborgen dat het BSN op de juiste manier wordt gebruikt in sectoren en organisaties.
PKI	Public Key Infrastructure. Een systeem van public key encryption gebruik makend van digitale certificaten van gecertificeerde instanties (TTP) om de authenticiteit van een partij te verifiëren en te garanderen.
Public key encryption	Een procedure om berichten te versleutelen en vervolgens te ontcijferen op basis van 2 sleutels, te weten een public key en een private key. De public key van de ontvanger is algemeen toegankelijk en wordt gebruikt bij de versleuteling van een bericht. Het bericht kan alleen worden ontcijferd met de private key die alleen bekend is bij de ontvanger.
Protocol	Een verzameling van formele regels om de manier van gegevensuitwisseling te beschrijven.
RNI	Registratie Niet-Ingezetenen
SBV	Sectorale BerichtenVoorziening
SGML	Standard Generalized Markup Language. SGML is een internationale standaard om de relatie tussen de inhoud van een document en de structuur van het document te beschrijven.
SLA	Service Level Agreement
SOAP	Simple Object Access Protocol, een computerprotocol dat wordt gebruikt voor communicatie tussen verschillende componenten middels XML-berichten.
SVF	Sectorale vertrouwensfunctie
TCP	Transmission Control Protocol. TCP is het meest gebruikte protocol in de transportlaag van gegevens voor het internet.
TCP/IP	Transmission Control Protocol over Internet Protocol. TCP/IP wordt meestal gebruikt als term voor het protocol dat naast TCP en IP zaken als telnet en FTP omvat en geldt als de defacto standaard voor het internet.
TTP	Trusted Third Party. Een instantie die digitale certificaten uitgeeft aan anderen waarmee deze hun identiteit kunnen aantonen aan derden. Het is de taak van de TTP om voor die tijd de identiteit van de aanvrager van het digitale certificate te verifiëren. Een bekend voorbeeld van een TTP is Verisign.
UML	Unified Modelling Language, een taal om computersystemen te modelleren en te beschrijven
WBP	Wet Bescherming Persoonsgegevens
WSDL	Web Service Description Language
WWW	World Wide Web
XML	eXtensible Markup Language. XML is een eenvoudige vorm van SGML om de opmaak en de structuur van een document te beschrijven.

1
De elfproef staat beschreven in bijlage 0, onder het element ‘BSN’.
2
De aansluitprocedure is op het internet te vinden op http://www.bprbzk.nl/
3
De elfproef staat beschreven in bijlage 0, onder het element ‘BSN’.
4
Meer informatie over de dienst ’Aanvragen BSN Voorraad’ is te vinden in bijlage 0.
5
Meer informatie over het ‘Vulbericht’ is te vinden in bijlage 0.
6
Meer informatie over de ’Presentievraag’ is te vinden in bijlage 0 en 0.
7
Meer informatie over de dienst ’Wijzigen BSN’ is te vinden in het Logisch Ontwerp GBA.
8
Meer informatie over de dienst ’Afvoeren PL’ is te vinden in het Logisch Ontwerp GBA.
9
Meer informatie over de dienst ’Toets of nummer een BSN is’ is te vinden in bijlage 0.
10
Meer informatie over de dienst ’Verificatie van identiteitsdocumenten’ is te vinden in bijlage 0.
11
Meer informatie over de dienst ’Opvragen identificerende gegevens op basis van een BSN’ is te vinden in bijlage II.2.2.
12
Meer informatie over de dienst ’Opvragen BSN op basis van identificerende gegevens’ is te vinden in bijlage 0.
13
Meer informatie over de dienst ’Toetsen van de combinatie BSN en identificerende gegevens’ is te vinden in bijlage 0.
14
Het nummerfoutenlogboek wordt verder toegelicht in paragraaf 0.
15
Het systeemfoutenlogboek wordt verder toegelicht in paragraaf 0.
16
Het benaderen van het systeem zonder geldig certificaat valt buiten de misbruikdetectie daar er uit wordt gegaan van systeem gebaseerde detectie en niet van netwerk gebaseerde detectie.
17
De score van de match wordt verder toegelicht in bijlage 0.
18
Een beschrijving van het Foutenmeldpunt is te vinden in hoofdstuk 0
19
De responsetijd is gedefinieerd als de tijd die verstrijkt tussen het ontvangen van de vraag en het versturen van het antwoord door de BV BSN. De vertraging die door tussenliggende partijen of de achterliggende registers optreedt maakt geen onderdeel uit van de responsetijd.
20
Elfproef:
Indien het nummer per cijfer wordt aangeduid (s0 s1 s2 s3 s4 s5 s6 s7 s8), dan is de volgende voorwaarde te controleren:
(9*s0) + (8*s1) + (7*s2) + (6*s3) + (5*s4) + (4*s5) + (3*s6) + (2*s7) + (1*s8) is deelbaar door 11.