<StructureDefinition xmlns="http://hl7.org/fhir">
  <id value="UKCore-Appointment" />
  <url value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Appointment" />
  <version value="1.4.0" />
  <name value="UKCoreAppointment" />
  <title value="UK Core Appointment" />
  <status value="active" />
  <date value="2026-01-19" />
  <publisher value="HL7 UK" />
  <contact>
    <name value="HL7 UK" />
    <telecom>
      <system value="email" />
      <value value="ukcore@hl7.org.uk" />
      <use value="work" />
      <rank value="1" />
    </telecom>
  </contact>
  <description value="This profile defines the UK constraints and extensions on the International FHIR resource [Appointment](https://hl7.org/fhir/R4/Appointment.html)." />
  <purpose value="This profile allows recording of detailed information about a planned meeting that may be in the future or past. The resource only describes a single meeting, a series of repeating visits would require multiple appointment resources to be created for each instance. &#xD;&#xA;&#xD;&#xA; Examples include a scheduled surgery, a follow-up for a clinical visit, a scheduled conference call between clinicians to discuss a case, the reservation of a piece of diagnostic equipment for a particular use, etc. The visit scheduled by an appointment may be in person or remote (by phone, video conference, etc.) All that matters is that the time and usage of one or more individuals, locations and/or pieces of equipment is being fully or partially reserved for a designated period of time." />
  <copyright value="Copyright © 2021+ HL7 UK Licensed under the Apache License, Version 2.0 (the &quot;License&quot;); you may not use this file except in compliance with the License. You may obtain a copy of the License at  http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. HL7® FHIR® standard Copyright © 2011+ HL7 The HL7® FHIR® standard is used under the FHIR license. You may obtain a copy of the FHIR license at  https://www.hl7.org/fhir/license.html." />
  <fhirVersion value="4.0.1" />
  <kind value="resource" />
  <abstract value="false" />
  <type value="Appointment" />
  <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Appointment" />
  <derivation value="constraint" />
  <differential>
    <element id="Appointment.extension:bookingOrganization">
      <path value="Appointment.extension" />
      <sliceName value="bookingOrganization" />
      <short value="A reference to the source Organization of the booked appointment." />
      <type>
        <code value="Extension" />
        <profile value="https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-BookingOrganization" />
      </type>
      <isModifier value="false" />
    </element>
    <element id="Appointment.extension:deliveryChannel">
      <path value="Appointment.extension" />
      <sliceName value="deliveryChannel" />
      <short value="Defines the delivery channel of a scheduled appointment." />
      <max value="1" />
      <type>
        <code value="Extension" />
        <profile value="https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-DeliveryChannel" />
      </type>
      <isModifier value="false" />
    </element>
    <element id="Appointment.status">
      <path value="Appointment.status" />
      <short value="The overall status of the appointment." />
      <mustSupport value="true" />
    </element>
    <element id="Appointment.serviceType">
      <path value="Appointment.serviceType" />
      <binding>
        <strength value="preferred" />
        <description value="Any code from the SNOMED CT UK Refset with fully specified name 'Services simple reference set (foundation metadata concept)' with Refset Id 1127531000000102." />
        <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-CareSettingType" />
      </binding>
    </element>
    <element id="Appointment.specialty">
      <path value="Appointment.specialty" />
      <short value="The specialty of a practitioner that would be required to perform the service requested in this appointment." />
      <mustSupport value="true" />
      <binding>
        <strength value="extensible" />
        <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-PracticeSettingCode" />
      </binding>
    </element>
    <element id="Appointment.appointmentType">
      <path value="Appointment.appointmentType" />
      <short value="The type of appointment or patient that has been booked in the slot." />
      <mustSupport value="true" />
      <binding>
        <strength value="extensible" />
        <description value="A set of codes that define an appointment reason." />
        <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-AppointmentReasonCode" />
      </binding>
    </element>
    <element id="Appointment.reasonCode">
      <path value="Appointment.reasonCode" />
      <short value="The reason for the appointment." />
      <mustSupport value="true" />
    </element>
    <element id="Appointment.reasonReference">
      <path value="Appointment.reasonReference" />
      <short value="A reference to the Observation, Condition, Procedure, or ImmunizationRecommendation that is the reason for the appointment." />
      <mustSupport value="true" />
    </element>
    <element id="Appointment.start">
      <path value="Appointment.start" />
      <short value="The start time of the appointment." />
      <mustSupport value="true" />
    </element>
    <element id="Appointment.basedOn">
      <path value="Appointment.basedOn" />
      <short value="The service request this appointment is allocated to assess." />
      <mustSupport value="true" />
    </element>
    <element id="Appointment.participant">
      <path value="Appointment.participant" />
      <short value="A list of participants involved in the appointment." />
      <mustSupport value="true" />
    </element>
  </differential>
</StructureDefinition>