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 basisprofiler

FormÄl og rolle

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.

Hvor publiseres profilene

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, SHALL den brukes som utgangspunkt.
  • Avledede profiler SHOULD konkretisere kommunal kontekst og krav, uten Ă„ bryte nasjonale forutsetninger.
  • Avvik fra no-basis SHOULD 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

No-basis-referanser i kommunale profiler

FĂžlgende referanser er lagt inn direkte i kommunale profiler:

  • KommuneKontakt.subject -> no-basis-Patient
  • KommuneKontakt.participant.individual -> no-basis-Practitioner eller no-basis-PractitionerRole eller no-basis-RelatedPerson
  • KommuneKontakt.location.location -> no-basis-Location
  • KommuneKontakt.serviceProvider -> no-basis-Organization
  • KommuneForlĂžp.patient -> no-basis-Patient
  • KommuneForlĂžp.managingOrganization -> no-basis-Organization
  • KommuneForlĂžp.careManager -> no-basis-Practitioner eller no-basis-PractitionerRole
  • KommuneOppfĂžlgingsplan.subject -> no-basis-Patient
  • KommuneOppfĂžlgingsplan.author -> no-basis-Practitioner eller no-basis-PractitionerRole eller no-basis-Organization
  • KommuneOppfĂžlgingsplan.supportingInfo (dokumentreferanser) -> no-basis-DocumentReference
  • KommuneOppfĂžlgingsplan.activity.reference (avtale) -> no-basis-Appointment
  • KommuneOppfĂžlgingsplan.activity.outcomeReference (dokumentreferanser) -> no-basis-DocumentReference

Prinsipper for videre profilering (normativ del)

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

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.

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.
  • 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- eller problemkoder som grunnlag for oppfĂžlging.
  • 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 felles minimum i denne IG-en

  • IPLOS / KPR-funksjonsmĂ„l: Viktig nasjonal kontekst for funksjon og bistandsbehov, men ikke egnet som eget FHIR-kodeverk 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.
  • 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 SHALL identifier.system og identifier.value brukes sammen.
  • identifier.system SHOULD peke pĂ„ offisielt namespace (OID/URI) nĂ„r nasjonal identifikator finnes.
  • Hvis nasjonal identifikator ikke finnes, MAY lokal identifikator brukes, men med stabilt system-URI og tydelig dokumentasjon.
  • HER-id SHALL ikke brukes som primĂŠridentifier for Organization, Practitioner, Location, HealthcareService eller Endpoint i FHIR REST.

Oppdatering og versjonering (veiledende del)

no-basis-profilene vedlikeholdes av HL7 Norge og publiseres pÄ Simplifier. Referer alltid til gjeldende versjon i Simplifier-prosjektet ved oppdatering av denne IG-en.

Referanser