A separate test environment has been created that system vendors and healthcare organizations can use to connect to a test version of Persontjenesten. The test environment can be used to test and verify an integration from a professional system to Persontjenesten. The test environment uses HelseID for authentication and authorization in the same way as the production environment.
The test environment is available both on the internet and on the health network:
"Helsenettet": https://et-helsenett.persontjenesten.test.nhn.no/api
We recommend using the internet publication unless special circumstances dictate that you have to go via the "Helsenettet".
Test environment limitations as of Q1 2024
The Persontjenesten test environment is not part of Grunndata's existing test environments.
The Persontjenesten test environment and test data can be used to test integrations against Persontjenesten, but it will not necessarily provide a full-fledged chain test of all functionality in a professional system.
The Persontjenesten test environment should not be used by consumers for performance testing
Test population and SyntPop
Persons in the Persontjenesten external test environment consist of a synthetic test population from the Tax Administration (+80 by month of birth), and a set of reserved test persons (+65 by month of birth). Functionality for searching for persons in the population, as well as the ability to reserve and update static test persons, is available in SyntPop. SyntPop also collects and combines data from multiple registers (e.g. the health personnel register and the general practitioner register), and offers functionality for searching and finding test persons with criteria across all of these registers.
SyntPop is available at https://syntpop.nhn.no/
See more information about SyntPop at https://www.nhn.no/tjenester/syntpop https://www.nhn.no/tjenester/syntpop/kom-i-gang
Read more about the different types of test subjects below.
Synthetic test population
The Persontjenesten uses a synthetic test population from the Norwegian Tax Administration's test population register (Tenor), as a source in the Personal Service's external test environment. Test-Norge (Tenor) is created based on a representative sample of the Norwegian population, and consists of constructed data that has no roots in reality. The test subjects are not named with real names, but with names that are composed of adjectives and nouns, e.g. "Vakker Blomst". The test subjects live at real street addresses, with real postal codes and municipality numbers.
The test population will be alive and changing, i.e. changes are generated in personal data that reflect reality. Examples are address changes, marriage, divorce, death and birth. The Norwegian Tax Administration will generate such changes in the test population daily, which are continuously updated in the Persontjenesten.
The test environment for the Persontjenesten uses the same authentication mechanisms as the production environment, so that it is possible to test how authenticated calls work. Note that there are different secrets and endpoints for test and production, you cannot reuse production secrets in test or vice versa.
Personal identifiers in test population
Since 2016, Tax has planned to change the PID in the test population as the practice of using real personal identification numbers is not in accordance with privacy. Real personal identification numbers should not be used in test data. The Tax Administration published a new version of the test population on February 1, 2021:
The test population consists of test subjects with synthetic personal identifiers.
To show that it is a synthetic personal identifier, +80 is added to the month for both the birth and d numbers, and individual digits are then calculated. The control calculation (modulus11) is kept unchanged as it is now.
With synthetic personal identifiers (PIDs), it is ensured that personal identifiers in the test environment will not be able to exist in production.
What must users of the Personal Service test environment do
All consumers of the Personal Service who are already using or plan to use the Personal Service test environment (ET environment) must be aware that the FNR and DNR must be in line with the new standard for the Norwegian Tax Administration's test population with new personal identifiers: Consumers must adapt their systems to make it possible to receive FNR and DNR with +80 in the month (January = 81, February = 82, etc.).
Examples of synthetic FNR and DNR can be found on the Norwegian Tax Administration's website.
The change at the Norwegian Tax Administration is permanent due to privacy concerns, but NHN is aware that +80 in the month in PID may lead to challenges for our consumers' test environments.
Tax has confirmed that the modulus11 logic still works (the check digits are calculated after 80 is added)
Solutions that have modulus11 check on the social security number will still work
Date of birth cannot be derived from the social security number, but must be retrieved from a separate field (in line with the changes in FREG)
Gender cannot be derived from the social security number, but must be retrieved from a separate field (in line with the changes in FREG)
Several sectors have reported a need for combinations of test data that are not currently offered via the Norwegian Tax Administration's synthetic test data, as well as a need for data for controlled testing and the ability to change data. The fact that some test subjects are kept static, i.e. do not live and receive changes from Tax, is what we at NHN have chosen to call reserved test data.
Reserved test data can be managed in SyntPop, where there is functionality for creating and updating reserved test subjects. There is also a separate API for automatically managing test subjects, for those who want to use this directly: Reserved Test Data API. SyntPop uses this API to manage subjects.
Reserved test subjects will remain static unless they are updated by the owner of the test subject. The API is secured with HelseID in the same way as the Persontjenesten, and will use information in the HelseID token that is sent with requests to the API to link reserved test subjects to an owner.
The reserved test persons must be separated from Test-Norge's PIDs and +65 will be added to the month for both birth and d-numbers (instead of +80). Control calculation (modulus11) will be used, and will work with both +80 and +65.
Examples:
016621-35465 (=01.01.21)
017121-35465 (=01.06.21)