Fact
- PhenixID Identity Provisioning 4.8.0 or later
- Customer ID for Navet
- Certificate for Navet
Situation
This document will describe the action that can be used to get personal information for a Swedish person with a given personal number from the service Navet.
Solution
Download and install the action package
Download the zip file according to version of PIP.
PhenixID Identity Provisioning version 5.4.1 and earlier:
navetActionPackage.zip
PhenixID Identity Provisioning version 6.0.0 and later:
navetActionPackage600.zip
For instruction of how to install the action package, read PSD1149.
Version
The current version of the action is 1.4.
Configure the action
The action will make one call to Navet for each session object, with the configured personal number attribute value. If the personal number is correct, a number of new session attributes will be created with information from Navet. If some error occurs, an error message attribute can be created.
The parameters for the Navet V2 Person Lookup action:
|
Parameter |
Description |
|
Customer organisation no |
[Mandatory] The organizational number, using 12 digits. |
|
Customer ID |
[Mandatory] Customer unique ID (syntax is often: XXXXXXXX-FOXX-XXXX). |
|
Key store |
[Mandatory] Path to key store. |
|
Key store password |
[Mandatory] Password to unlock the key store file |
|
Key store type |
[Optional] Key store type (default: PKCS12). |
|
Personnummer attribute |
[Mandatory] The session attribute where the Swedish personal number is located (syntax MUST be: XXXXXXXX-YYYY). |
|
Verify syntax |
[Optional] If set to “true” personal number syntax will be tested before online verification. (true/false). Default: false. |
|
Error attribute |
[Optional] The session attribute where any error will be placed. The attribute will have no value if no error occurred. Leave blank to not create any error attribute. |
|
Endpoint URL |
[Optional] Set endpoint URL if using another than the default. |
|
Log result |
[Optional] Set to true if the result from Navet should be logged in debug level. Set to false if no logging should be made. Default is false. |
Example values
|
Parameter |
Value |
|
Customer organisation no |
123456789012 |
|
Customer ID |
12345678-FO12-1234 |
|
Key store |
C:/certificates/navet.p12 |
|
Key store password |
password |
|
Key store type |
PKCS12 |
|
Personnummer attribute |
personalnumber |
|
Verify syntax |
true |
|
Error attribute |
navet-error |
|
Endpoint URL |
https://www2.skatteverket.se/na/V2/personpost |
|
Log result |
true |
Result
The following session attributes will be created.
|
Session Attribute |
Value |
|
navetSN |
Lastname, e.g. ‘Svensson’ |
|
navetAllGivenNames |
All givennames, e.g. ‘Anna Karin’ |
|
navetPrefGivenName |
The preferred givenname, e.g. ‘Anna’ If no preferred givenname is present for the person, the value will be ‘saknas’ |
|
navetMiddleName |
Middle name, e.g. ‘Lindh’ |
|
navetNameIsPrivate |
If the person has a private mark, value is ‘J’, else ‘N’ |
|
navetProtectedPublicRecords |
If the person has a mark for protected public records, value is ‘J’, else ‘N’ |
|
navetSwedishPersonalNumber |
If the personal number is a Swedish personal number, value is ‘J’, else ‘N’ |
|
navetStreetAddress1 |
Address row 1, e.g. Direktörshuset |
|
navetStreetAddress2 |
Address row 2, e.g. Storgatan 5 |
|
navetPostalAddress |
Postal address, e.g. Stockholm |
|
navetPostalCode |
Postal code, e.g. 12345 |
|
navetCareOf |
Care of address, e.g. c/o Andersson |
|
navetBornAbroadCountry |
The country the person is born in, e.g. Tyskland No value if the person is born in Sweden. |
|
navetBornAbroadCity |
The city abroad that the person is born in, e.g. Berlin No value if the person is born in Sweden. |
|
navetAbroadAddress1 |
Address row 1 for people living abroad, e.g. Big Street 4th |
|
navetAbroadAddress2 |
Address row 2 for people living abroad, e.g. Miami |
|
navetAbroadAddress3 |
Address row 3 for people living abroad, e.g. USA |
|
navetAbroadAddressCountry |
The country people living abroad, e.g. USA |
|
navetCitizenships |
Citizenships and the year the citizenship started, e.g SE, 2016 |
|
navetUnregisteringDate |
Date of unregistering, e.g. 20160123 |
|
navetUnregisteringCode |
Unregistering code, e.g. AV |
|
navetEncounteredDeath |
Date of encountered death, e.g. 20160123 |
|
navetChildren |
List of personal numbers for the person’s children, including children who have died, e.g. 199902010123 |
|
navetChildrenAlive |
List of personal numbers for the person’s living children, e.g. 199902010123 |
|
navetBirthdate |
Birthdate for the person, e.g. 19720427 |
DISCLAIMER
Information provided in this document is for your information only. PhenixID makes no explicit or implied claims to the validity of this information. Any trademarks referenced in this document are the property of their respective owners.The origin of this information may be internal or external to PhenixID. PhenixID makes all reasonable efforts to verify this information.
PhenixID - support.phenixid.se