Finnish Base Profiles
2.0.0 - release

Publication Build: This will be filled in by the publication tooling

## Home

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

This implementation guide specifies the Finnish FHIR base profiles.

This is an official HL7 Finland standard, with the oid `1.2.246.777.11.2025.4`.

This is an R4 IG. None of the features it uses are changed in R4B, so it can be used as is with R4B systems. Packages for both R4 (hl7.fhir.fi.base.r4) and R4B (hl7.fhir.fi.base.r4b) are available. There is no plan yet to base this implementation guide on FHIR R5.

IG | Package | FHIR | Comment
--- | --- | --- | ---
Finnish Base Profiles | hl7.fhir.fi.base#2.0.0 | R4 |
HL7 Terminology (THO) | hl7.terminology.r4#6.5.0 | R4 | Automatically added as a dependency - all IGs depend on HL7 Terminology
FHIR Extensions Pack | hl7.fhir.uv.extensions.r4#5.3.0-ballot-tc1 | R4 | Automatically added as a dependency - all IGs depend on the HL7 Extension Pack
Finnish Scheduling | hl7.fhir.fi.scheduling#0.3.1 | R4 |

The previous version of this implementation guide depended on the International Patient Access specification, and many profile definitions of that version derive from IPA profiles. These IPA-derived profiles are now moved to the Finnish Implementation Guide for SMART App Launch.

### Companion Specifications

There is a separate Finnish Implementation Guide for SMART App Launch that describes how the SMART specification is applied in Finland.

See also all FHIR implementation guides published by HL7 Finland and also HL7 Finland in Simplifier.

The Profiles page lists some Finnish FHIR implementation guides published by other parties.

### Why Do We Need Finnish FHIR Base Profiles?

Better flow of information between systems is one of the key enablers for digitalization and improved efficiency of healthcare systems. Better flow of information is facilitated by interoperability standards. HL7 FHIR® is one of the most important standards for interoperability and exchange of healthcare data.

For many things in healthcare it is hard to achieve a global consensus over what data should be coded and communicated, and how. The base HL7 FHIR standard does an excellent job in defining the global consensus where it exists. At the same time, it specifically allows and encourages smaller communities to come up with more specific profiles and implementation guides.

In many cases, the HL7 FHIR standard allows for several ways to implement a functionality. There are increasing concerns that without a coordinated approach implementers will choose different ways to implement some features, and this will lead to challenges for interoperability. This implementation guide attempts to define a consensus within the Finnish FHIR implementers on which ways we have considered the best fit for use cases in Finland.

In this implementation guide we also describe the code systems and identifiers that are specific to the Finnish healthcare system.

### Notable FHIR Implementations in Finland

There are dozens of FHIR enabled systems and applications implemented and in use in Finland. This list does not attempt to be a complete list of all implementations. Rather, it is included here for readers not familiar with the Finnish healthcare system, as a quick glance to some of the most notable implementations at the time of writing of the first version of this guide.

#### Kanta

Kanta is the Finnish national central registry of health and social welfare information, with many services available for systems, providers, and citizens. Most of both the data and the APIs in Kanta system are based on HL7 V3 standards. However, there is ongoing work to open also FHIR based access to the information.

The part where HL7 FHIR is used the most is the Kanta PHR, a personal health record platform for storing and exchanging health and wellbeing data produced and governed by citizens. This part of Kanta is also the one most open to application developers.

Kanta has also implemented a FHIR APIs for prescription data and for social welfare services.

#### Omaolo

Omaolo is a collection of services developed by DigiFinland, a publicly funded company. Omaolo has a fully HL7 FHIR based personal health record platform as its core.

#### Terveyskylä / Health Village

Health Village is yet another publicly funded group of services. It has built in HL7 SMART App Launch capability for interacting with third party apps.

#### Apotti

Apotti is a sizeable Epic installation in Finland. Epic is one of the biggest electronic health record system vendors globally.

#### CGI

The OMNI360 by CGI Finland is one of the prominent Finnish electronic health record systems and has several native FHIR APIs.

#### EskoSystems

The Esko APTJ by Esko Systems is also one of the prominent Finnish electronic health record systems. It uses several FHIR APIs internally, and offers a SMART App Launch method to interact with third party systems.

#### Learn more

The FHIR Demo 2022 showcase presented integrations implemented between a dozen platforms and more than a dozen FHIR apps, all based on HL7 FHIR. The FHIR Demo 2023 concentrated on these base profiles. FHIR Demo 2024 extended the geographical scope of the showcase to cover the Nordic countries. The latest FHIR Demo can always be found on fhir.fi/demo.

Even those showcases do not cover the full extent to which HL7 FHIR is being used in Finland. There's a lot going on!

To learn about the current status, please contact HL7 Finland. We're happy to give you an overview.

### Profiling Approach

The base FHIR specification works on a global scope. It is hard to achieve consensus on many things globally. However, smaller regions and jurisdictions are in a better position to agree on tighter constraints.

#### Local Considerations

For instance, different coding systems and terminologies are used in different parts of the world. In this implementation guide, we document which code systems and terminologies are used in Finland and how they are applied in FHIR.

The FHIR standard also allows implementers to implement many features in several ways. One example is scheduling. Some jurisdictions are working on scheduling API's based on FHIR operations. In Finland, existing solutions have chosen to go with a more fine grained approach with pure FHIR resources and the REST interface.

#### International Aspects

Our main intent is still to limit profiling specific to Finland. During the process, we actively monitor other national base profiles. We attempt to harmonize our base profiles with already published base profiles from other Nordic countries:

- the Danish DK Core
- the Norwegian core profiles for R4 HL7 Norway no-basis
- the Swedish Base Profiles

See the presentation slides of the session Nordic harmonization of health data, given in the Vitalis conference in May, 2023. They include an initial comparison of the Danish, Finnish, Norwegian, and Swedish base profile specifications.

Other national base profiles we have drawn inspiration from include

- the US Core
- the Canadian baseline
- the Swiss CH Core
- the Australian AU Base
- the Estonian Base Implementation Guide

Regarding international cooperation, please see also the National IG Implementations page in HL7 International's Confluence.

#### Baseline and Core Profiles

The FHIR community is currently figuring out how different implementation guides interact and can be layered. See, for instance, the layering approach in the Norwegian base profiles and the explanation on the Canadian Baseline specification.

According to those terms, this version of this implementation guide is closest to the national baseline profile. Its main purpose is to inform implementers of approaches already chosen, and thereby avoid re-implementing the wheel in a different form for new implementations.

There are other, more use case specific FHIR implementation guides in Finland. For instance, both the Finnish Appointment IG and the Finnish Scheduling IG focus on scheduling.

Especially the Kanta specific implementation guides for Finnish PHR, Kanta FHIR Prescription, and Kanta sosiaalihuolto are closer to national Core profile specifications.

This implementation guide may also in the future be extended to cover core profiles, in addition to the base profiles of this version.

#### Must-Support Rules

This version of this implementation guide does not define any Must Support rules.

#### Profiles and Examples

We publish profile resources that help implementers validate their implementations.

We also publish examples, as we think they are another good way to interoperability.

Also, where we cannot find consensus and agree on one single approach, we attempt to document all different approaches used.

The main aim of this implementation guide is to inform vendors on how to implement the FHIR specification in Finnish context. Requirements and constraints are limited, in order to allow for maximum reusability across a variety of use cases.

In the first versions of the implementation guide, a lot of profiling is done on resource type level. For instance, the patient identifier is profiled for the Patient profile. Another approach would be to concentrate on data types. We may evolve the profiling towards that direction in the future.

### Governance

The profiling work is performed in a project driven by HL7 Finland. See the announcement (in Finnish), the running memo, and some more details. We warmly welcome new participants to the project. You may even be compensated for your efforts.

The team involved in creating the first version of the specification includes

- Arto Huusko, CGI Oyj
- Janne Heikkinen, BCB Medical Oy
- Jari Kariniemi, Kymenlaakson hyvinvointialue
- Jari Vuonos, Apotti Oy
- Joni Hirviniemi, Fujitsu
- Jyrki Soikkeli, Apotti Oy
- Kalle Moilanen, Esko Systems Oy
- Marko Kaukonen, BCB Medical Oy
- Markus Lind, Buddy Healthcare Oy
- Markus Suonpää, CGI Finland Oyj
- Miika Langille, Esko Systems Oy
- Mika Jylhä, Esko Systems Oy
- Mika Lentovaara, HUS
- Mika Tuomainen, Kela
- Mikael Rinnetmäki, Sensotrend Oy
- Tero Pekkola, Esko Systems Oy

Each published major version of this implementation guide goes through the ballot and voting processes of HL7 Finland, and then represents the consensus view of the Finnish FHIR community.

### Collaboration

We want this implementation guide to be useful for you.

If you are implementing FHIR in a system or application that is meant to be used in Finland and are thinking of some implementation details, you are probably in the right place and this implementation guide should help you with those questions. If this implementation guide in any way fails to give you the answers you are looking for, we'd love to hear about it so we can make it better. Please do be in touch in one of the ways listed below.

#### Open an Issue in GitHub

The source code of this implementation guide is maintained in a publicly accessible repository in GitHub. Issues opened in that GitHub repo are very welcome. They help the team pick up any proposed changes or additions and to discuss them publicly.

#### Open a Pull Request in GitHub

Pull requests are even better. If you are in a position to suggest how exactly your proposal should be implemented in the specification, do it! It helps the team maintaining the implementation guide a great deal.

#### Participate in IG Development and Maintenance

Please also consider joining the development effort. This is the best way to affect the outcome of the profiling work. You may even be compensated for your efforts. Please be in touch with HL7 Finland to discuss options, if this even remotely interesting for you.

The best implementation guide is the one that reflects the views and the consensus of the whole FHIR community!

### Safety Considerations

This implementation guide defines data elements, resources, formats, and methods for exchanging healthcare data between different participants in the healthcare process. As such, clinical safety is a key concern. Additional guidance regarding safety for the specification’s many and various implementations is available at https://www.hl7.org/FHIR/safety.html.

Although the present specification does give users the opportunity to observe data protection and data security regulations, its use does not guarantee compliance with these regulations. Effective compliance must be ensured by appropriate measures during implementation projects and in daily operations. The corresponding implementation measures are explained in the standard. In addition, the present specification can only influence compliance with the security regulations in the technical area of standardisation. It cannot influence organisational and contractual matters.

### License and Legal Terms

This document is licensed under Creative Commons CC0 1.0 Universal Public Domain Dedication.

This implementation guide contains and references intellectual property owned by third parties ("Third Party IP"). Acceptance of these License Terms does not grant any rights with respect to Third Party IP. The licensee alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize Third Party IP in connection with the specification or otherwise.

HL7®, HEALTH LEVEL SEVEN®, FHIR® and the FHIR ® are trademarks owned by Health Level Seven International, registered with the United States Patent and Trademark Office.

See also http://hl7.org/fhir/license.html.

#### Other Intellectual Property Statements

This publication includes IP covered under the following statements.

- Copyright HL7. Licensed under creative commons public domain
  Show Usage
  - providerRole: PractitionerRole/PractitionerRoleGP
  - providerRole: Immunization/ImmunizationVaccinationExample
- ISO Maintains the copyright on the country codes, and controls it's use carefully. For futher details see the ISO 3166 web page: https://www.iso.org/iso-3166-country-codes.html
  Show Usage
  - ISO 3166-1 Codes for the representation of names of countries and their subdivisions — Part 1: Country code: CauseOfAdverseEffect, ConditionCategorizationOfAccident... Show 46 more, ConditionCausedByMedication, ConditionExternalCause, EndocrinologicalDisorder, FiBaseAppointment, FiBaseCondition, FiBaseEncounter, FiBaseEpisodeOfCare, FiBaseHealthcareService, FiBaseImmunization, FiBaseInformationCustodian, FiBaseInformationCustodianIndividual, FiBaseInformationCustodianPrivate, FiBaseInformationCustodianPublic, FiBaseLocation, FiBaseMedication, FiBaseMedicationAdministration, FiBaseMedicationRequest, FiBaseMedicationStatement, FiBaseObservation, FiBaseOrganization, FiBasePatient, FiBasePractitioner, FiBasePractitionerRole, FiBaseProcedure, FiBaseProvenance, FiBaseReasonForCare, FiBaseRegisterIdentifier, FiBaseReleaseforPatientViewingCS, FiBaseRestrictionParentVS, FiBaseSchedule, FiBaseSecurityLabelCS, FiBaseSecurityLabelVS, FiBaseSlot, FinnishBaseProfiles, KantaDocumentMetadata, KantaDocumentOtherMetadata, MunicipalityCode, PatientProfession, Permanence, PhysicalExcercise, PrimaryCondition, ReleaseDateForPatientViewing, RestrictionParent, ServiceEvent, VaccinationRecorder and ValueSet/kanta-provenance-agent-role
- The UCUM codes, UCUM table (regardless of format), and UCUM Specification are copyright 1999-2009, Regenstrief Institute, Inc. and the Unified Codes for Units of Measures (UCUM) Organization. All rights reserved. https://ucum.org/trac/wiki/TermsOfUse
  Show Usage
  - Unified Code for Units of Measure (UCUM): Bundle/diabetes-data-bundle, Bundle/diabetes-data-bundle-kantaphr-r4-en... Show 26 more, Bundle/diabetes-data-bundle-kantaphr-sv, Immunization/ImmunizationVaccinationExample, MedicationAdministration/a4d97476-39fa-46c6-bf2e-1fb153a7bbe3, MedicationAdministration/medication-administration-insulin-basal-dose-kanta-stu3-sv, MedicationAdministration/medication-administration-insulin-bolus-dose-fi, MedicationAdministration/medication-administration-insulin-dose-temp-basal-rate-kanta-en, MedicationRequest/medicationrequestesim6, MedicationRequest/medicationrequestesim7B, Observation/1153859e-0c86-1000-abb8-511d0000b222, Observation/2894b2e6-7ebf-4c33-93e4-31935effff21, Observation/2894b2e6-7ebf-4c33-93e4-31935effff22, Observation/4137d1c4-1e87-4e86-8c15-344ad086e3f8, Observation/4137d1c4-1e87-4e86-8c15-344ad086e3f9, Observation/48983b8b-ead3-4206-9583-fcdd40d762b6, Observation/48983b8b-ead3-4206-9583-fcdd40d762b7, Observation/542ae72e-c3b0-404f-8c06-8f77441e89f7, Observation/542ae72e-c3b0-404f-8c06-8f77441e89f8, Observation/71831b54-1a80-47c5-ba84-0180a5eb784b, Observation/bloodglucose-max, Observation/bloodglucose-min, Observation/bloodpressure-max, Observation/bloodpressure-min, Observation/bodyweight-max, Observation/bodyweight-min, Observation/mtvpa-max and Observation/mtvpa-min
- This material contains content from LOINC. LOINC is copyright © 1995-2020, Regenstrief Institute, Inc. and the Logical Observation Identifiers Names and Codes (LOINC) Committee and is available at no cost under the license. LOINC® is a registered United States trademark of Regenstrief Institute, Inc.
  Show Usage
  - LOINC: Bundle/diabetes-data-bundle, Bundle/diabetes-data-bundle-kantaphr-r4-en... Show 22 more, Bundle/diabetes-data-bundle-kantaphr-sv, Observation/1153859e-0c86-1000-abb8-511d0000b222, Observation/2894b2e6-7ebf-4c33-93e4-31935effff21, Observation/2894b2e6-7ebf-4c33-93e4-31935effff22, Observation/4137d1c4-1e87-4e86-8c15-344ad086e3f8, Observation/4137d1c4-1e87-4e86-8c15-344ad086e3f9, Observation/48983b8b-ead3-4206-9583-fcdd40d762b6, Observation/48983b8b-ead3-4206-9583-fcdd40d762b7, Observation/542ae72e-c3b0-404f-8c06-8f77441e89f7, Observation/542ae72e-c3b0-404f-8c06-8f77441e89f8, Observation/71831b54-1a80-47c5-ba84-0180a5eb784a, Observation/71831b54-1a80-47c5-ba84-0180a5eb784b, Observation/bloodglucose-as-text, Observation/bloodglucose-data-absent, Observation/bloodglucose-max, Observation/bloodglucose-min, Observation/bloodpressure-max, Observation/bloodpressure-min, Observation/bodyweight-max, Observation/bodyweight-min, Observation/mtvpa-max and Observation/mtvpa-min
- This material contains content that is copyright of SNOMED International. Implementers of these specifications must have the appropriate SNOMED CT Affiliate license - for more information contact https://www.snomed.org/get-snomed or info@snomed.org.
  Show Usage
  - SNOMED Clinical Terms&reg; (SNOMED CT&reg;): Bundle/diabetes-data-bundle, Bundle/diabetes-data-bundle-kantaphr-r4-en... Show 17 more, Bundle/diabetes-data-bundle-kantaphr-sv, Immunization/ImmunizationVaccinationExample, MedicationAdministration/medication-administration-insulin-basal-dose-kanta-stu3-sv, MedicationAdministration/medication-administration-insulin-bolus-dose-fi, MedicationAdministration/medication-administration-insulin-dose-temp-basal-rate-kanta-en, MedicationStatement/medication-statement-insulin, Observation/2894b2e6-7ebf-4c33-93e4-31935effff22, Observation/4137d1c4-1e87-4e86-8c15-344ad086e3f9, Observation/542ae72e-c3b0-404f-8c06-8f77441e89f8, Observation/bloodglucose-max, Observation/bloodpressure-max, Observation/bodyweight-max, Observation/mtvpa-max, PractitionerRole/PractitionerRoleGP, Procedure/ColonBiopsy, Procedure/ProcedureColotomy and Schedule/ScheduleExample
- This material derives from the HL7 Terminology (THO). THO is copyright ©1989+ Health Level Seven International and is made available under the CC0 designation. For more licensing information see: https://terminology.hl7.org/license.html
  Show Usage
  - Condition Category Codes: Condition/id-for-diagnosis-1, Condition/id-for-diagnosis-2 and Condition/id-for-diagnosis-3
  - Condition Clinical Status Codes: Condition/id-for-diagnosis-1, Condition/id-for-diagnosis-2 and Condition/id-for-diagnosis-3
  - DataAbsentReason: Observation/bloodglucose-as-text and Observation/bloodglucose-data-absent
  - Location type: Vuode 3
  - Observation Category Codes: Bundle/diabetes-data-bundle-kantaphr-r4-en, Observation/bloodglucose-as-text... Show 7 more, Observation/bloodglucose-data-absent, Observation/bloodglucose-max, Observation/bloodglucose-min, Observation/bloodpressure-max, Observation/bloodpressure-min, Observation/bodyweight-max and Observation/bodyweight-min
  - Organization type: Esko-Testi pp HVA
  - identifierType: FiBaseInformationCustodian, FiBaseInformationCustodianIndividual... Show 15 more, FiBaseInformationCustodianPrivate, FiBaseInformationCustodianPublic, Patient/patient-of-municipality, Patient/patient-with-turvakielto, Practitioner/practitioner-licensed-physician, Provenance/ESE-289490, Provenance/custodian-individual, Provenance/custodian-occupational-healthcare, Provenance/custodian-public-healthcare, Provenance/custodian-public-healthcare-kela, Provenance/id-for-provenance-1, Provenance/kanta-document-metadata-profile-example, Provenance/kanta-document-metadata-profile-example-2, Provenance/kanta-document-metadata-profile-test-example-1 and Provenance/kanta-document-metadata-profile-test-example-2
  - ActCode: Encounter/id-for-child-encounter, Encounter/id-for-child-encounter-2, Encounter/id-for-palvelutapahtuma, Encounter/id-for-visit and Encounter/id-for-ward-encounter
  - Confidentiality: Observation/bloodglucose-max
  - ObservationInterpretation: Observation/2894b2e6-7ebf-4c33-93e4-31935effff22, Observation/4137d1c4-1e87-4e86-8c15-344ad086e3f9... Show 5 more, Observation/542ae72e-c3b0-404f-8c06-8f77441e89f8, Observation/bloodglucose-max, Observation/bloodpressure-max, Observation/bodyweight-max and Observation/mtvpa-max
  - ParticipationType: Appointment/appointment-general-practitioner, FiBaseInformationCustodian... Show 13 more, FiBaseInformationCustodianIndividual, FiBaseInformationCustodianPrivate, FiBaseInformationCustodianPublic, Provenance/ESE-289490, Provenance/custodian-individual, Provenance/custodian-occupational-healthcare, Provenance/custodian-public-healthcare, Provenance/custodian-public-healthcare-kela, Provenance/id-for-provenance-1, Provenance/kanta-document-metadata-profile-example, Provenance/kanta-document-metadata-profile-example-2, Provenance/kanta-document-metadata-profile-test-example-1 and Provenance/kanta-document-metadata-profile-test-example-2