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
Denne siden er en praktisk lesehjelp for å gå fra kommunale begreper til FHIR.
Målgruppen er personer som kjenner kommunale helse- og omsorgstjenester, men som ikke nødvendigvis kjenner FHIR godt. Tabellen under er derfor ikke en komplett datamodell. Den viser anbefalt startpunkt: hvilken FHIR-ressurs du normalt bør se på først, og hva du ikke bør blande sammen.
Start med spørsmålet du prøver å svare på:
| Spørsmål | Typisk FHIR-startpunkt |
|---|---|
| Hvem gjelder informasjonen? | Patient, eventuelt RelatedPerson for pårørende/nærstående |
| Hvem har ansvar? | Organization, PractitionerRole, Practitioner, CareTeam |
| Hva er besluttet eller dokumentert? | DocumentReference, eventuelt Composition |
| Hva er bestilt eller ønsket utført? | ServiceRequest |
| Hvilket kommunalt forløp hører dette til? | EpisodeOfCare / NoKommuneEpisodeOfCare |
| Hva er planen for oppfølging? | CarePlan / NoKommuneCarePlan |
| Hva skjedde faktisk? | Encounter / NoKommuneEncounter |
| Hva ble målt eller vurdert? | Observation, eventuelt QuestionnaireResponse |
| Kommunalt begrep | Bruk FHIR-ressurs | Når passer den? | Viktige elementer | Kommentar |
|---|---|---|---|---|
| Pasient / bruker | Patient |
Når informasjonen gjelder en person som mottar helsehjelp eller kommunal oppfølging. | identifier, name, birthDate, address |
Bruk no-basis-Patient der pasientdata deles. |
| Pårørende / nærstående | RelatedPerson |
Når en person er relevant fordi vedkommende står i relasjon til pasienten. | patient, relationship, name, telecom |
Brukes for pårørende, kontaktperson eller annen nærstående i oppfølging. |
| Kommunal enhet / tjenesteansvarlig | Organization |
Når ansvarlig kommune, bydel, virksomhet eller tjenesteenhet skal beskrives. | identifier, name, partOf, type |
Bruk no-basis-Organization. |
| Tjenesteutøver | Practitioner |
Når individet som utfører eller vurderer skal identifiseres. | identifier, name, qualification |
Ofte bør rolle og organisasjon beskrives med PractitionerRole. |
| Rolle/funksjon i tjenesten | PractitionerRole |
Når en person opptrer i en rolle hos en organisasjon. | practitioner, organization, code, specialty |
Nyttig for koordinator, sykepleierrolle, fysioterapeutrolle osv. |
| Tverrfaglig team | CareTeam |
Når flere roller deler ansvar for oppfølgingen. | subject, participant, managingOrganization |
Gir bedre kontekst enn å liste enkeltpersoner løst. |
| Tjenestested / pasientens hjem / base | Location |
Når fysisk sted er relevant for kontakt eller tjeneste. | name, address, managingOrganization |
Bruk no-basis-Location der lokasjon deles. |
| Vedtak, brev, epikrise eller dokumentgrunnlag | DocumentReference |
Når et dokument skal refereres eller deles. | type, subject, date, author, content |
Vedtak er dokumentgrunnlag. Det er ikke det samme som bestilling/oppdrag. |
| Strukturert dokument | Composition |
Når dokumentet skal representeres med seksjoner og struktur. | type, subject, author, section |
Aktuelt for strukturert vedtak, notat eller rapport, men ikke nødvendig for alle dokumenter. |
| Bestilling, henvisning eller oppdrag | ServiceRequest |
Når noen ber om at noe skal utføres eller følges opp. | status, intent, code, subject, requester, performer, occurrence[x] |
Brukes for oppdraget. Dokumentet bak oppdraget kan ligge i DocumentReference. |
| Kommunalt tjenesteforløp | EpisodeOfCare / NoKommuneEpisodeOfCare |
Når kommunen følger en pasient over tid og har ansvar eller tjenestekontekst. | status, patient, period, managingOrganization, careManager, team |
Samler plan, kontakter, ansvar og dokumentgrunnlag i samme kontekst. |
| Oppfølgingsplan, tiltaksplan, besøksplan eller tjenesteoversikt | CarePlan / NoKommuneCarePlan |
Når mål, tiltak, planperiode og oppfølging skal beskrives på et samhandlingsnivå. | status, intent, category, subject, period, author, activity, goal, supportingInfo |
Skal ikke modellere hele lokal arbeidsliste eller turnus. Gir verdi når planen skal deles eller gjenfinnes. |
| Gjennomført kontakt | Encounter / NoKommuneEncounter |
Når en kontakt faktisk har skjedd: hjemmebesøk, telefon, video, møte, tilsyn eller vurdering. | status, class, type, subject, period, participant, serviceProvider, episodeOfCare |
Ikke bland med planlagt kontakt. Planlagt kontakt kan være Appointment. |
| Planlagt kontakt | Appointment |
Når kontakt er planlagt, men ikke gjennomført. | status, start, end, participant |
Når kontakten er gjennomført, kan den dokumenteres som Encounter. |
| Måling eller vurdering | Observation |
Når en strukturert måling eller vurdering skal deles. | code, value[x], effective[x], subject, performer |
Måledata bør følge relevante nasjonale profiler/tjenester der de finnes, for eksempel PMD. |
| Skjema eller funksjonskartlegging | QuestionnaireResponse eller Observation |
Når informasjonen kommer fra skjema, kartlegging eller strukturert vurdering. | questionnaire, item, answer eller Observation.code/value |
IPLOS/KPR/ICF-lignende funksjonsvurderinger bør vurderes nøye før det lages egne extensions. |
| Tilstand, problem eller diagnose | Condition |
Når et helseproblem eller en klinisk tilstand er relevant for oppfølgingen. | clinicalStatus, verificationStatus, code, subject, onset[x] |
ICPC-2, ICD-10 eller SNOMED CT kan være relevant avhengig av kontekst og system. |
| Oppgave / arbeidsflyt | Task |
Når arbeidsflyt, tildeling eller oppgavestatus må beskrives. | status, intent, focus, owner, executionPeriod |
Brukes bare når arbeidsflyt faktisk skal deles. Ikke nødvendig for alle planer. |
| Ikke bland sammen | Kort forklaring |
|---|---|
| Vedtak og bestilling | Vedtaket er dokumentgrunnlag (DocumentReference). Bestillingen eller oppdraget er ofte ServiceRequest. |
| Planlagt kontakt og gjennomført kontakt | Planlagt kontakt kan være Appointment. Gjennomført kontakt er Encounter. |
| Måling og kontakt | Måling er normalt Observation. Kontakt eller vurderingssamtale er Encounter. |
| Kommunalt forløp og behandlingskontakt | EpisodeOfCare beskriver oppfølging/ansvar over tid. Encounter beskriver en faktisk kontakt. |
| Lokal journalstruktur og samhandlingsminimum | Denne IG-en beskriver data som skal deles eller forstås på tvers, ikke hele internmodellen i EPJ. |
| NAV/saksbehandling og kommunal helsehjelp | NAV- eller saksbehandlingsprosesser modelleres ikke her. Relevante dokumenter kan eventuelt refereres som DocumentReference. |
Kommunale kodeverk er relevante, men denne IG-en etablerer ikke nye kommunale kodeverk i v0.1. Prinsippet er å bruke eksisterende norske og internasjonale kodeverk før nye lokale kodeverk etableres.
| Behov | Relevante kilder | Foreløpig FHIR-retning |
|---|---|---|
| Tjenestetype, tjenestegruppe, vedtak og rapporteringsgrunnlag | KPR/IPLOS og registrering av helse- og omsorgsdata i kommunen | Vurderes for ServiceRequest.code, CarePlan.category, EpisodeOfCare.type og dokumenttype/kategori. Ingen bindende binding i v0.1. |
| Funksjon, bistandsbehov og mestring | ICF og IPLOS/KPR-funksjonsvurdering | Bør normalt modelleres som Observation eller QuestionnaireResponse, eventuelt med Goal når det gjelder mål for oppfølging. |
| Kontaktårsak, problem og diagnose i primærhelsetjeneste | ICPC-2, ICD-10 og eventuelt SNOMED CT der aktuelt | Kan brukes i Condition.code, Encounter.reasonCode eller Observation.code når implementasjonen allerede har slik koding. |
| Måledata og vitale målinger | LOINC, UCUM, NEWS2 og nasjonale måledatatjenester som PMD | Bør modelleres som Observation. Denne IG-en definerer ikke egen måledataprofil. |
Når kodeverk brukes i et konkret API, bør støttede koder og bindings dokumenteres i tjenestens CapabilityStatement eller tilhørende tjenestedokumentasjon.