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}]}