Page History
...
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.
Migrering til Fælles Stamkort Er en optionel servide til understøttelse af fagsystemernes proces for migrering af stamkortdata til Fælles Stamkort, processen understøttes af en specifik migreringsgrænseflade på stamkortregisteret der understøtter system-system integration og som sikrer at validiteten samt aktualiteten og derved kvaliteten af data i Fælles Stamkort er så høj som muligt.
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.
...
Migrering af data fra lokale fagsystemer
...
til Fælles Stamkort
Den første synkronisering med Migrering af stamkortdata fra fagsystemet til 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
inden løsningen ibrugtages i drift, er en mulighed myndigheder med deres fagsystemer KAN benytte.
Ved at lave en migrering vil forretningsværdien af at benytte Fælles Stamkort kunne udnyttes hurtigere, da borgere derved hurtigere vil få et overblik over de stamkortdata fagsystemerne har registreret på dem, og således kan verificere og kvalificere disse stamkortdata.
Benyttes migreringsprocessen, SKAL den kun køre en gang pr. fagsystem, da stamkortdata under migreringen udelukkende vil blive skrevet til Fælles Stamkort, uden hensyntagen til eksisterende data i Fælles Stamkort.
Udførsel af migreringsprocessen SKAL benytte en ny migreringsgrænseflade på Stamkortregisteret, som har til ansvar at sikre datakvaliteten for migreringen, samt sikre at borgere der allerede har etableret et Fælles Stamkort, ikke får overskrevet dette med ikke validerede data fra fagsystemerne.
Undlader myndigheden at benytte migreringsprocessen for deres fagsystemer, eller for dele af deres fagsystemer BØR der laves lokale overvejelser for hvordan stamkort efterfølgende ibrugtages.
Principper for migrering af stamkortdata
#1: Alle stamkortdata migreres ukritisk
Stamkortdata migreres ukritisk, hvilket vil sige der ikke skal tages højde for tidligere udmeldte fletteregler. Forretningsregler SKAL stadig overholdes, hvilket beskrives nærmere i følgende principper.
Migreringsgrænsefladen vil returnere en fejlkode, i tilfælde af enten et brud på en forretningsregel, eller brud på en af følgende principper. Fagsystemet SKAL IKKE, i det tilfælde det modtager en fejlkode, migrere det pågældende element der giver fejlkoden.
Fagsystemet BØR i tilfælde af det ikke kan migrere stamkortdata overveje om det vil beholde lokale stamkortdata til senere synkronisering, eller om det eventuelt vil fjerne lokale data og udelukkende basere sig på de data der eksisterer i Fælles Stamkort.
Konsekvensen af en ukritisk migrering vil være, at der kan være duplikater af data på f.eks. borgerens pårørende. Dette KAN borgeren, eller dennes pårørende, enten selv rette op på via brugergrænsefladen på sundhed.dk, eller sundhedspersoner KAN hjælpe de borgere der ikke har fået det gjort, eller som ikke er i stand til selv at gøre dette.
#2: Hvor borgere i forvejen har oprettet et Fælles Stamkort vil det ikke være muligt at migrere stamkortdata
Fælles Stamkort SKAL IKKE gøre det muligt at migrere stamkortdata, hvor borgeren allerede har verificeret stamkortdata.
Borgeren kan enten selv have verificeret sine data, eller det kan være gjort af en sundhedsperson på vegne af borgeren, eller af borgerens fuldmagtshavere.
Der returneres en fejlkode fra migreringsgrænsefladen, og fagsystemet SKAL IKKE migrere stamkortdata for denne borger.
Fejlkode: 800 Fejltekst: Fælles Stamkort er verificeret af borgeren |
|---|
Når borgeren efterfølgende har kontakt til myndigheden, og denne myndighed slår borgeren op i fagsystemet, BØR fagsystemet allerede have taget stilling til om lokale data beholdes, da fagsystemet i den sammenhængt SKAL synkronisere med Fælles Stamkort
Eksemplet i Figur 3 viser hvordan det lokale fagsystem har tilknyttet UUID'er til de pårørende der står registreret lokalt, men ved efterfølgende migrering får fejlkode 800 retur, og derved kan se at borgeren allerede har et verificeret stamkort, og at stamdata ikke er migreret.
Figur 3 - Eksempel på migrering hvor borgeren har et verificeret stamkort i forvejen
#3: Alle pårørende oprettes ukritisk
Stamkort data indeholdende pårørende information skrives ukritisk til Fælles Stamkort, altså uden hensyntagen til om der skulle eksistere en pårørende med samme oplysninger i forvejen, i borgerens Fælles Stamkort.
Fagsystemet SKAL tilknytte en UUID til hver pårørende der migreres, og gemme denne UUID sammen med pårørende oplysninger i fagsystemet. Efterfølgende synkronisering af Fælles Stamkort, når borgeren er i kontakt med myndigheden, vil dermed kunne sikre, hvilke pårørende der har fået rettet op på data, er slettet, eller er migreret fra andre fagsystemer.
Eksemplet i Figur 4 viser hvordan det lokale fagsystem har tilknyttet UUID'er til de pårørende der står registreret lokalt, og disse migreres til Fælles Stamkort selvom der allerede eksisterer en pårørende med navnet Hans Hansen i Fælles Stamkort. Den eneste forskel på de to Hans Hansen'er i Fælles Stamkort er UUID'en.
Efterfølgende migrerer fagsystem nr. 2, som vist i eksemplet i Figur 5, hvor endnu en dublet af pårørende Hans Hansen oprettes i Fælles Stamkort.
Figur 4 - Migrering af pårørende til Fælles Stamkort, resulterende i dubletter
Figur 5 - Migrering af pårørende fra fagsystem nr. 2 til Fælles Stamkort, resulterende i flere dubletter
#4: Oprydning i fagsystemer inden migrering
Fagsystemerne BØR inden migrering af borgerens kontaktinformation (nuværende 3 typer af telefonnumre - hjemme, mobil, arbejde) - have struktureret egne data i fagsystemet. Fagsystemet SKAL skrive kontaktinformationen til Fælles Stamkort, eksisterer der et telefonnummer i forvejen, vil migreringsgrænsefladen returnere en fejlkode, og fagsystemet SKAL IKKE skrive borgerens telefonnummer.
Fagsystemet BØR overveje hvordan telefonnumre der ikke er migreret skal håndteres lokalt.
Fejlkode: 810 Fejltekst: Der eksisterer et telefonnummer af type <indsat type> i forvejen |
|---|
Efterfølgende synkronisering af Fælles Stamkort, vil ske når borgeren er i kontakt med en myndighed.
Eksemplet i Figur 6 viser hvordan det lokale fagsystem i forvejen har struktureret telefonnumrene på borgeren, og ved migreringen får skrevet hjemme nummeret til Fælles Stamkort. Hvorimod eksemplet i Figur 7 kun får skrevet hjemme nummeret, men får fejlkode tilbage på mobilnummeret, da dette eksisterer i forvejen.
Figur 6 - Migrering af borgerens hjemme telefonnummer til Fælles Stamkort
Figur 7 - Migrering af borgerens hjemme telefonnummer, men fejl på borgerens mobiltelefonnummer da dette eksisterer i forvejen.
#5: Fagsystemerne skal udelukkende migrere borgerens sprog, hvis det ikke eksisterer i forvejen
Fælles Stamkort har i forretningsregel nr. 11 defineret at der maksimalt kan være et sprog for borgeren, eksisterer der et sprog i forvejen, vil migreringsgrænsefladen returnere en fejlkode, og fagsystemet SKAL IKKE skrive borgerens sprog.
Fagsystemet BØR overveje hvordan sprog der ikke er migreret, skal håndteres lokalt.
Fejlkode: 820
Fejltekst: Borgerens sprog eksisterer i forvejen
Efterfølgende synkronisering af Fælles Stamkort, vil ske når borgeren er i kontakt med en myndighed.
Eksemplet i Figur 8 viser hvordan det Fælles Stamkort i forvejen har borgerens sprog til dansk, og ved migreringen får en fejlkode tilbage
Figur 8 - Migrering af borgerens sprog giver en fejlkode retur
#6: Fagsystemerne skal udelukkende migrere borgerens midlertidige adresse, hvis den ikke eksisterer i forvejen
Fælles Stamkort har i forretningsregel nr. 7 defineret at der maksimalt kan være en midlertidig adresse for borgeren i Fælles Stamkort, eksisterer der en midlertidig adresse i forvejen, vil migreringsgrænsefladen returnere en fejlkode, og fagsystemet SKAL IKKE skrive borgerens midlertidige adresse.
Fagsystemet BØR overveje hvordan en midlertidig adresse der ikke er migreret skal håndteres lokalt.
Fejlkode: 830
Fejltekst: Borgerens midlertidige adresse eksisterer i forvejen
Efterfølgende synkronisering af Fælles Stamkort, vil ske når borgeren er i kontakt med en myndighed.
Eksemplet i Figur 9 viser hvordan Fælles Stamkort i forvejen har borgerens midlertidige adresse, og ved migreringen giver en fejlkode tilbage til fagsystemet
Figur 9 - Migrering af borgerens midlertidige adresse giver en fejlkode retur
Tilslutning og governance i forhold til migreringsgrænsefladen.
Fagsystemer der tilsluttes migreringsgrænsefladen, SKAL have en whitelisting af det certifikat der benyttes til at skrive data til migreringsgrænsefladen.
Tilslutning SKAL anmeldes via den nationale servicedesk[1], hvor der oprettes en supportsag. Supportsagen SKAL indeholde "Subject" fra certifikatet, som følgende eksempel viser
Subject: SERIALNUMBER=CVR:11111111-FID:22222222 + CN=www.test-eksempel.dk – NemLogin (funktionscertifikat), O=Test-eksempel A/S // CVR:00000000, C=DK
Supportsagen SKAL ligeledes indeholde planlagt dato og tidspunkt for hvornår migreringen ønskes startet, således det kan planlægges fra Sundhedsdatastyrelsen at ikke alle fagsystemerne migrerer på samme tid.
Efter succesfuld migrering, vil whitelistingen for fagsystemet blive fjernet igen
Teknisk dokumentation.
Den tekniske dokumentation for migreringsgrænsefladen skal, efter godkendelse af dette dokument, opdateres. Ligeledes skal den eksisterende beskrivelse for synkronisering af stamkortdata, herunder fletteregler, tilpasses således det afspejler beslutningen i dette dokument.
Den tekniske dokumentation vil gøres tilgængelig via den tekniske implementeringsvejledning[2] til Fælles Stamkort på NSPOP.
[1] https://www.nspop.dk/category/sup
[2] https://www.nspop.dk/pages/viewpage.action?pageId=102370146
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.
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.
...
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 patient/borgerportaler.
...