Finnish Scheduling
2.0.0-ci - ci-build Finland flag

Finnish Scheduling - Local Development build (v2.0.0-ci) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

ConceptMap: Ajanvarauksen tila to Appointment status

Official URL: https://hl7.fi/fhir/finnish-scheduling/ConceptMap/ajanvarauksentila-appointmentstatus Version: 2.0.0-ci
Draft as of 2025-03-27 Computable Name: FiAppointmentStatusCodeMap

Mapping between the Finnish logical model Ajanvaraus - Ajanvarauksen tila (oid 1.2.246.537.6.881) and FHIR Appointment status codes.

Note: the codes are ordered according to the sequence (järjestys) indicated in the Finnish logical model. This ordering is different from the numeric order of the codes.

Generated Narrative: ConceptMap ajanvarauksentila-appointmentstatus

Mapping from https://koodistopalvelu.kanta.fi/codeserver/pages/classification-view-page.xhtml?classificationKey=1943 to AppointmentStatus


Group 1 Mapping from https://koodistopalvelu.kanta.fi/codeserver/pages/classification-view-page.xhtml?classificationKey=1943 to AppointmentStatus

Source CodeRelationshipTarget CodeComment
1 (Suunniteltu)is equivalent towaitlist (Waitlisted)Patient and need have been identified, the service provider and time have not.
2 (Tilattu)is equivalent toproposedDiffers from Suunniteltu in that in Tilattu the service provider has been identified.
8 (Ehdotettu)is equal topending
3 (Varattu)is equal tobooked
4 (Peruttu)is equal tocancelled
5 (Siirretty)maps to wider conceptcancelledThere is no separate status code in FHIR for rescheduled appointments. Note that this code is deprecated.
10 (Ilmoittautunut)is equal tochecked-in
6 (Alkanut)maps to wider conceptfulfilledAlkanut means that the encounter has begun and is ongoing. Most FHIR systems track this with the Encounter resource. There is no such state in Appointment.
7 (Toteutunut)maps to wider conceptfulfilledToteutunut means that the service the appointment is for has started or is complete. Most FHIR systems track this with the Encounter resource. There is no such state in Appointment.
9 (Saapumatta)is equal tonoshow

Notes:

The Finnish logical model for appointments includes a code set for appointment statuses that differs from the FHIR Appointment.status values.

The Finnish logical model is more detailed when the service is being planned, and separates between states where the need fo a service has been identified but no service provider has yet been identified (#1, Suunniteltu), and when the service provider has been selected (#2, Tilattu).

The FHIR specification uses the Appoinment resource to track information on scheduling and for administrative purposes, and in general for prepapring for the encounter. In FHIR, the Encounter resource is used to track the encounter, and any clinically relevant information (see Appointment Statuses and Encounters). In FHIR, when an encounter starts, its status is tracked with the Encounter resource, and no longer with the Appointment. The Finnish logical model does not make such a distinction between the appointment and the encounter.

The Finnish logical model does not have a separate status for when the patient has arrived (FHIR status arrived). It does have a code #10, Ilmoittautunut that matches the FHIR code checked-in.

On the other hand, the Finnish logical model separates between when an encounter has started (#6, Alkanut) and when the service is in progress or completed (#7, Toteutunut).

The Finnish logical model used to have a separate code for an appointment that has been rescheduled (#5, Siirretty), but that code is now deprecated.

The Finnish logical model does not have any code for appointments that have been entered in error.

The Ajanvarauksen tila codes can be added using the Ajanvarauksen tila extension to Appoinment.status.