Vejledning til systemintegration med sundhedsjournalen 2025

[Thomas Krogsgaard Holme]

Her finder du links til samtlige filer du kan downloade når du skal bygge en integration til sundhedsjournalen.

Vejledningen beskriver hvordan et fagsystem kan integreres med sundhed.dk.
Vejledningen beskriver ikke hvordan data, der skal benyttes i kaldet til sundhed.dk, herunder sosi-id-kort, tilvejbringes.

I kaldet til sundhed.dk indgår et Unsolicited SAML Response. Indholdet i dette skal Service Consumer (dvs fagsystemet)  selv tilvejebringe. Det kan gøres som beskrevet i sekvensdiagrammet vedhæftet herunder.

Vejledning til systemintegration mellem fagsystem og sundhedsjournalen 1.8.0 (Denne model er nedtaget og integrationen lukkes endeligt 9/6-2026)

Vejledning til systemintegration mellem fagsystemer og sundhedsjournalen 2.4

Download vejledning v.2.4

[Thomas Krogsgaard Holme]

Sekvensdiagram for kald til sundhedsjournalen fra fagsystem 1.8.0 og 2.0
Diagrammet viser den generelle sekvens for kald (diagrammet dækker mere end vejledningen)

Download diagram

[Thomas Krogsgaard Holme]

testklient.dk.2.1.7z - ny version pr 18 juni 2024
Filen indeholder en opdateret version af test-kilenten. Testklienten er i sig selv et website, der skal sættes op for at fungere. Yderligere er testklienten et kodeeksempel på hvordan klientdelen kan skrives. Eksemplet er i C# og beregnet på afvikling på Windows med IIS webserver...
Klienten

• Er et eksempel på hvordan SAML Response opbygges, helt konkret
• Kan med fordel bruges til at se om rammerne uden om koden er opfyldt. Eksempelvis Whitelisting hos sundhed.dk

Download test-klient

Læs vejledning til test-klient

[Thomas Krogsgaard Holme]

IP Adresser

URL til login på sundhed.dk

• https://sosidemo.sdkdev.dk/loginV2.ashx

URL til hjælpeværktøjer
Du skal whitelistet for at få adgang, og disse to sider kan bruges til at validere at whitelisting fungerer.

• https://epjlogindemo.sdkdev.dk/(sundhed.dk-hostet testklient)
• https://logviewer-sosilogin-demo.sdkdev.dk/(logviewer)

[Thomas Krogsgaard Holme]

Specielt for V2 endpointet:

Når et login forsøges, valideres den oplyste SOR organisation. Hvis denne validering fejler returneresen besked som denne: (HTTP 400, Bad Request)
{"type":"https://tools.ietf.org/html/rfc7231#section-6.5.1","title":"One or more validation errors occurred.","status":400,"traceId":"[ID]","errors":{"IsValidWorkplace":["No valid workplace for [CVR]"]}}

Krav til SOR koden:
1. SOR kode og CVR nummer skal tilhøre samme organisation.
2. SOR koden opfylder et af følgende krav:
 - a. 'almen lægepraksis' eller 'speciallægepraksis'
 - b.  organisationen er CVR whitelistet

[Thomas Krogsgaard Holme]

Vejledning til systemintegration til sundhedsjournalen er opdateret til version 2.2.

Ændringen omfatter forberedende support for graviditetsmappen og lidt redaktionel oprydning.

Graviditetsmappen er endnu ikke implementeret, så de to nye landingpages kan pt ikke anvendes.

[Thomas Krogsgaard Holme]

Vejledning til systemintegration til sundhedsjournalen version 1.8 er nedtaget.
Løsningen lukkes endeligt 9/6-2026.