Technische Handleiding ABO-interface

Transcriptie

1 Technische Handleiding ABO-interface Versie 2.1 WSDL versie 1.3 Datum 06 juni 2017 Status Definitief

2 Inhoud Inhoud... 2 Inleiding Communicatie op basis van XML-berichten Codering en optionele velden in XML Controles op DeelnemerOpgaven Administratie van verstuurde en ontvangen berichten DeelnemersOpgave Versie en Stuurgegevens Bijlage(n) Inschrijving (Dv01) Actualisering (Dv02) Wijziging in de naam (AC0101) Wijziging in de geboorte (AC0102) Wijziging in het geslacht (AC0103) Verkrijging Nederlandse nationaliteit (AC0401) Verlies Nederlandse nationaliteit (AC0402) Verkrijging buitenlandse nationaliteit (AC0403) Verlies buitenlandse nationaliteit (AC0404) Beëindiging staatsloosheid (AC0405) Wijziging in reden opname (AC0406) Wijziging in reden beëindiging (AC0407) Verwijderen van nationaliteitsgegevens (AC0408) Correctie van ten onrechte opgenomen gegevens (AC0409) Actualiseren document (AC0410) Actualiseren van de ingangsdatum geldigheid (AC0411) Opnemen overlijdensgegevens (AC0601) Corrigeren overlijdensgegevens (AC0602) Correctie van ten onrechte opgenomen gegevens (AC0603) Actualiseren akte en document (AC0604) Wijziging buitenlands adres (AC0801) Wijzigen onderzoeksgegevens (AC8301) Verificatie (Dv03) AanvullendeScan (Dv04) Synchroon: OntvangstBevestiging of TechnischeFout OntvangstBevestiging Technische Fout OpgaveResultaat VerwerkBevestiging (Da01..Da04) FoutBericht (Df01..Df04) DeelnemersAanvraag Stuurgegevens Pagina 2 van 53

3 4.2 Overzicht ingediende opgaven (Dv11) Details ingediende opgaven (Dv12) Intrekken ingediende opgave (Dv13) Synchroon: Antwoord of Technische Fout Antwoord Deel met informatie ingediende opgave Technische Fout Overgang naar nieuwe versie WSDL Handreiking Bijlage A: T.61 en UTF-8 coderingen II Teletex II.1 Inleiding II.2 Overzicht van alle Teletex karakters II.3 Overzicht van de te gebruiken Teletex karakters II.4 Overzicht van de te gebruiken gecombineerde Teletex karakters II.5 Overzicht van de te gebruiken Teletex-besturingskarakters Bijlage B: XML-namen Bijlage C: Overzicht verwerkingscodes Bijlage D: Voorbeelden XML-berichten Bijlage E: Tekens in namen Pagina 3 van 53

4 Inleiding Onderliggende technische handleiding is onderdeel van het aansluitproces waarbij een GBA-afnemer de rol van ABO op zich neemt. Dit document is bedoeld als handreiking voor ontwikkelaars die een interface bouwen tussen de applicatie(s) van een RNI-deelnemer (ABO) en het RNI-systeem. De basis voor die interface wordt gevormd door drie in de WSDL opgenomen webservices: DeelnemersOpgave-service; OpgaveResultaat-service; DeelnemersAanvraag-service. De algemene werking van de webservices staat in dit document beschreven. Onderliggend document is tot stand gekomen door de informatie samen te voegen uit een aantal eerdere documenten waarin werking en gebruik van de berichten staat beschreven. Dit document vervangt de volgende documenten: Handleiding 1.1.c, Toelichting v120 en de Handreiking. In onderstaand figuur is de ABO-RNI-Keten schematisch weergegeven. Figuur 1: ABO-RNI Keten met de centrale voorzieningen. Pagina 4 van 53

5 1 Communicatie op basis van XML-berichten De webservices van het RNI-systeem zijn vanuit het Diginetwerk (Haagse Ring, Gemnet) beschikbaar voor de ABO s. Het onderliggende netwerk-protocol is https waarbij de ABO evenals het RNI-systeem moet beschikken over een SHA2-PKIO-overheidscertificaat. De berichten bestaan uit XML-code en de webservices zijn beschreven volgens de Soap 1.1 standaard in een WSDL (WSDL 1.3 is de laatste versie). De WSDL bestaat in totaal uit 6 WSDL-bestanden en 5 XSDbestanden en beschrijft de eerder genoemde drie webservices: DeelnemerAanvraag, DeelnemerOpgave en OpgaveResultaat. Gebruik van WS-adressing is verplicht (enabled). Het systeem van de ABO kan een verbinding maken middels https met de DeelnemerOpgave-webservice van de RNI en een opgave (Request: Dv01, Dv02, Dv03 of Dv04) versturen in XML-formaat. De ABO vervult daarbij de rol van Cliënt. Nadat de opgave in goede orde is ontvangen, stuurt de RNI een bevestigingsbericht (Response). Vervolgens zal de opgave worden verwerkt in het RNI-systeem. Na verwerking (en dit kan enige dagen duren) maakt het RNI-systeem contact met de OpgaveResultaat-webservice van de ABO en zal het resultaat van de verwerking opsturen naar de ABO. De RNI vervult daarbij de rol van Cliënt en de ABO vervult de rol van Server. Afhankelijk van het resultaat van de verwerking verstuurt RNI een verwerkbevestiging (Da01, Da02, Da03 of Da04) of een foutbericht met foutreden dan wel afwijsreden (Df01, Df02, Df03 of Df04). Bovenstaande proces beschrijft een synchroon stuk waarbij de ABO direct een OntvangstBevestiging ontvangt op de door de ABO ingestuurde opgave en een asynchroon deel waarbij de RNI op een zeker moment het resultaat van de verwerking naar de ABO stuurt. Verder beschikt het RNI-systeem over een tweede synchrone DeelnemerAanvraag-webservice. Hierop kan de ABO ten alle tijden de status opvragen van de ingediende opgaven. Er zijn diverse filter mogelijkheden om op basis van berichtsoort, datum-tijd, referentie en status de gewenste overzichten van opgaven te ontvangen. Deze service is synchroon, dat wil zeggen: de ABO ontvangt direct een overzicht (Da11, Da12 of Da13) dan wel een foutbericht met foutreden (Technische Fout). Zowel op een deelnemersopgave als deelnemersaanvraag kan als reactie een Soapfault (Technische fout) worden verstuurd voor alle (uitzonderlijke) foutsituaties. Dit bericht wordt synchroon verstuurd als reactie op een deelnemersopgave of deelnemersaanvraag. Als een ABO bijvoorbeeld niet over de juiste autorisatie in het RNI-systeem beschikt, volgt een Soapfault. Uit beveiligingsoogpunt wordt in dit geval verder geen nadere (specifieke) informatie gestuurd dan dat de deelnemer geen autorisatie heeft. 1.1 Codering en optionele velden in XML In de XML-berichten moet gebruik worden gemaakt van UTF-8. Omdat een ABO al is aangesloten als afnemer zal deze in die hoedanigheid te maken hebben met de T.61 Teletex-karakters in GBA-berichten en persoonslijsten. In de BRP en in het bijzonder het RNI-systeem mogen alleen de T.61 Teletex-karakters worden gebruikt zoals opgenomen in het LO GBA. Daaruit voortvloeiend mogen in XML-berichten alleen UTF-8 tekens worden opgenomen waarvan de corresponderende T.61 Teletex-karakters in het LO GBA zijn toegestaan. In bijlage A is een tabel opgenomen met alle toegestane T.61 en daarmee corresponderende UTF-8 coderingen. Deze tabel is rechtstreeks overgenomen uit het LO GBA versie Als een ABO niet beschikt over een bepaald optioneel gegeven en dit gegeven dus ook niet kan aanleveren dan wordt het desbetreffende XML-veld weggelaten uit het bericht. Hetzelfde geldt als een gehele set aan gegevens (bijvoorbeeld Historie) niet wordt opgestuurd. Deze velden zijn in de WSDL opgenomen als optioneel (minoccurs= 0 of nillable= true ) en moeten dan ook in het geheel niet worden opgenomen. Pagina 5 van 53

6 1.2 Controles op DeelnemerOpgaven Als DeelnemerOpgaven aan alle controles voldoen, kunnen ze automatisch worden verwerkt. De beheerder kan in het systeem echter ook instellen dat bepaalde actualiseringscodes (zie tabel 3, paragraaf 2.4) altijd in Tussenkomst Vereist (TV) moeten komen. Dv01 s komen in Tussenkomst Vereist (TV) als de gegevens één of meer keer worden gevonden in de BvBSN, BRP of RNI. Bij het zoeken naar personen wordt naast met de opgegeven gegevens ook gezocht op de verschillende naamdelen (Walraven-Jansen ook zoeken op Walraven en op Jansen) en op de naam zonder de aan de naam gekoppelde voorvoegsels (Vanderhout ook zoeken op Hout). Dv02 s komen in Tussenkomst Vereist (TV) als het een correctie (CO) betreft en er historie aanwezig is op de PL die mogelijk ook (handmatig) gecorrigeerd moet worden. De WSDL, die door RvIG wordt uitgeleverd aan de ABO s, voert een beperkt aantal controles uit. Een bericht dat niet door de WSDL-controles komt, kan niet worden aangeboden aan het RNI-systeem, maar een bericht dat wel door de WSDL-controles komt, kan nog worden afgekeurd in de RNI-applicatie. De ABO mag uitsluitend deelnemersverzoeken indienen waarvoor de ABO is geautoriseerd. Die autorisatie is afhankelijk van de gegevens die de ABO verwerkt in het kader van de aangewezen taak en van het met succes afgerond hebben van de test met het betreffende verzoek. Bij Dv02 s is het autorisatieniveau de Actualiseringscode. Alle waarden voor PL-rubrieken moeten bestaan uit tekens die afgebeeld kunnen worden op de GBA Teletex tekenset (LO GBA, onderdeel par. II.3, zie ook bijlage A). Dv01-berichten komen in de volgende situatie altijd op de status Tussenkomst Vereist: o De persoon heeft de Nederlandse nationaliteit; o De persoon is in Nederland geboren; o De geslachtsaanduiding heeft de waarde "O"; o De geboortedatum bevat geen volledige datum (dag is 00 of dag en maand zijn 00). Dit betreft dus ook automatisch In een Dv02-bericht voor een PL die is opgeschort vanwege overlijden (Opschortingsreden "O") of vanwege Ministerieel besluit (Opschortingsreden M ), moet de ingangsdatum van het aangeleverde categorievoorkomen (01, 04, 06 of 08) liggen voor of op de datum opschorting bijhouding. Zo niet, dan volgt een Df02 met foutcode 1022 (zie bijlage C). Zowel een Dv01-bericht als Dv02-bericht komt in TV als deze een voornaam of geslachtsnaam bevat met ongebruikelijke tekens. In bijlage A is een set van alle toegestane tekens (292) opgenomen. In bijlage E staan twee subsets opgenomen van 244 tekens in de geslachtsnaam en 252 tekens in de voornaam. Indien de voornaam of geslachtnaam tekens bevat die niet staan opgenomen in de subset, komt het bericht in TV. 1.3 Administratie van verstuurde en ontvangen berichten Verondersteld wordt dat het ABO-systeem een administratie bijhoudt omtrent de verstuurde opgaven, ontvangstbevestigingen (synchroon) en VerwerkBevestigingen (asynchroon). De verschillende berichten zijn aan elkaar gekoppeld middels de verplichte en unieke DeelnemerReferentie en RNIReferentie. De eigen administratie kan gecontroleerd worden doormiddel van de DeelnemerAanvraag die de gegevens haalt uit de berichtenadministratie van het RNI-systeem. Wat betreft de uniekheid en traceerbaarheid van een bericht, is het bijvoorbeeld niet handig om de eerste 10 tekens te gebruiken voor een verwijzing naar een binnen het ABO-systeem opgeslagen (uniek) dossier en de laatste 2 tekens random te laten bepalen door een aanverwant systeem. De nadelen: Er moet rekening worden gehouden met het feit dat over één dossier meerdere berichten in de loop der jaren verstuurd zullen worden (uniekheid); Het random bepalen kan dezelfde waarde opleveren (uniekheid); Het ABO-systeem heeft geen weet van de laatste 2 tekens en kan het bericht dus niet goed terug vinden (traceerbaarheid). Een handig en goed systeem is te starten met en dit getal steeds te verhogen met 1. Pagina 6 van 53

7 Mocht blijken dat een opgave is afgewezen dan zal de ABO de reden van afwijzing moeten onderzoeken. De oorzaak zal onderkend worden (eventueel in samenwerking of in overleg met de RvIG-beheerders) en in de veel gevallen zal de opgave vervolgens opnieuw onder iets gewijzigde omstandigheden en met een nieuwe unieke DeelnemerReferentie worden aangeboden aan het RNI-systeem. Tenslotte zal het ABO-systeem beschikken over een methode om enigerlei controle over de binnenkomende en uitgaande berichten te hebben: In aantal (bij de overgangsfase naar productie een maximum aantal); In tijd (tijdelijk parkeren of in batches versturen van berichten); Verwijderen (om wat voor reden dan ook); Opnieuw aanbieden (bij communicatie problemen waarbij geen ontvangstbevestiging is verkregen). Pagina 7 van 53

8 2 DeelnemersOpgave Met de DeelnemerOpgave kunnen vier soorten berichten worden verstuurd: Dv01, Inschrijving; Dv02, Actualisering; Dv03, Verificatie; Dv04, AanvullendeScan. Alle bovenstaande berichten bestaan uit een Versie, Stuurgegevens, Bijlage(n) en een Specifiek deel. Het Specifieke deel wordt in de volgende paragrafen per berichtsoort beschreven. De Versie, Stuurgegevens en Bijlage(n) zijn algemeen. 2.1 Versie en Stuurgegevens Het onderdeel Versie en Stuurgegevens bevat de volgende elementen: Versie; Het versienummer van de WSDL. Dit element is verplicht met waarde 1.3 DatumTijdAangemaakt; De datum/tijd waarop het bericht door de deelnemer is aangemaakt. Dit element is verplicht. Deelnemer; De deelnemerscode volgens Tabel 60. Dit element is verplicht. OmschrijvingVerdrag; Een omschrijving van het verdrag op basis waarvan de gegevens zijn verkregen. Dit element is optioneel en wordt alleen gevuld als er daadwerkelijk sprake is van een verdrag. DeelnemerReferentie; Een uniek referentienummer naar het bericht. Dit element is verplicht. De DeelnemerReferentie is 12 tekens lang en kan zowel cijfers als letters bevatten. Het nummer moet uniek aan 1 bericht zijn gekoppeld en mag na uitgave nooit meer worden gebruikt voor een ander bericht. Zowel in de ontvangstbevestiging als het verwerkbericht wordt gerefereerd aan deze unieke DeelnemerReferentie en daarbij gebruikt het RNI-systeem ook een eigen unieke referentie met 12 tekens: de RNIReferentie. DeelnemerMelderId; Optionele code die de deelnemer in staat stelt te traceren welke afdeling of welke medewerker de opgave heeft gedaan. Het element wordt gevuld met een betekenisloze code die alleen door de deelnemer geïnterpreteerd kan worden. 2.2 Bijlage(n) Een bijlage kan een scan bevatten van een willekeurig document waaruit de gegevens in het specifieke deel van het bericht, zijn ontleend. Een beheerder van RvIG kan eventueel de gegevens op de scan vergelijken met de gegevens in de opgave of de persoonslijst en deze controleren op juistheid. De bijlage bevat de volgende verplichte elementen (allen verplicht): Bestand. Dit blok kan 0, 1 of meerdere keren voorkomen. Binnen een blok komen de volgende elementen voor: o SoortScan; Een aanduiding van het soort bestand dat meegestuurd wordt. Voor de RNI-deelnemers is voorlopig slechts één waarde beschikbaar: Overig o Bestandsnaam; De naam waaronder het bestand bij de deelnemer opgeslagen is. o BinaireInhoud / Attachment; De eigenlijke inhoud van het bestand. Afhankelijk van de gekozen manier van insluiten, wordt het element BinaireInhoud of Attachment gebruikt. Vanuit het oogpunt van performance gaat de voorkeur uit naar het gebruik van Attachment (MTOM). Pagina 8 van 53

9 2.3 Inschrijving (Dv01) Het Specifiek gedeelte Inschrijving van een Dv01 bevat de volgende gegevens: Burgerservicenummer; Het Burgerservicenummer is optioneel maar moet <leeg> zijn (d.w.z. het veld Burgerservicenummer ontbreekt in zijn geheel in de XML). Dit gegeven is gebruikt tijdens de initiële vulling RNI en mag nu niet meer worden gebruikt. Persoon; Dit blok komt exact 1 keer voor. Nationaliteit; Dit blok kan 0, 1 of meerdere keren voorkomen. Verblijfplaats; Dit blok komt exact 1 keer voor. In tabel 1 staan de al dan niet verplichte gegevens in bovenstaande blokken Persoon, Nationaliteit en Verblijfplaats. Zoals al eerder beschreven kan een bericht dat wel door de WSDL-controles komt, nog worden afgewezen in de RNI-applicatie op basis van de regels die binnen de BRP gelden. In paragraaf 2.4 en 2.5 is voor de Dv01- en Dv02-berichten aangegeven welke gegevens al dan niet verplicht moeten voorkomen (in allerhande varianten). Tenslotte kunnen de opgaven dan alsnog (handmatig) worden afgewezen door RNI-gegevensbeheer ten behoeve van de kwaliteitsbewaking. De handreiking in hoofdstuk 5 is een hulpmiddel om inzichtelijk te maken aan welke eisen de gegevens moeten voldoen. Betekenis code C, K, O, PN en V in Tabel 1 De categorie 04 Nationaliteit is niet verplicht, maar als die voorkomt, moeten de gegevens , en worden ingevuld. Deze gegevens worden als C[onditioneel verplicht] aangeduid; Bij de groepen 81 en 82 is er sprake van een verplichte K[euze]. Of groep 81 (81.10 en 81.20) komt voor of groep 82 (82.20 en 82.30) komt voor.; Een O[ptioneel] gegeven moet worden weg gelaten uit de XML; Bij de naamgegevens en de adresgegevens komt de aanduiding PN (Gegevens zijn niet verplicht, maar moeten exact overeenkomen met de gegevens zoals ze op de nieuwe PL moeten komen. Alleen Geslachtsnaam is technisch correct, maar in bijna alle gevallen zullen er meer gegevens zijn; Een V[erplicht] gegeven moet worden opgenomen in het bericht. De standaardwaarde kan worden gebruikt indien onbekend (zie tabel 2); Een Dv01 bevat altijd alle (conditioneel) verplichte gegevens, inclusief geboorteplaats en geboorteland. NB: In de deelnemersopgaven spelen de GBA-rubrieknummers geen rol maar wordt gebruik gemaakt van de XML-namen. Omwille van de overzichtelijkheid (rubrieknummers zijn korter en allemaal even lang) en het in het Logisch Ontwerp kunnen nazoeken van de voorwaarden die voor gegevens gelden, zijn hier de gegevens wel met de rubrieknummers aangeduid. In bijlage B staat een vertaaltabel Rubrieknummer - rubrieknaam XML-naam. Tabel 1: Gegevens die aangeleverd worden in Dv01. Rubriek Omschrijving Code Toelichting Voornamen PN Optionele naamvelden Adellijke titel/predicaat PN worden ingevuld Voorvoegsel PN indien van toepassing Geslachtsnaam V Geboortedatum V Geboorteplaats V Bij Dv01 plaats en land Geboorteland V wel verplicht Geslachtsaanduiding V Registergemeente Akte K Of groep 81 of groep Aktenummer K komt verplicht voor met beide rubrieken Datum document K Beschrijving document K Ingangsdatum geldigheid V Pagina 9 van 53

10 Nationaliteit C Categorie nationaliteit komt 0, 1 of meer keren voor Reden opname nationaliteit C Groep 05, 63 en 85 zijn verplicht Datum document O Of geen of beide rubrieken Beschrijving document O Ingangsdatum geldigheid C Land adres buitenland V Optionele adresregels Datum aanvang adres buitenland V worden ingevuld indien Regel 1 adres buitenland PN bekend. Als is ingevuld Regel 2 adres buitenland PN moet zijn ingevuld; als Regel 3 adres buitenland PN is ingevuld moet zijn ingevuld Omschrijving van de aangifte adreshouding V Bij een verplicht gegeven dat een ABO niet verwerkt in het kader van de aangewezen taak, of een verplicht gegeven dat niet bekend is bij de ABO, wordt over het algemeen de standaardwaarde ingevuld. Een Optioneel gegeven wordt weg gelaten. Tabel 2: Inhoud van onbekende maar verplichte elementen in Dv01-berichten. Rubriek Omschrijving Inhoud Toelichting Geslachtsnaam Geslachtsnaam Een onbekende geslachtsnaam is niet toegestaan Geboortedatum Standaardwaarde indien onbekend. Gedeeltelijk onbekend is ook toegestaan: jjjjmm00, jjjj Geboorteplaats 0000 Standaardwaarde indien onbekend Geboorteland 0000 Standaardwaarde indien onbekend Geslachtsaanduiding O Standaardwaarde indien onbekend Datum document <vandaag> De datum waarop de gegevens zijn ontleend aan een akte of document. Over het algemeen is deze datum niet bekend bij de ABO en wordt de datum van vandaag verwacht Beschrijving document <tekst> Indien er een scan wordt meegestuurd zou hier een tekst als Kopie paspoort opgenomen kunnen worden. Indien het ABO-systeem zelf de bron is, verwachten wij een tekst die (uniek) verwijst naar dit systeem. Dit kan een standaardtekst zijn als UPA, GAK, BuZa, PROBAS etc Ingangsdatum geldigheid De datum waarop het geheel aan gegevens hun geldigheid kregen. Over het algemeen is dit onbekend bij de ABO en moet de standaardwaarde worden gebruikt Nationaliteit <code> Indien er geen nationaliteitsgegevens bekend zijn, moeten alle elementen , en worden weg gelaten uit de XML. Indien nationaliteit bekend is wordt de code verwacht Reden opname nationaliteit <code> Dit gegeven is over het algemeen niet bekend bij de ABO. Wij verwachten code 301 (Vaststelling bezit nationaliteit) indien de buitenlandse nationaliteit bekend is. Wij Pagina 10 van 53

11 Ingangsdatum geldigheid verwachten code 000 (Onbekend) indien de Nederlandse nationaliteit bekend is Dit gegeven kan over het algemeen niet bekend zijn bij de ABO. Wij verwachten de standaardwaarde Land adres buitenland 0000 Standaardwaarde indien onbekend Datum aanvang adres buitenland Standaardwaarde indien onbekend Omschrijving van de. Hier wordt de standaardwaarde aangifte adreshouding verwacht. In de handreiking (hoofdstuk 5) staat een toelichting op alle aan te leveren gegevens en de (technische) eisen die hieraan gesteld worden. Voor een aantal gegevens zijn de toegestane waarden of codes opgenomen in zogenaamde landelijke tabellen. In de handreiking is een verwijzing opgenomen naar de landelijke tabel die gebruikt moet worden. In bijlage D is van een aantal DeelnemerOpgaven een voorbeeld opgenomen in XML-formaat. In de voorbeelden hierna zijn alleen de persoongegevens opgenomen. Ten behoeve van de overzichtelijkheid ontbreken daarbij de stuurgegevens en xml-velden. Voorbeeld Dv01 met weinig gegevens Piet Boer M kopie paspoort Voorbeeld Dv01 met veel gegevens Piet G de Boer Aachen M kopie paspoort Kortenberglaan Bruxelles I Pagina 11 van 53

12 2.4 Actualisering (Dv02) Het Specifiek gedeelte Actualisering van een Dv02 bevat de volgende gegevens: Burgerservicenummer; Het Burgerservicenummer (BSN) van de persoon op wie de actualisering betrekking heeft. Dit element is verplicht. Anummer; Het A-nummer van de persoon op wie de actualisering betrekking heeft. Dit element is optioneel (en in zekere zin ook redundant. Als het BSN in het RNI-systeem niet voorkomt in de juiste combinatie met het Anummer, wordt de opgave niet verwerkt en volgt foutcode 201, zie bijlage C). SoortActualisering; Keuze uit een lijst met actualiseringscodes waaruit een keuze gemaakt moet worden. Dit element is verplicht. IndicatieAfhandeling; Keuze NA (Normale Actualisering), CO (Correctie), GC (Gegevens correct bij afgerond onderzoek), GA (Gegevens actualiseren na afgerond onderzoek). Dit element is verplicht. Afhankelijk van de SoortActualisering (actualiseringcode) omvat het specifieke gedeelte Actualisering exact één van de volgende blokken: PersoonActualisering; Dit blok kan 0 of 1 keer voorkomen. Als het blok voorkomt, komen de andere blokken niet voor (0 keer). NationaliteitActualisering; Dit blok kan 0 of 1 keer voorkomen. Als het blok voorkomt, komen de andere blokken niet voor (0 keer). OverlijdenActualisering; Dit blok kan 0 of 1 keer voorkomen. Als het blok voorkomt, komen de andere blokken niet voor (0 keer). VerblijfplaatsActualisering; Dit blok kan 0 of 1 keer voorkomen. Als het blok voorkomt, komen de andere blokken niet voor (0 keer). In onderstaande tabel staan alle mogelijke actualiseringscodes waarbij per actualiseringscode is aangegeven welke afhandelingsindicaties mogelijk zijn. Tabel 3: Alle actualiseringscode met mogelijke afhandelingsindicaties. ActualiseringsCode Omschrijving NA CO GC GA AC0101 Wijziging in de naam X X X AC0102 Wijziging in de geboorte X X AC0103 Wijziging in het geslacht X X X AC0401 Verkrijging Nederlandse nationaliteit X AC0402 Verlies Nederlandse nationaliteit X AC0403 Verkrijging buitenlandse nationaliteit X AC0404 Verlies buitenlandse nationaliteit X AC0405 Beëindiging staatsloosheid X AC0406 Wijziging in reden opname X X AC0407 Wijziging in reden beëindiging X X AC0408 Verwijderen van nationaliteitsgegevens X AC0409 Correctie van ten onrechte opgenomen gegevens X X AC0410 Actualiseren document X x* X AC0411 Actualiseren van de ingangsdatum geldigheid X X AC0601 Opnemen overlijdensgegevens X AC0602 Corrigeren overlijdensgegevens X X AC0603 Correctie van ten onrechte opgenomen gegevens X X AC0604 Actualiseren akte en document X x* X AC0801 Wijziging buitenlands adres X X X AC8301 Wijzigen onderzoeksgegevens X x* X x* = Actualisering is mogelijk als Correctie, maar omdat het administratieve gegevens betreft, is de wijziging op de PL niet anders dan bij een Normale Actualisering. Pagina 12 van 53

13 Bij de Dv02 worden actualiseringcodes onderscheiden. Per actualiseringscode wordt het bericht in de volgende paragrafen besproken. Betekenis code K, O, PH, PN en V bij Dv02-berichten Bij de groepen 81 en 82 is er sprake van een verplichte K[euze]. Of groep 81 (81.10 en 81.20) komt voor of groep 82 (82.20 en 82.30) komt voor.; Een O[ptioneel] gegeven kan worden weg gelaten uit de XML; Bij de naamgegevens en de adresgegevens komen de aanduiding PH (Gegevens zijn niet verplicht, maar moeten exact overeenkomen met zoals ze op de huidige PL staan) en PN (Gegevens zijn niet verplicht, maar moeten exact overeenkomen met zoals ze op de gewijzigde PL moeten komen). Als de aangeleverde gegevens niet exact overeenkomen met de gegevens zoals ze op de PL staan, wordt het bericht op status TV (Tussenkomst Vereist) gezet en handmatig afgehandeld.; Een V[erplicht] gegeven moet worden opgenomen in het bericht. De standaardwaarde moet worden gebruikt indien onbekend; Een Dv02 bevat altijd alle verplichte gegevens Wijziging in de naam (AC0101) Voornamen PN Optionele naamvelden Adellijke titel/predicaat PN worden ingevuld Voorvoegsel PN indien van toepassing Geslachtsnaam V Registergemeente Akte K Of groep 81 of groep 82 komt Aktenummer K verplicht voor met beide rubrieken Datum document K Beschrijving document K Ingangsdatum geldigheid V Voornamen PH Gegevens moeten exact Adellijke titel/predicaat PH overeenkomen met de Voorvoegsel PH huidige actuele op de PL Geslachtsnaam V Registergemeente Akte O Aktenummer O Datum document O Beschrijving document O Ingangsdatum geldigheid O Voorbeeld AC0101, Piet de Boer wordt Piet Boer Piet Boer akte van naamswijziging Duitsland Piet de Boer Voorbeeld AC0101, namenreeks Hasham Badshah Mulla wordt voornaam Hasham en geslachtsnaam Badshah Mulla Hasham Badshah Mulla ga Ghana Hasham Badshah Mulla Pagina 13 van 53

14 2.4.2 Wijziging in de geboorte (AC0102) Een AC0102 is altijd een correctie (CO) en geen normale actualisering (NA) Geboortedatum V Geboorteplaats O Geboorteplaats en - land Geboorteland O niet verplicht Registergemeente Akte K Of groep 81 of groep 82 komt Aktenummer K verplicht voor met beide rubrieken Datum document K Beschrijving document K Ingangsdatum geldigheid V Geboortedatum V Geboortedatum als op PL Geboorteplaats O Geboorteplaats en - land Geboorteland O niet verplicht Registergemeente Akte O Aktenummer O Datum document O Beschrijving document O Ingangsdatum geldigheid O Voorbeeld AC0102, zonder plaats en land, 22 juni 1960 wordt 23 juni A Voorbeeld AC0102, met plaats en land, 22 juni 1960 wordt 23 juni A Voorbeeld AC0102, geboorteplaats 0599 (Rotterdam) wordt 0518 (Den Haag) A Pagina 14 van 53

15 2.4.3 Wijziging in het geslacht (AC0103) Geslachtsaanduiding V Registergemeente Akte K Of groep 81 of groep 82 komt Aktenummer K verplicht voor met beide rubrieken Datum document K Beschrijving document K Ingangsdatum geldigheid V Geslachtsaanduiding V Geslacht als op PL Registergemeente Akte O Aktenummer O Datum document O Beschrijving document O Ingangsdatum geldigheid O Voorbeeld AC0103, man wordt vrouw V Q M Verkrijging Nederlandse nationaliteit (AC0401) Nationaliteit V waarde Reden opname nationaliteit V waarde 000 indien onbekend Datum document O Of geen of beide rubrieken Beschrijving document O Ingangsdatum geldigheid V Voorbeeld AC0401, met onbekende Reden opname nationaliteit Verlies Nederlandse nationaliteit (AC0402) Reden beëindigen nationaliteit V waarde 000 indien onbekend Datum document O Of geen of beide rubrieken Beschrijving document O Ingangsdatum geldigheid V Nationaliteit V waarde Ingangsdatum geldigheid O Voorbeeld AC0402, verlies Nederlandse nationaliteit Verkrijging buitenlandse nationaliteit (AC0403) Nationaliteit V ongelijk Reden opname nationaliteit V waarde 301 indien onbekend Datum document O Of geen of beide rubrieken Beschrijving document O Ingangsdatum geldigheid V Pagina 15 van 53

16 Voorbeeld AC0403, zonder document Voorbeeld AC0403, met document kopie Paspoort Duitsland Verlies buitenlandse nationaliteit (AC0404) Reden beëindigen nationaliteit V waarde 401 indien onbekend Datum document O Of geen of beide rubrieken Beschrijving document O Ingangsdatum geldigheid V Nationaliteit V geen Ingangsdatum geldigheid O Voorbeeld AC0404, verlies Duitse nationaliteit Beëindiging staatsloosheid (AC0405) Reden beëindigen nationaliteit V waarde 412 indien onbekend Datum document O Of geen of beide rubrieken Beschrijving document O Ingangsdatum geldigheid V Nationaliteit V moet 0499 (Staatloos) bevatten Ingangsdatum geldigheid O Voorbeeld AC0405, beëindiging staatsloosheid Wijziging in reden opname (AC0406) Een AC0406 is meestal een correctie (CO) en geen normale actualisering (NA) Reden opname nationaliteit V Datum document O Of geen of beide rubrieken Beschrijving document O Ingangsdatum geldigheid V Nationaliteit V Opnemen nationaliteit V Reden als op de PL Ingangsdatum geldigheid O Geen voorbeelden, want AC0406 wordt door geen van de thans bekende ABO s gebruikt. Pagina 16 van 53

17 Wijziging in reden beëindiging (AC0407) Een AC0406 is meestal een correctie (CO) en geen normale actualisering (NA) Reden beëindigen nationaliteit V Datum document O Of geen of beide rubrieken Beschrijving document O Ingangsdatum geldigheid V Nationaliteit V Beëindigen nationaliteit V Reden als op de PL Ingangsdatum geldigheid O Geen voorbeelden, want AC0407 wordt door geen van de thans bekende ABO s gebruikt Verwijderen van nationaliteitsgegevens (AC0408) Nationaliteit V Als op de PL Geen voorbeelden, want AC0408 wordt door geen van de thans bekende ABO s gebruikt Correctie van ten onrechte opgenomen gegevens (AC0409) Een AC0409 is altijd een correctie (CO) en geen normale actualisering (NA) Beëindigen nationaliteit V moet 405 bevatten Datum document O Of geen of beide rubrieken Beschrijving document O Ingangsdatum geldigheid V Nationaliteit V Als op de PL Ingangsdatum geldigheid O Geen voorbeelden, want AC0409 wordt door geen van de thans bekende ABO s gebruikt Actualiseren document (AC0410) Datum document V Beschrijving document V Nationaliteit V Als op de PL Datum document V Beide rubrieken als op de PL Beschrijving document V Voorbeeld AC0410, plaatsen PROBAS-aantekening PROBAS kopie paspoort kopie paspoort Actualiseren van de ingangsdatum geldigheid (AC0411) Een AC0411 is meestal een correctie (CO) en geen normale actualisering (NA) Datum document O Of geen of beide rubrieken Beschrijving document O Ingangsdatum geldigheid V Pagina 17 van 53

18 Nationaliteit V Als op de PL Ingangsdatum geldigheid V Als op de PL Voorbeeld AC0411, aanpassing onbekende ingangsdatum geldigheid bij Duitse nationaliteit Opnemen overlijdensgegevens (AC0601) Datum overlijden V Plaats overlijden O Plaats en land overlijden Land overlijden O niet verplicht, weglaten indien onbekend Registergemeente Akte K Of groep 81 of groep 82 komt Aktenummer K verplicht voor met beide rubrieken Datum document K Beschrijving document K Voorbeeld AC0601, zonder plaats en land CA7654 Voorbeeld AC0601, met plaats en land CA Corrigeren overlijdensgegevens (AC0602) Een AC0602 is altijd een correctie (CO) en geen normale actualisering (NA) Datum overlijden V Plaats overlijden O Plaats en land overlijden Land overlijden O niet verplicht, weglaten indien onbekend Registergemeente Akte K Of groep 81 of groep 82 komt Aktenummer K verplicht voor met beide rubrieken Datum document K Beschrijving document K Datum overlijden V Als op PL Plaats overlijden O Plaats en land overlijden Land overlijden O niet verplicht Registergemeente Akte O Aktenummer O Datum document O Beschrijving document O Voorbeeld AC0602, datum overlijden corrigeren Ovl akte Duitsland Pagina 18 van 53

19 Voorbeeld AC0602, land overlijden corrigeren (België wordt Duitsland) Ovl akte Duitsland Correctie van ten onrechte opgenomen gegevens (AC0603) Een AC0603 is altijd een correctie (CO) en geen normale actualisering (NA) Registergemeente Akte K Of groep 81 of groep 82 komt Aktenummer K verplicht voor met beide rubrieken Datum document K Beschrijving document K Registergemeente Akte O Aktenummer O Datum document O Beschrijving document O Voorbeeld AC0603 Deze persoon is niet overleden, maar verwisseld met iemand met dezelfde identificerende kenmerken (naam, geboortedatum, geslachtsaanduiding) Ovl akte Duitsland Actualiseren akte en document (AC0604) Registergemeente Akte K Of groep 81 of groep 82 komt Aktenummer K verplicht voor met beide rubrieken Datum document K Beschrijving document K Registergemeente Akte K Of groep 81 of groep 82 komt Aktenummer K verplicht voor met beide rubrieken Datum document K Invulling als op PL Beschrijving document K Geen voorbeelden, want AC0604 wordt door geen van de thans bekende ABO s gebruikt Wijziging buitenlands adres (AC0801) Land adres buitenland V Optionele adresregels worden Datum aanvang adres buitenland V ingevuld indien bekend. Als Regel 1 adres buitenland PN is ingevuld moet zijn Regel 2 adres buitenland PN ingevuld; als is ingevuld moet Regel 3 adres buitenland PN zijn ingevuld Omschrijving van de aangifte adreshouding V waarde Land adres buitenland V Gegevens moeten exact Datum aanvang adres buitenland V overeenkomen met de Regel 1 adres buitenland PH huidige actuele op de PL Regel 2 adres buitenland PH Regel 3 adres buitenland PH Omschrijving van de aangifte adreshouding O geen controle of historie Overeenkomt Pagina 19 van 53

20 Voorbeeld 1 Van Kortenberglaan Bruxelles België naar 7-9, Rue Eblé Paris Frankrijk , Rue Eblé Paris Kortenberglaan Bruxelles Voorbeeld 2 Van onbekend adres in Frankrijk naar 7-9, Rue Eblé Paris Frankrijk , Rue Eblé Paris Voorbeeld 3 Van Kortenberglaan Bruxelles België naar onbekende bestemming vertrokken Kortenberglaan Bruxelles Wijzigen onderzoeksgegevens (AC8301) 0n Aanduiding gegevens in onderzoek V n = 1, 4 1, 6 of 8 0n Datum ingang onderzoek V 0n Datum einde onderzoek O 5n Aanduiding gegevens in onderzoek O geen controle of historie 5n Datum ingang onderzoek O overeenkomt Voorbeeld AC8301, onderzoek opstarten (twijfels over de geslachtsnaam) Voorbeeld AC8301, uitbreiding onderzoek naar voornamen Als het een onderzoek in categorie 04 betreft waar meerdere stapels voorkomen, kan bij een nieuw onderzoek niet worden bepaald welke stapel het betreft. Pagina 20 van 53

21 Voorbeeld AC8301, gegevens bleken toch correct Verificatie (Dv03) Het Specifiek onderdeel Verificatie bevat de volgende elementen: Burgerservicenummer; Het Burgerservicenummer van de persoon op wie de verificatie betrekking heeft. Dit element is verplicht. Anummer; Het A-nummer van de persoon op wie de verificatie betrekking heeft. Dit element is optioneel. DatumVerificatie; Element <DatumVerificatie>. De datum waarop verificatie van PL-gegevens heeft plaatsgevonden. Dit element is verplicht. OmschrijvingVerificatie. Element <OmschrijvingVerificatie>. De omschrijving op welke wijze de verificatie heeft plaatsgevonden. Dit element is verplicht. Indien in het RNI-systeem een verificatiedatum staat opgeslagen moet de aangeleverde verificatiedatum recenter zijn dan de reeds opgeslagen datum. Zo niet, dan volgt een Df02 met foutcode 1035 of 1036 (zie bijlage C). 2.6 AanvullendeScan (Dv04) Het Specifiek onderdeel AanvullendeScan bevat de volgende elementen: Burgerservicenummer; Het Burgerservicenummer van de persoon op wie de scan betrekking heeft. Dit element is verplicht. Anummer; Het A-nummer van de persoon op wie de scan betrekking heeft. Dit element is optioneel. Bestand. Dit blok kan 1 of meerdere keren voorkomen. Binnen een blok komen de volgende elementen voor: o SoortScan; Een aanduiding van het soort bestand dat meegestuurd wordt. Voor de RNI-deelnemers is voorlopig slechts één waarde beschikbaar: Overig o Bestandsnaam; De naam waaronder het bestand bij de deelnemer opgeslagen is. o BinaireInhoud / Attachment; De eigenlijke inhoud van het bestand. Afhankelijk van de gekozen manier van insluiten, wordt het element BinaireInhoud of Attachment gebruikt. Vanuit het oogpunt van performance gaat de voorkeur uit naar het gebruik van Attachment (MTOM). Pagina 21 van 53

22 2.7 Synchroon: OntvangstBevestiging of TechnischeFout Na ontvangst van een deelnemersopgave (Dv01, Dv02, Dv03 of Dv04-bericht) stuurt de RNI onmiddellijk (synchroon) een OntvangstBevestiging òf Technische Fout terug. Asynchroon zal later met de OpgaveResultaat-service (Da01..Da04, Df01..Df04) het resultaat van de verwerking in de RNI worden verstuurd naar de ABO. Voor de ontvangst hiervan dient ook de ABO een webservice in te richten die 24h/7d beschikbaar is OntvangstBevestiging De OntvangstBevestiging bevat de volgende elementen: Versie; Het versienummer van de WSDL. Dit element is verplicht met waarde 1.3. RNIReferentie; Een uniek referentienummer van de OntvangstBevestiging uitgegeven door de RNI. Dit element is verplicht. DeelnemerReferentie; Dit element is verplicht en is een kopie van de DeelnemerReferentie zoals in de ontvangen Opgave (Dv01..Dv04) Technische Fout De TechnischeFout bevat de volgende elementen: Versie; Het versienummer van de WSDL. Dit element is verplicht met waarde 1.3. Code; Een foutcode volgens de tabel in Bijlage C. Bij een TechnischeFout kan deze ook de waarde -1 krijgen. Dit element is verplicht. Omschrijving; Een nadere aanduiding van de reden waarom de opgave niet verwerkt kan worden. Dit element is verplicht DatumTijd; De datum/tijd waarop de opgave van de deelnemer is ontvangen en beantwoord met een Technische Fout. Dit element is verplicht. Pagina 22 van 53

23 3 OpgaveResultaat Na ontvangst en bevestiging van een ontvangen Opgave, zal deze al dan niet automatisch worden afgehandeld binnen het RNI-systeem. De Opgave kan daarbij worden doorgevoerd (automatisch of handmatig) of afgewezen (automatisch of handmatig). In beide situatie ontvangt de ABO daarover een bericht: Da01..Da04: Bevestiging dat de opgave is doorgevoerd, een VerwerkBevestiging; Df01..Df04: Bericht dat de opgave is afgewezen met omschrijving van de reden, een FoutBericht. 3.1 VerwerkBevestiging (Da01..Da04) Alle VerwerkBevestigingen (Da01..Da04) bevatten de onderdelen Versie en Verwerking met de volgende verplichte elementen (allen verplicht): Versie; Het versienummer van de WSDL. Dit element bevat waarde 1.3. DatumTijdAangemaakt; De datum/tijd waarop het bericht door de RNI is aangemaakt. RNIReferentie; Een uniek referentienummer van de VerwerkBevestiging uitgegeven door de RNI. Deelnemer; De deelnemerscode volgens Tabel 60. DeelnemerReferentie; Dit element is verplicht en is een kopie van de DeelnemerReferentie zoals in de ontvangen Opgave (Dv01..Dv04). Deze referentie is eerder al gebruikt in de synchroon verstuurde OntvangstBevestiging. Verwerkingscode; Een Verwerkingscode volgens de tabel in Bijlage C. Verwerkingsomschrijving; Een Verwerkingsomschrijving volgens de tabel in Bijlage C. Een Da01 bevat verder nog de verplichte elementen: Burgerservicenummer; Het Burgerservicenummer van de persoon die is ingeschreven. Anummer; Het A-nummer van de persoon die is ingeschreven. 3.2 FoutBericht (Df01..Df04) Alle FoutBerichten (Df01..Df04) bevatten de onderdelen Versie, Berichtsoort en Verwerking met de volgende verplichte elementen (allen verplicht): Versie; Het versienummer van de WSDL. Dit element bevat waarde 1.3. Berichtsoort; De opgave die niet is verwerkt. Bij een Dv01 hoort een Df01, bij een Dv02 een Df02, bij een Dv03 een Df03 en bij een Dv04 een Df04. DatumTijdAangemaakt; De datum/tijd waarop het bericht door de RNI is aangemaakt. RNIReferentie; Een uniek referentienummer van het FoutBericht uitgegeven door de RNI. Deelnemer; De deelnemerscode volgens Tabel 60. DeelnemerReferentie; Dit element is verplicht en is een kopie van de DeelnemerReferentie zoals in de ontvangen Opgave (Dv01..Dv04). Deze referentie is eerder al gebruikt in de synchroon verstuurde OntvangstBevestiging. Verwerkingscode; Een Verwerkingscode volgens de tabel in Bijlage C. Verwerkingsomschrijving; Een Verwerkingsomschrijving volgens de tabel in Bijlage C. DetailsGeconstateerdeFouten; Een lijst met geconstateerde fouten. Deze omschrijving kan automatisch door het systeem zijn gegenereerd of handmatig zijn ingegeven door een gegevensbeheerder bij RvIG. Pagina 23 van 53

24 4 DeelnemersAanvraag Met de DeelnemerAanvraag kunnen drie soorten berichten worden verstuurd: Dv11, Overzicht ingediende opgaven; Dv12, Details ingediende opgaven; Dv13, Intrekken ingediende opgave. Alle bovenstaande berichten bestaan uit Stuurgegevens en een specifiek deel ZoekCriteria. Het specifieke deel wordt in de volgende paragrafen per berichtsoort beschreven. 4.1 Stuurgegevens Het onderdeel Stuurgegevens bevat de volgende elementen: Versie; Het versienummer van de WSDL. Dit element is verplicht met waarde 1.3. DatumTijdAangemaakt; De datum/tijd waarop het bericht door de deelnemer is aangemaakt. Dit element is verplicht. Deelnemer; De deelnemerscode volgens Tabel 60. Dit element is verplicht. OmschrijvingVerdrag; Een omschrijving van het verdrag op basis waarvan de gegevens zijn verkregen. Dit element is optioneel en wordt alleen gevuld als er daadwerkelijk sprake is van een verdrag. DeelnemerReferentie; Een uniek referentienummer naar het bericht; dit element is verplicht. De DeelnemerReferentie is 12 tekens lang en kan zowel cijfers als letters bevatten. Het nummer moet uniek aan 1 bericht zijn gekoppeld en mag na uitgave nooit meer worden gebruikt voor een ander bericht. In het antwoord vanuit de RNI wordt gerefereerd aan deze unieke DeelnemerReferentie en daarbij gebruikt RNI ook een eigen unieke referentie van 12 tekens: de RNIReferentie DeelnemerMelderId; Optionele code die de deelnemer in staat stelt te traceren welke afdeling of welke medewerker de opgave heeft gedaan. Het element wordt gevuld met een betekenisloze code die alleen door de deelnemer geïnterpreteerd kan worden. 4.2 Overzicht ingediende opgaven (Dv11) Het specifiek onderdeel ZoekCriteria bevat de volgende elementen: DeelnemerReferentie; Het referentienummer van de ingediende opgave (Dv01..Dv04) waarover men de status wil opvragen. Dit element is optioneel. Invulling van de DeelnemerReferentie kan 0 of hooguit 1 resultaat opleveren (de DeelnemerReferentie moet immers uniek zijn). Slechts indien ook de verplichte velden Aanvraag en Status (zie hieronder) correct zijn ingevuld zal de aanvraag tot 1 resultaat leiden. Indien Aanvraag en Status niet bekend zijn kan een Dv12 worden gebruikt waarbij de DeelnemerReferentie het enige zoekcriterium is. Burgerservicenummer; Dit element is optioneel. Het Burgerservicenummer van de persoon waarover een overzicht is gewenst van ingestuurde opgaven. DatumTijdVan; Dit element is optioneel. De datum/tijd van waaraf gezocht moet worden. DatumTijdTot; Dit element is optioneel. De datum/tijd tot wanneer gezocht moet worden AanvraagDv01; Keuze Ja/Nee. Dit element is verplicht. Overzicht van het aantal ingestuurde Dv01- berichten. AanvraagDv02; Keuze Ja/Nee. Dit element is verplicht. Overzicht van het aantal ingestuurde Dv02- berichten. AanvraagDv03; Keuze Ja/Nee. Dit element is verplicht. Overzicht van het aantal ingestuurde Dv03- berichten AanvraagDv04; Keuze Ja/Nee. Dit element is verplicht. Overzicht van het aantal ingestuurde Dv04- berichten. Status; Keuze IB (In Behandeling), IG (InGetrokken), FR (Fout Resultaat), VW (VerWerkt). Dit element is verplicht. Pagina 24 van 53

25 Merk op dat indien AanvraagDv01, AanvraagDv02, AanvraagDv03 en AanvraagDv04 allemaal op N (Nee) staan, het resultaat 0 resultaten oplevert en het deel InformatieIngediendeOpgave zal ontbreken in het antwoord. 4.3 Details ingediende opgaven (Dv12) Het specifiek onderdeel ZoekCriteria bevat de volgende elementen: DeelnemerReferentie; Het referentienummer van de ingediende opgave (Dv01..Dv04) waarover de status wordt opgevraagd. Dit element is verplicht. 4.4 Intrekken ingediende opgave (Dv13) Het specifiek onderdeel ZoekCriteria bevat de volgende elementen: DeelnemerReferentie; Het referentienummer van de ingediende opgave (Dv01..Dv04) die de ABO wenst in te trekken. Dit element is verplicht. Toelichting; Een toelichting. Dit veld heeft verder geen toepassing. Het veld mag leeg worden gelaten maar mag niet in zijn geheel worden weg gelaten. Dit is een uitzondering op de regel. 4.5 Synchroon: Antwoord of Technische Fout Na ontvangst van een deelnemersaanvraag (Dv11, Dv12 of Dv13-bericht) stuurt de RNI onmiddellijk (synchroon) een Antwoord (Da11, Da12 of Da13) òf TechnischeFout terug Antwoord De antwoorden bestaan uit een algemeen verplicht deel Verwerking en een specifiek optioneel deel InformatieIngediendeOpgave Algemeen deel Het algemene verplichte deel bevat de volgende elementen (allen verplicht): Versie; Het versienummer van de WSDL. Dit element is verplicht met waarde 1.3. RNIReferentie; Een uniek referentienummer van de OntvangstBevestiging uitgegeven door de RNI. DeelnemerReferentie; Dit is een kopie van de DeelnemerReferentie zoals in de ontvangen Aanvraag (Dv11..Dv13). Verwerkingscode; Een code volgens de tabel in Bijlage C. Verwerkingsomschrijving; Een omschrijving volgens de tabel in Bijlage. NB Indien geen enkele opgave wordt gevonden, volgt een antwoord zonder het optionele gedeelte met informatie omtrent de ingediende opgave(n). De Verwerkingscode is daarbij ongelijk aan 11, 12 of Deel met informatie ingediende opgave Het optionele deel komt 0..n keer voor; voor elke ingediende opgave die voldoet aan de ZoekCriteria worden de volgende gegevens verstuurd (allen verplicht): DeelnemerReferentie; De DeelnemerReferentie van de desbetreffende opgave. RNIReferentie; De RNIReferentie waarmee de ontvangst van de opgave is bevestigd. DatumTijdRegistratieOpgave; De datum/tijd waarop de opgave is ontvangen. Berichtsoort; De berichtsoort (Dv01..Dv04) van de opgave. Status; De status (IB=In Behandeling, IG=InGetrokken, FR=Fout Resultaat, VW=VerWerkt) van de opgave. DatumTijdVerwerkingsOpgave; De datum/tijd waarop de opgave is verwerkt. Verwerkingscode; Een code volgens de tabel in Bijlage C. Verwerkingsomschrijving; Een omschrijving volgens de tabel in Bijlage C. Pagina 25 van 53

26 4.5.3 Technische Fout De TechnischeFout bevat de volgende verplichte elementen elementen (allen verplicht) : Versie; Het versienummer van de WSDL. Dit element bevat waarde 1.3. Code; Een foutcode volgens de tabel in Bijlage C Bij een TechnischeFout kan deze ook de waarde -1 krijgen. Omschrijving; Een nadere aanduiding van de reden waarom de opgave niet verwerkt kan worden. DatumTijd; De datum/tijd waarop de aanvraag van de deelnemer is ontvangen en beantwoord met een Technische Fout. Pagina 26 van 53

27 5 Overgang naar nieuwe versie WSDL Om het mogelijk te maken de ABO-interface in de toekomst te wijzigen of uit te breiden, ondersteunt de RNI ten hoogste twee versies van de WSDL. Hiermee moet het mogelijk zijn om een overgang van de oude WSDL naar de nieuwe WSDL te realiseren zonder dat de ABO s gedwongen zijn om tegelijkertijd over te gaan op de volgende WSDL. De ABO-interface beschikt zowel over een synchroon deel waarbij het RNI-systeem de functie van server vervult als een asynchroon deel waarbij het RNI-systeem de cliënt is. De cliënt van het RNI-systeem moet beschikken over het end-point van de server en daartoe beschikt het systeem voor elke ABO over twee endpoints: een end-point van de ABO met de versie van de oude WSDL (dit is tevens het endpoint van alle versies ouder dan 1.3 waarbij geen versienummer is opgenomen in de berichten) ; een end-point van de ABO met de versie van de nieuwe WSDL. Elke bericht beschikt over een verplicht attribuut met daarin de versie van de WSDL. Voor de asynchrone beantwoording van een DeelnemersOpgave doormiddel van de OpgaveResultaat, zal het RNI-systeem naar de versie van de DeelnemersOpgave kijken. Vervolgens zal de OpgaveResultaat naar het end-point worden gestuurd met de corresponderende WSDL-versie. Aldus worden communicatiefouten tijdens de overgang van de ene WSDL naar de andere WSDL voorkomen. Over het algemeen zal een overgang naar naar een nieuwe versie van de WSDL worden ingepland. Het streven zal er op gericht zijn dat alle openstaande opgaven van de ABO zijn afgehandeld op het moment dat deze de overstap wil maken naar de nieuwe WSDL. Met bovenstaande systematiek moet worden uitgesloten dat berichten bij een verkeerde server (met een afwijkende versie van de WSDL) terecht komen. Het is aan de ABO zelf of deze tijdens de overstap naar de nieuwe WSDL de oude en nieuwe server tegelijkertijd operationeel houdt. Als uit de eigen administratie (zie hoofdstuk 1) blijkt dat alle opgaven die zijn aangeboden onder de oude WSDL, zijn verwerkt en doorgevoerd, is er geen noodzaak de oude server operationeel te houden. Pagina 27 van 53

28 6 Handreiking Vanuit Aangewezen en aan te wijzen Bestuursorganen worden regelmatig vragen gesteld over de invulling van Deelnemersberichten. In de vorige hoofdstukken is op berichten-niveau de XML-inhoud beschreven. Onderliggende handreiking biedt een helpende hand met een beschrijving op functioneel niveau. Dit hoofdstuk zelf en de beschreven gegevens kunnen en mogen niet als voorschrift worden beschouwd. Wat moet en mag staat in de Regeling BRP, waarin onder meer wordt verwezen naar (delen van) het Logisch Ontwerp GBA en Logisch Ontwerp RNI. Ook voor dit hoofdstuk vormen die beide documenten een inspiratiebron. Daarnaast is geput uit het Kwaliteitsstatuut en uit het Functioneel Ontwerp RNI. Voornamen Adellijke titel/predicaat Voorvoegsel Geslachtsnaam - De naam moet correct opgesplitst zijn in de vier elementen: voornamen, adellijke titel/predikaat, voorvoegsel en geslachtsnaam. - Voornamen moeten volledig zijn en voluit geschreven. Indien voornamen niet aanwezig zijn dan volstaan voorlopig voorletters, mits ze volledig zijn voor alle voornamen die de persoon heeft en gescheiden doormiddel van een spatie. - Voorvoegsels afgesplitst van de geslachtsnaam volgens BRP-tabel Alleen Nederlandse adellijke titels en predicaten, gecodeerd volgens BRP-tabel De geslachtsnaam moet volledig zijn, met onderscheid tussen hoofd- en kleine letters. Een namenreeks wordt als geslachtsnaam opgenomen; in dat geval worden de andere drie elementen niet gevuld. Een onbekende geslachtsnaam is niet toegestaan. - Indien de naam (voornaam, geslachtsnaam) ongebruikelijke tekens bevat, zal deze handmatig gefiatteerd moeten worden. Zie ook bijlage E en paragraaf 2.1. Geboortedatum Geboorteplaats Geboorteland - In de groep Geboorte moet minimaal het element geboortedatum aanwezig zijn, zo mogelijk aangevuld met geboorteland volgens BRP-tabel 34 en plaats (indien in NL) volgens BRP-tabel 33. Als geboorteplaats onbekend is wordt altijd 0000 ingevuld, ook als het geboorteland niet Nederland is. - Als fictieve geboortedatums gebruikt worden, dan moet een het onbekende deel van de geboortedatum met nullen worden gevuld, dus JJJJMM00 als dag onbekend, JJJJJ0000 als maand onbekend of als jaar onbekend 2. - Geboortedatum mag niet in de toekomst liggen. - Geboorteland moet o.b.v. tabel 34 geldig zijn op geboortedatum - Indien Geboorteplaats is gecodeerd volgens tabel 33, moet Geboorteplaats op geboortedatum geldig zijn. Geslachtsaanduiding - De waarden M, V en O zijn toegestaan. Nationaliteit - Opname van nationaliteiten geschiedt voor zover bekend bij inschrijving. Als een deelnemer over dit gegeven beschikt zal het worden aangeleverd, gecodeerd volgens BRP-tabel 32; de waarden 0002 (behandeld als Nederlander) en 0500 (vastgesteld niet-nederlander) mogen niet worden gebruikt. - Merk op dat als de persoon de Nederlandse nationaliteit heeft, geen andere nationaliteiten mogen worden aangeleverd. - De Nationaliteitscode moet geldig zijn op de ingangsdatum geldigheid en op de systeemdatum 3. 2 Een Geboortedatum als of is dus alleen toegestaan mits het een werkelijke geboortedatum is en niet een fictieve geboortedatum. 3 De ratio hierachter is dat bijvoorbeeld iemand die in 1990 in Joegoslavië is geboren, niet sinds 1990 (geboortedatum) de Servische nationaliteit kan hebben [die bestond toen nog niet], maar nu zeker de Joegoslavische nationaliteit niet meer heeft [die bestaat niet meer sinds 2003]. In zo n geval kan dus de Servische nationaliteit worden opgenomen met ingangsdatum standaardwaarde ( ). Pagina 28 van 53

29 Datum overlijden Plaats overlijden Land overlijden - Het is verplicht eventuele gegevens hiervan bij te houden. Minimaal met het element overlijdensdatum, zo mogelijk aangevuld met land (volgens BRP-tabel 34) en plaats (indien in NL volgens BRP-tabel 33). Indien plaats onbekend is, wordt 0000 opgenomen. - Bij een mutatie in de gegevensgroep Overlijden zal de deelnemer een (scan van een) brondocument meeleveren. - Overlijdensdatum mag niet in de toekomst liggen Land adres buitenland Datum aanvang adres buitenland Regel 1 adres buitenland Regel 2 adres buitenland Regel 3 adres buitenland - Het streven is erop gericht volledige adressen te hebben, bij uitzondering zal een adres onvolledig zijn. Minimaal moet in de groep adres de elementen land datum aangeleverd worden - Land gecodeerd volgens BRP-tabel 34. De waarde Onbekend ('0000') is toegestaan. - Alle adressen zijn in principe buitenlandse adressen (dat wil zeggen gecodeerd zijn in het formaat van een buitenlands adres). - Als de Regels worden ingevuld dan moet bij een Regel ingevuld gekozen worden voor Regel 2 en twee regels ingevuld voor Regel 1 en Regel 2. (Afgekeurd worden dus: Regel 3 zonder Regel 1 en/of 2; Regel 1 zonder Regel 2) - Het adres zal door BRP-afnemers worden gebruikt om niet-ingezetenen aan te schrijven, daarom is het van belang dat onder elkaar Regel 1, Regel 2, Regel 3, Land adres buitenland tot een tekst leidt die ter plaatse tot correcte bezorging leidt. Aanduidingen die niets met de adressering te maken hebben of herhaling van het land in een van de Regels leidt tot verwarring en moet dus worden vermeden. - Datum aanvang adres buitenland mag niet in de toekomst liggen. - Land adres buitenland wordt gecodeerd volgens BRP-tabel 34 en moet geldig zijn op datum aanvang adres buitenland. Bij een actualisering moet Land adres buitenland tevens geldig zijn op systeemdatum. - Bij een actualisering van het adres moet Datum aanvang adres buitenland recenter zijn dan die van het actuele adres. Reden opname nationaliteit - Is verplicht bij een Dv02-bericht AC0401 en AC0403. De op te nemen waarde is de reden verkrijging Nederlandse nationaliteit of standaardwaarde 000 bij een AC0401 (Nederlandse nationaliteit) en 301 of standaardwaarde 000 bij een AC0403 (vreemde nationaliteit). - Ook bij een Dv01 zou eigenlijk de Reden opname moeten worden meegestuurd. Tot nader order vult het RNI-systeem deze aan bij ontbreken in het Dv01-bericht. NB: Dit is een tijdelijke maatregel. Reden beëindiging nationaliteit - Is verplicht bij een Dv02-bericht AC0402 en AC0404. De op te nemen waarde is de reden verlies Nederlandse nationaliteit of standaardwaarde 000 bij een AC0402 (Nederlandse nationaliteit) en 401 of standaardwaarde 000 bij een AC0404 (vreemde nationaliteit). Omschrijving van de aangifte adreshouding - Is verplicht bij een Dv01 en in de actuele gegevens van de Dv02. Aangezien de meeste ABO s dit gegeven niet registreren, zal de op te nemen waarde meestal standaardwaarde. zijn. - Merk op dat het onverstandig is om in de historische gegevens in de Dv02 dit gegeven mee te sturen, want als niet de waarde wordt opgestuurd die op de PL staat, moet het bericht handmatig worden afgehandeld. Registergemeente akte Aktenummer - Dit gegeven kan en mag uitsluitend worden ingevuld als het een rechtsfeit betreft dat in Nederland heeft plaatsgevonden en de ABO over deze akte beschikt. In praktijk zal dus (bijna) altijd voor de groep Document worden gekozen. Pagina 29 van 53

30 Datum document Beschrijving document - De datum document betreft niet de datum waarop het document is opgesteld, maar de datum waarop de ABO de gegevens aan het document heeft ontleend. In het algemeen zal dit dus de systeemdatum zijn of een datum kort ervoor. - Beschrijving document geeft aan welk document/signaal de trigger is geweest om deze gegevens in de registratie van de ABO te verwerken. NB: Het meesturen van een scan van het document kan NIET dienen als vervanging voor dit gegeven, aangezien de scan geen onderdeel uitmaakt van de persoonslijst en de groep Document wel. - Datum document mag niet in de toekomst liggen - Datum document mag niet liggen voor de datum ingang geldigheid - In de HUP, bijlage 5 staan aanbevelingen over te hanteren afkortingen voor Beschrijving document Aanduiding gegevens in onderzoek Datum ingang onderzoek Datum einde onderzoek - Bij het in onderzoek plaatsen van gegevens (bij gerede twijfel over een gegeven, zonder dat bekend is wat de juiste waarde is. Dit kan bijvoorbeeld het geval zijn als bij een huisbezoek is gebleken dat iemand niet meer op het geregistreerde adres woont, maar niet bekend is waar dan wel) moeten de Aanduiding en de Datum ingang worden opgenomen - Datum ingang zal in het algemeen de systeemdatum zijn of kort ervoor. - Bij de Aanduiding gegevens in onderzoek moet worden aangegeven welk gegeven of welke gegevens in onderzoek staan. Dit kan een gegeven zijn, bijvoorbeeld Voornaam (Aanduiding is ), dat kunnen meerdere gegevens in een groep zijn, bijvoorbeeld Voornaam en Adellijke titel/predicaat (Aanduiding is ) of gegevens in meerdere groepen, bijvoorbeeld voornaam en geboorteplaats (Aanduiding is ). - Datum ingang en datum einde onderzoek mogen niet in de toekomst liggen Ingangsdatum geldigheid - Dit gegeven geeft aan wanneer de gegevens in de betreffende categorie geldig zijn geworden. Dit heeft dus niets te maken met de datum waarop de gegevens bij de ABO zijn geregistreerd. Aangezien deze datum vaak niet kan worden vastgesteld (uit een paspoort blijkt niet of iemand de naam in het paspoort al sinds geboortedatum heeft; voor de taak van de ABO is het wellicht niet nodig te weten sinds wanneer iemand op het huidige adres woont). Om die reden zal bij een Dv01 veelal moeten worden gekozen voor standaardwaarde. Een foutieve ingangsdatum geldigheid kan bij wijzigingen en/of correcties op een later moment tot verwarring leiden. - Ingangsdatum geldigheid mag niet in de toekomst liggen. Pagina 30 van 53

31 Bijlage A: T.61 en UTF-8 coderingen Op de volgende pagina s is bijlage II uit het LO GBA versie 3.10 integraal opgenomen. Pagina 31 van 53

32 II Teletex II.1 Inleiding De Teletex standaard is gebaseerd op CCITT-aanbeveling Rec. T.61 [11]. Voor een volledige beschrijving van de Teletex standaard wordt verwezen naar dat document. Deze bijlage bevat een uittreksel daaruit. Om de binnen Teletex gedefinieerde karakters in een geautomatiseerd systeem te kunnen weergeven maakt Teletex gebruik van de hexadecimale, 8 bits codering. Paragraaf 0 bevat een volledig overzicht van alle karakters die binnen Teletex voorkomen. Met behulp van de regel- en kolomaanduidingen op de rand van de tabel kan de hexadecimale Teletex-codering worden vastgesteld. Dit werkt als volgt: zoek het te coderen karakter op in de tabel. Neem de hexadecimale codering zoals die boven dit karakter staat, gevolgd door de hexadecimale codering zoals die links van het karakter staat. De zo verkregen hexadecimale codering is de unieke Teletex-codering. Voorbeeld: de hoofdletter E wordt gecodeerd als 45. In paragraaf 0 wordt een overzicht gegeven van die tekens uit de Teletex-tekenset die binnen het GBA-systeem gebruikt mogen worden. Niet opgenomen tekens mogen niet gebruikt worden. Dat betreft onder andere de Hollandse IJ (codes E6 en F6). Voor de diakritische karakters (codes C0 t/m CF) geldt dat die slechts mogen voorkomen in combinatie met een ander karakter. Tekens waarbij een diakriet voorkomt, worden als volgt gecodeerd: allereerst wordt de diakriet gecodeerd en direct daarachter het karakter dat de diakriet bevat. In paragraaf 0 staat een overzicht van alle combinaties van letters en diakrieten die binnen het GBA-systeem gebruikt mogen worden. Niet opgenomen combinaties mogen niet gebruikt worden. In paragraaf 0 wordt een overzicht gegeven van de in de Teletex-tekenset gedefinieerde besturingskarakters die binnen het GBA-systeem gebruikt mogen worden. Omdat binnen de BRP steeds meer uitwisseling via webservices plaatsvindt en binnen webservices de afspraak is om te coderen op basis van de UTF-8-standaard, is in de tabllen in paragraaf II.3 en II.4 tevens een kolom toegevoegd met de UTF-8-codering voor de Teletex-tekens die binnen de BRP mogen worden gebruikt. Merk op dat andere UTF-coderingen dan die in bijlage II.3 en II.4 zijn opgenomen, niet mogen worden gebruikt. Pagina 32 van 53

33 II.2 Overzicht van alle Teletex karakters A B C D E F 0 SP P p Ω ĸ 1! 1 A Q a q ± ` Æ æ 2 " 2 B R b r 2 Đ đ 3 3 C S c s 3 ˆ ª ð 4 4 D T d t $ Ħ ħ 5 % 5 E U e u µ ı 6 & 6 F V f v # IJ ij 7 ' 7 G W g w Ŀ ŀ 8 ( 8 H X h x Ł ł 9 ) 9 I Y i y Ø ø A * : J Z j z Œ œ B + ; K [ k º ß C, < L l ¼ Þ þ D - = M ] m ½ Ŧ ŧ E. > N n ¾ Ŋ ŋ F /? O _ o ˇ ʼn Pagina 33 van 53

34 II.3 Overzicht van de te gebruiken Teletex karakters In deze paragraaf zijn alle karakters uit de Teletex-tekenset opgesomd die als teken binnen het GBAsysteem gebruikt mogen worden. T.61 code UTF-8 code Char Omschrijving T.61 code UTF-8 code Char Omschrijving SP Space Digit ! Exclamation mark 3A 3A : Colon " Quotation mark 3B 3B ; Semicolon % Procent sign 3C 3C < Less-than sign & Ampersand 3D 3D = Equals sign ' Apostrophe 3E 3E > Greater-than sign ( Left parenthesis 3F 3F? Question mark ) Right parenthesis 40 Commercial at 2A 2A * Asterisk A Capital A 2B 2B + Plus sign B Capital B 2C 2C, Comma C Capital C 2D 2D - Hyphen or minus sign D Capital D 2E 2E. Full stop, period E Capital E 2F 2F / Solidus F Capital F Digit G Capital G Digit H Capital H Digit I Capital I Digit 3 4A 4A J Capital J Digit 4 4B 4B K Capital K Digit 5 4C 4C L Capital L Digit 6 4D 4D M Capital M Digit 7 4E 4E N Capital N Digit 8 4F 4F O Capital O Pagina 34 van 53

35 T.61 code UTF-8 code Char Omschrijving T.61 code UTF-8 code Char Omschrijving P Capital P h Small h Q Capital Q i Small i R Capital R 6A 6A j Small j S Capital S 6B 6B k Small k T Capital T 6C 6C l Small l U Capital U 6D 6D m Small m V Capital V 6E 6E n Small n W Capital W 6F 6F o Small o X Capital X p Small p Y Capital Y q Small q 5A 5A Z Capital Z r Small r 5B 5B [ Left square bracket s Small s 5D 5D ] Right square bracket t Small t 5F 5F _ Low line u Small u a Small a v Small v b Small b w Small w c Small c x Small x d Small d y Small y e Small e 7A 7A z Small z f Small f 7C 7C Vertical Bar g Small g Pagina 35 van 53

36 T.61 code UTF-8 code Char Omschrijving T.61 code A1 C2 A1 Inverted exclamation mark UTF-8 code Char Omschrijving E3 C2 AA ª Ordinal indicator, feminine A2 C2 A2 Cent sign E4 C4 A6 Ħ Capital H with stroke A3 C2 A3 Pound sign E7 C4 BF Ŀ Capital L with middle dot A4 24 $ Dollar sign4 E8 C5 81 Ł Capital L with stroke A5 C2 A5 Yen sign E9 C3 98 Ø Capital O with slash A6 23 # Number sign5 EA C5 92 Œ Capital OE ligature A7 C2 A7 Section sign EB C2 BA º Ordinal indicator, masculine A8 C2 A4 Currency symbol EC C3 9E Þ Capital thorn, Icelandic AB C2 AB «Angle quotation mark left ED C5 A6 Ŧ Capital T with stroke B0 C2 B0 Degree sign EE C5 8A Ŋ Capital eng, Lapp B1 C2 B1 ± Plus/minus sign EF C5 89 ʼn Small n with apostrophe B2 C2 B2 ² Superscript 2 F0 C4 B8 ĸ Small k, Greenlandic B3 C2 B3 ³ Superscript 3 F1 C3 A6 æ Small ae, diphtong B4 C3 97 Multiply sign F2 C4 91 đ Small d with stroke B5 C2 B5 µ Micro sign F3 C3 B0 ð Small eth, Icelandic B6 C2 B6 Paragraph sign F4 C4 A7 ħ Small h with stroke B7 C2 B7 Middle dot F5 C4 B1 ı Small i without dot B8 C3 B7 Divide sign F7 C5 80 ŀ Small l with middle dot BB C2 BB» Angle quotation mark right F8 C5 82 ł Small l with stroke BC C2 BC ¼ Fraction one quarter F9 C3 B8 ø Small o with slash BD C2 BD ½ Fraction one half FA C5 93 œ Small oe ligature BE C2 BE ¾ Fraction three quarters FB C3 9F ß Small sharp s, German BF C2 BF Inverted question mark FC C3 BE þ Small thorn, Icelandic E0 E2 84 A6 Ω Ohm sign FD C5 A7 ŧ Small t with stroke E1 C3 86 Æ Capital AE diphtong FE C5 8B ŋ Small eng, Lapp E2 C4 90 Đ Capital D with stroke 4 Merk op dat het Dollar sign in T.61 Teletex een andere codering heeft dan in de meeste tekensets 5 Merk op dat het Number sign in T.61 Teletex een andere codering heeft dan in de meeste tekensets Pagina 36 van 53

37 II.4 Overzicht van de te gebruiken gecombineerde Teletex karakters In deze paragraaf zijn alle gecombineerde karakters uit de Teletex-tekenset opgesomd die als teken binnen het GBA-systeem gebruikt mogen worden. T.61 code UTF-8 code Char T.61 code UTF-8 code Char Naam C1 41 C3 80 À C1 61 C3 A0 à A grave C2 41 C3 81 Á C2 61 C3 A1 á A acute C3 41 C3 82 Â C3 61 C3 A2 â A circumflex C4 41 C3 83 Ã C4 61 C3 A3 ã A tilde C5 41 C4 80 Ā C5 61 C4 81 ā A macron C6 41 C4 82 Ă C6 61 C4 83 ă A breve C8 41 C3 84 Ä C8 61 C3 A4 ä A diaeresis CA 41 C3 85 Å CA 61 C3 A5 å A ring CE 41 C4 84 Ą CE 61 C4 85 ą A ogonek C2 43 C4 86 Ć C2 63 C4 87 ć C acute C3 43 C4 88 Ĉ C3 63 C4 89 ĉ C circumflex C7 43 C4 8A Ċ C7 63 C4 8B ċ C dot CB 43 C3 87 Ç CB 63 C3 A7 ç C cedilla CF 43 C4 8C Č CF 63 C4 8D č C caron CF 44 C4 8E Ď CF 64 C4 8F ď D caron Pagina 37 van 53

38 T.61 code UTF-8 code Char T.61 code UTF-8 code Char Naam C1 45 C3 88 È C1 65 C3 A8 è E grave C2 45 C3 89 É C2 65 C3 A9 é E acute C3 45 C3 8A Ê C3 65 C3 AA ê E circumflex C5 45 C4 92 Ē C5 65 C4 93 ē E macron C7 45 C4 96 Ė C7 65 C4 97 ė E dot C8 45 C3 8B Ë C8 65 C3 AB ë E diaeresis CE 45 C4 98 Ę CE 65 C4 99 ę E ogonek CF 45 C4 9A Ě CF 65 C4 9B ě E caron C2 67 C4 A3 ģ G cedilla (vroeger G acute) C3 47 C4 9C Ĝ C3 67 C4 9D ĝ G circumflex C6 47 C4 9E Ğ C6 67 C4 9F ğ G breve C7 47 C4 A0 Ġ C7 67 C4 A1 ġ G dot CB 47 C4 A2 Ģ G cedilla C3 48 C4 A4 Ĥ C3 68 C4 A5 ĥ H circumflex C1 49 C3 8C Ì C1 69 C3 AC ì I grave C2 49 C3 8D Í C2 69 C3 AD í I acute C3 49 C3 8E Î C3 69 C3 AE î I circumflex C4 49 C4 A8 Ĩ C4 69 C4 A9 ĩ I tilde C5 49 C4 AA Ī C5 69 C4 AB ī I macron C7 49 C4 B0 İ I dot C8 49 C3 8F Ï C8 69 C3 AF ï I diaeresis CE 49 C4 AE Į CE 69 C4 AF į I ogonek C3 4A C4 B4 Ĵ C3 6A C4 B5 ĵ J circumflex Pagina 38 van 53

39 T.61 code UTF-8 code Char T.61 code UTF-8 code Char Naam CB 4B C4 B6 Ķ CB 6B C4 B7 ķ K cedilla C2 4C C4 B9 Ĺ C2 6C C4 BA ĺ L acute CB 4C C4 BB Ļ CB 6C C4 BC ļ L cedilla CF 4C C4 BD Ľ CF 6C C4 BE ľ L caron C2 4E C5 83 Ń C2 6E C5 84 ń N acute C4 4E C3 91 Ñ C4 6E C3 B1 ñ N tilde CB 4E C5 85 Ņ CB 6E C5 86 ņ N cedilla CF 4E C5 87 Ň CF 6E C5 88 ň N caron C1 4F C3 92 Ò C1 6F C3 B2 ò O grave C2 4F C3 93 Ó C2 6F C3 B3 ó O acute C3 4F C3 94 Ô C3 6F C3 B4 ô O circumflex C4 4F C3 95 Õ C4 6F C3 B5 õ O tilde C5 4F C5 8C Ō C5 6F C5 8D ō O macron C8 4F C3 96 Ö C8 6F C3 B6 ö O diaeresis CD 4F C5 90 Ő CD 6F C5 91 ő O double acute C2 52 C5 94 Ŕ C2 72 C5 95 ŕ R acute CB 52 C5 96 Ŗ CB 72 C5 97 ŗ R cedilla CF 52 C5 98 Ř CF 72 C5 99 ř R caron C2 53 C5 9A Ś C2 73 C5 9B ś S acute C3 53 C5 9C Ŝ C3 73 C5 9D ŝ S circumflex CB 53 C5 9E Ş CB 73 C5 9F ş S cedilla CF 53 C5 A0 Š CF 73 C5 A1 š S caron Pagina 39 van 53

40 T.61 code UTF-8 code Char T.61 code UTF-8 code Char Naam CB 54 C5 A2 Ţ CB 74 C5 A3 ţ T cedilla CF 54 C5 A4 Ť CF 74 C5 A5 ť T caron C1 55 C3 99 Ù C1 75 C3 B9 ù U grave C2 55 C3 9A Ú C2 75 C3 BA ú U acute C3 55 C3 9B Û C3 75 C3 BB û U circumflex C4 55 C5 A8 Ũ C4 75 C5 A9 ũ U tilde C5 55 C5 AA Ū C5 75 C5 AB ū U macron C6 55 C5 AC Ŭ C6 75 C5 AD ŭ U breve C8 55 C3 9C Ü C8 75 C3 BC ü U diaeresis CA 55 C5 AE Ů CA 75 C5 AF ů U ring CD 55 C5 B0 Ű CD 75 C5 B1 ű U double acute CE 55 C5 B2 Ų CE 75 C5 B3 ų U ogonek C3 57 C5 B4 Ŵ C3 77 C5 B5 ŵ W circumflex C2 59 C3 9D Ý C2 79 C3 BD ý Y acute C3 59 C5 B6 Ŷ C3 79 C5 B7 ŷ Y circumflex C8 59 C5 B8 Ÿ C8 79 C3 BF ÿ Y diaeresis C2 5A C5 B9 Ź C2 7A C5 BA ź Z acute C7 5A C5 BB Ż C7 7A C5 BC ż Z dot CF 5A C5 BD Ž CF 7A C5 BE ž Z caron Pagina 40 van 53

41 II.5 Overzicht van de te gebruiken Teletex-besturingskarakters In deze paragraaf zijn alle besturingstekens uit de Teletex-tekenset genoemd die als besturingsteken binnen het GBA-systeem gebruikt mogen worden. De codering in UTF-8 is gelijk aan die in Teletex A B C D E F A LF B C FF D CR E F Pagina 41 van 53

42 Bijlage B: XML-namen Tabel 4: Rubrieknummers Rubrieknamen XML-namen Rubriek Rubrieknaam XML-naam A-nummer ANummer Burgerservicenummer Burgerservicenummer Voornamen Voornamen Adellijke Titel/Predikaat AdellijkeTitelPredikaat Voorvoegsel geslachtsnaam VoorvoegselGeslachtnaam Geslachtsnaam Geslachtnaam Geboortedatum Geboortedatum Geboorteplaats Geboorteplaats Geboorteland Geboorteland Geslachtsaanduiding Geslachtsaanduiding Registergemeente akte RegistergemeenteAkte Aktenummer Aktenummer Datum document DatumDocument Beschrijving document BeschrijvingDocument Aanduiding gegevens in onderzoek AanduidingGegevensInOnderzoek Datum ingang onderzoek DatumIngangOnderzoek Datum einde onderzoek DatumEindeOnderzoek Ingangsdatum geldigheid IngangsdatumGeldigheid Nationaliteit Nationaliteit Reden opname nationaliteit RedenOpnameNationaliteit Reden beëindigen nationaliteit RedenBeeindigenNationaliteit Datum document DatumDocument Beschrijving document BeschrijvingDocument Aanduiding gegevens in onderzoek AanduidingGegevensInOnderzoek Datum ingang onderzoek DatumIngangOnderzoek Datum einde onderzoek DatumEindeOnderzoek Ingangsdatum geldigheid IngangsdatumGeldigheid Datum overlijden DatumOverlijden Plaats overlijden PlaatsOverlijden Land overlijden LandOverlijden Registergemeente akte RegistergemeenteAkte Aktenummer Aktenummer Datum document DatumDocument Beschrijving document BeschrijvingDocument Aanduiding gegevens in onderzoek AanduidingGegevensInOnderzoek Datum ingang onderzoek DatumIngangOnderzoek Datum einde onderzoek DatumEindeOnderzoek Datum verificatie DatumVerificatie Omschrijving verificatie OmschrijvingVerificatie Land adres buitenland LandAdresBuitenland Datum aanvang adres buitenland DatumAanvangAdresBuitenland Regel 1 adres buitenland AdresRegelBuitenland Regel 2 adres buitenland AdresRegelBuitenland Regel 3 adres buitenland AdresRegelBuitenland Omschrijving van de aangifte adreshouding OmschrijvingAangifteAdreshouding Aanduiding gegevens in onderzoek AanduidingGegevensInOnderzoek Pagina 42 van 53

43 Bijlage C: Overzicht verwerkingscodes Pagina 43 van 53

44 Pagina 44 van 53

45 Pagina 45 van 53

46 Bijlage D: Voorbeelden XML-berichten In deze bijlage staan een aantal voorbeelden in XML-formaat. De persoonsgegevens in het Dv01- en Dv02-bericht zijn vet gemaakt. Dv01 (paragraaf 2.3) Inschrijvings bericht met veel gegevens. <soapenv:envelope xmlns:soapenv=" xmlns:deel=" xmlns:rni=" xmlns:xm=" <soapenv:header/> <soapenv:body> <deel:dv01> <deel:versie>1.3</deel:versie> <deel:stuurgegevens> <rni:datumtijdaangemaakt> t00:00: :00 </rni:datumtijdaangemaakt> <rni:deelnemer>0101</rni:deelnemer> <rni:deelnemerreferentie> </rni:deelnemerreferentie> <rni:deelnemermelderid>1234</rni:deelnemermelderid> </deel:stuurgegevens> <deel:inschrijving> <deel:persoon> <rni:voornamen>piet</rni:voornamen> <rni:adellijketitelpredikaat>g</rni:adellijketitelpredikaat> <rni:voorvoegselgeslachtnaam>de</rni:voorvoegselgeslachtnaam> <rni:geslachtnaam>boer</rni:geslachtnaam> <rni:geboortedatum> </rni:geboortedatum> <rni:geboorteplaats>aachen</rni:geboorteplaats> <rni:geboorteland>9089</rni:geboorteland> <rni:geslachtsaanduiding>m</rni:geslachtsaanduiding> <rni:datumdocument> </rni:datumdocument> <rni:beschrijvingdocument>kopie paspoort</rni:beschrijvingdocument> <rni:ingangsdatumgeldigheid> </rni:ingangsdatumgeldigheid> </deel:persoon> <deel:nationaliteit> <rni:nationaliteit>0001</rni:nationaliteit> <rni:redenopnamenationaliteit>017</rni:redenopnamenationaliteit> <rni:ingangsdatumgeldigheid> </rni:ingangsdatumgeldigheid> </deel:nationaliteit> <deel:verblijfplaats> <rni:landadresbuitenland>5010</rni:landadresbuitenland> <rni:datumaanvangadresbuitenland> </rni:datumaanvangadresbuitenland> <rni:adresregelbuitenland1>kortenberglaan 4-10</rni:AdresRegelBuitenland1> <rni:adresregelbuitenland2>1040 Bruxelles</rni:AdresRegelBuitenland2> <rni:omschrijvingaangifteadreshouding>i</rni:omschrijvingaangifteadreshouding> </deel:verblijfplaats> </deel:inschrijving> </deel:dv01> </soapenv:body> </soapenv:envelope> Pagina 46 van 53

47 Dv02 (paragraaf 2.4) Mutatiebericht, in dit geval een AC0101. <soapenv:envelope xmlns:soapenv=" xmlns:deel=" xmlns:rni=" xmlns:xm=" <soapenv:header/> <soapenv:body> <deel:dv02> <deel:versie>1.3</deel:versie> <deel:stuurgegevens> <rni:datumtijdaangemaakt> t00:00: :00 </rni:datumtijdaangemaakt> <rni:deelnemer>0101</rni:deelnemer> <rni:deelnemerreferentie> </rni:deelnemerreferentie> </deel:stuurgegevens> <deel:actualisering> <deel:burgerservicenummer> </deel:burgerservicenummer> <deel:soortactualisering>ac0101</deel:soortactualisering> <deel:indicatieafhandeling>na</deel:indicatieafhandeling> <deel:persoonactualisering> <deel:actueel> <rni:voornamen>piet</rni:voornamen> <rni:geslachtnaam>boer</rni:geslachtnaam> <rni:datumdocument> </rni:datumdocument> <rni:beschrijvingdocument>akte van naamswijziging Duitsland </rni:beschrijvingdocument> <rni:ingangsdatumgeldigheid> </rni:ingangsdatumgeldigheid> </deel:actueel> <deel:historie> <rni:voornamen>piet</rni:voornamen> <rni:voorvoegselgeslachtnaam>de</rni:voorvoegselgeslachtnaam> <rni:geslachtnaam>boer</rni:geslachtnaam> </deel:historie> </deel:persoonactualisering> </deel:actualisering> </deel:dv02> </soapenv:body> </soapenv:envelope> TechnischeFout (paragraaf en 4.5.2) De XML van dit bericht ontbreekt in deze bijlage. Ontvangstbevestiging op opgave (paragraaf 2.7.2) Ontvangstbevestiging van bovenstaande Dv02. <soapenv:envelope xmlns:soapenv=" xmlns:deel=" <soapenv:header/> <soapenv:body> <deel:ontvangstbevestiging> <deel:versie>1.3</deel:versie> <deel:rnireferentie> </deel:rnireferentie> <deel:deelnemerreferentie> </deel:deelnemerreferentie> </deel:ontvangstbevestiging> </soapenv:body> </soapenv:envelope> Pagina 47 van 53

48 Df02 (paragraaf 3.2) Een foutbericht als reactie op de Dv02 op blz. 46. <soapenv:envelope xmlns:soapenv=" xmlns:opg=" xmlns:rni=" <soapenv:header/> <soapenv:body> <opg:df02> <opg:versie>1.3</opg:versie> <opg:berichtsoort>dv02</opg:berichtsoort> <opg:verwerking> <rni:datumtijdaangemaakt> t11:23: :00 </rni:datumtijdaangemaakt> <rni:rnireferentie> </rni:rnireferentie> <rni:deelnemer>0101</rni:deelnemer> <rni:deelnemerreferentie> </rni:deelnemerreferentie> <rni:verwerkingscode>104</rni:verwerkingscode> <rni:verwerkingsomschrijving>deelnemer heeft al eerder een opgave met uw referentienummer aangeleverd. </rni:verwerkingsomschrijving> </opg:verwerking> <opg:detailsgeconstateerdefouten>geen nadere details. </opg:detailsgeconstateerdefouten> </opg:df02> </soapenv:body> </soapenv:envelope> Da01 (paragraaf 3.1) Een verwerkbevestiging van de inschrijving op blz. 45. <soapenv:envelope xmlns:soapenv=" xmlns:opg=" xmlns:rni=" <soapenv:header/> <soapenv:body> <opg:da01> <opg:versie>1.3</opg:versie> <opg:verwerking> <rni:datumtijdaangemaakt> t09:01: :00 </rni:datumtijdaangemaakt> <rni:rnireferentie> </rni:rnireferentie> <rni:deelnemer>0101</rni:deelnemer> <rni:deelnemerreferentie> </rni:deelnemerreferentie> <rni:verwerkingscode>1</rni:verwerkingscode> <rni:verwerkingsomschrijving>de inschrijvingsopgave is doorgevoerd. </rni:verwerkingsomschrijving> </opg:verwerking> <opg:burgerservicenummer> </opg:burgerservicenummer> <opg:anummer> </opg:anummer> </opg:da01> </soapenv:body> </soapenv:envelope> Pagina 48 van 53

49 Da02 (paragraaf 3.1) Een verwerkbevestiging van de mutatie op blz. 46 <soapenv:envelope xmlns:soapenv=" xmlns:opg=" xmlns:rni=" <soapenv:header/> <soapenv:body> <opg:da02> <opg:versie>1.3</opg:versie> <opg:verwerking> <rni:datumtijdaangemaakt> t23:23: :00 </rni:datumtijdaangemaakt> <rni:rnireferentie> </rni:rnireferentie> <rni:deelnemer>0101</rni:deelnemer> <rni:deelnemerreferentie> </rni:deelnemerreferentie> <rni:verwerkingscode>2</rni:verwerkingscode> <rni:verwerkingsomschrijving>de actualisering 'AC0101' is doorgevoerd. </rni:verwerkingsomschrijving> </opg:verwerking> </opg:da02> </soapenv:body> </soapenv:envelope> Dv11 (paragraaf 4.2) Dit voorbeeld controleert de status van Dv02-berichten die van t/m zijn verstuurd en status verwerkt hebben in het RNI-systeem. <soapenv:envelope xmlns:soapenv=" xmlns:deel=" xmlns:rni=" <soapenv:header/> <soapenv:body> <deel:dv11> <deel:versie>1.3</deel:versie> <deel:stuurgegevens> <rni:datumtijdaangemaakt> t00:00: :00 </rni:datumtijdaangemaakt> <rni:deelnemer>0101</rni:deelnemer> <rni:deelnemerreferentie> </rni:deelnemerreferentie> </deel:stuurgegevens> <deel:zoekcriteria> <deel:datumtijdvan> t00:00: :00</deel:datumtijdvan> <deel:datumtijdtot> t00:00: :00</deel:datumtijdtot> <deel:aanvraagdv01>n</deel:aanvraagdv01> <deel:aanvraagdv02>j</deel:aanvraagdv02> <deel:aanvraagdv03>n</deel:aanvraagdv03> <deel:aanvraagdv04>n</deel:aanvraagdv04> <deel:status>vw</deel:status> </deel:zoekcriteria> </deel:dv11> </soapenv:body> </soapenv:envelope> Pagina 49 van 53

50 Da11 (paragraaf 4.5.1) Dit antwoord toont 2 berichten die aan de zoekcriteria voldoen. Het is een reactie op de Dv11 op blz. 48. <soapenv:envelope xmlns:soapenv=" xmlns:deel=" xmlns:rni=" <soapenv:header/> <soapenv:body> <deel:da11> <deel:versie>1.3</deel:versie> <deel:verwerking> <rni:datumtijdaangemaakt> t00:00: :00 </rni:datumtijdaangemaakt> <rni:rnireferentie> </rni:rnireferentie> <rni:deelnemer>0101</rni:deelnemer> <rni:deelnemerreferentie> </rni:deelnemerreferentie> <rni:verwerkingscode>11</rni:verwerkingscode> <rni:verwerkingsomschrijving>overzicht met 2 opgaven opgeleverd. </rni:verwerkingsomschrijving> </deel:verwerking> <deel:informatieingediendeopgave> <deel:deelnemerreferentie> </deel:deelnemerreferentie> <deel:rnireferentie> </deel:rnireferentie> <deel:datumtijdregistratieopgave> t00:00: :00 </deel:datumtijdregistratieopgave> <deel:berichtsoort>dv02</deel:berichtsoort> <deel:status>vw</deel:status> <deel:datumtijdverwerkingsopgave> t00:00: :00 </deel:datumtijdverwerkingsopgave> <deel:verwerkingscode>2</deel:verwerkingscode> <deel:verwerkingsomschrijving>de actualisering 'AC0101' is doorgevoerd. </deel:verwerkingsomschrijving> </deel:informatieingediendeopgave> <deel:informatieingediendeopgave> <deel:deelnemerreferentie> </deel:deelnemerreferentie> <deel:rnireferentie> </deel:rnireferentie> <deel:datumtijdregistratieopgave> t00:00: :00 </deel:datumtijdregistratieopgave> <deel:berichtsoort>dv02</deel:berichtsoort> <deel:status>vw</deel:status> <deel:datumtijdverwerkingsopgave> t00:00: :00 </deel:datumtijdverwerkingsopgave> <deel:verwerkingscode>2</deel:verwerkingscode> <deel:verwerkingsomschrijving>de actualisering 'AC0801' is doorgevoerd. </deel:verwerkingsomschrijving> </deel:informatieingediendeopgave> </deel:da11> </soapenv:body> </soapenv:envelope> Pagina 50 van 53

51 Da11 (paragraaf 4.5.1) Dit antwoord geeft aan dat geen enkele opgave aan de zoekcriteria voldoet. Verwerkingscode is ongelijk aan 11, 12 of 13 en veld InformatieIngediendeOpgave ontbreekt. <soapenv:envelope xmlns:soapenv=" xmlns:deel=" xmlns:rni=" <soapenv:header/> <soapenv:body> <deel:da11> <deel:versie>1.3</deel:versie> <deel:verwerking> <rni:datumtijdaangemaakt> t00:00: :00 </rni:datumtijdaangemaakt> <rni:rnireferentie> </rni:rnireferentie> <rni:deelnemer>0101</rni:deelnemer> <rni:deelnemerreferentie> </rni:deelnemerreferentie> <rni:verwerkingscode>1102</rni:verwerkingscode> <rni:verwerkingsomschrijving>geen opgaven aangetroffen die aan de zoekcriteria voldoen.</rni:verwerkingsomschrijving> </deel:verwerking> </deel:da11> </soapenv:body> </soapenv:envelope> Pagina 51 van 53

52 Bijlage E: Tekens in namen Pagina 52 van 53