Indledning
Denne vejledning beskriver de tekniske forretningsregler i forhold til at implementere Fælles Stamkort i et fagsystem eller en borgerportal. Vejledningen er tiltænkt Forretningsarkitekter, Systemarkitekter samt Systemleverandører, således disse kan vurdere hvordan Fælles Stamkort kan implementeres i systemerne.
Fælles stamkort er en forretningsservice baseret på den nationale dokumentdelingsinfrastruktur, som udstiller stamdata fra et antal underliggende registre1 i HL7 CDA format. Vejledningen præciserer brugen af den danske CDA profil til Personal Data Card (PDC-DK) [version 2.0]2, der anvendes til at udstille borgernes Fælles Stamkort.
Vejledningen beskriver desuden de tekniske krav forudsætninger
De følgende afsnit, beskriver hvordan DK-PDC anvendes, samt hvilke forretningsregler borger portaler og fagsystemer skal implementere for at understøtte Fælles Stamkort
1 - Herunder CPR-register, Sygesikringsregister, Organdonorregister, Livs- og Behandlingstestamenteregister samt stamkortregister
2 - https://svn.medcom.dk/svn/drafts/Standarder/HL7/PDC/
Anden dokumentation
De overordnede forretningsregler til Fælles Stamkort kan ses i dokumentet: (Indsæt reference)
Detaljeret teknisk anvenderguide, herunder information om felttyper, feltstørrelser og kardinalitet i dokumentet: https://www.nspop.dk/display/public/web/FSK+-+Guide+til+anvendere
Teknisk oversigt
Udveksling af Borgerens Fælles Stamkort foregår via den nationale infrastruktur til dokumentdeling. Denne understøtter referencearkitekturen for deling af dokumenter og billeder.
For generel introduktion til den nationale infrastruktur om dokumentdeling, se vejledningen ’Kom godt i gang med dokumentdeling’ til deling af dokumenter via Dokumentdelingsservice på NSP lavet af MedCom. For detaljeret teknisk dokumentation omkring dokumentdeling via NSP, se NSP'ens Dokumentdelingsservice.
Fælles Stamkort er understøttet af to overordnede forretningsservices. Hent Fælles Stamkort samt Opdater Fælles Stamkort, disse services vil indgå i borgerportaler samt lokale fagsystemer.
Hent Fælles Stamkort er implementeret via den nationale løsning for dokumentdeling, og følger derved principperne for denne, herunder adgangskontrol, informationssikkerhed og audit. Udvekslingsformatet er HL7 CDA (DK-PDC 2.0)
Opdater Fælles Stamkort foregår via en webservice integration, hvor der er implementeret endpoints til henholdsvis adgang for sundhedsfaglige samt borgere
Fælles Stamkort on-demand servicen indeholder model og grænsefladebeskrivelser for CDA udvekslingsformatet
Fælles Stamkort on-demand servicen er implementeret som en on-demand dokumentkilde der integrerer til en række registre, heriblandt et stamkortregister, der er autoritativt register for oplysninger om borgerens pårørende, borgerens midlertidige adresse, borgerens kontaktoplysninger samt borgerens sprog. Læsning af Fælles Stamkort dokumenter fra Fælles Stamkort on-demand servicen foregår via dokumentdelingsservicen på den nationale service platform ved brug af HL7's standard ITI-18 og ITI-43 grænseflader.
Stamkortregister-servicen benyttes til at hente (kun adgang fra Fælles Stamkort on-demand service) samt redigere borgerens stamdata (telefonnummer, pårørende oplysninger, midlertidige adresse, sprog samt tilknytning til læge og tandlæge). Opdateringer af data, sker via en direkte webserviceintegration til Stamkortregisteret.
Teknisk implementering
Afsnittet indeholder tekniske vejledninger til hvordan Fælles Stamkort kan integrereres i borgerportaler og fagsystemer
Indhold i Fælles Stamkort
Indholdet i Fælles stamkort er defineret i CDA profilen: Personal Data Card (PDC-DK) [version 2.0]
Indeholdet 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.
Kode | Beskrivelse | Eksempel | Kilde |
Patientens CPR-nummer er en del af den generiske CDA header recordTarget.patientRole.id | Patientens CPR-nummer | <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 | <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" | <templateId root="1.2.208.184.16.1.10.20.1.25" extension="2019-08-14"/> 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. | <templateId root="1.2.208.184.16.1.10.20.1.23" extension="2019-08-14"/> <!-- 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 → | CPR - register |
Patientens forældremyndighedshavere component.structuredBody. templateId code | Hvis patienten er et barn børn, 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 færæ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. | <templateId root="1.2.208.184.16.1.10.20.1.23" extension="2019-08-14"/> <!-- Value representing the name of the Custodian of whom the patient is in custody --> <!-- Value representing the relationship the patient has to the custodian of whom the patient is in custody → | CPR - register |
Patientens telefonnummer | Patientens kontakt telefonnummer (3 telefonnumre kan angives (hjemme, mobil, arbejde). | Hjemme: 11223344 Mobil: 21212121 Arbejde: 55556666 | Stamkortregister |
Patientens midlertidige adresse | Patientens midlertidige adresse inklusiv et tidsinterval for hvornår patienten befinder sig på adressen. | Sommervej 12 0001 Strandby Fra 1/6-2019 Til 15/8-2019 Bemærk at det ikke er nødvendigt at angive et sluttidspunkt for den midlertidige adresse og at adressen ikke vises hvis slutdato er overskredet. | Stamkortregister |
Patientens egen læge | Kontaktoplysninger til patientens egen læge, hvis der er tilknyttet en. | Lægerne Hansen Torvegade 27, 0000 Brøndstrup Tlf.: 45454545 | Yderregisteret |
Patientens tandlæge | Kontaktoplysninger til patientens egen tandlæge, hvis der er tilknyttet en. Der er mulighed for at patienten selv kan angive tandlæge. | Tandlægerne Jensen & Jensen Torvegade 29 0000 Brøndstrup Tlf.: 98989898 | Yderregisteret eller Stamkortregister |
Sygesikringsgruppe | Patientens sygesikringsgruppe. | Sygesikringsgruppe 1 | Sygesikringsregisteret |
Patientens foretrukne kommunikationssprog. | Patienten kan registrerer hvilket sprog de foretrækker at kommunikerer på. Feltet er for udfyldt med sproget ”Dansk”. | Dansk Bemærk: Der kan kun registreres 1 sprog pr. patient. | Stamkort register |
Behandlingstestamente Livstestamente Organdonor | Information om patienten har registreret enten Livstestamente/Behandlingstestamente eller Organdonation kan vises i Fælles Stamkort. Stamkortet må IKKE vise indholdet i registreringen, kun OM der lavet en registrering. | Livstestamente: Ja/Nej Behandlingstestamente: Ja/Nej Organdonorregister: Ja/Nej Bemærk: Sundhed.dk viser ikke disse oplysninger sammen med Stamkort, da hvert register har sin egen side. | Behandlingstestamenteregister, Livstestamenteregister og Organdonorregister. |
3 https://svn.medcom.dk/svn/releases/Standarder/HL7/CDA Header/Dokumentation/DK-CDA-Header.pdf
Visning af Fælles Stamkort
...
Opdatering af Fælles Stamkort
...
Webservices
Håndtering af Spærring og fuldmagt
...
Ændringslog
| 1.0 | 2019-11-18 | Teknisk implementeringsguide til Fælles Stamkort | SDS |