Indholdsfortegnelse:

1. Introduktion

Nationalt eCPR er et register over nationalt unikke erstatnings-CPR-numre til understøttelse af behandling af patienter uden CPR-nummer i det danske sundhedsvæsen.

I denne guide og på underliggende sider findes de tekniske vejledninger i forhold til at implementere integration til Nationalt eCPR i et lokalt fagsystem. 

Vejledningen er tiltænkt forretningsarkitekter, systemarkitekter samt systemleverandører, således at disse kan vurdere, hvordan Nationalt eCPR kan implementeres i systemerne.

AS IS Nationalt eCPR driftes pt på FMK platformen.

TO BE Når Nationalt eCPR flyttes til NSP platformen opdateres denne side.

2. Kom-godt-i-gang guide

Nedenstående diagram viser et overblik over de steps som der skal gennemgås, før det er muligt at få adgang til Nationalt eCPR via FMK. Vurder derfor inden opstart, hvilke behov jeres organisation har for adgang, og hvad der er behov for at kunne se og følge. Tallet angivet i parentes henviser til links, hvor der kan findes yderligere information om emnet. 

(1) Adgangsrettigheder:

• eCPR - Roller og rettigheder

(2) MitID erhverv:

• Brug af MitID Erhverv i adgang til patientdata

• Sådan får I MitID Erhverv

• Teknisk overblik til anvendere

• MitID erhverv support

(3) Testmiljøer, produktionsmiljøer, generelt:

• Introduktion til service og adgang til miljøer

• Testmiljøer

• Adgang til fælles testmiljøer

• Endpoints for eksterne testmiljøer

(4) Testcertifikater:

• Vejledning til oprettelse og vedligehold af testcertifikater

• Offentlige test-klientcertifikater for NSP

(5) Test stamdata, MitID simulator:

• Guide til oprettelse af Testmedarbejder på NSP

(6) End points, Security token service og eksempelkode:

• Eksempel kode (på FMK wiki)

• STS - guide til anvendere

(7) Certifikater:

• Guide til udtræk af offentlig certifikat af OCES2 og OCES3

• Klargøring til MitID på sundhedsområdet

(8) SDN:

• Vilkår for anvendelse af data og services på NSP

• SDN startpakke

(9) Webservice:

• NAS anvenderguide

2.1. Aftaler

Der skal laves 2 forskellige aftaler med SDS for at kunne bruge Nationalt eCPR i produktion:

1. En sundhedsdatanetaftale og tilsvarende tilslutning
   1. Det har alle regioner i forvejen, men det skal sikres, at det integrerende system har sikker adgang til SDN.
2. En NSP serviceaftale
   1. Sådan en har alle regioner i forvejen.

Det er en god idé at få aftaleprocesserne igangsat som noget af det første, så I ikke senere bliver bremset af manglende aftaler.

• Sundhedsdatanet aftale og adgang: Du kan læse og søge om adgang til sundhedsdatanettet her
• NSP Serviceaftale: I kan se alle jeres eksisterende aftaler her. Kræver login – hvis du ikke har et login, så er der vejledning til at kontakte support på siden.

2.2. DGWS adgangsbillet

Hvis din bruger eller dit system ikke allerede har et gyldigt ID-kort, skal der rekvireres et sådant hos NSP’ens STS-service. Der er i skrivende stund (okt. 2023) kun krav om ”Den Gode Web Service” niveau 3 (system IDKort), men hvis servicen (i step 3) kaldes med et person IDKort (DGWS niveau4) virker det naturligvis også.

Det bliver for omstændeligt at beskrive i detaljer, hvordan du rekvirerer et ID-Kort (og du har sikkert også gjort det i andre sammenhænge), men du kan læse mere om det her:

• STS - Guide til anvendere

Hvis det er et System-IDkort, du vil skabe, skal du bruge: /sts/services/NewSecurityTokenService, og i dit request skal du medsende et autentifikationsbevis baseret på et ”systemcertifikat”. Læs evt. mere om dem på MitID Erhverv - Certifikater.

STS’en skal betragtes som endnu en DGWS service på NSP, så her skal der også whitelistes. Testmulighederne i de efterfølgende steps gælder også for STS’en, så her er der god hjælp/inspiration at hente. 

2.3. Brug af Nationalt eCPR

Snitfladen i Nationalt eCPR følger ”Den Gode Web Service”, hvor adgangsbilletten indlejres i headeren og parametre mv. kommunikeres i body. Hvis I koder i Java eller .NET er der god hjælp at hente i ”SOSI bibliotekerne”:

• Java: https://www.nspop.dk/display/public/web/SEAL.JAVA+-+Guide+til+anvendere
• .NET: https://www.nspop.dk/display/public/web/SEAL.NET+-+Guide+til+anvendere

2.4. Test og Testmiljøerne på NSP

Der er gode muligheder for at teste din (færdige) løsning mod NSP’ens testmiljøer. Du finder yderligere information om testmiljøerne her:

• Generel info: https://www.nspop.dk/pages/releaseview.action?pageId=8915030
• Adgang til testmiljøer: https://www.nspop.dk/pages/releaseview.action?pageId=8915610

Hvis I ikke allerede har adgang, kan I ansøge om adgang her: Bestillingsark for adgang til testmiljø der skal udfyldes og indsendes til SDS´s Nationale Servicedesk.

3. Liste over miljøer

Nationalt eCPR-Service er tilgængelig i følgende miljøer

Test1

http://test1-cnsp.ekstern-test.nspop.dk:8080/decoupling/ecpr2/

Test2

http://test2-cnsp.ekstern-test.nspop.dk:8080/decoupling/ecpr2/

Prodtest

http://prodtest-cnsp.ekstern-test.nspop.dk:8080/decoupling/ecpr2/

Udd

http://uddannelse-cnsp.ekstern-test.nspop.dk:8080/decoupling/ecpr2/

Stage og Prod

Endpoints til stage og prod miljøer fås efter aftale ved henvendelse til NSP Supporten.

4. eCPR - Forretningsregler

5. WSDL

Der findes en række services i Nationalt eCPR, som er defineret gennem to WSDLer:

• ECPR2Service: De basale service til opslag og opdatering af data

• ECPR2MasterDataService: Utility service til OID-opslag

De konkrete WSDLer findes i ecpr2-wsdl.zip under /wsdl.

AS IS Nationalt eCPR driftes pt på FMK platformen, og wsdl filerne kan derfor hentes der.

TO BE Når Nationalt eCPR flyttes til NSP platformen fjernes ECPRMasterDataService, hvorefter Utility service til OID service også findes gennem ECPR2Service. Herefter kan WSDL'erne findes på to forskellige endpoints, både med og uden security headers:

• Med security header:{\[miljøurl\}\ecpr2\wsdl\dgws_service.wsdl
• Uden security header: {\[miljøurl\}\ecpr2\wsdl\dgws_service_no_security_header.wsdl

6. eCPR - Snitfladebeskrivelse

7. Adviseringer

Indholdet i adviseringer vil i så høj grad som muligt indeholde information, der gør det muligt at identificere hvilken person der er ændret.

XML skemaer for indhold i adviseringer: ECPR2Advis-collection.zip

AS IS Nationalt eCPR driftes pt på FMK platformen, og xml filerne kan derfor hentes der.

TO BE Når Nationalt eCPR flyttes til NSP platformen opdateres ovenstående link.

Der adviseres ved to typer handlinger:

7.1. Ændringer af personregistreringer

Ændringer af personregistreringer sker ved opdatering på datasættet for den pågældende personregistrering. I indholdet for adviseringen fremgår handlingen i Action-elementet, og Identifieren findes i PersonId-elementet. 

Nedenstående eksempel viser hvad der forventes returneret fra adviseringsservicen, såfremt en klient notificeres om at der er opdateret noget på personregistreringen identificeret med X-eCPR-nummer 1111111AB8. 

Nationalt eCPR-servicen definerer indholdet af Topic-elementet, samt elementet PersonIdentifierModification med underelement Action.

<Notify>
  <NotificationMessage>
    <Topic>http://sds.dk/personid/2018/01/01</Topic>
    <Message>
      <NotifyContent id="1.2.208.176.1.6.1.1:1111111AB8" idType="http://sds.dk/personid/advis/OIDID">
        <PersonIdentifierModification>           
          <Action>Updated</Action>
        </PersonIdentifierModification>
      </NotifyContent>
    </Message>
  </NotificationMessage>
</Notify>

Ændringslog