Page History
Table of Contents | ||
---|---|---|
|
Indledning
Denne vejledning beskriver de tekniske implementeringsregler i forhold til at implementere Fælles Stamkort i et lokalt fagsystem eller en patient/borgerportal. Vejledningen er tiltænkt forretningsarkitekter, systemarkitekter samt systemleverandører, således at disse kan vurdere hvordan Fælles Stamkort kan implementeres i systemerne.
...
1 - Herunder CPR-register, Sygesikringsregister, Organdonorregister, Livs- og Behandlingstestamenteregister samt stamkortregister
2 - https://svn.medcom.dk/svn/releases/Standarder/HL7/PDC/
Anden dokumentation
De overordnede forretningsregler til Fælles Stamkort kan ses i dokumentet: Indhold og forretningsregler Fælles Stamkort
Detaljeret teknisk anvenderguide, herunder information om felttyper, feltstørrelser og kardinalitet i dokumentet: Fælles Stamkort - Teknisk guide til anvendere
Teknisk oversigt
Udveksling af patientens Fælles Stamkort foregår via den nationale infrastruktur til deling af dokumenter. Denne understøtter referencearkitekturen for deling af dokumenter og billeder.
...
For detaljeret teknisk dokumentation omkring dokumentdeling via NSP, se NSP'ens Dokumentdelingsservice.
For detaljeret information ang. MinSpærring se Min Spærring på NSPOP
Bemærk: For Fælles Stamkort 3.0 er det ikke længere muligt for borgeren at spærre for deling af stamoplysninger, herunder Fælles Stamkort
Fælles Stamkort er understøttet af to overordnede services. Hent Fælles Stamkort samt Opdater Stamkortregister, disse services vil indgå i lokale fagsystemer samt patient/borgerportaler.
...
Stamkortregister-servicen benyttes til at hente (kun adgang fra Fælles Stamkort komponenten) samt redigere patientens stamdata (telefonnummer, pårørende oplysninger, midlertidige adresse, sprog samt tilknytning til tandlæge). Opdateringer af data, sker via en direkte webserviceintegration til Stamkortregisteret.
Migrering af data fra lokale fagsystemer til Fælles Stamkort
Funktionaliteten vedr. migrering er arkiveret, anvend fremadrettet den beskrevne proces for synkronisering af data mellem lokale fagsystemer og Fælles Stamkort
Dokumentation for migrering bibeholdes indtil servicen er lukket ned, og kan ses under: Migrering af data fra lokale fagsystemer til Fælles Stamkort
Daglig drift mellem lokale fagsystemer og Fælles Stamkort
Den første synkronisering med Fælles Stamkort, har til målsætning at få ensrettet data i Fælles Stamkort med de allerede eksisterende data i de lokale fagsystemer.
...
Fagsystemet ser ved næste opslag på patientens data, at kontaktinformationer har et nyere tidsstempel end de lokla data, og skal derfor synkronisere data fra Fælles Stamkort ned til de lokale data.
Da det her drejer sig om en sletning af data, skal data fjernes fra det lokale fagsystem, da det ikke længere er validt - da patienten har slettet det.
Lokal information tilknyttet data i Stamkortregisteret
Da hver data-entitet i Stamkortregisteret har tilknyttet en unikt id, er det muligt at have lokale informationer, der kun befinder sig i eget fagsystem tilknyttet data i stamkortregisteret.
Bemærk: Det er ikke et krav at fagsystemer skal kunne understøtte yderligere tilknytning af data til informationen i Fælles Stamkort.
...
Eksempelvis kan pårørende Hans Hansen fra ovenstående eksempler med ID: 9c13a4e6-fa0e-4740-833b-1e9e80ecc18e være 1. prioritet der skal kontaktes når det er en indlæggelse, men 2. prioritet når det handler om kommunale ydelser. Fagsystemet på hospitalet har derved tilknyttet information om 1. prioritet til Hans Hansen, hvorimod det kommunale fagsystem har tilknyttet 2. prioritet til Hans Hansen.
Skulle borgeren ikke længere ønske Hans Hansen som pårørende, og derved sletter denne, kan fagsystemerne tilsvarende slette de tilknyttede oplysninger når de modtager ændringen via Fælles Stamkort.
Adviseringer fra Stamkortregisteret
Fagsystemer bør hente patientens seneste Fælles Stamkort, hver gang der laves opslag på patientens stamdata i fagsystemet. Således kan fagsystemet flette de seneste ændringer fra Fælles Stamkort ind i de lokalt cachede stamdata. Betydningen af dette er at der laves mange opslag på patientens Fælles Stamkort, også når der ikke er sket ændringer.
Hvis fagsystemet derimod modtager en advisering når der er ændring i borgerens data fra stamkortregisteret, kan der laves optimeringer i forhold til antallet af opslag.
...
- Hans Hansen har for 2 dage siden oprettet sit telefonnummer via sundhed.dk, da dette ikke var indtastet i forvejen.
- Stamkortregisteret har udsendt en advisering til beskedkøen: "Ændring på Fælles Stamkort", som fagsystemet "lytter på", og hvor fagsystemet i forvejen har fortalt det vil modtage adviseringer for regionens patienter, her i blandt Hans Hansen.
Fagsystemet får markeret Hans Hansen's stamdata, således det kan opdateres når en sundhedsperson tilgår Hans Hansen's journal næste gang. - Når Hans Hansen møder op på afdelingen, vil sundhedspersonen slå op på Hans Hansens data. Fagsystemet vil synkronisere stamdata, og i dette tilfælde opdatere Hans Hansens telefonnummer fra Fælles Stamkort (ud fra sundhedspersonens medarbejdercertifikat). I dette eksempel har fagsystemet lavet en markering at Hans Hansen's telefonnummer er opdateret således sundhedspersonen er informeret.
Synkroniseringen bevirker følgende:Der laves automatisk opslag mod MinSpærring, med sundhedspersonens medarbejdercertifikat, fagsystemet skal agere ud fra svaret. (Eksempelvis gøre opmærksom over for sundhedspersonen at der foreligger en spærring) (Bemærk:- For Fælles Stamkort version 3 kan der ikke længere spærres for deling af Fælles Stamkort)
- Der laves automatisk en behandlingsrelationsopfølgning
- Der laves automatisk en registrering i patientens MinLog - således patienten har indsigt i hvordan data er benyttet (i dette tilfælde kan Hans Hansen se at sundhedspersonen har hentet Fælles Stamkort).
System kald ved læsning af Fælles Stamkort
Fagsystemer vil kunne hente egne borgeres stamkort via et system kald udenfor konteksten af en sundhedsfaglig bruger. Dermed har fagsystemet mulighed for at kunne lave en asynkron opdatering af lokale kopier af borgerens Fælles Stamkort, uden en sundhedsfaglig bruger involveres. Fagsystemet kan derved eksempelvis lave brevfletning, generere arbejdslister og kørelister med borgerens opdaterede adresse og kontaktinformation i batch-jobs.
Borgere har dog mulighed for at spærre for deling af sit Fælles Stamkort via MinSpærring (Bemærk: Dette bortfalder fra Fælles Stamkort version 3). Dette er uanset om brugeren der spærres for har en sundhedsfaglig autorisation, er under bemyndigelse/trust eller er et system.
Både systemer og brugere vil blive fortalt at der foreligger en spærring når et Fælles Stamkort hentes, som beskrevet i Håndtering af spærring og fuldmagt. Fagsystemet skal således kunne håndtere dette, f.eks ved at brugeren foretager et værdispring, eller spørger borgeren om samtykke til at se oplysningerne.
Fagsystemet skal desuden, som lovgivningen foreskriver det, indføre samtykket i patientjournalen.
I forhold til logning, kræver bekendtgørelsen I forhold til logning, kræver bekendtgørelsen om drift m.v. af den fælles digitale infrastruktur (Bekendtgørelse om drift m.v. af den fælles digitale infrastruktur (Bekendtgørelse om drift m.v. af den fælles digitale infrastruktur (retsinformation.dkretsinformation.dk)) at der laves logning med brugerkontekst ved anvendelse af persondata.
Det betyder at anvender systemer selv skal registrere brugeranvendelsen af Fælles Stamkort til MinLog når system-system kommunikation benyttes til at hente en borgers Fælles Stamkort.
Anvendersystemets Minlog registrering skal indeholde følgende:
...
Endpoint NSP TEST-1 og TEST-2: Se anvenderguiden for synkroniseringsservice til Fælles Stamkort: https://www.nspop.dk/display/public/web/SFSK+-+Guide+til+Anvendere
Bemærk: Da det jvf. bekendtgørelsen ikke skal være muligt at spærre for deling af stamoplysninger pr. 1/12-24, vil Fælles Stamkort fra dette tidspunkt udelukkende blive udstillet via Synkroniseringsservice til Fælles Stamkort
...
Grænsefladerne vil være uændrede i forhold, da det stadig er ITI-18 og ITI-43 kald til dokumentdelingsservicen der benyttes, der vil dog være et nyt endpoint, der udelukkende kan benyttes til at hente Fælles Stamkort via et system kald. Dette endpoint kan ikke benyttes til af hente andre typer af dokumenter (Aftaler, Planer, PRO-skemaer m.v.)
Har borgeren spærret for deling af sit Fælles Stamkort (Bemærk: bortfalder fra Fælles Stamkort version 3), kan fagsystemerne godt hente data ind lokalt, fagsystemerne skal dog kunne håndtere dette, ved eksempelvis at gemme denne spærring lokalt - eksempelvis som et flag der kontrolleres inden stamkortet benyttes. Fagsystemerne skal kunne advisere brugerne om at borgerens Fælles Stamkort er spærret, og enten give brugeren mulighed for at foretage et værdispring, eller anmode borgeren om et samtykke, inden data benyttes. Værdispring eller samtykke skal indføres i fagsystemets journalsystem som Sundhedloven angiver det.
Der indføres ligeledes en mulighed for fagystemet, til at lytte på adviseringer angående borgerens spærringer, se Håndtering af spærring og fuldmagt, derved kan fagsystemet fjerne den lokale spærring, og benytte data som loven foreskriver det.
Fagsystemet kan også vælge ikke at have en lokal kopi af en borger Fælles Stamkort, hvis borgeren har lavet en spærring. Det er op til fagsystemets egne processer at kunne håndtere dette.
Teknisk implementering
Afsnittet indeholder tekniske vejledninger til hvordan Fælles Stamkort kan integrereres i lokale fagsystemer og patient/borgerportaler.
Fagsystemer og borgerportaler der skal benytte Fælles Stamkort, skal godkendes og certificeres af MedCom. Testprotokollerne for certificering til Fælles Stamkort, hvor version 1.3 er gældende for modtagelse, kan findes på MedCom's hjemmeside under: Testprotokoller for modtagelse af Fælles Stamkort
Bemærk: Testprotokollerne er under opdaterering til Fælles Stamkort version 3
Yderligere information om om hvordan CDA dokumenter er opbygget kan findes hos IHE, under: IHE - Hvad er HL7 CDA?
Indhold i Fælles Stamkort
Indholdet i Fælles stamkort er defineret i CDA profilen: Personal Data Card (PDC-DK) [version 2.0] og [version 3.0].
Update 10/10-2022: MedCom har opdateret Errata, hvori der er enkelte præciseringer samt rettelser af fejl i forhold til PDC-DK 2.0., Errata'en kan hentes på MedCom's hjemmeside, og er gældende sammen med PDC-DK 2.0 profilen.
Bemærk for version 3.0, vil errata fremadrettet blive indarbejdet i et "build" versionsnummer, eksempelvis til version 3.0.1. Build versionsnumre er præciseringer og rettelser der ikke ændrer på snitfladerne.
Indholdet er struktureret således at generelt stamdata om patienten er en del af den generiske CDA header, som beskriver alle typer af CDA dokumenter. Den generiske CDA header er beskrevet i dokumentet: HL7 Implementation Guide for CDA Release 2.0 CDA Header (DK CDA Header)3.
Body delen af dokumentet component.structuredBody indeholder staminformation om patienten, der enten er taget fra registre eller tastet ind manuelt.
Nedenstående tabel giver et indblik i hvilket indhold der findes i Fælles Stamkort, samt hvad der er kilden.
Fælles Stamkort CDA dokumenter er alle udstedt af Sundhedsdatastyrelsen via SOR enheden: "Fælles Stamkort udstedelse" med SOR-ID: "1126211000016009"
Teknisk implementering
Afsnittet indeholder tekniske vejledninger til hvordan Fælles Stamkort kan integrereres i lokale fagsystemer og patient/borgerportaler.
Fagsystemer og borgerportaler der skal benytte Fælles Stamkort, skal godkendes og certificeres af MedCom. Testprotokollerne for certificering til Fælles Stamkort, hvor version 1.3 er gældende for modtagelse, kan findes på MedCom's hjemmeside under: Testprotokoller for modtagelse af Fælles Stamkort
Bemærk: Testprotokollerne er under opdaterering til Fælles Stamkort version 3
Yderligere information om om hvordan CDA dokumenter er opbygget kan findes hos IHE, under: IHE - Hvad er HL7 CDA?
Indhold i Fælles Stamkort
Indholdet i Fælles stamkort er defineret i CDA profilen: Personal Data Card (PDC-DK) [version 2.0] og [version 3.0].
Update 10/10-2022: MedCom har opdateret Errata, hvori der er enkelte præciseringer samt rettelser af fejl i forhold til PDC-DK 2.0., Errata'en kan hentes på MedCom's hjemmeside, og er gældende sammen med PDC-DK 2.0 profilen.
Bemærk for version 3.0, vil errata fremadrettet blive indarbejdet i et "build" versionsnummer, eksempelvis til version 3.0.1. Build versionsnumre er præciseringer og rettelser der ikke ændrer på snitfladerne.
Indholdet er struktureret således at generelt stamdata om patienten er en del af den generiske CDA header, som beskriver alle typer af CDA dokumenter. Den generiske CDA header er beskrevet i dokumentet: HL7 Implementation Guide for CDA Release 2.0 CDA Header (DK CDA Header)3.
Body delen af dokumentet component.structuredBody indeholder staminformation om patienten, der enten er taget fra registre eller tastet ind manuelt.
Nedenstående tabel giver et indblik i hvilket indhold der findes i Fælles Stamkort, samt hvad der er kilden.
Fælles Stamkort CDA dokumenter er alle udstedt af Sundhedsdatastyrelsen via SOR enheden: "Fælles Stamkort udstedelse" med SOR-ID: "1126211000016009"
Kode | Beskrivelse | Eksempel | Kilde | ||||||
Patientens CPR-nummer er en del af den generiske CDA header recordTarget.patientRole.id | Patientens CPR-nummer Patientens CPR-nummer er en del af den generiske CDA Header. | <id assigningAuthorityName="CPR" extension="2512489996" root="1.2.208.176.1.2"/> | CPR – register | ||||||
Patientens navn og adresse er en del af den generiske CDA header recordTarget.patientRole.addr | Patientens navn og adresse Patientens navn og adresse er en del af den generiske CDA Header. | <addr use="H"> Bemærk at har patienten navne eller adressebeskyttelse vises "BESKYTTET NAVN/ADRESSE" | CPR - register | ||||||
Information om patientens pårørende component.structuredBody. templateId code | Oplysninger om patientens pårørende, som patienten selv har angivet. Oplysningerne er: · Pårørendes Navn · Pårørendes Relation · Pårørendes Telefonnummer · Fritekstfelt, hvor der f.eks. kan angives "bor i Canada" Bemærk der kan kun angives flere observation med patientens pårørende Validering: Telefonnumre valideres i forhold til om de overholder formatet
| <templateId root="1.2.208.184.16.1.10.20.1.25" extension="2019-08-14"/> | |||||||
Kode | Beskrivelse | Eksempel | Kilde | ||||||
Patientens CPR-nummer er en del af den generiske CDA header recordTarget.patientRole.id | Patientens CPR-nummer Patientens CPR-nummer er en del af den generiske CDA Header. | <id assigningAuthorityName="CPR" extension="2512489996" root="1.2.208.176.1.2"/> | CPR – register | ||||||
Patientens navn og adresse er en del af den generiske CDA header recordTarget.patientRole.addr | Patientens navn og adresse Patientens navn og adresse er en del af den generiske CDA Header. | <addr use="H"> Bemærk at har patienten navne eller adressebeskyttelse vises "BESKYTTET NAVN/ADRESSE" | CPR - register | ||||||
Information om patientens pårørende component.structuredBody. templateId code | Oplysninger om patientens pårørende, som patienten selv har angivet. Oplysningerne er: · Pårørendes Navn · Pårørendes Relation · Pårørendes Telefonnummer · Fritekstfelt, hvor der f.eks. kan angives "bor i Canada" Bemærk der kan kun angives flere observation med patientens pårørende Validering: Telefonnumre valideres i forhold til om de overholder formatet
<templateId root="1.2.208.184.16.1.10.20.1.25" extension="2019-08-14100.2" codeSystemName="MedCom Relation Codes" displayName="Nabo"/> Bemærk: Der tilføjes ikke automatisk pårørende angivet i CPR-registeret (f.eks. værger og ægtefæller) - eneste undtagelse herfor er børn under forældremyndighed, eller personer som har forældremyndighed over et barn (se næste række) | Indtastet information fra stamkortregisteret | |||||||
Patientens børn under forældremyndighed component.structuredBody. templateId code
| Hvis patienten har forældremyndighed over et eller flere børn, kan børnene vises i Fælles Stamkort. Bemærk: Hvis patienten er biologisk forælder, men ikke har forældremyndigheden over barnet, vises barnet ikke i Fælles Stamkort. Bemærk: Hvis patienten er værge for et barn, men ikke har forældremyndigheden over det pågældende barn, vises barnet ikke i Fælles Stamkort. Bemærk: Der kan kun angives flere observationer med patientens børn under forældremyndighed. | <templateId root="1.2.208.184.16.1.10.20.1.23" extension="2019-08-14"/> <!-- The Relative's relation to the Value representing the name of the child of whom the patient has custody --> <!-- Value representing the relationship the patient has to the child of whom the patient have custody → patient --> Bemærk: Der tilføjes ikke automatisk pårørende angivet i CPR-registeret (f.eks. værger og ægtefæller) - eneste undtagelse herfor er børn under forældremyndighed, eller personer som har forældremyndighed over et barn (se næste række) | Indtastet information fra stamkortregisteret | CPR - register | |||||
Patientens forældremyndighedshavere component Patientens børn under forældremyndighed component.structuredBody. templateId code
| Hvis patienten har forældremyndighed over et eller flere børner et barn, kan børnene forældremyndighedshavere vises i Fælles Stamkort. Bemærk: Hvis patienten er biologisk forælder, men barnet har biologiske forældre som ikke har forældremyndigheden over barnet, vises barnet de biologiske forældre ikke i Fælles Stamkort. Bemærk: Hvis patienten barnet er myndling under en værge for et barn, men værgen ikke har forældremyndigheden over det pågældende barn, vises barnet værgen ikke i Fælles Stamkort. Bemærk: Der kan kun angives flere observationer med patientens børn under forældremyndighedbarnets forældremyndighedshavere. | <templateId root="1.2.208.184.16.1.10.20.1.23" extension="2019-08-14"/> <!-- Value representing the name of the child Custodian of whom the patient has is in custody --> <!-- Value representing the relationship the patient has to the child custodian of whom the patient have is in custody → | CPR - register | ||||||
Patientens forældremyndighedshaveretelefonnummer component.structuredBody. templateId code
| Hvis patienten er et barn, kan forældremyndighedshavere vises i Fælles Stamkort. Bemærk: Hvis barnet har biologiske forældre som ikke har forældremyndigheden over barnet, vises de biologiske forældre ikke i Fælles Stamkort. Bemærk: Hvis barnet er myndling under en værge, men værgen ikke har forældremyndigheden over det pågældende barn, vises værgen ikke i Fælles Stamkort. Bemærk: Der kan kun angives flere observationer med barnets forældremyndighedshavere. | Patientens kontakt telefonnummer (3 telefonnumre kan angives (hjemme "H", mobil "MC", arbejde "WP"). Bemærk: Der kan kun angives en observation med patientens telefonnumre. | <templateId root=”1<templateId root="1.2.208.184.16.1.10.20.1.23" 24” extension="”2019-08-14"”/> <given>Søren</given> <given>Severin</given <family>Knudsen</family> </value><!-- Value representing the relationship the patient has to the custodian of whom the patient is in custody → ”TEL” use=”H” value=”tel:11223344”/> <value xsi:type="CD" code="barn" codeSystem="1.2.208.184.100.2" codeSystemName="MedCom Relation Codes" displayName="Barn"/>”TEL” use=”WP” value=”tel:33112244”/> <value xsi:type=”TEL” use=”MC” value=”tel:66774433”/> | Indtastet information fra stamkortregisteret | |||||
Patientens midlertidige adresse | CPR - register | Patientens telefonnummer component.structuredBody. templateId code | Patientens kontakt telefonnummer (3 telefonnumre kan angives (hjemme "H", mobil "MC", arbejde "WP")midlertidige adresse inklusiv et tidsinterval for hvornår patienten befinder sig på den midlertidige adresse. Bemærk: Det er ikke nødvendigt at angive et sluttidspunkt (effectivetime.high) for den midlertidige adresse. Bemærk: Er slutdatoen overskredet på forespørgselstidspunktet, returneres den midlertidige adresse ikke fra Fælles Stamkort. Bemærk: Der kan kun angives en observation med patientens telefonnumremidlertidige adresse. | <templateId root=”"1.2.208.184.16.1.10.20.1.24” 21" extension=”"2019-08-14”"/> <value xsi:type=”TEL” use=”WP” value=”tel:33112244”/> <value xsi:type=”TEL” use=”MC” value=”tel:66774433”/> displayName="Midlertidig adresse, indtastet"/> | Indtastet information fra stamkortregisteret | ||||
Patientens midlertidige adresseegen læge componentrecordtarget.structuredBodypatientRole. | Kontaktoplysninger til patientens egen læge. Bemærk: Det er ikke alle patienter der har tilknyttet en læge - elementet er derfor optionelt. | <providerOrganization> <id extension="123456" root="1.2.208.184176.16.1.10.20.1.21" extension="2019-08-14" code <name>Lægerne Hansen</name> <telecom use="WP" value="tel:+4512345678"/> <telecom value="mailto:test@testyder.dk"/> <addr use="H"> <streetAddressLine>Ydervej 42</streetAddressLine <postalCode>1234</postalCode> <city>Yderby</city> </addr> </providerOrganization> | Yderregisteret | ||||||
Patientens tandlæge component.structuredBody. templateId | Patientens midlertidige adresse inklusiv et tidsinterval for hvornår patienten befinder sig på den midlertidige adresse. Bemærk: Det er ikke nødvendigt at angive et sluttidspunkt (effectivetime.high) for den midlertidige adresse. Bemærk: Er slutdatoen overskredet på forespørgselstidspunktet, returneres den midlertidige adresse ikke fra Fælles Stamkort. Bemærk: Der kan kun angives en observation med patientens midlertidige adresse. | <templateId root="1.2.208.184.16.1.10.20.1.2122" extension code | Hvis patienten har tilknyttet en tandlæge, kan Fælles Stamkort indeholde kontaktoplysninger til tandlægen. Patienten skal selv angive tandlægen, Fælles Stamkort vil efterfølgende hente kontaktoplysninger på patientens tandlæge fra Yderregisteret. | <templateId root"/> | Indtastet information fra stamkortregisteret | Patientens egen læge recordtarget.patientRole. | Kontaktoplysninger til patientens egen læge. Bemærk: Det er ikke alle patienter der har tilknyttet en læge - elementet er derfor optionelt. | <providerOrganization> <id extension="123456" root="1.2.208.176.1.4" assigningAuthorityName="Yderregisteret"/ <name>Lægerne Hansen</name> <telecom <country>DentistcountryTypedIn</country> <telecom value="mailto:test@testyder.dk 01234567" xsi:type="TEL"/> <addr use="H"><streetAddressLine>Ydervej 42</streetAddressLine <postalCode>1234</postalCode> <city>Yderby</city> </addr> </providerOrganization> | Yder id på tandlægen er indtastet i stamkortregisteret, Ved opslag, hentes seneste information om tandlægen fra yderregisteret. Der returneres ikke personnavne på tandlæger, kun kliniknavne. Der kan dog være kliniknavne som indeholder tandlægens personnavn. |
Sygesikringsgruppe | Yderregisteret | Patientens tandlæge component.structuredBody. templateId code | Patientens sygesikringsgruppe. | <templateId root="1.2.208.184 Hvis patienten har tilknyttet en tandlæge, kan Fælles Stamkort indeholde kontaktoplysninger til tandlægen. Patienten skal selv angive tandlægen, Fælles Stamkort vil efterfølgende hente kontaktoplysninger på patientens tandlæge fra Yderregisteret. | Yder id på tandlægen er indtastet i stamkortregisteret, Ved opslag, hentes seneste information om tandlægen fra yderregisteret. Der returneres ikke personnavne på tandlæger, kun kliniknavne. Der kan dog være kliniknavne som indeholder tandlægens personnavn. | Sygesikringsregisteret | |||
Patientens foretrukne kommunikationssprog. component.structuredBody. templateId Sygesikringsgruppe component.structuredBody. templateId code Patientens sygesikringsgruppe. | Patienten kan registrere hvilket sprog de foretrækker at kommunikere på. Er feltet ikke forudfyldt, kan det antages at sproget er ”Dansk”. Bemærk: Der kan kun registreres et sprog pr. patient. | <templateId root="1.2.208.184.16.1.10.20.1.2720" extension="2019-08-14"/> | Indtastet information fra stamkortregisteret | ||||||
Behandlingstestamente | Sygesikringsregisteret | Patientens foretrukne kommunikationssprog. component.structuredBody. templateId code | Information om patienten har registreret et Behandlingstestamente kan vises i Fælles Stamkort. Fælles Stamkort må IKKE vise indholdet i registreringen, kun OM der lavet en registrering. Bemærk: En patient kan have registreret enten et Behandlingstestamente eller et Livstestamente, ikke begge testamenter på samme tid Patienten kan registrere hvilket sprog de foretrækker at kommunikere på. Er feltet ikke forudfyldt, kan det antages at sproget er ”Dansk”. Bemærk: Der kan kun registreres et sprog pr. patient. | <templateId root="1.2.208.184.16.1.10.20.1.2029" extension="2019-08-14"/> | Indtastet information fra stamkortregisteret | Behandlingstestamenteregister | |||
LivstestamenteBehandlingstestamente component.structuredBody. templateId code | Information om patienten har registreret et Behandlingstestamente Livstestamente kan vises i Fælles Stamkort. Fælles Stamkort må IKKE vise indholdet i registreringen, kun OM der lavet en registrering. Bemærk: En patient kan have registreret enten et Behandlingstestamente eller et Livstestamente, ikke begge testamenter på samme tid. | <templateId root="1.2.208.184.16.1.10.20.1.2930" extension="2019-08-14"/> | Livstestamenteregister | ||||||
LivstestamenteOrgandonorregistrering component.structuredBody. templateId code | Information om patienten har registreret et Livstestamente en Organdonorregistrering kan vises i Fælles Stamkort. Fælles Stamkort må IKKE vise indholdet i registreringen, kun OM der lavet en registrering. Bemærk: En patient kan have registreret enten et Behandlingstestamente eller et Livstestamente, ikke begge testamenter på samme tid. | <templateId root="1.2.208.184.16.1.10.20.1.3028" extension="2019-08-14"/> <id extension="7d2a50a0bf5b7087-dbf9b8dd-443c41f3-875991c8-3574bed1dd1bd2e0a8955c3a" root="1.2.208.184"/> <code code="LivingWillRegistrationOrganDonorRegistration" codeSystem="1.2.208.184.100.1" codeSystemName="MedCom Message Codes" displayName="Registreret livstestamenteorgandonor"/> <value xsi:type="II" root="1.2.208.176.1.810" extension="true" assigningAuthorityName="SundhedsdatastyrelsenDansk Center For Organdonation"/> | Livstestamenteregister | Organdonorregisteret | |||||
Fravalg af genoplivningsforsøg v. hjertestopOrgandonorregistrering component.structuredBody. templateId code Information om patienten har en Organdonorregistrering kan vises i Fælles Stamkort. Fælles Stamkort må IKKE vise indholdet i registreringen, kun OM der lavet en registrering. | Bemærk: Gælder udelukkende for Fælles Stamkort version 3 Bemærk: At visse typer fagsystemer kan begrænse visning til udelukkende fravalgsoplysningen, jvf. Fælles Stamkort, forretningsregel #17 Værdien (value) kan antage følgende værdier: “true” = Borgeren har et aktivt fravalg til genoplivningsforsøg v. hjertestop registreret “false” = Borgeren har ikke registreret, eller har ikke et aktivt fravalg til genoplivningsforsøg v. hjertestop registreret
| <templateId root="1.2.208.184.16.1<templateId root="1.2.208.184.16.1.10.20.1.2831" extension="20192023-0807-1401"/> <id extension="bf5b7087d90df5cb-b8dd602c-41f344d5-91c88cc6-d2e0a8955c3a9fb7ed9b8df9" root="1.2.208.184"/> <code code="OrganDonorRegistrationNoResuscitationRegistration" codeSystem="1.2.208.184.100.1" codeSystemName="MedCom Message Codes" displayName="Registreret organdonorfravalg af genoplivningsforsøg v. hjertestop"/> <value xsi:type="II" root="1.2.208.176.1.1011" extension="true" assigningAuthorityName="Dansk Center For OrgandonationSundhedsdatastyrelsen"/> | Organdonorregisteret | Fravalg Registrer til fravalg af genoplivningsforsøg v. hjertestop component.structuredBody. templateId code Bemærk: Gælder udelukkende for Fælles Stamkort version 3 Bemærk: At visse typer fagsystemer kan begrænse visning til udelukkende fravalgsoplysningen, jvf. Fælles Stamkort, forretningsregel #17 Værdien (value) kan antage følgende værdier: “true” = Borgeren har et aktivt fravalg til genoplivningsforsøg v. hjertestop registreret “false” = Borgeren har ikke registreret, eller har ikke et aktivt fravalg til genoplivningsforsøg v. hjertestop registreret Bemærk: Indtil fravalgsregisteret bliver åbnet for borgerregistrering pr. 15/1-2025, vil der blive returneret “false” som der ikke er et aktivt fravalg til genoplivningsforsøg v. hjertestop registreret. Derved undgås misforståelser i forhold til beskrivelse og eksempel i afsnit 5.7 regel:CONF-DK:507 fra CDA standarden Release 3.0.0 fra 1. Juli 2023.Efter 15/1-2025, vil der blive returneret en fejlmeddelelsese jvf. XDS-protokollen. I tilfælde af at indhold i fravalgsregisteret er utilgængeligt. | <templateId root="1.2.208.184.16.1.10.20.1.31" extension="2023-07-01"/> <id extension="d90df5cb-602c-44d5-8cc6-9fb7ed9b8df9" root="1.2.208.184"/> <code code="NoResuscitationRegistration" codeSystem="1.2.208.184.100.1" codeSystemName="MedCom Message Codes" displayName="Registreret fravalg af genoplivningsforsøg v. hjertestop"/> <value xsi:type="II" root="1.2.208.176.1.11" extension="true" assigningAuthorityName="Sundhedsdatastyrelsen"/> | Registrer til fravalg af genoplivningsforsøg v. hjertestop |
3 http://svn.medcom.dk/svn/releases/Standarder/HL7/CDA-Header/
Tekniske forudsætninger
Se Administrative forudsætninger for at få adgang til NSP'en.
Fælles stamkort udstilles via services på NSP'en, disse skal tilgås gennem en afkoblingskomponent "DCC'en" DCC'en viderestiller kald til underliggende services, så der er ikke en WSDL for DCC'en. Se DCC Dokumentation for adgang til servies gennem DCC'en.
NSP services kan tilgås enten via Den Gode Webservice eller via OIO-IDWS (Udelukkende patient adgang).
Den Gode WebService benytter XMLDSIG til at signere SAML assertions ud fra X.509 certifikater/nøgler. For mere information om den gode webservice, se: https://www.medcom.dk/standarder/webservice-standarder/den-gode-webservice
Til at understøtte SAML har Sundhedsdatastyrelsen udviklet biblioteker til Java og .NET (SEAL biblioteket) Dette bør benyttes så vidt det er muligt, se STS Guide til anvendere
Søgning på Fælles Stamkort
For at søge på en patients Fælles Stamkort, skal der laves en ITI-18 forespørgsel via NSP'ens dokumentdelingsservice, eller via systemkaldskomponenten SFSK. Det er samme forespørgsel bare foretaget på forskellige endpoints.
WSDL til DDS Registry findes her: https://wsdl.nspop.dk/ddsregistry?wsdl
Når der søges på et stamkort, kan der søges på de værdier der er angivet i dokument metadata. Fælles Stamkort benytter MedCom's metadata profil version 0.96, der kan hentes på https://svn.medcom.dk/svn/releases/Standarder/IHE/DK_profil_metadata/
Typisk angives patientens kun CPR nummer, samt en typecode - For Fælles Stamkort er typecode "PDC", og da Fælles Stamkort er en on-demand dokumenttype angives dette også. Se følgende eksempel.
For forløbsplaner, er der desuden følgende forretningsmæssige XDS-metdata, som skal anvendes i søgninger:
- Typecode: PDC
Når der forespørges på Fælles Stamkort, laves et opslag til underliggende registre, derfor forespørged der altid på dynamiske (on-demand) dokumentkilder, angives denne værdi ikke, returneres kun data fra statiske dokumentkilder.
- Type: urn:uuid:34268e47-fdf5-41a6-ba33-82133c465248 (for dynamiske "on-demand" dokumentkilder)
Fælles stamkort udstilles i en overgang i flere formater (version 2.0 og version 3.0) - angives formatkoden ikke, returneres begge versioner.
- FormatCode:
- urn:ad:dk:medcom:pdc-v2.0:full (Fælles stamkort version 2.0)
- urn:ad:dk:medcom:pdc-v3.0:full (Fælles stamkort version 3.0)
Værdierne (klassifikationerne) som anvendes i XDS-metadata er defineret i et regneark hos MedCom, se: DK-IHE_Metadata-Common_Code_systems-Value_sets.xlsx
hjertestop |
3 http://svn.medcom.dk/svn/releases/Standarder/HL7/CDA-Header/
Tekniske forudsætninger
Se Administrative forudsætninger for tilslutning for at få adgang til NSP'en.
Fælles stamkort udstilles via services på NSP'en, disse skal tilgås gennem en afkoblingskomponent "DCC'en" DCC'en viderestiller kald til underliggende services, så der er ikke en WSDL for DCC'en. Se DCC Dokumentation for adgang til servies gennem DCC'en.
NSP services kan tilgås enten via Den Gode Webservice eller via OIO-IDWS (Udelukkende patient adgang).
Den Gode WebService benytter XMLDSIG til at signere SAML assertions ud fra X.509 certifikater/nøgler. For mere information om den gode webservice, se: https://www.medcom.dk/standarder/webservice-standarder/den-gode-webservice
Til at understøtte SAML har Sundhedsdatastyrelsen udviklet biblioteker til Java og .NET (SEAL biblioteket) Dette bør benyttes så vidt det er muligt, se STS Guide til anvendere
Søgning på Fælles Stamkort
For at søge på en patients Fælles Stamkort, skal der laves en ITI-18 forespørgsel via NSP'ens dokumentdelingsservice, eller via systemkaldskomponenten SFSK. Det er samme forespørgsel bare foretaget på forskellige endpoints.
WSDL til DDS Registry findes her: https://wsdl.nspop.dk/ddsregistry?wsdl
Når der søges på et stamkort, kan der søges på de værdier der er angivet i dokument metadata. Fælles Stamkort benytter MedCom's metadata profil version 0.96, der kan hentes på https://svn.medcom.dk/svn/releases/Standarder/IHE/DK_profil_metadata/
Typisk angives patientens kun CPR nummer, samt en typecode - For Fælles Stamkort er typecode "PDC", og da Fælles Stamkort er en on-demand dokumenttype angives dette også. Se følgende eksempel.
For forløbsplaner, er der desuden følgende forretningsmæssige XDS-metdata, som skal anvendes i søgninger:
- Typecode: PDC
Når der forespørges på Fælles Stamkort, laves et opslag til underliggende registre, derfor forespørged der altid på dynamiske (on-demand) dokumentkilder, angives denne værdi ikke, returneres kun data fra statiske dokumentkilder.
- Type: urn:uuid:34268e47-fdf5-41a6-ba33-82133c465248 (for dynamiske "on-demand" dokumentkilder)
Fælles stamkort udstilles i en overgang i flere formater (version 2.0 og version 3.0) - angives formatkoden ikke, returneres begge versioner.
- FormatCode:
- urn:ad:dk:medcom:pdc-v2.0:full (Fælles stamkort version 2.0)
- urn:ad:dk:medcom:pdc-v3.0:full (Fælles stamkort version 3.0)
Værdierne (klassifikationerne) som anvendes i XDS-metadata er defineret i et regneark hos MedCom, se: DK-IHE_Metadata-Common_Code_systems-Value_sets.xlsx
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<AdhocQueryRequest xmlns="urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0">
<ResponseOption returnType="LeafClass" returnComposedObjects="true"/>
<AdhocQuery xmlns="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" id="urn:uuid:14d4debf-8f97-4251-9a74-a90016b0af0d">
<Slot name="$XDSDocumentEntryPatientId">
<ValueList>
<Value>'2512489996^^^&1.2.208.176.1.2&ISO'</Value>
</ValueList>
</Slot>
<Slot name="$XDSDocumentEntryFormatCode">
<ValueList>
<Value>('urn:ad:dk:medcom:pdc-v3.0:full^^1.2.208.184.100.10')</Value>
</ValueList>
</Slot>
<Slot name="$XDSDocumentEntryTypeCode">
<ValueList>
<Value>('PDC^^1.2.208.184.100.1')</Value>
</ValueList>
</Slot> | ||||||
Code Block | ||||||
| ||||||
<AdhocQueryRequest xmlns="urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0"> <ResponseOption returnType="LeafClass" returnComposedObjects="true"/> <AdhocQuery xmlns="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" id="urn:uuid:14d4debf-8f97-4251-9a74-a90016b0af0d"> <Slot name="$XDSDocumentEntryPatientId$XDSDocumentEntryType"> <ValueList> <Value>'2512489996^^^&1.2.208.176.1.2&ISO'('urn:uuid:34268e47-fdf5-41a6-ba33-82133c465248')</Value> </ValueList> </Slot> <Slot name="$XDSDocumentEntryFormatCode$XDSDocumentEntryStatus"> <ValueList> <Value>('urn:adoasis:dknames:medcomtc:pdc-v3.0:full^^1.2.208.184.100.10ebxml-regrep:StatusType:Approved')</Value> </ValueList> </Slot> <Slot name="$XDSDocumentEntryTypeCode"> <ValueList> <Value>('PDC^^1.2.208.184.100.1')</Value></AdhocQuery> </ValueList> </Slot> <Slot name="$XDSDocumentEntryType"> <ValueList> <Value>('urn:uuid:34268e47-fdf5-41a6-ba33-82133c465248')</Value> </ValueList> </Slot> <Slot name="$XDSDocumentEntryStatus"> <ValueList> <Value>('</AdhocQueryRequest> |
Svaret indeholder referencen til Fælles Stamkort dokumentet, der skal benyttes efterfølgende til at udtrække selve Fælles Stamkort dokumenter
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<ns3:AdhocQueryResponse xmlns="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" xmlns:ns2="urn:oasis:names:tc:ebxml-regrep:xsd:rs:3.0" xmlns:ns3="urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0" xmlns:ns4="urn:oasis:names:tc:ebxml-regrep:xsd:cms:3.0" xmlns:ns5="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved')</Value> </ValueList> </Slot> </AdhocQuery> </AdhocQueryRequest> |
Svaret indeholder referencen til Fælles Stamkort dokumentet, der skal benyttes efterfølgende til at udtrække selve Fælles Stamkort dokumenter
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<ns3:AdhocQueryResponse xmlns:xsd:lcm:3.0" xmlns:ns6="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns7="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3SAML:2.0" xmlns:ns2="urn:oasis:names:tc:ebxml-regrep:xsd:rs:3.0:assertion" xmlns:ns3ns8="urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0" xmlns:ns4="urn:oasis:names:tc:ebxml-regrep:xsd:cms:3.0" xmlns:ns5="urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0" xmlns:ns6http://www.w3.org/2000/09/xmldsig#" xmlns:ns9="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:ns7="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ns8="http://www.w3.org/2000/09/xmldsig#" xmlns:ns9="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:ns10="http://www.medcom.dk/dgws/2006/04/dgws-1.0.xsd" xmlns:ns11="http://www.nsi.dk/hsuid/2016/08/hsuid-1.1.xsd" totalResultCount="1" status="urn:oasis:names:tc:ebxml-regrep:ResponseStatusType:Success"> <RegistryObjectList> <ExtrinsicObject mimeType="text/xml" objectType="urn:uuid:34268e47-fdf5-41a6-ba33-82133c465248" status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved" id="1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff" home="1.2.208.176.8.1.12"> <Slot name="creationTime"> <ValueList> <Value>20240125090207</Value> </ValueList> </Slot> <Slot name="languageCode"> <ValueList> <Value>da-DK</Value> </ValueList> </Slot> <Slot name="repositoryUniqueId"> <ValueList> <Value>1.2.208.176.43210.8.20.12</Value> </ValueList> </Slot> <Slot name="sourcePatientId"> <ValueList> <Value>2708599967^^^&1.2.208.176.1.2&ISO</Value> </ValueList> </Slot> <Name> <LocalizedString xml:lang="en-US" charset="UTF-8" value="Fælles stamkort"/> </Name> <Classification classificationScheme="urn:uuid:93606bcf-9494-43ec-9b4e-a7748d1a838d" classifiedObject="1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff" nodeRepresentation="" id="urn:uuid:8519e993-c2eb-441e-8d05-b474181718e7"> <Slot name="authorInstitution"> <ValueList> <Value>Fælles Stamkort udstedelse^^^^^&1.2.208.176.1.1&ISO^^^^1126211000016009</Value> </ValueList> </Slot> </Classification> <Classification classificationScheme="urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a" classifiedObject="1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff" nodeRepresentation="001" id="urn:uuid:5f794583-a64d-484c-9642-a69363ffcb0b"> <Slot name="codingScheme"> <ValueList> <Value>1.2.208.184.100.9</Value> </ValueList> </Slot> <Name> <LocalizedString xml:lang="en-US" charset="UTF-8" value="Klinisk rapport"/> </Name> </Classification> <Classification classificationScheme="urn:uuid:a09d5840-386c-46f2-b5ad-9c3699a4309d" classifiedObject="1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff" nodeRepresentation="urn:ad:dk:medcom:pdc-v2.0:full" id="urn:uuid:7b3aecee-6e15-4944-a511-8e5822b92536"> <Slot name="codingScheme"> <ValueList> <Value>1.2.208.184.100.10</Value> </ValueList> </Slot> <Name> <LocalizedString xml:lang="en-US" charset="UTF-8" value="DK PDC schema"/> </Name> </Classification> <Classification classificationScheme="urn:uuid:f33fb8ac-18af-42cc-ae0e-ed0b0bdb91e1" classifiedObject="1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff" nodeRepresentation="554041000005106" id="urn:uuid:8a6b8eb1-6fd5-45a7-9e52-0ac8dbfa4ddd"> <Slot name="codingScheme"> <ValueList> <Value>2.16.840.1.113883.6.96</Value> </ValueList> </Slot> <Name> <LocalizedString xml:lang="en-US" charset="UTF-8" value="sundhedsforvaltning"/> </Name> </Classification> <Classification classificationScheme="urn:uuid:cccf5598-8b07-4b77-a05e-ae952c785ead" classifiedObject="1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff" nodeRepresentation="408443003" id="urn:uuid:d6f3da90-aea3-4230-8137-538e34e6bb39"> <Slot name="codingScheme"> <ValueList> <Value>2.16.840.1.113883.6.96</Value> </ValueList> </Slot> <Name> <LocalizedString xml:lang="en-US" charset="UTF-8" value="almen medicin"/> </Name> </Classification> <Classification classificationScheme="urn:uuid:f0306f51-975f-434e-a61c-c59651d33983" classifiedObject="1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff" nodeRepresentation="PDC" id="urn:uuid:ad6e5960-7481-41c0-9e73-a0859eb336f3"> <Slot name="codingScheme"> <ValueList> <Value>1.2.208.184.100.1</Value> </ValueList> </Slot> <Name> <LocalizedString xml:lang="en-US" charset="UTF-8" value="Stamkort"/> </Name> </Classification> <Classification classificationScheme="urn:uuid:f4f85eac-e6cb-4883-b524-f2705394840f" classifiedObject="1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff" nodeRepresentation="N" id="urn:uuid:6c343c23-cb63-466d-a3f8-ba34be3128d5"> <Slot name="codingScheme"> <ValueList> <Value>2.16.840.1.113883.5.25</Value> </ValueList> </Slot> <Name> <LocalizedString xml:lang="en-US" charset="UTF-8" value="normal"/> </Name> </Classification> <ExternalIdentifier registryObject="1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff" identificationScheme="urn:uuid:58a6f841-87b3-4a3e-92fd-a8ffeff98427" value="2708599967^^^&1.2.208.176.1.2&ISO" id="urn:uuid:9fe7321b-2796-4954-be43-c1f52f1eae1d"> <Name> <LocalizedString value="XDSDocumentEntry.patientId"/> </Name> </ExternalIdentifier> <ExternalIdentifier registryObject="1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff" identificationScheme="urn:uuid:2e82c1f6-a085-4c72-9da3-8640a32e42ab" value="1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff" id="urn:uuid:f0572561-ae53-48c6-b223-f4559b5d3530"> <Name> <LocalizedString value="XDSDocumentEntry.uniqueId"/> </Name> </ExternalIdentifier> </ExtrinsicObject> </RegistryObjectList> </ns3:AdhocQueryResponse> |
...
Yderligere information omkring forespørgsler via dokumentdeling kan ses i Brugervejledning til forespørgsler via DDS
Hentning af Fælles Stamkort
For at hente en patients Fælles Stamkort, skal der laves en ITI-43 forespørgsel via NSP'ens dokumentdelingsservice.
...
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<RetrieveDocumentSetRequest xmlns="urn:ihe:iti:xds-b:2007"> <DocumentRequest> <HomeCommunityId>1.2.208.176.8.1.12</HomeCommunityId> <RepositoryUniqueId>1.2.208.176.43210.8.20.12</RepositoryUniqueId> <DocumentUniqueId>1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff</DocumentUniqueId> </DocumentRequest> </RetrieveDocumentSetRequest> |
Det svar der returneres er patientens Fælles Stamkort, indeholdende de dataelementer der er beskrevet under indhold,
Se bl.a MedCom's testeksempler under http://svn.medcom.dk/svn/releases/Standarder/HL7/PDC/Eksempler/
Opdatering af Fælles Stamkort
Fælles Stamkort læses som beskrevet via dokumentdeling, men opdateres via Stamkort register servicen
WSDL findes under: https://wsdl.nspop.dk/#skr hvor der både er referencer til snitfladen for sundhedspersoner via Den Gode Webservice (DGWS) samt snitfladen for patientadgang via OIO-IDWS.
Den tekniske anvenderguide til Stamkortregisteret giver detaljeret information om dataudvekselingsformater samt XML eksempler på oprettelser, opdateringer og sletninger
Sikkerhed, roller og rettigheder
For adgang til Fælles Stamkort skal der for sundhedspersoner eksistere et gyldigt SOSI-ID kort som er signeret af NSP'ens Secure Token Service, dokumentationen for SoSI-ID kort og STS ligger under: Anvenderguide til STS.
Patientdata portaler skal benytte det fællesoffentlige OIO-IDWS, der er vedligeholdt af Digitaliseringsstyrelsen - dokumentation til OIO-IDWS findes på Digitaliser.dk, STS'en har en omvekslingsservice for OIO-IDWS bootstraptokens til et signeret identitytoken, for adgang til Fælles Stamkort webservicen kald er benyttes et STS signeret identitytoken.
Sundhedspersoner, med en sundhedsfaglig autorisation har adgang til Fælles Stamkort. Sundhedspersoner uden sundhedsfaglig autorisation skal have tilknyttet en rettighed før disse kan få adgang. Lokale organisationer kan enten tilknytte disse rettigheder via Sundhedsstyrelssens Elektroniske Brugerstyring (SEB), eller give rettigheden via den lokale identifikations- og rettighedstyring.
For Fælles stamkort er der 4 forskellige måder for Sundhedspersoner uden sundhedsfaglig autorisation at få adgang til borgerens Fælles Stamkort.
...
Følgende rollebeskrivelser anvendes i forbindelse med Et samlet patientoverblik.
...
Rollenavn
...
Rollebeskrivelse
...
Notation som indsættes i SOSI IdKort ved udstedelse
...
nspSundAssistR1
...
Giver ret til at læse Fælles Stamkort (FSK)
Se detaljeret beskrivelse af alle nationale roller her: Beskrivelse af de nationale roller i produktion - NSP services - Global Site (nspop.dk) samt overordnet dokumentation for SEB her: SEB - Sundhedsvæsenets Elektroniske Brugerstyring - Sundhedsdatastyrelsen Services (nsi.dk)
...
urn:dk:healthcare:national-federation-role:code:41001:value:SundAssistR1
...
nspSundAssistR2
...
Giver ret til at læse Fælles Stamkort (FSK)
Giver også adgang til at læse andre dokumenter, der deles via dokumentdelingsinfrastrukturen jvf. Sundhedslovens §42a stk. 4
Se detaljeret beskrivelse af alle nationale roller her: Beskrivelse af de nationale roller i produktion - NSP services - Global Site (nspop.dk) samt overordnet dokumentation for SEB her: SEB - Sundhedsvæsenets Elektroniske Brugerstyring - Sundhedsdatastyrelsen Services (nsi.dk)
...
urn:dk:healthcare:national-federation-role:code:41002:value:SundAssistR2
En sundhedsperson kan ikke have tilknyttet flere roller på samme tid - dette skal administreres via den lokale identifikations- og rettighedsstyring.
Håndtering af spærring og fuldmagt
Bemærk: Spærring for deling af Fælles Stamkort udgår i forbindelse med Fælles Stamkort version 3.0
Spærring
Patienten kan have spærret for at data fra Fælles Stamkort må deles med andre parter i sundhedssektoren, i det tilfælde vil fejlkoden "Consent Filter Applied” blive returneret (se nedenstående xml eksempel for ITI-18 spærrede dokumenter). Det betyder at patienten har spærret for deling af Fælles Stamkort til en specifik sundhedsperson, eller at spærringen er lavet specifikt mod deling af Fælles Stamkort (via SOR-id: 1126211000016009). Klienten skal håndtere at der er angivet en spærring, og give sundhedspersonen mulighed for at få adgang til Fælles Stamkort under specielle vilkår.
For adgang til det spærrede Fælles Stamkort kan klienten enten angive et værdispring, eller angive at der ligger et explicit samtykke til at se data, og så sende forespørgslen igen med “ConsentOverride” flaget sat til “True”. Der laves logning i dokumentdelingsinfrastrukturen der angiver at en spærring er tilsidesat. Klienten skal samtidig angive årsagen (Eksempelvis: eksplicit samtykke fra patienten for at få adgang til data) til at spærringen er tilsidesat i eget journalsystem, da der kan forventes at være opfølgning på tilsidesatte spærringer.
Yderligere teknisk information omkring spærring og forespørgsler via dokumentdeling kan ses i Brugervejledning til forespørgsler via DDS
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
<rs:RegistryError codeContext="urn:dk:nsi:Consent Filter Applied" errorCode="XDSRegistryError" severity="urn:oasis:names:tc:ebxml-regrep:ErrorSeverityType:Error"/> |
Adviseringer på borgerens spærring
Har en borger spærret for deling af Fælles Stamkort, og benytter løsningen for system-system kald, som beskrevet i afsnit 3.5 - System kald ved læsning af Fælles Stamkort, vil fagsystemet have et behov for at blive adviseret hvis borgeren ændrer sine spærringer.
Fagsystemerne bør implementere en adviseringskomponent, der håndterer at fagsystemet kan lytte på adviseringer fra MinSpærring (Samtykkeservicen)
Den tekniske dokumentation i forhold til brugen af endpoints til NAS, er beskrevet i NAS-2 Anvenderguide
Topic
Navn til Topic for ændringer til MinSpærring (samtykkeservicen) er:
...
Beskedformat
Beskedformat for ændringer i MinSpærring (samtykkeservicen), er pakket ind i NAS'ens generelle beskedformat (Markeret med blåt)
Indholdet i notifikationen er neutralt, idet der ikke må inkluderes hvad ændringen omhandler. Følgende værdier ligger i adviseringen
- id: Patientens CPR nummer
- date: Dato for hvornår ændringen er sket
- version: Versionsnummer for beskeddefinitionen.
...
<NotificationMessage>
<TopicDialect="http://docs.oasis-open.org/wsn/t-1/TopicExpression/Simple">MinSpærring Topic</Topic>
<Message>
<NotifyContent id="Borgerens CPR nummer" idType="http://nsi.dk/advis/v10/CPR">
<ConsentUpdated xmlns:ns14="http://nsp.dk/consent/2021/04/12">
<date value="2021-04-21"/>
<version value="1"/>
</ConsentUpdated>
</NotifyContent>
</Message>
</NotificationMessage>
12</RepositoryUniqueId>
<DocumentUniqueId>1.2.208.176.43210.8.20.12^9a6d387b-db0f-4075-aeb3-63a5ad45f3ff</DocumentUniqueId>
</DocumentRequest>
</RetrieveDocumentSetRequest> |
Det svar der returneres er patientens Fælles Stamkort, indeholdende de dataelementer der er beskrevet under indhold,
Se bl.a MedCom's testeksempler under http://svn.medcom.dk/svn/releases/Standarder/HL7/PDC/Eksempler/
Opdatering af Fælles Stamkort
Fælles Stamkort læses som beskrevet via dokumentdeling, men opdateres via Stamkort register servicen
WSDL findes under: https://wsdl.nspop.dk/#skr hvor der både er referencer til snitfladen for sundhedspersoner via Den Gode Webservice (DGWS) samt snitfladen for patientadgang via OIO-IDWS.
Den tekniske anvenderguide til Stamkortregisteret giver detaljeret information om dataudvekselingsformater samt XML eksempler på oprettelser, opdateringer og sletninger
Sikkerhed, roller og rettigheder
For adgang til Fælles Stamkort skal der for sundhedspersoner eksistere et gyldigt SOSI-ID kort som er signeret af NSP'ens Secure Token Service, dokumentationen for SoSI-ID kort og STS ligger under: Anvenderguide til STS.
Patientdata portaler skal benytte det fællesoffentlige OIO-IDWS, der er vedligeholdt af Digitaliseringsstyrelsen - dokumentation til OIO-IDWS findes på Digitaliser.dk, STS'en har en omvekslingsservice for OIO-IDWS bootstraptokens til et signeret identitytoken, for adgang til Fælles Stamkort webservicen kald er benyttes et STS signeret identitytoken.
Sundhedspersoner, med en sundhedsfaglig autorisation har adgang til Fælles Stamkort. Sundhedspersoner uden sundhedsfaglig autorisation skal have tilknyttet en rettighed før disse kan få adgang. Lokale organisationer kan enten tilknytte disse rettigheder via Sundhedsstyrelssens Elektroniske Brugerstyring (SEB), eller give rettigheden via den lokale identifikations- og rettighedstyring.
For Fælles stamkort er der 4 forskellige måder for Sundhedspersoner uden sundhedsfaglig autorisation at få adgang til borgerens Fælles Stamkort.
Integrationsmetode | Beskrivelse | Er national rolle nødvendig? | |
---|---|---|---|
1 | Fagsystem opbevarer og vedligeholder lokal registerkopi af Fælles Stamkort | Det lokale fagsystem opbevarer og vedligeholder en lokal registerkopi af data fra Fælles Stamkort (via SFSK), og har til ansvar at holde registerkopien synkroniseret når der notificeres om ændringer i underliggende registre. I dette tilfælde er det ikke nødvendigt at tildele nationale roller til ikke autoriserede sundhedsfaglige, da det er det lokale anvendersystem som står for tildeling af rettigheder. Det lokale anvendersystem har til ansvar at skrive til borgerens Minlog når data tilgås (både fra autoriserede og ikke autoriserede sundhedsfaglige) | Nej |
2 | Fagsystem laver synkront system til system-baseret opslag på Fælles Stamkort | Opslag på Fælles Stamkort via SFSK når data skal anvendes, men med anvendelse af system-certifikat adgang. Ligeledes er det i dette tilfælde ikke nødvendigt at tildele nationale roller til ikke autoriserede sundhedsfaglige, da det er det lokale anvendersystem som står for tildeling af rettigheder. Det lokale anvendersystem har også her til ansvar at skrive til borgerens Minlog når data tilgås (både fra autoriserede og ikke autoriserede sundhedsfaglige). | Nej |
3 | Fagsystem laver synkront bruger-baseret opslag på Fælles Stamkort | Opslag på Fælles Stamkort via SFSK når data skal anvendes, men med anvendelse af bruger-certifikat adgang. Her er det nødvendigt for ikke autoriserede sundhedsfaglige at have tildelt en national rolle, da SFSK skal sikre at brugeren har de nødvendige rettigheder inden adgang til data gives. SFSK står ligeledes for at logge opslaget til borgerens Minlog. | Ja |
4 | Opslag på Fælles Stamkort for ikke autoriserede sundhedsfaglige via Sundhedsjournalen | Opslag for ikke autoriserede sundhedsfaglige via knapløsning til Sundhedsjournalen, eller via direkte login på Sundhedsjournalen. Sundhedsjournalen anvender integrationsmetoden beskrevet i punkt. 3, derfor skal ikke autoriserede sundhedsfaglige have tilknyttet en national rolle, hvis de skal have adgang til Fælles Stamkort via Sundhedsjournalen. | Ja |
Følgende rollebeskrivelser anvendes i forbindelse med Et samlet patientoverblik.
Rollenavn | Rollebeskrivelse | Notation som indsættes i SOSI IdKort ved udstedelse |
nspSundAssistR1 | Giver ret til at læse Fælles Stamkort (FSK) Se detaljeret beskrivelse af alle nationale roller her: Beskrivelse af de nationale roller i produktion - NSP services - Global Site (nspop.dk) samt overordnet dokumentation for SEB her: SEB - Sundhedsvæsenets Elektroniske Brugerstyring - Sundhedsdatastyrelsen Services (nsi.dk) | urn:dk:healthcare:national-federation-role:code:41001:value:SundAssistR1 |
nspSundAssistR2 | Giver ret til at læse Fælles Stamkort (FSK) Giver også adgang til at læse andre dokumenter, der deles via dokumentdelingsinfrastrukturen jvf. Sundhedslovens §42a stk. 4 Se detaljeret beskrivelse af alle nationale roller her: Beskrivelse af de nationale roller i produktion - NSP services - Global Site (nspop.dk) samt overordnet dokumentation for SEB her: SEB - Sundhedsvæsenets Elektroniske Brugerstyring - Sundhedsdatastyrelsen Services (nsi.dk) | urn:dk:healthcare:national-federation-role:code:41002:value:SundAssistR2
|
En sundhedsperson kan ikke have tilknyttet flere roller på samme tid - dette skal administreres via den lokale identifikations- og rettighedsstyring.
Håndtering af spærring og fuldmagt
Bemærk: pr. 1/12-2024 er det ikke længere muligt at borgere kan spærre for deling af Fælles Stamkort
Det skal bemærkes, at der godt kan foreligge flere adviseringer for den samme borger, da der vil blive skabt en advisering hver gang der er foretaget en ændring på borgerens spærringer. Fagsystemet skal kunne håndtere dette scenarie.
Ved tekniske fejl er der altid en risiko for at adviseringer går tabt, fagsystemet bør derfor have mulighed for at synkronisere med Fælles Stamkort, selvom det ikke har modtaget en advisering på at en borger har ændret en spærring, eksempelvis via en aktiv handling fra en sundhedsperson.
Fuldmagt
Patient/borgerportaler kan give patienternes pårørende adgang via den Fælles Offentlige Fuldmagtsservice, hvortil der er tilknyttet en brugergrænseflade på Borger.dk.
Bevis for fuldmagter er understøttet i OIO-IDWS identitytokens signeret af STS'en, dog understøtter dokumentdelingsservicen understøttersynkroniseringsservicen til Fælles Stamkort ikke fuldmagter via OIO-IDWS - så fuldmagter er i stedet etableret via en trust-løsning hvor patientportalen selv håndterer kontrol af fuldmagter.
Information angående angivelse af fuldmagter via dokumentdelingsservicensynkroniseringsservicen til Fælles Stamkort, kan ses i i HSUID header dokumentation.
Ændringslog
Version | Dato | Beskrivelse | Ændret af |
---|---|---|---|
2.1.0 | 2024-12-03 | Pr. 1/12-2024 kan borgere ikke længere spærre for deling af Fælles Stamkort, dokumentation omkring spærring af Fælles Stamkort er derfor fjernet. | SDS |
2.0.3 | 2024-10-22 | Beskrevet præcisering af når "fravalgsregister" ikke er tilgængeligt | SDS |
2.0.2 | 2024-10-21 | Præciseret adgang via nationale roller for forskellige integrationsmetoder, herunder når system til system integration anvendes. | SDS |
2.0.1 | 2024-03-12 | Tilpasset efter offentliggørelse af BEK nr 193 af 27/02/2024, hvor spærring ikke længere eer muligt for deling af stamoplysninger | SDS |
2.0 | 2023-12-11 | Tilpasset Version 3.0 af Fælles Stamkort, således både version 2.0 og 3.0 er beskrevet sideløbende | SDS |
...