Finnish Base Profiles
2.0.0 - release

Finnish Base Profiles, published by HL7 Finland. This guide is not an authorized publication; it is the continuous build for version 2.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/fhir-fi/finnish-base-profiles/ and changes regularly. See the Directory of published versions

## Extension: Municipality Code

Official URL: https://hl7.fi/fhir/finnish-base-profiles/StructureDefinition/municipality-code | Version: 2.0.0
Active as of 2025-10-05 | Computable Name: MunicipalityCode

Extension for home municipality. Home municipality is relevant for ex. in billing and listing available healthcare services, and for statistical purposes. It it not necessarily the place where a patient lives, rather closer to where they pay their taxes.

Context of Use

This extension may be used on the following element(s)

- Element ID: `Patient`

### Scope and Usage

The purpose of Municipality code is to represent the municipality of residence which is always registered by the Digital and Population Data Services Agency. The municipality of residence indicates that the person has right to use certain services provided by municipality or wellbeing services county. Municipalities are part of wellbeing services counties. Municipality of residence will also indicate in which municipality the person pays taxes.

> NOTE:The responsibility for organising primary care services was transferred from municipalities to wellbeing services counties on January 1, 2023. This means that the municipality code would not be sufficient information in a case of billing wellbeing services county from using secondary care services via referral. Nevertheless the municipality code does offer one way of deducing the correct wellbeing services county, when needed.

Municipality of residence differs from address information which represents the contact address of the patient. In most cases the contact address is at the municipality of residence but for instance due to work location one might have separate residence which serves as a contact address. The address which corresponds to municipality of residence is in a different location.

At the time this profile has been created, use cases for using municipality code focus on billing and deducing the correct wellbeing services county. Although municipality is not the responsible party of producing wellbeing services, most billing systems still handle invoices on municipality level. The base profiles do not yet contain a seperate profile to represent wellbeing services county, so even in other than billing use cases the deducing of the correct county will have to be done through the municipality. Once all systems are capable of handling counties and there is a mature national profile for county, the municipality code extension may be deprecated.

Usage info

Usages:

- Use this Extension: FI Base Patient and FI Base Patient
- Examples for this Extension: Patient/patient-of-municipality and Patient/patient-with-turvakielto

You can also check for usages in the FHIR IG Statistics

### Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

- Differential Table
- Snapshot Table
- Statistics/References
- All

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | The home municipality of the patient (not necessarily where they live).
extension |  | 0..0 |  |
url |  | 1..1 | uri | "https://hl7.fi/fhir/finnish-base-profiles/StructureDefinition/municipality-code"
value[x] |  | 1..1 | Coding | Value of extension
system |  | 0..1 | uri | Identity of the terminology system Required Pattern: urn:oid:1.2.246.537.6.21
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | The home municipality of the patient (not necessarily where they live).
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  |
url |  | 1..1 | uri | "https://hl7.fi/fhir/finnish-base-profiles/StructureDefinition/municipality-code"
value[x] |  | 1..1 | Coding | Value of extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | Σ | 0..1 | uri | Identity of the terminology system Required Pattern: urn:oid:1.2.246.537.6.21
version | Σ | 0..1 | string | Version of the system - if relevant
code | Σ | 0..1 | code | Symbol in syntax defined by the system
display | Σ | 0..1 | string | Representation defined by the system
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type Coding: Extension for home municipality. Home municipality is relevant for ex. in billing and listing available healthcare services, and for statistical purposes. It it not necessarily the place where a patient lives, rather closer to where they pay their taxes.

Differential View

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | The home municipality of the patient (not necessarily where they live).
extension |  | 0..0 |  |
url |  | 1..1 | uri | "https://hl7.fi/fhir/finnish-base-profiles/StructureDefinition/municipality-code"
value[x] |  | 1..1 | Coding | Value of extension
system |  | 0..1 | uri | Identity of the terminology system Required Pattern: urn:oid:1.2.246.537.6.21
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | The home municipality of the patient (not necessarily where they live).
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  |
url |  | 1..1 | uri | "https://hl7.fi/fhir/finnish-base-profiles/StructureDefinition/municipality-code"
value[x] |  | 1..1 | Coding | Value of extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | Σ | 0..1 | uri | Identity of the terminology system Required Pattern: urn:oid:1.2.246.537.6.21
version | Σ | 0..1 | string | Version of the system - if relevant
code | Σ | 0..1 | code | Symbol in syntax defined by the system
display | Σ | 0..1 | string | Representation defined by the system
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type Coding: Extension for home municipality. Home municipality is relevant for ex. in billing and listing available healthcare services, and for statistical purposes. It it not necessarily the place where a patient lives, rather closer to where they pay their taxes.

Other representations of profile: CSV, Excel, Schematron

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`