NO Municipal API
0.2.0 - ci-build

NO Municipal API - Local Development build (v0.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Use Case Municipal Services

Use case: Municipal Services

Municipal services are a part of the municipal healthcare system and various services are assigned to citizens according to their needs. The services are provided by the municipality.

The municipalities report on the services they provide to the citizens. The reporting is done by the municipality and is typically based on the data contained in a local EHR system. Services are classified by a service code as described by the Norwegian Directorate of Health and is documented in the National code repository

List of service codes:

Code Service Name
1 Praktisk bistand - daglige gjøremål
2 Praktisk bistand - opplæring - daglige gjøremål
3 Praktisk bistand - brukerstyrt - personlig assistanse
4 Dagaktivitetstilbud
5 Matombringing
6 Trygghetsalarm
7 Avlastning utenfor institusjon
8 Avlastning i institusjon
9 Støttekontakt
11 Omsorgsstønad
14 Bruk av tvang psykisk utviklingshemning – planlagte tiltak
15 Helsetjenester i hjemmet
17 Dagopphold i institusjon
18 Tidsbegrenset opphold - utredning/behandling
19 Tidsbegrenset opphold - habilitering/rehabilitering
20 Tidsbegrenset opphold - annet
21 Langtidsopphold i institusjon
22 Nattopphold i institusjon
23 Bruk av tvang psykisk utviklingshemning – nødsituasjoner
24 Helsehjelp med tvang
25 Kommunal øyeblikkelig hjelp - døgnopphold
26 Lokaliseringsteknologi (GPS)
27 Elektronisk medisineringsstøtte
28 Digitalt tilsyn
29 Bolig som kommunen disponerer for helse- og omsorgsformål

Information about the services assigned to a citizen can be useful in a number of clinical settings. For example, it can be important to know what services a citizen has access to when they are discharged from a hospital in order to ensure an appropriate transition to home care or other services.

NHN has created a national service for storing municipal services assigned to citizens. Local EHR systems report the services assigned to citizens to this service.

Looking up the services assigned to a citizen

Sequence describes lookup from clinical context, e.g. when a citizen is admitted to or discharged from a hospital.

Case workerCitizenEHR AHelseIDNHN Municipal ServicesEHR BHealth personelCase workerCase workerCitizenCitizenEHR AEHR AHelseIDHelseIDNHN Municipal ServicesNHN Municipal ServicesEHR BEHR BHealth personelHealth personel1Request municipal service2Process request and assign municipal service3Authenticate system / fetch access token4POST /services {patient: {Patient}, services: [{Municipal-service}], ..}5201 Created6Treatment with information needed about municipal services7Lookup municipal service for citizen8Authenticate system / fetch access token9GET /services/{patient-id}10200 OK {patient: {Patient}, services: [{Municipal-service}]}

Looking up all services of type

Sequence describes lookup of all services of one particular type to analyze distribution of services in a municipality.

Case workerCitizenHealth administratorEHRHelseIDCase workerCase workerCitizenCitizenHealth administratorHealth administratorEHREHRHelseIDHelseID1Request municipal service2Process request and assign municipal service3Authenticate system / fetch access token4Search for municipal service of type X5200 OK {services: [{Municipal-service}]}