A patient-facing representation of an appointment used for coordination workflows (transportation, forms, etc.).

This profile supports two creation patterns: 1) Manual appointments created by patients/caregivers (Appointment.slot may be absent). 2) Appointments derived from scheduling publishers (Appointment.slot SHOULD be present when known).

A Location used in SMART Scheduling Links workflows and downstream coordination (e.g., transportation). This profile keeps location requirements light to enable broad adoption while supporting practical consumer needs (display + routing).

A Schedule used for publishing availability in SMART Scheduling Links workflows. This profile is intentionally flexible: schedule actor(s) may include practitioners, roles, services, locations, and/or organizations depending on publisher capabilities.

A Slot used for publishing discrete availability windows in SMART Scheduling Links workflows. Slots reference a Schedule and carry the time window and free/busy status.

A Task used by patient-facing applications to coordinate activities related to an appointment, including booking, transportation, and completion of forms.

Task.code indicates the type of coordination task. Task.status represents the lifecycle state of the task. Task.businessStatus represents the business outcome for task types where an outcome is applicable (e.g., booking attempts).

Task.intent is fixed to 'order' to indicate the task is actionable/authorized to proceed in the context of the patient-facing application (not a clinician order).

Task.requester and Task.owner may reference the Patient, a RelatedPerson (caregiver), or an Organization representing the patient-facing application/platform.

This profile sets minimum expectations for the Healthcare Service resource to enable SMART Schedule Links use cases

This profile sets minimum expectations for the Location resource to enable SMART Schedule Links use cases

This profile sets minimum expectations for the Practitioner resource to enable SMART Schedule Links use cases

This profile sets minimum expectations for the PractitionerRole resource to enable SMART Schedule Links use cases

This profile sets minimum expectations for the Schedule resource to enable SMART Schedule Links use cases

This profile sets minimum expectations for the Virtual Location resource to enable SMART Schedule Links use cases

Allowed booking outcome values for AppointmentCoordinationTask.businessStatus.

Allowed task types for AppointmentCoordinationTask.code.

A subset of the HL7 service-type codes and possibly other code systems to illustrate the more common service types that patients may want to schedule appointments for. Ideally, this would be based on utilization data and usually 1:1 with serviceType:schedule if the procedures can be performed independently of each other (e.g. 2 x-ray machines, 2 CT machines, 3 MRI machines and the schedule represents a pool of image technicians that can perform any of these procedures, but are limited by the actual, physical machines). These also may likely be more limited by both the technician/practitioner and the physical machine.
Conversely, if a provider (e.g. family medicine physician) can perform multiple types of services (e.g. annual wellness visit, follow-up visit, chronic disease management, etc) then it's appropriate to use serviceType to represent multiple services.

Business outcome of an appointment booking attempt.

Task types used to classify coordination work related to appointments.

Annual wellness visit

Primary care clinic located in downtown Pittsfield

Pharmacist

Pharmacist Role

Emergency Medicine Physician

Emergency Medicine Physician Role

Diagnostic Radiology/Xray/CT/Fluroscopy services at Outpatient Radiology Services.

Primary care visit

Family medicine clinic that offers in-person visits and virtual

Located behind old Berkshire Bank building

Visits offered both in-person and virtual with Dr. John Robert Smith.

In-person visits at Berkshire Family Medicine with Dr. John Robert Smith (via PractitionerRole).

MRI services at Outpatient Radiology Services.

MRI Radiology

Family Nurse Practitioner

An outpatient radiology services location

Ultrasound services at Outpatient Radiology Services.

Ultrasound Radiology

Primary care clinic located in downtown Pittsfield