Finnish Base Profiles
1.0.1-cibuild - ci-build
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
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):
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:
Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.
This structure is derived from Extension
This structure is derived from Extension
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
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 |
---|---|---|---|---|
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
Differential View
This structure is derived from Extension
Name | Flags | Card. | Type | Description & Constraints |
---|---|---|---|---|
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 |
---|---|---|---|---|
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 |
Other representations of profile: CSV, Excel, Schematron
Id | Grade | Path(s) | Details | Requirements |
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() |