HL7 Norway
FHIR implementasjonsguide for norsk kommunesektor
Felles startpunkt for forstÄelse og omforent bruk av FHIR i kommunal helse- og omsorgstjeneste.

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

Norske forhold

FormÄl og rolle

Dette kapittelet beskriver norske forhold som kommunal FHIR-bruk mÄ forholde seg til:

  • no-basis som nasjonalt profilgrunnlag
  • relevante nasjonale tjenester som VKP og Pasientens mĂ„ledata
  • kommunale kodeverk, klassifikasjoner og rapporteringsgrunnlag
  • prinsipper for videre kommunal profilering

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

Oversikt over basisprofiler (veiledende del)

Tabellen viser et kuratert utvalg av no-basis-profiler som ofte er relevante i kommunal sektor. Full oversikt finnes i Simplifier-prosjektet.

Praktisk leseguide:

  • Start med pasient og aktĂžrer (Patient, Practitioner, PractitionerRole, Organization).
  • Legg til kontekst (Location, Appointment) og dokumentasjon (DocumentReference, Composition).
  • Bruk kliniske ressurser (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.

Bruk av no-basis i denne IG-en (normativ del)

  • Der no-basis-profil finnes, SKAL den brukes som utgangspunkt.
  • Avledede profiler BØR konkretisere kommunal kontekst og krav, uten Ă„ bryte nasjonale forutsetninger.
  • Avvik fra no-basis BØR dokumenteres eksplisitt i guiden.

Forholdet mellom no-basis og kommunale profiler

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:

  • gjenbruke no-basis direkte der det er mulig
  • bare stramme inn felter som er viktige for kommunal samhandling
  • i denne versjonen ikke bruke MustSupport, siden profilene fortsatt er tidlige og skal ligge tett pĂ„ no-basis
  • unngĂ„ nye lokale variasjoner nĂ„r samme behov kan dekkes av no-basis og standard FHIR

Prinsipper for videre profilering (normativ del)

  • no-basis er et nasjonalt startpunkt og ikke en komplett sluttmodell for alle use case.
  • Kommunale avledede profiler KAN stramme inn kardinalitet og eventuelt senere bruke MustSupport eller bindings der det er nĂždvendig for samhandling.
  • Slike innstramminger BØR begrunnes med konkrete use case og dokumenteres som avvik fra no-basis.

Forholdet til VKP, PMD og annet nasjonalt arbeid

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:

  • Bruk no-basis for norske grunnprofiler.
  • Bruk VKPs nye informasjonstjenester, PMD eller andre nasjonale tjenester der de faktisk dekker dataflyt og tjenestebehov.
  • Bruk denne IG-en for Ă„ beskrive kommunal oppfĂžlgingskontekst: 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.

Relevante kodeverk og klassifikasjoner

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

  • IPLOS/KPR-funksjonsmĂ„l: Viktig nasjonal kontekst for funksjon og bistandsbehov, men ikke gjort til bindende FHIR-binding i denne fĂžrste generelle 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

  • Vi bĂžr bruke disse kildene som faglig og semantisk referanse i mapping og videre profilutvikling.
  • Vi bĂžr ikke kopiere dem ukritisk inn som nye FHIR CodeSystem eller bindings i en tidlig, generell kommunal IG.
  • FĂžr nye kommunale FHIR-kodeverk etableres, bĂžr eksisterende KPR/IPLOS, ICF, ICPC-2, ICD-10, LOINC, SNOMED CT og relevante nasjonale kodeverk vurderes.
  • Hvis det senere lages en egen profil eller mer presis modell for kommunalt vedtak, vil KPR-begreper og registreringskrav vĂŠre et naturlig sted Ă„ starte.

Identifikatorer og HER-id (normativ del)

  • For forretningsidentifikatorer SKAL identifier.system og identifier.value brukes sammen.
  • identifier.system BØR peke pĂ„ offisielt namespace (OID/URI) nĂ„r nasjonal identifikator finnes.
  • Hvis nasjonal identifikator ikke finnes, KAN lokal identifikator brukes, men med stabilt system-URI og tydelig dokumentasjon.
  • HER-id SKAL ikke brukes som primĂŠridentifier for Organization, Practitioner, Location, HealthcareService eller Endpoint i FHIR REST.

Referanser