Finnish Base Profiles
1.0.0 - trial-use Finland flag

This page is part of the Finnish Base Profiles (v1.0.0: STU 1) based on FHIR R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Extension: Municipality Code

Official URL: https://hl7.fi/fhir/finnish-base-profiles/StructureDefinition/municipality-code Version: 1.0.0
Active as of 2023-11-10 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 1.1.2023. This means that municipality would not be sufficient information in a case of billing wellbeing services county from using secondary care services via referral. Nevertheless the municipality code would be one way to deduce the correct wellbeing services county, if 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

Usage:

Formal Views of Extension Content

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

This structure is derived from Extension

Summary

Simple Extension of 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.

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..*ExtensionThe home municipality of the patient (not necessarily where they live).
... extension 0..0
... url 1..1uri"https://hl7.fi/fhir/finnish-base-profiles/StructureDefinition/municipality-code"
... value[x] 1..1CodingValue of extension
.... system 0..1uriIdentity of the terminology system
Required Pattern: urn:oid:1.2.246.537.6.21

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..*ExtensionThe home municipality of the patient (not necessarily where they live).
... id 0..1stringUnique id for inter-element referencing
... extension 0..0
... url 1..1uri"https://hl7.fi/fhir/finnish-base-profiles/StructureDefinition/municipality-code"
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... system Σ0..1uriIdentity of the terminology system
Required Pattern: urn:oid:1.2.246.537.6.21
.... version Σ0..1stringVersion of the system - if relevant
.... code Σ0..1codeSymbol in syntax defined by the system
.... display Σ0..1stringRepresentation defined by the system
.... userSelected Σ0..1booleanIf this coding was chosen directly by the user

doco Documentation for this format

This structure is derived from Extension

Summary

Simple Extension of 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

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..*ExtensionThe home municipality of the patient (not necessarily where they live).
... extension 0..0
... url 1..1uri"https://hl7.fi/fhir/finnish-base-profiles/StructureDefinition/municipality-code"
... value[x] 1..1CodingValue of extension
.... system 0..1uriIdentity of the terminology system
Required Pattern: urn:oid:1.2.246.537.6.21

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..*ExtensionThe home municipality of the patient (not necessarily where they live).
... id 0..1stringUnique id for inter-element referencing
... extension 0..0
... url 1..1uri"https://hl7.fi/fhir/finnish-base-profiles/StructureDefinition/municipality-code"
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... system Σ0..1uriIdentity of the terminology system
Required Pattern: urn:oid:1.2.246.537.6.21
.... version Σ0..1stringVersion of the system - if relevant
.... code Σ0..1codeSymbol in syntax defined by the system
.... display Σ0..1stringRepresentation defined by the system
.... userSelected Σ0..1booleanIf this coding was chosen directly by the user

doco Documentation for this format

 

Other representations of profile: CSV, Excel, Schematron

Constraints

IdGradePath(s)DetailsRequirements
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()