Finnish Scheduling
2.0.0-rc3 - ballot

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

## ConceptMap: Appointment status to Ajanvarauksen tila

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

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

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

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

Source Concept Details | Relationship | Target Concept Details | Comment
Codes from AppointmentStatus |  | Codes from https://koodistopalvelu.kanta.fi/codeserver/pages/classification-view-page.xhtml?classificationKey=1943 |
proposed | Proposed | is equivalent to | 2 | Tilattu |
pending | Pending | is equivalent to | 8 | Ehdotettu |
booked | Booked | is equal to | 3 | Varattu |
arrived | Arrived | maps to wider concept | 3 | Varattu | The Finnish logical model does not have a direct match for the arrived status.
|  | maps loosely to | 6 | Alkanut | There is the status Alkanut for when the encounter has started.
fulfilled | Fulfilled | narrower | 6 | Alkanut | Alkanut actually means that the encounter has already started.
|  | narrower | 7 | Toteutunut | Toteutunut means that the encounter (or other provision of service) has begun or is complete.
cancelled | Cancelled | is equal to | 4 | Peruttu |
noshow | No Show | is equal to | 9 | Saapumatta |
entered-in-error | Entered in error | is not related to |  |  | There is no code for erroneously entered records in the Finnish logical model.
checked-in | Checked In | is equal to | 10 | Ilmoittautunut |
waitlist | Waitlisted | is equivalent to | 1 | Suunniteltu |

### 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`.