FHIR © HL7.org  |  Server Home  |  XIG Home  |  XIG Stats  |  Server Source  |  FHIR  

FHIR IG Statistics: OperationDefinition/appointment-book

Packagehl7.at.fhir.tc.wg.scheduling.r5
Resource TypeOperationDefinition
Idappointment-book
FHIR VersionR5
Sourcehttp://hl7.at/fhir/TC-FHIR-AG-Scheduling-R5/R5/https://build.fhir.org/ig/HL7Austria/TC-FHIR-AG-Scheduling-R5/OperationDefinition-appointment-book.html
URLhttp://hl7.at/fhir/TC-FHIR-AG-Scheduling-R5/R5/OperationDefinition/appointment-book
Version0.2.0
Statusactive
Date2025-05-23T10:55:12+00:00
NameBook_Appointment_Operation
Authorityhl7
DescriptionRequest to book a selected Appointment. This operation follows the appointment availability and optional hold interactions. This operation completes the booking of an appointment. The server determines if the nominated appointment is still available (i.e., all the required actors and physical assets needed for the appointment are still available) and either accepts or rejects the book request and updates the resource status accordingly.
Typetrue
Kindoperation

Resources that use this resource

No resources found


Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: OperationDefinition appointment-book

URL: [base]/Appointment/$book

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INappointment-resource1..1Resource (HL7® AT Scheduling Appointment Profile)

The full appointment resource is needed for this operation. The appointment SHALL have the status proposed.

OUTreturn1..1Parameters

The response will be a Parameters resource consisting of the requested Appointment resource and an OperationOutcome with errors, warnings or information as a result of processing the operation. The Appointment resource will have an updated status of booked if the request is approved, pending if it needs to be manually confirmed or cancelled if it is rejected.


Source

{
  "resourceType": "OperationDefinition",
  "id": "appointment-book",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "url": "http://hl7.at/fhir/TC-FHIR-AG-Scheduling-R5/R5/OperationDefinition/appointment-book",
  "version": "0.2.0",
  "name": "Book_Appointment_Operation",
  "status": "active",
  "kind": "operation",
  "date": "2025-05-23T10:55:12+00:00",
  "publisher": "HL7® Austria, TC FHIR®",
  "description": "Request to book a selected Appointment. This operation follows the appointment availability and optional hold interactions. This operation completes the booking of an appointment. The server determines if the nominated appointment is still available (i.e., all the required actors and physical assets needed for the appointment are still available) and either accepts or rejects the book request and updates the resource status accordingly. ",
  "affectsState": true,
  "code": "book",
  "resource": [
    "Appointment"
  ],
  "system": false,
  "type": true,
  "instance": false,
  "parameter": [
    {
      "name": "appointment-resource",
      "use": "in",
      "min": 1,
      "max": "1",
      "documentation": "The full appointment resource is needed for this operation. The appointment SHALL have the status ```proposed```.",
      "type": "Resource",
      "targetProfile": [
        "http://hl7.at/fhir/TC-FHIR-AG-Scheduling-R5/R5/StructureDefinition/at-scheduling-appointment"
      ]
    },
    {
      "name": "return",
      "use": "out",
      "min": 1,
      "max": "1",
      "documentation": "The response will be a Parameters resource consisting of the requested Appointment resource and an OperationOutcome with errors, warnings or information as a result of processing the operation. The Appointment resource will have an updated `status` of ```booked``` if the request is approved, ```pending``` if it needs to be manually confirmed or  ```cancelled``` if it is rejected.",
      "type": "Parameters"
    }
  ]
}