9. Voorinvullen

De formulieren server is gekoppeld aan een broker (service bus) en kan via deze broker koppeling gegevens ontvangen van andere (externe) bronnen. In de hier gebruikte configuratie haalt de formulieren server, Orbeon, de gegevens uit één totaal bericht, onder andere gevoed vanuit het GBA.
Om de gegevens uit dit bericht in het formulier weer te geven wordt bij de property 'voorinvulling' een referentie naar het bericht ingevuld. Bij het invoerveld achter achternaam wordt, bijvoorbeeld, bij de property voorinvulling 'surname' ingevuld (zie afbeelding).

De gebruiker moet zich eerst bij DigiD aanmelden om de voorinvulling mogelijk te maken.

Gegevens voorinvullen

De volgende tabel laat enkele gegevens zien die vooringevuld kunnen worden. Deze gegevens worden uit het GBA opgehaald of zijn daaruit herleid. Om van deze gegevens gebruik te kunnen maken, dient een autorisatie aanvraag formulier bij het BPR ingediend te worden. Voor deze formulieren server gelden collectieve regelingen. Neem hiervoor contact op met de helpdesk. Niet alle beschikbare gegevens zijn al ontsloten en er zijn ook gegevens uit andere bronnen ontsloten. Voor  het gebruik van de overige gegevens moeten aparte procedures doorlopen worden. Neem hiervoor contact op met de helpdesk.

Tabel voorinvulling

Met de bouwsteen DigiD Extra is het mogelijk om in het formulier een tweede keer in te loggen met DigiD, bijvoorbeeld door een partner. De gegevens van die persoon kunnen ook in het formulier worden opgenomen. Met deze bouwsteen is het dus ook mogelijk om het formulier te starten zonder DigiD en pas op een later moment DigiD te gebruiken.

LET OP! Bij het inloggen met DigiD Extra worden eerder geuploade bestanden verwijderd. Hou hier rekening mee bij het plaatsen van de bouwsteen en de positie van upload-bouwsteen.

De voorinvulcodes voor het gebruik van DigiD Extra zijn gelijk aan de hierboven genoemde codes met de toevoeging "_extra".
BSN_extra
firstForename_extra
voorvoegsel_extra
enz...

DigiD Extra kan ook gebruikt worden i.c.m. prefillservices (zie hieronder). De toevoeging "_extra" Moet dan worden toegevoegd aan "NPS".
NPS_extra/BSN
NPS_extra/voornamen
enz...

Lokale bron ontsluiting via de StUF prefillservices standaard

Gemeenten die voorinvullen via hun lokale gegevensmakelaar gebruiken hiervoor de NPS berichten. Dit zijn standaard berichten gebaseerd op StUF BG en uitgeschreven in de prefill services standaard van KING (http://www.gemmaonline.nl/images/gemmaonline/a/a8/Specificatie_Prefill_E-formulierenservices_v1.0.2.pdf)

1.      npsLv01-prs-NatuurlijkPersoon/ npsLa01-prs-NatuurlijkPersoon
2.      npsLv01-prs-gezinssituatieOpAdresAanvrager/ npsLa01-prs-gezinssituatieOpAdresAanvrager
3.      npsLv01-prs-kinderenVanAanvrager/ npsLa01-prs-kinderenVanAanvrager
4.      vesLv01-prs-vestiging/ vesLa01-prs-vestiging

De volgende voorinvulling waarden hebben wij gedefinieerd. Deze kunnen bij de property 'voorinvulling' worden ingevoerd. [01] verwijst naar het eerste kind. Gebruik [02] voor het tweede kind etc.

Voorinvulcodes die beginnen met NPS/ worden gebruikt om gegevens te prefillen wanneer een formulier start met DigiD. Gebruik dezelfde codes, maar dan beginnend met NPS_extra/ om de gegevens te prefillen als gebruik wordt gemaakt van DigiD_extra.

Houdt er rekening mee dat niet alle informatie door beide services ondersteund worden.

1.      npsLv01-prs-NatuurlijkPersoon/ npsLa01-prs-NatuurlijkPersoon

Deze service haalt de gegevens op van de aanvrager en toont deze in het formulier wanneer onderstaande voorinvulcodes worden gebruikt.
De gegevens worden alleen gevuld uit het lokale GBA wanneer de aanvrager niet is overleden.
De gegevens van de aanvrager worden ook gevuld als de indicatie geheim is geplaatst. Dit is alleen voor derden bedoeld, de aanvrager zelf mag uiteraard wel over de gegevens beschikken.

NPS/BSN
NPS/voorletters
NPS/voornamen
NPS/voorvoegselGeslachtsnaam
NPS/geslachtsnaam
NPS/aanduidingNaamgebruik (mogelijke waarden E= Eigen geslachtsnaam, N= Geslachtsnaam echtgenoot/geregistreerd partner na eigen geslachtsnaam,P= Geslachtsnaam echtgenoot/geregistreerd partner, V= Geslachtsnaam echtgenoot/geregistreerd partner voor eigen geslachtsnaam)
NPS/geslachtsnaamPartner
NPS/voorvoegselGeslachtsnaamPartner
NPS/geboortedatum
NPS/geboorteplaats
NPS/geboorteland
NPS/geslachtsaanduiding (mogelijke waarden: M/V/O)
NPS/geheim (mogelijke waarden 0 of 7)
NPS/woonplaatsNaam
NPS/openbareRuimteNaam (Straatnaam zoals in de BAG)
NPS/straatnaam
NPS/postcode
NPS/huisnummer
NPS/huisletter
NPS/huisnummertoevoeging

2.      npsLv01-prs-gezinssituatieOpAdresAanvrager
Deze service haalt de gegevens op van de personen die op hetzelfde adres staan ingeschreven als de aanvrager.
Er worden geen gegevens teruggegeven als:
- de aanvrager nog geen 18 jaar is
- er geen familierelatie is  ((geregistreerd) partner, ouders en/of kinderen)
- het gezinslid overleden is
De indicatie geheim is ook hier niet van toepassing. De aanvrager weet immers wie er bij hem op zijn adres zijn ingeschreven.

NPS_INWONEND/partnerOpAdres/partner/BSN
NPS_INWONEND/partnerOpAdres/partner/geslachtsnaam
NPS_INWONEND/partnerOpAdres/partner/voorvoegselGeslachtsnaam
NPS_INWONEND/partnerOpAdres/partner/voorletters
NPS_INWONEND/partnerOpAdres/partner/voornamen
NPS_INWONEND/partnerOpAdres/partner/geslachtsaanduiding
NPS_INWONEND/partnerOpAdres/partner/geboortedatum

NPS_INWONEND/kinderenOpAdres/kind[01]/BSN
NPS_INWONEND/kinderenOpAdres/kind[01]/geslachtsnaam
NPS_INWONEND/kinderenOpAdres/kind[01]/voorvoegselGeslachtsnaam
NPS_INWONEND/kinderenOpAdres/kind[01]/voorletters
NPS_INWONEND/kinderenOpAdres/kind[01]/voornamen
NPS_INWONEND/kinderenOpAdres/kind[01]/geslachtsaanduiding
NPS_INWONEND/kinderenOpAdres/kind[01]/geboortedatum

NPS_INWONEND/oudersOpAdres/ouder[01]/BSN
NPS_INWONEND/oudersOpAdres/ouder[01]/geslachtsnaam
NPS_INWONEND/oudersOpAdres/ouder[01]/voorvoegselGeslachtsnaam
NPS_INWONEND/oudersOpAdres/ouder[01]/voorletters
NPS_INWONEND/oudersOpAdres/ouder[01]/voornamen
NPS_INWONEND/oudersOpAdres/ouder[01]/geslachtsaanduiding
NPS_INWONEND/oudersOpAdres/ouder[01]/geboortedatum

3.      npsLv01-prs-kinderenVanAanvrager
Deze service haalt de gegevens op van de kinderen van de aanvrager.
Er worden geen gegevens teruggegeven als: 
- er geen familierelatie is  ((geregistreerd) partner, ouders en/of kinderen)
- het gezinslid overleden is
- de indicatie geheim actief is. De gegevens van uitwonend kind met indicatie geheim kan op deze manier dus niet door vader of moeder in een formulier worden opgenomen.

NPS_KINDEREN/kinderen/kind[01]/BSN
NPS_KINDEREN/kinderen/kind[01]/geslachtsnaam
NPS_KINDEREN/kinderen/kind[01]/voorvoegselGeslachtsnaam
NPS_KINDEREN/kinderen/kind[01]/voorletters
NPS_KINDEREN/kinderen/kind[01]/voornamen
NPS_KINDEREN/kinderen/kind[01]/geslachtsaanduiding
NPS_KINDEREN/kinderen/kind[01]/geboortedatum
 

NPS_KINDEREN/kinderen/kind[02]/BSN
NPS_KINDEREN/kinderen/kind[02]/geslachtsnaam
NPS_KINDEREN/kinderen/kind[02]/voorvoegselGeslachtsnaam
NPS_KINDEREN/kinderen/kind[02]/voorletters
NPS_KINDEREN/kinderen/kind[02]/voornamen
enz...

4.      vesLv01-prs-vestiging
Vanuit eHerkenning worden het kvk-nummer en vestigingsnummer doorgegeven aan de Toolkit.
Deze worden in het formulier geladen via de volgende prefillcodes:
kvknr
kvkvestiging

Het vestigingsnummer wordt vervolgens gebruikt om de prefillservice te starten. In het formulier moet daarom altijd een veld zijn opgenomen waarin het vestigingsnummer wordt gevuld. Het formulier mag maximaal één veld bevatten met de prefillcode 'kvkvestiging'. Via de prefillservice kunnen de volgende gegevens in het formulier worden geladen:

VES/handelsnaam
VES/handelsnaamverkort
VES/verblijfsadressen/verblijfsadres[01]/identificatie
VES/verblijfsadressen/verblijfsadres[01]/identificatiewoonplaats
VES/verblijfsadressen/verblijfsadres[01]/woonplaats
VES/verblijfsadressen/verblijfsadres[01]/openbareruimtenaam
VES/verblijfsadressen/verblijfsadres[01]/straat
VES/verblijfsadressen/verblijfsadres[01]/postcode
VES/verblijfsadressen/verblijfsadres[01]/huisnummer
VES/verblijfsadressen/verblijfsadres[01]/huisletter
VES/verblijfsadressen/verblijfsadres[01]/huisnummertoevoeging
VES/verblijfsadressen/verblijfsadres[01]/locatiebeschrijving
VES/correspondentieadressen/correspondentieadres[01]/identificatie
VES/correspondentieadressen/correspondentieadres[01]/woonplaats
VES/correspondentieadressen/correspondentieadres[01]/openbareruimtenaam
VES/correspondentieadressen/correspondentieadres[01]/straat
VES/correspondentieadressen/correspondentieadres[01]/postcode
VES/correspondentieadressen/correspondentieadres[01]/huisnummer
VES/correspondentieadressen/correspondentieadres[01]/huisletter
VES/correspondentieadressen/correspondentieadres[01]/huisnummertoevoeging
VES/telefoon
VES/email
VES/website

Prefillcodes voor eIDAS

De meeste codes spreken voor zich. Zo niet, dan staat de betekenis erachter.

identifier = uniek identificatie nummer
achternaam
voornaam
geboortedatum
geboortenaam
placeofbirth = geboorteplaats
geslacht
huisnummer
postcode
straatnaam
huisnummertoevoeging
plaatsnaam
landcode
provincieofstaat
specialisatieadres = naam van een gebouw of deel ervan als specialisatie van het adres van de gebruiker.
uniekeidentificatieadres = huisnummer, of andere unieke identificatie van een adres op een "straat" (thoroughfare) van de vertegenwoordigde.
wijk = wijk of deel van een gemeente van de vertegenwoordigde.