HL7 Norway
FHIR Implementation Guide for the Norwegian Municipal Sector
Shared starting point for understanding and consistent use of FHIR in municipal health and care services.
Norwegian

FHIR Implementation Guide for the Norwegian Municipal Sector
0.2.0 - ci-build NO

FHIR Implementation Guide for the Norwegian Municipal Sector - Local Development build (v0.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Examples

This page shows the reusable municipal example instances as a connected example set. It follows the same example instances that are listed in the artifact pages, but presents them in clinical and workflow order so readers can see how the resources relate to one another.

The examples are non-normative. They illustrate one possible municipal follow-up chain after discharge and should be read together with Modelling and profiling and Use cases.

Example Sections

Overview

The example describes Kari Hansen after discharge from hospital. The municipality receives a decision/supporting document, creates two service requests, establishes a municipal episode and follow-up plan, and records contacts and supporting information over time.

The diagram below is a presentation flow, not a complete reference diagram. It tells the story in the example set with concrete example resources in each step. Click a resource box to open the generated FHIR example page.

The Kari example from request to planned and completed follow-up Diagram showing ServiceRequest as request, EpisodeOfCare as shared frame, CarePlan as plan, Appointment as planned contact and Encounter as completed follow-up. 1. Kari and basis Kari is the patient. A decisionor supporting document explainswhy the municipality follows up. Patient Document 2. What should be followed up? The requests describe the work:home nursing, ADL assistance andrehabilitation assessment. ServiceRequesthome nursing ServiceRequestrehabilitation 3. EpisodeOfCare: shared municipal frame The plan, appointments and completed contacts belong to the same follow-up over time. ExampleEpisodeOfCare CarePlan The plan makes goals,interventions and furtherfollow-up concrete. ExampleCarePlan Appointment Planned contactbefore it hashappened. Appointment Encounter Contact, meetingor stay that hashappened. Encounter How the relationship works EpisodeOfCare is the frame for follow-up over time.CarePlan describes what should be followed up and how.Appointment is planned contact. Encounter is completed contact.If the contact fulfills an appointment, Encounter.appointment can point back. Completed contacts/stays in the same EpisodeOfCare ShortTermStayshort-term stay Encounterhome visit EncounterFollowupdigital contact EncounterPhonephone contact EncounterEvaluationevaluation meeting Supporting data such as HealthConcern, Observation, CareTeam and Goal can support the request and plan.
Story flow for municipal FHIR examples A simplified clickable overview showing how the Kari example connects patient and supporting documentation, service requests, shared episode context, care plan, planned appointment and completed contacts. 1. Kari and basis Kari (87) is identified.The municipality hassupporting documentationfor follow-up. ExamplePatientKari Hansen DocumentReferencedecision / supportingdocument 2. Municipal requests What the municipalityshould do is modelledas requests. ServiceRequesthome nursing andADL assistance ServiceRequestrehabilitationassessment 3. Shared episode context The episode is the framethat requests, plan andcontacts belong toover time. EpisodeOfCaremunicipal follow-upepisode 4. Plan in the episode The plan makes goals,interventions, appointmentsand follow-up concrete. CarePlanADL, practical supportand rehabilitation Goalpractical follow-up goal 5. Planned contact Before the visit hashappened, it is aplanned appointment. Appointmentplanned home visit22 January 6. Completed follow-up When a contact, meetingor stay has happened,it is documented asEncounter. All Encounter examplesbelow point to the sameepisode. Completed Encounter examples in the same municipal EpisodeOfCare ShortTermStayshort-term stayafter discharge Encounterfirst home visitafter discharge EncounterFollowupdigital follow-up EncounterPhonephone with patientand next of kin EncounterEvaluationmultidisciplinaryevaluation Supporting context used by requests and plan HealthConcernhip fracture as reason Observationstructured assessment CareTeammunicipal team no-kommune profile no-basis profile standard FHIR resource

How to read the diagram: the order is pedagogical, not a requirement for exact creation time. Kari and the supporting document provide context. The service requests describe what the municipality should follow up. EpisodeOfCare is a higher-level shared episode context; CarePlan, Appointment and completed Encounter contacts belong to that context over time. CarePlan makes plan, goals, activities and outcomes concrete. Appointment shows a planned contact before it has happened, while completed contacts, meetings and stays are documented as Encounter. If a completed contact documents that it fulfilled a specific appointment, use Encounter.appointment.

Patient, Organization And Roles

This section establishes the patient and municipal actors used throughout the example. The person, organization, locations and roles use no-basis profiles in meta.profile where no-basis profiles exist.

Example Profile reference Role in the examples
ExamplePatient no-basis-Patient Patient receiving municipal follow-up.
ExampleOrganization no-basis-Organization Responsible municipal unit.
ExamplePractitioner no-basis-Practitioner Coordinator or municipal service practitioner.
ExamplePractitionerRole no-basis-PractitionerRole Role that links practitioner and organization.
ExampleRelatedPerson no-basis-RelatedPerson Next of kin used in the phone contact example.

Decision And Municipal Service Requests

The decision or supporting document is not modelled as the request itself. It is represented as a DocumentReference. The practical assignment is represented with municipal ServiceRequest examples.

Example Profile reference What it shows
ExampleDocumentReference no-basis-DocumentReference Decision document or other supporting document for follow-up.
ExampleServiceRequest no-kommune-ServiceRequest Request for home nursing and ADL assistance after discharge.
ExampleRehabilitationServiceRequest no-kommune-ServiceRequest Additional rehabilitation request in the same episode.

Episode And Follow-Up Plan

The episode gives shared context over time. The care plan describes goals, plan period, involved team, supporting information and planned activities.

Example Profile reference Key links
ExampleEpisodeOfCare no-kommune-EpisodeOfCare References the service requests through referralRequest, and links to patient and responsible organization.
ExampleCarePlan no-kommune-CarePlan References the service requests, appointment, encounters, observation, goal and supporting document.
ExampleCareTeam FHIR CareTeam Shows a multidisciplinary municipal team.
ExampleGoal FHIR Goal Goal used by the follow-up plan.

Completed Contacts And Stay

Completed contacts are represented as Encounter, while planned contact is represented as Appointment until the contact has happened. In this example set, the completed contacts point to the relevant request and the same municipal episode. If a completed contact documents that it fulfilled a specific appointment, Encounter.appointment can point to Appointment.

Example Profile reference What it shows
ExampleShortTermStay no-kommune-Encounter Short-term municipal stay after discharge.
ExampleEncounter no-kommune-Encounter First home visit after discharge.
ExampleAppointment no-basis-Appointment Planned follow-up visit linked to ExampleServiceRequest through basedOn.
ExampleEncounterFollowup no-kommune-Encounter Digital follow-up contact.
ExampleEncounterPhone no-kommune-Encounter Phone contact with patient and next of kin.
ExampleEncounterEvaluation no-kommune-Encounter Multidisciplinary evaluation meeting.

Supporting Information

Supporting resources can be used where they add useful context. They are not all municipal profiles in this version.

Example Profile reference How it is used
ExampleObservation FHIR Observation Structured assessment supporting follow-up.
ExampleHealthConcern FHIR Condition Health concern used as reason/context.
ExampleLocation no-basis-Location Municipal service base.
ExampleHomeLocation no-basis-Location Patient home as contact location.
ExampleShortTermLocation no-basis-Location Short-term ward location.

Complete Clickable Resource List

Step Examples
Patient and actors ExamplePatient, ExampleOrganization, ExamplePractitioner, ExamplePractitionerRole, ExampleRelatedPerson
Other practitioners and roles ExamplePhysiotherapist, ExamplePhysiotherapistRole, ExampleOccupationalTherapist, ExampleOccupationalTherapistRole
Decision and requests ExampleDocumentReference, ExampleServiceRequest, ExampleRehabilitationServiceRequest
Episode, plan and team ExampleEpisodeOfCare, ExampleCarePlan, ExampleCareTeam, ExampleGoal
Contacts and planned contact ExampleShortTermStay, ExampleEncounter, ExampleAppointment, ExampleEncounterFollowup, ExampleEncounterPhone, ExampleEncounterEvaluation
Supporting data and places ExampleObservation, ExampleHealthConcern, ExampleLocation, ExampleHomeLocation, ExampleShortTermLocation