Indledning

Denne vejledning beskriver de tekniske forretningsregler i forhold til at implementere Fælles Stamkort i et lokalt fagsystem eller en borgerportal. Vejledningen er tiltænkt forretningsarkitekter, systemarkitekter samt systemleverandører, således at 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 patientens Fælles Stamkort.
Vejledningen beskriver desuden de tekniske krav og forudsætninger.

De følgende afsnit, beskriver hvordan DK-PDC anvendes, samt hvilke forretningsregler lokale fagsystemer og borgerportaler 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/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: FSK Guide til anvendere

Teknisk oversigt

Udveksling af patientens 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 lokale fagsystemer samt borgerportaler.

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 patienter.

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 patientens pårørende, patientens midlertidige adresse, patientens kontaktoplysninger samt patientens 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 patientens 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.

Synkronisering 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.
Det skal sikres at patientens data ikke går tabt samt at integriteten bevares. Det lokale fagsystem skal derfor følge den viste proces.

De enkelte data-entiteter fra Fælles Stamkort er tilknyttet en unik ID, de lokale fagsystemer skal kunne opbavere denne ID, da den skal benyttes når en data-entitet enten skal opdaterers eller slettes. Samtidig har de enkelte data-entiteter tilknyttet informationer om hvornår de er opdateret, samt hvilken organisation eller om det er patienten selv der har opdateret data. Information omkring opdateringstidspunkt skal også gemmes i det lokale fagsystem, således at fagsystemet kan se om data er ændret siden sidste synkronisering.

Følgende eksempel viser data som det ser ud i det lokale fagsystem samt Fælles Stamkort før den første synkronisering.

Fagsystemet indlæser derefter data fra Fælles Stamkort, fletter data med lokale data og skriver efterfølgende nye og ændrede data til Fælles Stamkort

Som det ses har den pårørende Hans Hansen i det lokale fagsystem fået tilknyttet ID 9c13a4e6-fa0e-4740-833b-1e9e80ecc18e fra Fælles Stamkort.
Pårørende Jens Hansen eksisterede ikke i Fælles Stamkort i forvejen og er nu blevet oprettet, ID e5e4bfae-12c3-460b-a51c-6310a72cbc68 fra Fælles Stamkort er blevet tilknyttet det lokale fagsystem.

(Bemærk at ID kan enten dannes lokalt og dermed skrives til Fælles Stamkort, medsendes den ikke vil Fælles Stamkort selv oprette en ID.)

Fælles Stamkort har fået tilknyttet patientens 2. telefonnummer.
Fælles Stamkort har fået tilknyttet patientens foretrukne sprog, i dette tilfælde Dansk.

Felter omkring hvornår de enkelte data-entiteter er opdateret, samt hvilken organisation der har lavet opdateringen er ligeledes tilknyttet det lokale fagsystem (ikke vist på tegningen).

Efterfølgende laver patienten en opdatering af pårørende Jens Hansen via sundhed.dk, hvor patienten tilknytter relationen "Bror" samt at telefonnummeret på den pårørende er ændret.

Næste gang det lokale fagsystem laver et opslag på patientens data, og dermed kontrollerer om der er nye data i Fælles Stamkort. Kan det lokale fagsystem se at tidspunktet for pårørende Jens Hansen er nyere end det lokalt opbevarede tidspunkt, og skal derfor synkronisere data fra Fælles Stamkort ned til de lokale data.

Patienten ønsker at slette det ene af de 2 tilknyttede telefonnummer og gør dette via sundhed.dk.

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.

Regler for fletning af data mellem det lokale fagsystem og Fælles Stamkort.

I forhold til første synkronisering af data mellem det lokale fagsystem og Fælles Stamkort, vil der skulle ske en maskinel behandling af patientens data, hvor patienten ikke selv er involveret.

Ved at følge de tekniske krav, som er defineret i nedenstående tabel, sikres det at der ikke sker forvanskning eller tab af data, hvilket er i overensstemmelse med GDPR og Databeskyttelsesloven.

Lokalt fagsystem	Synkronisering	Fælles Stamkort
Pårørende: Hans Hansen	Pårørende flettes, og ID fra Fælles Stamkort tilknyttes lokalt fagsystem	Pårørende: Hans Hansen
Pårørende: H. Hansen	Ny pårørende oprettes i Fælles Stamkort, da der ikke er eksakt match i navnene.	Pårørende: Hans Hansen
Pårørende: Hans Hansen Telefon nummer: 33445566	Pårørende flettes, og ID på mobilnummer fra Fælles Stamkort tilknyttes lokalt fagsystem	Pårørende: Hans Hansen Telefon nummer: 33445566 Mobil nummer: 51525354
Pårørende: Hans Hansen Telefon nummer: 33445566	Ny pårørende oprettes i Fælles Stamkort, da der ikke er eksakt match i telefonnummeret	Pårørende: Hans Hansen Telefon nummer: 33445577
Pårørende: Hans Hansen Relation: Søn	Ny pårørende oprettes i Fælles Stamkort da der ikke er eksakt match i relationen	Pårørende: Hans Hansen Relation: Ingen
Pårørende: Hans Hansen Relation: Søn Telefon nummer: 33445566	Pårørende flettes, og ID fra Fælles Stamkort tilknyttes lokalt fagsystem	Pårørende: Hans Hansen Relation: Søn Telefon nummer: 33445566
Midlertidig adresse: Tinevej 4 3070 Snekkersten Start dato: 1. juni 2020	Midlertidig adresse flettes, og ID fra Fælles Stamkort tilknyttes lokalt fagsystem	Midlertidig adresse: Tinevej 4 3070 Snekkersten Start dato: 1. juni 2020
Midlertidig adresse: Tinevej 4 3070 Snekkersten Start dato: 1. juni 2020 Slut dato: 15. juni 2020	Midlertidig adresse fra Fælles Stamkort benyttes, da der er forskel i dato-intervallet.	Midlertidig adresse: Tinevej 4 3070 Snekkersten Start dato: 1. juni 2020

Teknisk implementering

Afsnittet indeholder tekniske vejledninger til hvordan Fælles Stamkort kan integrereres i lokale fagsystemer og borgerportaler.

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)₃.
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

Patientens CPR-nummer er en del af den generiske CDA Header.

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">
<streetAddressLine>Vedbæk Strandvej 464</streetAddressLine>
<postalCode>7000</postalCode>
<city>Fredericia</city>
<country>DK</country>
</addr>
<patient classCode="PSN">
<name>
<given>Bente</given>
<given>Kirkegård</given>
<family>Knudsen</family>
</name>
<administrativeGenderCode codeSystem="2.16.840.1.113883.5.1" code="F"/>
<birthTime value="19481225000000+0000"/>
</patient>

Bemærk at har patienten navne eller adressebeskyttelse vises "BESKYTTET NAVN/ADRESSE"

CPR - register

Information om patientens pårørende

component.structuredBody.
component.section.entry.observation

templateId
root="1.2.208.184.16.1.10.20.1.25"
extension="2019-08-14"

code
code="RelativeTypedIn"
codeSystem="1.2.208.184.100.1"

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

<templateId root="1.2.208.184.16.1.10.20.1.25" extension="2019-08-14"/>
<id extension="839697de-9660-4575-a3ac-61def6fb3474" root="1.2.208.184"/>
<code code="RelativeTypedIn" codeSystem="1.2.208.184.100.1"
codeSystemName="MedCom Message Codes" displayName="Pårørende, indtastet"/>

<value xsi:type="PN">
<given>Hans</given>
<family>Hansen</family>
</value>
<value xsi:type="TEL" use="H" value="tel:11223344"/>
<value xsi:type="TEL" use="WP" value="tel:(46)-55667788-1234"/>
<value xsi:type="TEL" use="MC" value="tel:99001122"/>

<value xsi:type="CD" code="nabo" codeSystem="1.2.208.184.100.2" codeSystemName="MedCom Relation Codes" displayName="Nabo"/>

<value xsi:type="ST">Naboen arbejder hos TDC i Sverige og kan træffes på
arbejdstelefon i dagtimerne ml. 8 og 16.</value>

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.
component.section.entry.observation

templateId
root="1.2.208.184.16.1.10.20.1.23"
extension="2019-08-14"

code
code="ChildCustody"
codeSystem="1.2.208.184.100.1"

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.

<value xsi:type="PN">
<given>Peter</given>
<given>Severin</given
<family>Knudsen</family>
</value>

<!-- Value representing the relationship the patient has to the child of whom the patient have custody →
<value xsi:type="CD" code="mor" codeSystem="1.2.208.184.100.2"
codeSystemName="MedCom Relation Codes" displayName="Mor"/>

CPR - register

Patientens forældremyndighedshavere

component.structuredBody.
component.section.entry.observation

templateId
root="1.2.208.184.16.1.10.20.1.23"
extension="2019-08-14"

code
code="CustodyBy"
codeSystem="1.2.208.184.100.1"

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.

<value xsi:type="PN">
<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 →
<value xsi:type="CD" code="barn" codeSystem="1.2.208.184.100.2"
codeSystemName="MedCom Relation Codes" displayName="Barn"/>

CPR - register

Patientens telefonnummer

component.structuredBody.
component.section.entry.observation

templateId
root="1.2.208.184.16.1.10.20.1.24"
extension="2019-08-14"

code
code="PatientContactTypedIn"
codeSystem="1.2.208.184.100.1"

Patientens kontakt telefonnummer (3 telefonnumre kan angives (hjemme "H", mobil "MC", arbejde "WP").

Bemærk: Der kan kun angives en observation med patientens telefonnumre.

Indtastet information fra stamkortregisteret

Patientens midlertidige adresse

component.structuredBody.
component.section.entry.observation

templateId
root="1.2.208.184.16.1.10.20.1.21"
extension="2019-08-14"

code
code="TempAddrTypedIn"
codeSystem="1.2.208.184.100.1"

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.21" extension="2019-08-14"/>
<id extension="3eda0a9c-3363-4257-9eda-a7c8d15fa301" root="1.2.208.184"/>
<code code="TempAddrTypedIn"
codeSystem="1.2.208.184.100.1"
codeSystemName="MedCom Message Codes"
displayName="Midlertidig adresse, indtastet"/>
<effectiveTime>
<low value="20190101000000+0100"/>
<high value="20200101000000+0100"/>
</effectiveTime>
<value xsi:type="AD">
<streetAddressLine>Sommerhusvej 23</streetAddressLine>/>
<streetAddressLine>Strandbytrand</streetAddressLine>/>
<postalCode>1234</postalCode
<city>Strandbystrand</city
<country>Danmark</country>
</value>

Indtastet information fra stamkortregisteret

Patientens egen læge

recordtarget.patientRole.
providerOrganization

Kontaktoplysninger til patientens egen læge.
Patientens egen læge er en del af den generiske CDA Header.

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 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.
component.section.entry.observation

templateId
root="1.2.208.184.16.1.10.20.1.22"
extension="2019-08-14"

code
code="DentistTypedIn"
codeSystem="1.2.208.184.100.1"

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.

Bemærk: Det er ikke alle tandlæger der er tilknyttet Yderregisteret, i disse tilfælde vil tandlægens kontaktinformation skulle indtastes manuelt.

<templateId root="1.2.208.184.16.1.10.20.1.22" extension="2019-08-14"/>
<id extension="8f1d5b96-b16e-405d-a840-4e5bc87690ae" root="1.2.208.184"/>
<code code="DentistTypedIn"
codeSystem="1.2.208.184.100.1"
codeSystemName="MedCom Message Codes"
displayName="Tandlæge indtastet"/>
<value xsi:type="EN">
<prefix>Tandlæge</prefix>
<given>Jette</given>
<family>Testesen</family>
</value>
<value xsi:type="AD">
<streetAddressLine>Tandvej 7</streetAddressLine>
<postalCode>1234</postalCode>
<city>Yderby</city>
<country>DentistcountryTypedIn</country>
</value>

Indtastet information fra stamkortregisteret

Sygesikringsgruppe

component.structuredBody.
component.section.entry.observation

templateId
root="1.2.208.184.16.1.10.20.1.27"
extension="2019-08-14"

code
code="CoverageGroup"
codeSystem="1.2.208.184.100.1"

Patientens sygesikringsgruppe.

Sygesikringsregisteret

Patientens foretrukne kommunikationssprog.

component.structuredBody.
component.section.entry.observation

templateId
root="1.2.208.184.16.1.10.20.1.27"
extension="2019-08-14"

code
code="LanguageTypedIn"
codeSystem="1.2.208.184.100.1"

Patienten kan registrere hvilket sprog de foretrækker at kommunikerer på.

Feltet er forudfyldt med sproget ”Dansk”.

Bemærk: Der kan kun registreres et sprog pr. patient.

Indtastet information fra stamkortregisteret

Behandlingstestamente

component.structuredBody.
component.section.entry.observation

templateId
root="1.2.208.184.16.1.10.20.1.29"
extension="2019-08-14"

code
code="TreatmentWillRegistration"
codeSystem="1.2.208.184.100.1"

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.

Behandlingstestamenteregister

Livstestamente

component.structuredBody.
component.section.entry.observation

templateId
root="1.2.208.184.16.1.10.20.1.30"
extension="2019-08-14"

code
code="LivingWillRegistration"
codeSystem="1.2.208.184.100.1"

Information om patienten har registreret et 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.

Livstestamenteregister

Organdonorregistrering

component.structuredBody.
component.section.entry.observation

templateId
root="1.2.208.184.16.1.10.20.1.31"
extension="2019-08-14"

code
code="OrganDonorRegistration"
codeSystem="1.2.208.184.100.1"

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.

Organdonorregisteret

_{3 https://svn.medcom.dk/svn/releases/Standarder/HL7/CDA Header/Dokumentation/DK-CDA-Header.pdf}

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 borgeradgang).
Den Gode WebService benytter XMLDSIG til at signere SAML assertions ud fra X.509 certifikater/nøgler - for adgang til Fælles Stamkort skal sundhedspersoner have et gyldigt Nem-ID Medarbejdercertifikat (MOCES) - 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 Dokumentation

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.

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, detaljeret information om dokument-metadata findes under Fælles Stamkort Servicens Metadata anvenderguide

Typisk angives patientens kun CPR nummer, samt en typecode, se følgende eksempel.

ITI-18 AdhocQueryRequest

		<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="$XDSDocumentEntryTypeCode">
					<ValueList>
						<Value>('PDC^^2.16.840.1.113883.6.1')</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

ITI-18 AdhocQueryResponse

		<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: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: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:ihe:iti:2007:ResponseStatusType:PartialSuccess">
			<RegistryObjectList>
				<ExtrinsicObject mimeType="text/xml" objectType="urn:uuid:34268e47-fdf5-41a6-ba33-82133c465248" status="urn:oasis:names:tc:ebxml-regrep:StatusType:Approved" id="urn:sds:fsk:stamkort:4dfd86a1-ccdd-4463-8d06-2e6d2f4f2b52" home="1.2.208.176.8.1.12">
					<Slot name="creationTime">
						<ValueList>
							<Value>20191129120611</Value>
						</ValueList>
					</Slot>
					<Slot name="languageCode">
						<ValueList>
							<Value>da-DK</Value>
						</ValueList>
					</Slot>
					<Slot name="repositoryUniqueId">
						<ValueList>
							<Value>1.2.208.176.43210.8.10.12</Value>
						</ValueList>
					</Slot>
					<Slot name="sourcePatientId">
						<ValueList>
							<Value>2512489996^^^&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="urn:sds:fsk:stamkort:4dfd86a1-ccdd-4463-8d06-2e6d2f4f2b52" nodeRepresentation="" id="urn:uuid:2dc69467-1a1a-43a5-a300-7ff085dc4ad7">
						<Slot name="authorInstitution">
							<ValueList>
								<Value>Sundhedsdatastyrelsen^^^^^&1.2.208.176.1.1&ISO^^^^634491000016008</Value>
							</ValueList>
						</Slot>
					</Classification>
					<Classification classificationScheme="urn:uuid:41a5887f-8865-4c09-adf7-e362475b143a" classifiedObject="urn:sds:fsk:stamkort:4dfd86a1-ccdd-4463-8d06-2e6d2f4f2b52" nodeRepresentation="001" id="urn:uuid:76545ece-d1f8-46fe-84ad-69b84caba60c">
						<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="urn:sds:fsk:stamkort:4dfd86a1-ccdd-4463-8d06-2e6d2f4f2b52" nodeRepresentation="DK FSK Schema" id="urn:uuid:9216fb14-c16f-499c-bb48-f67b956aac59">
						<Slot name="codingScheme">
							<ValueList>
								<Value>urn:ad:dk:medcom:fsk:full</Value>
							</ValueList>
						</Slot>
						<Name>
							<LocalizedString xml:lang="en-US" charset="UTF-8" value="DK FSK Schema"/>
						</Name>
					</Classification>
					<Classification classificationScheme="urn:uuid:f33fb8ac-18af-42cc-ae0e-ed0b0bdb91e1" classifiedObject="urn:sds:fsk:stamkort:4dfd86a1-ccdd-4463-8d06-2e6d2f4f2b52" nodeRepresentation="554041000005106" id="urn:uuid:0cde4f59-9e49-4dfb-925a-9325564dc47e">
						<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:f0306f51-975f-434e-a61c-c59651d33983" classifiedObject="urn:sds:fsk:stamkort:4dfd86a1-ccdd-4463-8d06-2e6d2f4f2b52" nodeRepresentation="52460-3" id="urn:uuid:f6aec0bd-8ee0-4ad3-932f-cb4c6314fa84">
						<Slot name="codingScheme">
							<ValueList>
								<Value>2.16.840.1.113883.6.1</Value>
							</ValueList>
						</Slot>
						<Name>
							<LocalizedString xml:lang="en-US" charset="UTF-8" value="Patient Information"/>
						</Name>
					</Classification>
					<Classification classificationScheme="urn:uuid:f4f85eac-e6cb-4883-b524-f2705394840f" classifiedObject="urn:sds:fsk:stamkort:4dfd86a1-ccdd-4463-8d06-2e6d2f4f2b52" nodeRepresentation="N" id="urn:uuid:84b2075d-0ded-4bec-b50a-c67d9cbb83d2">
						<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="urn:sds:fsk:stamkort:4dfd86a1-ccdd-4463-8d06-2e6d2f4f2b52" identificationScheme="urn:uuid:58a6f841-87b3-4a3e-92fd-a8ffeff98427" value="0202999573^^^&1.2.208.176.1.2&ISO" id="urn:uuid:f8d811f5-1d9a-4774-a49c-0c90c01ce0d8">
						<Name>
							<LocalizedString value="XDSDocumentEntry.patientId"/>
						</Name>
					</ExternalIdentifier>
					<ExternalIdentifier registryObject="urn:sds:fsk:stamkort:4dfd86a1-ccdd-4463-8d06-2e6d2f4f2b52" identificationScheme="urn:uuid:2e82c1f6-a085-4c72-9da3-8640a32e42ab" value="urn:sds:fsk:stamkort:4dfd86a1-ccdd-4463-8d06-2e6d2f4f2b52" id="urn:uuid:da6376b7-0cb9-4bfd-a80e-241cff0be6de">
						<Name>
							<LocalizedString value="XDSDocumentEntry.uniqueId"/>
						</Name>
					</ExternalIdentifier>
				</ExtrinsicObject>
			</RegistryObjectList>
		</ns3:AdhocQueryResponse>

Der er tre værdier der skal benyttes:

HomeCommunityId - der beskriver det domæne dokumentet befinder sig i.
Værdien hentes ud fra ...ExtrinsicObject/@home
RepositoryUniqueId - der bekriver den kilde under domænet der opbevarer dokumentet
Værdien hentes ud fra ...ExtrinsicObject/Slot[@name=’repositoryUniqueId’]/Value List/Value
DocumentUniqueId - der identificerer selve dokumentet
Værdien hentes ud fra ...ExtrinsicObject/ExternalIdentifier[@identificationScheme=’urn:uuid:2e82c1f6-a085-4c72-9da3-8640a32e42ab]/@value

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.

Som beskrevet ovenfor benyttes de tre værdier: HomeCommunityId, RepositoryUniqueId og DocumentUniqueId til at hente dokumentet.

WSDL til DDS Repository findes her: https://wsdl.nspop.dk/ddsrepository?wsdl

ITI-43 RetrieveDocumentSetRequest

		<ns2:RetrieveDocumentSetRequest xmlns:ns6="urn:oasis:names:tc:ebxml-regrep:xsd:lcm:3.0" xmlns:ns5="urn:oasis:names:tc:ebxml-regrep:xsd:query:3.0" xmlns:ns4="urn:oasis:names:tc:ebxml-regrep:xsd:rs:3.0" xmlns:ns3="urn:oasis:names:tc:ebxml-regrep:xsd:rim:3.0" xmlns:ns2="urn:ihe:iti:xds-b:2007">
			<ns2:DocumentRequest>
				<ns2:HomeCommunityId>1.2.208.176.8.1.12</ns2:HomeCommunityId>
				<ns2:RepositoryUniqueId>1.2.208.176.43210.8.20.12</ns2:RepositoryUniqueId>
				<ns2:DocumentUniqueId>1.2.208.176.43210.8.20.12^bb386d3d-3cb0-45a9-a8b4-cec6a208ee84</ns2:DocumentUniqueId>
			</ns2:DocumentRequest>
		</ns2:RetrieveDocumentSetRequest>

Det svar der returneres er patientens Fælles Stamkort, indeholdende de dataelementer der er beskrevet under indhold.

ITI-43 RetrieveDocumentSetResponse

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 borgeradgang 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 vedligholdt 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 skald 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.

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, i Fælles Stamkort (FSK)

urn:dk:healthcare:national-federation-role:code:41001:value:SundAssistR1

nspSundAssistR2

Giver ret til at læse til Aftaler, FSK og Planer og Indsatser

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 rettighedstyring.

Håndtering af spærring og fuldmagt

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. 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 tekniskinformation omkring spærring og forespørgsler via dokumentdeling kan ses i Brugervejledning til forespørgsler via DDS

ITI-18 Spærrede dokumenter

<rs:RegistryError codeContext="urn:dk:nsi:Consent Filter Applied" errorCode="XDSRegistryError" severity="urn:oasis:names:tc:ebxml-regrep:ErrorSeverityType:Error"/>

Fuldmagt

Patientportaler 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 ikke OIO-IDWS - så fuldmagter er istedet etableret via en trust-løsning hvor patientportalen selv håndterer kontrol af fuldmagter.

Information angående angivelse af fuldmagter via dokumentdelingsservicen, kan ses i HSUID header dokumentation.

Ændringslog

0.8	2019-12-06	Udkast til Teknisk implementeringsguide til Fælles Stamkort	SDS
1.0	2020-01-06	Offentlig efter afsluttet kommenteringsrunde	SDS
1.0.1	2020-01-21	Tilrettet link til standard for Fælles Stamkort	SDS
1.1	2020-03-27	Tilrettet efter opdatering af testprotokol for CDA profilen Desuden mindre tekstuelle rettelser	SDS
1.2	2020-05-28	Inført afsnit som præciserer hvorledes data skal synkroniseres mellem lokale fagsystemer og Fælles Stamkort	SDS

Content

Space Tools

Indledning

Anden dokumentation

Teknisk oversigt

Synkronisering mellem lokale fagsystemer og Fælles Stamkort

Regler for fletning af data mellem det lokale fagsystem og Fælles Stamkort.

Teknisk implementering

Indhold i Fælles Stamkort

Tekniske forudsætninger

Søgning på Fælles Stamkort

Hentning af Fælles Stamkort

Opdatering af Fælles Stamkort

Sikkerhed, roller og rettigheder

Håndtering af spærring og fuldmagt

Ændringslog

Content

Space Tools

Teknisk Implementeringsvejledning Fælles Stamkort

Indledning

Anden dokumentation

Teknisk oversigt

Synkronisering mellem lokale fagsystemer og Fælles Stamkort

Regler for fletning af data mellem det lokale fagsystem og Fælles Stamkort.

Teknisk implementering

Indhold i Fælles Stamkort

Tekniske forudsætninger

Søgning på Fælles Stamkort

Hentning af Fælles Stamkort

Opdatering af Fælles Stamkort

Sikkerhed, roller og rettigheder

Håndtering af spærring og fuldmagt

Ændringslog