Finnish Base Profiles
1.0.1-cibuild - ci-build Finland flag

Finnish Base Profiles, published by HL7 Finland. This guide is not an authorized publication; it is the continuous build for version 1.0.1-cibuild 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: 1.0.1-cibuild
Draft as of 2024-09-08 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..* 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

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. 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"
.... 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

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..* 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

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. 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"
.... 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

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()