The Navet service offered by Skatteverket provides information on all individuals who are registered (folkbokförda) in Sweden. The data includes names, personal identification numbers, registration addresses, marital status, and relationships.
Note: Navet is an information service only for public actors, that is to say, authorities, municipalities, and regions.
This Blueprint shows how Onify can get persondata (by "personnummer") from Skatteverket SOAP web service.
Note: This has only been tested against Navets testversion, see page for more information.
These are the technical requirements.
- Onify Hub
- Onify Hub Functions
- Camunda Modeler
- Certificate via Expisoft
As mentioned in the requirements, you need a certificate from Expisoft. If you want to test the integration we recommend using the test service and test certificate.
Here is how you prepare the certificate and test service.
Get and download certificate
- Go to https://eid.expisoft.se/expitrust-test-certifikat/
- Click and download "Testcertifikat server- och stämpellegitimationer" file
- Uzip it
- Open
Kommun A.pdf - Copy "Unika identifieraren" (UID)
- Copy "PIN-koden" (PASSPHRASE)
- Go to https://eid.expisoft.se/hamta-e-legitimation/
- Paste UID
- Download the file
Prepare certificate for Onify
Now when you have downloaded (replace <FILENAME> below) the certificate you need to convert it to a base64 so it can be used as a setting in Onify. Here is how you do it in Node.js;
import fs from 'fs';
function toBase64(filePath) {
const img = fs.readFileSync(filePath);
return Buffer.from(img).toString('base64');
}
const base64String = toBase64('<FILENAME>.p12');
console.log(base64String);Note: Keep the base64 string for later...
Add the following settings in Onify.
| Key | Value | Type | Tag | Role |
|---|---|---|---|---|
| skv_navet_cert_base64 | *** (the base64 string, eg. MIIR*** something) |
string | skv, navet | admin |
| skv_navet_cert_passphrase | *** (this is same as PIN-koden, eg. 4729451359506045 for test) |
password | skv, navet | admin |
| skv_navet_order_id | *** (beställningsidentitet, eg. 00000236-FO01-0001 for test ) |
string | skv, navet | admin |
| skv_navet_org_nr | *** (eg. 162021004748 for test ) |
string | skv, navet | admin |
| skv_navet_url_persondata | *** (eg. https://www2.test.skatteverket.se/na/na_epersondata/V4/personpostXML for test) |
string | skv, navet | admin |
Note: Creating settings via admin interface add a trailing
_in key. This is required for flow to work.
- Open the BPMN diagram in Camunda Modeler.
- Deploy the BPMN diagram (click
Deploy current diagramand follow the steps). - Run it (click
Start current diagram).
- Community/forum: https://support.onify.co/discuss
- Documentation: https://support.onify.co/docs
- Support and SLA: https://support.onify.co/docs/get-support
This project is licensed under the MIT License - see the LICENSE file for details.