Indholdsfortegnelse:
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.
Nationalt eCPR driftes pt på FMK platformen.
Når Nationalt eCPR flyttes til NSP platformen opdateres denne side.
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:
(2) MitID erhverv:
(3) Testmiljøer, produktionsmiljøer, generelt:
(4) Testcertifikater:
(5) Test stamdata, MitID simulator:
(6) End points, Security token service og eksempelkode:
(7) Certifikater:
(8) SDN:
(9) Webservice:
Der skal laves 2 forskellige aftaler med SDS for at kunne bruge Nationalt eCPR i produktion:
Det er en god idé at få aftaleprocesserne igangsat som noget af det første, så I ikke senere bliver bremset af manglende aftaler.
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:
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.
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”:
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:
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.
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.
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.
Nationalt eCPR driftes pt på FMK platformen, og wsdl filerne kan derfor hentes der.
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:
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
Nationalt eCPR driftes pt på FMK platformen, og xml filerne kan derfor hentes der.
Når Nationalt eCPR flyttes til NSP platformen opdateres ovenstående link.
Der adviseres ved to typer handlinger:
Ændring af personregistrering | Action | Beskrivelse |
---|---|---|
Opdatering af person | Updated | For alle ændringer der foretages på en personregistrering efter den er oprettet.
Adviseringen indeholder ikke information om hvordan og med hvad personregistreringen er blevet ændret. |
Sletning af person | Deleted | Fuldstændig fjernelse af en personregistrering - vil kun forekomme i test. |
Æ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
1.0 | 2023-11-30 | Indhold publiceret | SDS |
1.1 | 2023-12-04 | Tilføjet:
| SDS |
1.2 | 2023-12-05 | Tilrettet hvordan wsdl'erne tilgåes efter flytning til NSP | Trifork |