Pasientens journaldokumenter i kjernejournal
Merk! Støtte for integrasjoner i produksjonsmiljøet vil være tilgjengelig når tillitsrammeverket er tatt i bruk. Antatt februar 2024.
Inntil da vil integrasjoner mot Pasientens journaldokumenter være mulig i testmiljøet.
Pasientens journaldokumenter er en tjeneste som tillater helsepersonell å tilgjengeliggjøre og slå opp journaldokumenter med andre helsepersonell/relevante personer, samt gir innbygger innsyn i egne journaldokumenter.
Tjenesten gir stor nytte blant annet for pasienter i uplanlagte behandlingsforløp (akuttsituasjoner), kjente pasienter med komplisert sykdomshistorikk eller pasienter som befinner seg i tverrfaglige behandlingsløp. Ved bruk av tjenesten hentes relevant informasjon tidligere virksomheter har registrert på en pasient, og sammenstilles for å gi behandleren et bilde av pasientens tidligere behandling. Dette bidrar til at de kan gjøre bedre og mer bevisste valg under behandling av pasienten.
Journaldokumentene blir tilgjengeliggjort for helsepersonell via Kjernejournal, og for innbygger via Helsenorge.
Slik går du frem for å utvikle integrasjon
For spørsmål om utvikling av integrasjon i test, bruk Slack-kanalen #ext-nhn-pasientens-journaldokumenter
For dokumentkonsument
Tjenesten er i første omgang kun tilgjengelig via Kjernejournal Portal i test, og er sikret med HelseID.
EPJ-leverandøren må støtte tillitsrammeverket for å kunne bli konsument. Tillitsrammeverk - GitHub 🡕
En del av tillitsrammeverket er overføring av helsepersonellets attest ved bruk av HelseID. Mer om dette her
En sentral del av tillitsrammeverket er informasjons- og datamodell for attestering av grunnlaget for tilgang til journaldokumenter. For Pasientens journaldokumenter så er disse feltene obligatorisk i attesteringen.
| Kategori | Attributt |
| practitioner | "identifier" |
| "legal-entity" | |
| "point-of-care" | |
| care-relation | "healthcare-service" |
| "decision-ref" |
1. Brukerpålogging med HelseID
For produksjon: Vesentlige endringer i bruk av HelseID kan føre til behov for at integrasjonen må godkjennes på nytt (kodegjennomgang).
Pasientens journaldokumenter krever brukerpålogging med HelseID. For EPJ-leverandører betyr dette at de må ha en integrasjon med HelseID brukerpålogging.
Se "Jeg ønsker å logge på en bruker via HelseID" i linken nedenfor
HelseID - Bruksmønstre og eksempelkode
2. Hent aksess-token fra HelseID
Det må være mulig for EPJ-en å hente aksesstokenet for helsepersonellet som ønsker å bruke tjenesten.
Se "Jeg ønsker å konsumere et REST-API som krever brukerpålogging" i linken nedenfor.
HelseID - Bruksmønstre og eksempelkode
Se også midlertidig løsning spesifikt for Pasientens journaldokumenter i testmiljø
3. Alternativ 1: Integrasjon med Kjernejournal
Kjernejournal - Single Sign On
Hvis det er første gang du tar i bruk kjernejournal, må du gjennomføre en godkjenning. Kjernejournal - Godkjenninger🡕
3. Alternativ 2: Integrasjon med API for Pasientens journaldokumenter
⚠ API-et er under utvikling, og ikke tilgjengelig for bruk per dags dato.
For dokumenttilbyder (kilde)
For integrasjoner som dokumenttilbyder anbefaler vi å begynne med en integrasjon mot Helsenorge.no, da vi har erfart at dette er løpet de fleste nye kildene går, og helsenorge-integrasjonen stiller færre tekniske krav.
Kilde til Helsenorge.no
For virksomheter under et samarbeidsområde (hvis virksomheten er under f.eks. Helse Sør-øst) må du ha en integrasjon mot det regionale endepunktet. Ta kontakt med IKT på det regionale foretaket virksomheten befinner seg under.
Fremgangsmåte
Videre må du henvende seg til NHN Kundesenter med ønske om å bli dokumentkilde for Pasientens journaldokumenter gjennom Helsenorge.no. Overordnet prosess i testmiljø:
- Anskaff og konfigurere opp en XCA-Gateway for kilden
- Skaffe OIDer for din tekniske løsning
- Etablere en teknisk løsning i ditt testmiljø for å kunne kommunisere med NHN test XDS/XCA. Innsyn pasientjournal - Helsenorge Atlassian 🡕
- Etablere infrastruktur i henhold til norsk profilering av XDS.b for å kunne lagre dokumenter og dokumentoversikt
- Mappe lokale journaldokumenter mot nasjonalt kodeverk 9602 🡕
- Kobling til endepunkter
- Av deg krever NHN en OID, en Registry-URL (Query) og en Repository-URL (Retrieve)
- Mappe opp endepunktet i kjernejournal og helsenorge
For virksomheter under et samarbeidsområde (hvis virksomheten er under f.eks. Helse Sør-øst) må du ha en integrasjon mot det regionale endepunktet. Ta kontakt med IKT på det regionale foretaket virksomheten din befinner seg under.
Løsningen muliggjør elektronisk tilgjengeliggjøring av journaldokumenter og erstatter dagens manuelle rutiner med digital tilgjengeliggjøring.
Fremgangsmåte
- Konfigurere opp en XCA-Gateway for kilden i produksjonsmiljø.
- Skaffe OIDer for din tekniske løsning i produksjon.
OBS! Det er viktig at de samme OID-ene fra testmiljø ikke brukes i produksjon! Skaff egne OID-er for produksjon.
- Etablere infrastruktur i produksjonsmiljøet med utgangspunkt i testmiljøet med nødvendige endringer for produktivt miljø. Innsyn pasientjournal - Helsenorge Atlassian 🡕
- Mappe lokale journaldokumenter mot nasjonalt kodeverk 9602 🡕
- Kobling til endepunkter i produksjon
- Av deg krever NHN en OID, en Registry-URL (Query) og en Repository-URL (Retrieve).
- Mappe opp endepunktet i kjernejournal og helsenorge
Kilde til Kjernejournal
For virksomheter under et samarbeidsområde (hvis virksomheten er under f.eks. Helse Sør-øst) må du ha en integrasjon mot det regionale endepunktet. Ta kontakt med IKT på det regionale foretaket virksomheten befinner seg under.
For tilkobling til NHNs testmiljø for Pasientens journaldokumenter er det forutsatt at EPJen virksomheten bruker har en integrasjon mot kjernejournal.
Fremgangsmåte
Videre må du henvende seg til NHN Kundesenter med ønske om å bli dokumentkilde for Pasientens journaldokumenter. Overordnet prosess i testmiljø:
- Anskaff og konfigurere opp en XCA-Gateway for kilden
- Skaffe OIDer for din tekniske løsning
- Etablere en teknisk løsning i ditt testmiljø for å kunne kommunisere med NHN test XDS/XCA
- Etablere infrastruktur i henhold til norsk profilering av XDS.b for å kunne lagre dokumenter og dokumentoversikt
- Mappe lokale journaldokumenter mot nasjonalt kodeverk 9602 🡕
- Kobling til endepunkter
- Av deg krever NHN en OID, en Registry-URL (Query) og en Repository-URL (Retrieve)
- NHN: Mappe opp endepunktet i kjernejournal.
Fremgangsmåte for de som allerede er kilde til helsenorge.
Hvis du allerede er kilde til Helsenorge, kreves det kun endringer til integrasjonen
- Endre på tilgangsstyringen for å ta imot kilder fra kjernejournal
- NHN: Mappe opp endepunktet i kjernejournal.
For virksomheter under et samarbeidsområde (hvis virksomheten er under f.eks. Helse Sør-øst) må du ha en integrasjon mot det regionale endepunktet. Ta kontakt med IKT på det regionale foretaket virksomheten din befinner seg under.
Løsningen muliggjør elektronisk tilgjengeliggjøring av journaldokumenter og erstatter dagens manuelle rutiner med digital tilgjengeliggjøring. Dette gjelder journaldokumenter i journalgruppene som er listet under. Både helsepersonelloven § 45 og pasientjournalloven § 19 hjemler virksomhetenes tilgjengeliggjøring av journaldokumenter (helseopplysninger).
P.t. er det kun journaldokumenter som eksplisitt fremgår av kjernejournalforskriften § 4 punkt 7 som kan gjøres tilgjengelige via løsningen:
- epikriser/sammenfatninger
- prøvesvar
- henvisninger
- billedundersøkelser
Fremgangsmåte
Videre må du henvende seg til NHN Kundesenter med ønske om å bli dokumentkilde for Pasientens journaldokumenter. Overordnet prosess i produksjons-miljø:
- Gjennomføre en personvernkonsekvensanalyse
- Gjennomføre en risiko og sårbarhetsanalyse
- Anskaff og konfigurere opp en XCA-Gateway for kilden
- Skaffe OIDer for din tekniske løsning i produksjon.
OBS! Det er viktig at de samme OID-ene fra testmiljø ikke brukes i produksjon! Skaff egne OID-er for produksjon og test. - Etablere infrastruktur i henhold til norsk profilering av XDS.b for å kunne lagre dokumenter og dokumentoversikt
- Etablere en teknisk løsning for å kunne kommunisere med XDS/XCA i produksjon
- Mappe lokale journaldokumenter mot nasjonalt kodeverk 9602 🡕
- Kobling til endepunkter i produksjon
- Av deg krever NHN en OID, en Registry-URL (Query) og en Repository-URL (Retrieve).
- Mappe opp endepunktet i kjernejournal og helsenorge
Fremgangsmåte for de som allerede er kilde til helsenorge.
Hvis du allerede er kilde til Helsenorge, kreves det kun endringer til integrasjonen
- Endre på tilgangsstyringen for å ta imot kilder fra kjernejournal
- NHN: Mappe opp endepunktet i kjernejournal.
Test av tjenesten for nye kilder
Når integrasjonen er oppe og går, må du verifisere at det er mulig for innbygger å kun hente ut dokumenter de skal ha tilgang til.
Listen er formatert som følger:
- (Tall) = Teststeg
- (Bokstav) = ønsket utfall av teststeg
Testforløp for konsument (ikke endelig):
- Hvis det ikke ligger dokumenter i dokumentlageret, lag et dokument med testdata for en testpasient og lagre dette i dokumentlageret på pasienten. Liste over testpasienter 🡕
- Registry burde oppdateres med metadaten om dokumentet.
- Hent dokumentlisten for en pasient som vi vet finnes hos den nye dokumentkilden
- Kilden skal returnere metadata
- Hent dokumentlisten for en pasient som vi vet ikke finnes hos den nye dokumentkilden
- Kilden skal ikke returnere metadata
- Hent et dokument fra dokumentlisten for en pasient som vi vet finnes hos den nye dokumentkilden
- informasjonen om en referansene i dokumentlisten skal kunne brukes for å hente ut et enkelt dokument. Dette dokumentet vil vises som forventet i en ny fane.
- Generell bruk av tjenesten for helsepersonell skal dukke opp i innsynslogg i helsenorge.no