FHIR implementasjonsguide for norsk kommunesektor
0.1.0 - ci-build
NO
FHIR implementasjonsguide for norsk kommunesektor - Local Development build (v0.1.0) built by the FHIR (HL7Âź FHIRÂź Standard) Build Tools. See the Directory of published versions
Dette kapittelet beskriver norske forhold som kommunal FHIR-bruk mÄ forholde seg til:
no-basis som nasjonalt profilgrunnlagNorske basisprofiler (no-basis) er et nasjonalt utgangspunkt for FHIR-profilering i Norge. Profilene er ment som et Äpent utgangspunkt for videre profilering i konkrete brukstilfeller.
Kortversjon:
| Tema | Hva betyr det for denne IG-en |
|---|---|
no-basis |
Brukes som nasjonalt basislag fĂžr nye kommunale varianter etableres. |
| VKP, nye informasjonstjenester og PMD | Dekker nasjonale dataflyter/tjenester der disse er relevante. VKP moderniseres til API-baserte informasjonstjenester pÄ kommunal samhandlingsplattform. Denne IG-en erstatter dem ikke. |
| KPR/IPLOS og ICF | Er viktige semantiske kilder for videre arbeid med tjenestetype, vedtak, funksjon og bistandsbehov. |
| ICPC-2, ICD-10, LOINC, SNOMED CT | Brukes der de passer faglig, men skal ikke forveksles med kommunale tjenestekodeverk. |
Tabellen viser et kuratert utvalg av no-basis-profiler som ofte er relevante i kommunal sektor. Full oversikt finnes i Simplifier-prosjektet.
Praktisk leseguide:
Patient, Practitioner, PractitionerRole, Organization).Location, Appointment) og dokumentasjon (DocumentReference, Composition).MedicationStatement, AllergyIntolerance) nÄr innholdet faktisk er klinisk.| Ressurs | no-basis profil | Typisk nÄr relevant |
|---|---|---|
| Patient | no-basis-Patient | NÄr data gjelder en pasient i tjenesteforlÞp, oppfÞlging eller dokumentasjon. |
| Person | no-basis-Person | NÄr personen skal beskrives pÄ tvers av roller/systemer uten at konteksten er en konkret pasientkontakt. |
| Practitioner | no-basis-Practitioner | NÄr du trenger identitet pÄ tjenesteutÞver (individ). |
| PractitionerRole | no-basis-PractitionerRole | NÄr ansvar/funksjon mÄ knyttes til organisasjon og rolle, ikke bare person. |
| Organization | no-basis-Organization | NÄr enhet/virksomhet og organisatorisk ansvar skal beskrives. |
| RelatedPerson | no-basis-RelatedPerson | NÄr pÄrÞrende/nÊrstÄende er relevante i oppfÞlging og samhandling. |
| Location | no-basis-Location | NÄr tjenestested eller fysisk lokasjon har betydning for kontakt/tiltak. |
| Appointment | no-basis-Appointment | NÄr kontakt er planlagt fÞr en gjennomfÞrt Encounter. |
| DocumentReference | no-basis-DocumentReference | NÄr vedtak, brev eller annen dokumentasjon skal deles som referanse til dokumentinnhold. |
| Composition | no-basis-Composition | NÄr dokumentet er strukturert (seksjoner/helhet), f.eks. journalnotat eller strukturert vedtak. |
| Endpoint | no-basis-Endpoint | NÄr tekniske adresser/endepunkter for samhandling mÄ publiseres og forvaltes. |
| HealthcareService | no-basis-HealthcareService | NÄr tjenestetilbudet (hva som leveres) skal beskrives, uavhengig av konkret kontakt. |
| Address | no-basis-Address | NÄr norsk adresseformat mÄ brukes konsistent pÄ tvers av ressurser. |
| HumanName | no-basis-HumanName | NÄr personnavn skal representeres konsistent etter norsk navnepraksis. |
| Medication | no-basis-Medication | NÄr legemiddelobjektet i seg selv skal beskrives (produkt/innhold). |
| MedicationStatement | no-basis-MedicationStatement | NÄr opplysninger om faktisk legemiddelbruk hos pasient skal deles. |
| AllergyIntolerance | no-basis-AllergyIntolerance | NÄr allergier/intoleranser mÄ vÊre tilgjengelige i oppfÞlging og beslutningsstÞtte. |
| Substance | no-basis-Substance | NÄr stoffer mÄ identifiseres pÄ tvers av bruk, f.eks. i allergi- og legemiddelsammenheng. |
no-basis er nasjonale basisprofiler. De skal vÊre Äpne og generelle, og brukes pÄ tvers av mange anvendelser i Norge.
De kommunale profilene i denne IG-en er avledede omrÄdeprofiler. De skal derfor:
no-basis direkte der det er muligMustSupport, siden profilene fortsatt er tidlige og skal ligge tett pÄ no-basisno-basis og standard FHIRMustSupport eller bindings der det er nÞdvendig for samhandling.Denne IG-en bÞr leses sammen med pÄgÄende nasjonalt arbeid, men den erstatter ikke nasjonale informasjonstjenester eller plattformer.
| Initiativ | Rolle | Forhold til denne IG-en |
|---|---|---|
no-basis |
Nasjonale basisprofiler for FHIR i Norge | Denne IG-en bygger pÄ no-basis og lager kommunale omrÄdeprofiler der kommunal kontekst mÄ presiseres. |
VKP / nye API-baserte informasjonstjenester |
VKP moderniseres/erstattes av enkeltstÄende informasjonstjenester for integrasjon, uthenting og journalfÞring mellom velferdsteknologiske lÞsninger og EPJ | Disse tjenestene etableres pÄ kommunal samhandlingsplattform. Denne IG-en beskriver ikke VKP-flyt, tilgangsstyring eller journalfÞring. Den beskriver kommunal kontekst rundt forlÞp, plan og kontakt. |
Pasientens mÄledata (PMD) |
Nasjonal informasjonstjeneste for mÄledata, sÊrlig Observation |
Denne IG-en lager ikke egen mÄledataprofil i v0.1. MÄlinger kan inngÄ som stÞttedata i kommunal oppfÞlging. |
| Oslo kommune / velferdsteknologi og digital hjemmeoppfÞlging | Kommunal tjenesteutvikling, hÄndbÞker, utprÞving og bruk av data fra velferdsteknologi | Erfaringene er relevante for use case og eksempler, sÊrlig digital hjemmeoppfÞlging, men denne IG-en gjÞr ikke Oslo-modeller til nasjonale krav. |
| Oslo kommune / NO Municipal API | Kommunalt FHIR-arbeid med profiler og API-sider for blant annet Encounter, CarePlan, EpisodeOfCare, Observation og DocumentReference |
Brukes som erfaringsgrunnlag og inspirasjon. Denne IG-en lÞfter arbeidet til et mer generelt kommunalt startpunkt og bygger pÄ no-basis. |
| Kommunal samhandlingsplattform / kommunale samhandlingstjenester | Plattform og lĂžsningsmĂžnster for standardiserte samhandlingstjenester, med NHN som sentral plattformaktĂžr | VKP-moderniseringen er en konkret anvendelse av dette mĂžnsteret. Denne IG-en kan bidra med semantisk avklaring og kommunale profiler som kan brukes i slike sammenhenger. |
Praktisk konsekvens:
NoKommuneEpisodeOfCare, NoKommuneCarePlan og NoKommuneEncounter.VKP bÞr derfor omtales som et arbeid i endring, ikke bare som en eksisterende enkeltlÞsning. NHN beskriver at dagens VKP skal erstattes av enkeltstÄende API-baserte informasjonstjenester i lÞpet av 2026. Disse tjenestene etableres pÄ kommunal samhandlingsplattform. Det betyr at VKP-funksjonalitet flyttes inn i et mer modulÊrt og skalerbart samhandlingsmÞnster.
Oslo kommune er sÊrlig relevant som erfaringsgrunnlag fordi kommunen har arbeidet systematisk med velferdsteknologi, digital hjemmeoppfÞlging, digitalt tilsyn, digital medisineringsstÞtte og bruk av data fra velferdsteknologiske tjenester. Oslo kommune beskriver ogsÄ hÄndbÞker for velferdsteknologi basert pÄ helhetlig tjenestemodell fra KS. Helsedirektoratets omtale av Pasientens mÄledata peker i tillegg pÄ at Oslo kommune deltar sammen med Oslo universitetssykehus i arbeid med sammenhengende pasientforlÞp.
Oslo kommunes publiserte NO Municipal API viser ogsÄ at flere av de samme FHIR-ressursene er praktisk relevante i kommunal kontekst, blant annet Encounter, CarePlan, EpisodeOfCare, DocumentReference og Observation. Dette stÞtter behovet for en generell kommunal FHIR-IG som kan beskrive forlÞp, plan, ansvar og kontakt rundt mÄledata og velferdsteknologi. Samtidig bÞr denne IG-en ikke presenteres som en kopi av Oslo-arbeidet. Ambisjonen er et felles kommunalt startpunkt som kan gjenbruke erfaringene, men som er tydelig forankret i no-basis og bredere norske forhold.
Denne IG-en innfĂžrer ikke nye kommunale kodeverk i fĂžrste versjon. Likevel finnes det noen klassifikasjoner og registreringsgrunnlag som er sĂŠrlig relevante som semantisk bakteppe for videre arbeid.
Kommunale kodeverk er viktige fordi mange kommunale informasjonsbehov handler om tjenestetype, vedtak, funksjonsnivÄ, bistandsbehov, tiltak og rapportering. Denne guiden bÞr derfor peke pÄ relevante kodeverk og klassifikasjoner, men ikke kopiere dem inn som nye FHIR-kodeverk fÞr behovet er tydelig avklart.
SÊrlig relevante Ä bygge videre pÄ
KPR og registrering av helse- og omsorgsdata i kommunen:
Gir et nasjonalt begrepsgrunnlag for kommunale tjenester, tjenestekoder, vedtak og rapporteringskrav. Dette er sĂŠrlig relevant for videre arbeid med vedtak, tjenestetype, omfang, oppstart, avslutning og kommunal tjenestekontekst.IPLOS:
IPLOS-begreper og historikken rundt rapportering av helse- og omsorgsdata er fortsatt viktige for kommunal forstÄelse av funksjon, bistandsbehov og tjenestetype. I videre FHIR-arbeid bÞr IPLOS/KPR-begreper vurderes fÞr nye lokale kommunale kodeverk etableres.ICF:
Er relevant som begrepsgrunnlag for funksjon, bistandsbehov, mÄl og oppfÞlging.ICD-10 og ICPC-2:
Er relevante nÄr kommunale systemer allerede bruker diagnose-, kontaktÄrsaks- eller problemkoder som grunnlag for oppfÞlging. ICPC-2 er sÊrlig relevant i primÊrhelsetjeneste og fastlegekontekst, men er ikke et kommunalt tjenestekodeverk.NEWS2 og tilsvarende mÄlesett:
Er relevante for deling av mÄlinger via Observation, sÊrlig i arbeid med digital hjemmeoppfÞlging og velferdsteknologi.Relevant som bakgrunn, men ikke som bindende minimum i denne IG-en
IPOS:
Kan vÊre relevant i avgrensede fagomrÄder som palliasjon, men er for smalt som generelt kommunalt minimum i denne IG-en.Praktisk konsekvens for denne IG-en
CodeSystem eller bindings i en tidlig, generell kommunal IG.vedtak, vil KPR-begreper og registreringskrav vĂŠre et naturlig sted Ă„ starte.identifier.system og identifier.value brukes sammen.identifier.system BĂR peke pĂ„ offisielt namespace (OID/URI) nĂ„r nasjonal identifikator finnes.HER-id SKAL ikke brukes som primĂŠridentifier for Organization, Practitioner, Location, HealthcareService eller Endpoint i FHIR REST.