AppointmentAppointment

AppointmentAppointment-profiilia käytetään valtakunnallisesti yhtenäisten ajanvarauksen rakenteisten tietojen arkistoinnissa Potilastietovarantoon.

Näyttömuodossa esitettävät tiedot

Kaikki näyttömuodossa esitettävät ajanvarauksen tiedot välitetään ajanvarauksen välittämiseen käytettävällä pääresurssilla.

Appointment.text.div-elementtiin kirjoitetaan näyttömuodossa esitettävät tiedot xhtml-muodossa FHIR-määritysten mukaisesti (ks. lisätietoja https://hl7.org/fhir/R4/narrative.html -sivulta).

Viitattavat resurssit

Profiilin mukaisesta Appointment-resurssista viitataan participant-rakenteilla muihin ajanvarauksen välittämisessä tarvittaviin ressursseihin. HealthcareService-resurssista viitataan edelleen Organization-resurssiin. Viitattavat resurssit välitetään Appointment-ressurssin sisällä Contained-resursseina.

Appointment

idΣ0..1string
id0..1string
extensionI0..*Extension
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceΣ0..1uri
profileΣ1..1canonical(StructureDefinition)Fixed Value
id0..0string
extensionI0..*Extension
systemΣ1..1uri
versionΣ0..0string
codeΣ1..1code
displayΣ1..1string
userSelectedΣ0..0boolean
tagΣ0..*Coding
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text1..1Narrative
contained0..*Resource
RemoteServiceURLI0..1Extension(string)
ServiceAdditionalInformationI0..1Extension(string)
AppointmentReasonI0..1Extension(Complex)
CareplanIdentifierI0..1Extension(Identifier)
NotificationMediumI0..*Extension(Coding)
CustomerJourneyI0..*Extension(Complex)
SelfServiceInfoI0..1Extension(Complex)
AppointmentMutabilityI0..1Extension(Complex)
QueueNoI0..1Extension(string)
TicketNoI0..1Extension(string)
ChildAppointmentI0..*Extension(Identifier)
AdditionalInformationURLI0..*Extension(url)
PractitionerGenderI0..1Extension(Coding)
BookingDeadlineI0..1Extension(dateTime)
modifierExtension?! I0..*Extension
id0..0string
extensionI0..*Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uri
valueΣ1..1string
periodΣ0..0Period
assignerΣ0..0Reference(Organization)
statusΣ ?!1..1codeBinding
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ1..1uri
versionΣ0..0string
codeΣ1..1code
displayΣ1..1string
userSelectedΣ0..0boolean
textΣ0..0string
specialtyΣ0..0CodeableConceptBinding
appointmentTypeΣ0..0CodeableConceptBinding
reasonCodeΣ0..0CodeableConceptBinding
priority0..0unsignedInt
description0..0string
supportingInformation0..0Reference(Resource)
startΣ0..1instant
endΣ0..1instant
minutesDuration0..0positiveInt
slot0..0Reference(Slot)
created0..0dateTime
comment0..1string
id0..1string
PatientInstructionURLI0..*Extension(url)
value0..1System.String
id0..1string
extensionI0..*Extension
referenceΣ I0..0string
typeΣ0..0uriBinding
id0..1string
extensionI0..*Extension
useΣ ?!0..0codeBinding
typeΣ0..0CodeableConceptBinding
systemΣ1..1uri
valueΣ1..1string
periodΣ0..0Period
assignerΣ0..0Reference(Organization)
displayΣ0..0string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
typeΣ0..*CodeableConceptBinding
actorΣ0..1Reference(Patient | Practitioner | PractitionerRole | RelatedPerson | Device | HealthcareService | Location)
requiredΣ0..1codeBinding
statusΣ1..1codeBinding
period0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1codeFixed Value
displayΣ1..1string
userSelectedΣ0..0boolean
textΣ0..0string
actorΣ1..1Reference(AppointmentPatient)
requiredΣ0..0codeBinding
statusΣ1..1codeBindingFixed Value
period0..0Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1codeFixed Value
displayΣ1..1string
userSelectedΣ0..0boolean
textΣ0..0string
id0..1string
extensionI0..*Extension
referenceΣ I1..1string
typeΣ0..1uriBinding
identifierΣ0..0Identifier
displayΣ0..0string
requiredΣ0..0codeBinding
statusΣ1..1codeBindingFixed Value
period0..0Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemΣ1..1uriFixed Value
versionΣ0..0string
codeΣ1..1codeFixed Value
displayΣ1..1string
userSelectedΣ0..0boolean
textΣ0..0string
id0..1string
extensionI0..*Extension
referenceΣ I1..1string
typeΣ0..1uriBinding
identifierΣ0..0Identifier
displayΣ0..0string
requiredΣ0..0codeBinding
statusΣ1..1codeBindingFixed Value
period0..0Period
requestedPeriod0..0Period

Ajanvarauksen tila

Seuraavassa taulukossa esitetään Appointment.status-koodien ja Ajanvaraus - Ajanvarauksen tila -koodiston (Koodistopalvelu) tilojen vastaavuudet

Appointment.status Ajanvaraus - Ajanvarauksen tila -koodiston tila (fi) Ajanvaraus - Ajanvarauksen tila -koodiston tila (sv)
proposed Tilattu Beställd
pending Ehdotettu Föreslagen
booked Varattu Bokad
arrived Alkanut Påbörjad
fulfilled Toteutunut Genomförd
cancelled Peruttu Annullerad
noshow Saapumatta Frånvarande

Ajanvarauksen aikaväli

Ajanvarauksen aikaväli ilmoitetetaan elementeillä Appointment.start ja Appointment.end.

Vain proposed (Tilattu) ja cancelled (Peruttu) -tilaisista ajanvarauksista ajanvarauksen aikaväli voi puuttua. Näillekin aikaväli voidaan kuitenkin antaa, jos se on tiedossa.

Jos ajanvarauksen aikavälin loppuaika ei ole tiedossa, ajanvarauksen loppuajaksi laitetaan ajanvarauksen alkuaika.

Esimerkkejä ajanvarauksen aikavälin ilmoittamisesta

Ajanvarauksen aikavälin alkuaika ja loppuaika tiedossa

  • Appointment.start: 2025-06-10T10:00:00+00:00
  • Appointment.end: 2025-06-10T10:30:00+00:00

Ajanvarauksen aikavälin alkuaika tiedossa, loppuaika ei tiedossa (ajanvarauksen loppuajaksi laitetaan ajanvarauksen alkuaika)

  • Appointment.start: 2025-06-10T10:00:00+00:00
  • Appointment.end: 2025-06-10T10:00:00+00:00

Keskiyölle varattava aika, kun ajanvarauksen loppuaika tiedossa

  • Appointment.start: 2025-06-10T00:00:00+00:00
  • Appointment.end: 2025-06-10T01:30:00+00:00

Keskiyölle varattava aika, kun ajanvarauksen loppuaika ei tiedossa

  • Appointment.start: 2025-06-10T00:00:00+00:00
  • Appointment.end: 2025-06-10T00:00:00+00:00

Tilattu-tilaisen ajanvarauksen aikavälin ilmoittaminen, jos aikavälin tarkempi ajankohta ei ole tiedossa

Esim. 10.6.2025, varataan tarkempi aika ko. päivän johon tarkempaan ajankohtaan

  • Appointment.start: 2025-06-10T00:00:00+00:00
  • Appointment.end: 2025-06-10T23:59:59+00:00

Esim. 10.6.-12.6.2025, varataan tarkempi aika jonkun noista päivistä johonkin tarkempaan ajankohtaan

  • Appointment.start: 2025-06-10T00:00:00+00:00
  • Appointment.end: 2025-06-12T23:59:59+00:00