Package | fhir.argonaut.scheduling |
Type | CapabilityStatement |
Id | client |
FHIR Version | R3 |
Source | http://fhir.org/guides/argonaut/scheduling/https://simplifier.net/resolve?scope=fhir.argonaut.scheduling@1.0.0&canonical=http://fhir.org/guides/argonaut-scheduling/CapabilityStatement/client |
URL | http://fhir.org/guides/argonaut-scheduling/CapabilityStatement/client |
Version | 1.0.0 |
Status | active |
Date | 2018-03-18T18:00:00+11:00 |
Name | Argonaut_Scheduling_Client_CapabilityStatement |
Title | Argonaut Scheduling Client CapabilityStatement |
Realm | us |
Authority | hl7 |
Description | The Argonaut Scheduling Client CapabilityStatement provides a for a complete list of supported RESTful interactions for the Argonaut Scheduling Implementation Guide |
Kind | requirements |
No resources found
ImplementationGuide | |
ig | Argo-Scheduling |
OperationDefinition | |
appointment-book | Appointment_Book |
appointment-find | Appointment_Availability_Operation |
appointment-hold | Appointment_Hold |
slot-prefetch | Availability_Prefetch_Operation |
Note: links and images are rebased to the (stated) source
This section outlines conformance requirements for the Argonaut Scheduling Client applications, identifying the specific profiles that need to be supported, the specific RESTful operations that need to be supported, and the search parameters that need to be supported. Note: The individual Argonaut Scheduling profiles identify the structural constraints, terminology bindings and invariants, however, implementers must refer to the conformance requirements for details on the RESTful operations, specific profiles and the search parameters applicable to each of the Argonaut Scheduling actors.
The Section describes the expected capabilities of the Argonaut Scheduling Scheduling Client which is responsible for creating and initiating the queries for information about patient scheduling as well as creating and updating this information. The complete list of FHIR profiles, RESTful operations, and search parameters supported by Argonaut Scheduling Servers are defined in the Argonaut Scheduling Server CapabilityStatement. Clients have the option of choosing from this list to access necessary data based on their local use cases and other contextual requirements.
Description:
The Argonaut Scheduling Client SHOULD:
The Argonaut Scheduling Client MAY:
For general security consideration refer to the Security section in the US Core Implementation Guide.
Specific server search capabilities are described in detail in each of the resource sections below.
Supported Profiles: Argonaut Appointment Profile
A client SHOULD be capable of fetching Appointments using:
GET [base]/Appointment/[id]
.
A client SHOULD be capable of fetching Appointments using search:
GET [base]/Appointment?patient=[id]{&status=[status]}{&date=[date]{&date=[date]}}{&practitioner=[id]}
A client SHOULD be capable of fetching Appointments by supporting the Appointment Availability Operation using either the GET
or POST
syntax.
GET [base]/Appointment/$find?{parameters}&?{_count}
POST [base]/Appointment/$find?{_count}
A client MAY be capable of creating or updating Appointments by supporting the Appointment Hold Operation.
POST [base]/Appointment/[id]/$hold
POST [base]/Appointment/$hold
A client SHOULD be capable of creating or updating Appointments by supporting the Appointment Book Operation.
POST [base]/Appointment/[id]/$hold
POST [base]/Appointment/$hold
A client SHOULD be capable of updating Appointments by supporting patch using either JSON, XML, or FHIRPath Patch.
PATCH [Base]/Appointment/[id]
Supported Profiles:
A client SHOULD be capable of consuming a Bundle as a response to a a query or operation.
Supported Profiles: Argonaut Coverage Profile
A client MAY be capable of updating or creating a patient's Coverage.
PUT [base]/Coverage/[id]
PUT or POST [base]/Coverage
Supported Profiles: US Core Patient Profile
A client SHOULD be capable of searching for Patients as defined in the US Core Implementation Guide.
A client MAY be capable of creating Patients by supporting create.
POST [base]/Patient
Supported Profiles: Argonaut Schedule Notification Profile
Supported Profiles: Argonaut Prefetch Slot Profile
A client MAY be capable of fetching Slots by supporting the Appointment Availability Operation.
Both the GET
and POST
Syntax SHALL be supported:
GET [base]/Slot/$prefetch?{parameters}
POST [base]/Slot/$prefetch
Supported Profiles: Argonaut Scheduling Subscription Profile
A client MAY be capable of creating Subscriptions
POST [base]/Subscription
A client MAY be capable of deleting Subscriptions
DELETE [base]/Subscription
{ "resourceType": "CapabilityStatement", "id": "client", "text": { "status": "additional", "div": "<!-- snip (see above) -->" }, "url": "http://fhir.org/guides/argonaut-scheduling/CapabilityStatement/client", "version": "1.0.0", "name": "Argonaut_Scheduling_Client_CapabilityStatement", "title": "Argonaut Scheduling Client CapabilityStatement", "status": "active", "experimental": false, "date": "2018-03-18T18:00:00+11:00", "publisher": "Argonaut Project", "description": "The Argonaut Scheduling Client CapabilityStatement provides a for a complete list of supported RESTful interactions for the Argonaut Scheduling Implementation Guide", "jurisdiction": [ { "coding": [ { "system": "urn:iso:std:iso:3166", "code": "US", "display": "United States of America" } ] } ], "kind": "requirements", "fhirVersion": "3.0.1", "format": [ "application/fhir+xml", "application/fhir+json" ], "patchFormat": [ "application/json-patch+json", "application/xml-patch+xml", "application/fhirpath-patch+fhirpath" ], "implementationGuide": [ "http://fhir.org/guides/argonaut-scheduling/ImplementationGuide/ig", "http://hl7.org/fhir/us/core/ImplementationGuide/ig" ], "rest": [ { "mode": "server", "documentation": "The [Argonaut](http://argonautwiki.hl7.org/) Scheduling Project is a vendor agnostic specification providing FHIR RESTful APIs and guidance for access to and booking of appointments for patients by both patient and practitioner end users. This specification is based on [FHIR Version 3.0.1]({{site.data.fhir.path}}) and specifically the [Scheduling and Appointment resources]({{site.data.fhir.path}}/administration-module.html#sched).", "security": { "service": [ { "coding": [ { "system": "http://hl7.org/fhir/restful-security-service", "code": "SMART-on-FHIR" } ] } ], "description": "For general security consideration refer to the [Security section](http://hl7.org/fhir/us/core/security.html) in the US Core Implementation Guide." }, "resource": [ { "type": "Appointment", "interaction": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "code": "read" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "code": "search-type" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "code": "patch" } ], "referencePolicy": [ "enforced" ], "searchParam": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "name": "_id", "definition": "http://hl7.org/fhir/SearchParameter/_id", "type": "token" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "name": "patient", "definition": "http://hl7.org/fhir/SearchParameter/patient", "type": "reference" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "name": "status", "definition": "http://hl7.org/fhir/SearchParameter/status", "type": "token" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "name": "date", "definition": "http://hl7.org/fhir/SearchParameter/date", "type": "date" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "name": "practitioner", "definition": "http://hl7.org/fhir/SearchParameter/practitioner", "type": "reference", "documentation": "including the date modifiers ‘ge’,’le’,’gt’,’lt’" } ] }, { "type": "Coverage", "interaction": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "code": "create" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "code": "update" } ], "updateCreate": true, "referencePolicy": [ "enforced" ] }, { "type": "Patient", "documentation": "A serve **SHALL** be capable of searching for Patients as defined in the US Core Implementation Guide", "interaction": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "code": "create" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "code": "search-type" } ], "referencePolicy": [ "enforced" ] }, { "type": "Schedule", "interaction": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "code": "read" } ] }, { "type": "Subscription", "interaction": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "code": "create" }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "code": "delete" } ] } ], "operation": [ { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "name": "find", "definition": { "reference": "http://fhir.org/guides/argonaut-scheduling/OperationDefinition/appointment-find" } }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "name": "hold", "definition": { "reference": "http://fhir.org/guides/argonaut-scheduling/OperationDefinition/appointment-hold" } }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "SHOULD" } ], "name": "book", "definition": { "reference": "http://fhir.org/guides/argonaut-scheduling/OperationDefinition/appointment-book" } }, { "extension": [ { "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation", "valueCode": "MAY" } ], "name": "prefetch", "definition": { "reference": "http://fhir.org/guides/argonaut-scheduling/OperationDefinition/slot-prefetch" } } ] } ] }