0.1.0 - trial-use
KisimScheduling - Local Development build (v0.1.0). See the Directory of published versions
| Official URL: http://fhir.kisimdocs.ch/ig/KisimScheduling/OperationDefinition/appointment-query-searchByPlan | Version: 0.1.0 | |||
| Draft as of 2022-09-05 | Computable Name: SearchAppointmentByPlan | |||
Search for a bundle of appointments which were created on the locations or practitioners defined in the search plan.
Additional to the _query parameter we also need to include a time frame defined by the from and to parameters.
This operation can be used to look for appointments after they were booked.
QUERY: SearchAppointmentByPlan
The official URL for this operation definition is:
http://fhir.kisimdocs.ch/ig/KisimScheduling/OperationDefinition/appointment-query-searchByPlan
Parameters
| Use | Name | Cardinality | Type | Binding | Documentation |
| IN | _query | 1..1 | string (string) | http://hl7.org/fhir/ValueSet/binding-strength (Required) | Extended search parameter, value has to be searchByPlan |
| IN | planIcode | 1..1 | string (string) | http://hl7.org/fhir/ValueSet/binding-strength (Required) | Search definition inside ERP. UUID-Format |
| IN | from | 1..1 | string (string) | http://hl7.org/fhir/ValueSet/binding-strength (Required) | Starting time for the search. Accepted formats are: "yyyy-mm-dd hh:ii" or "yyyy-mm-dd". |
| IN | to | 1..1 | string (string) | http://hl7.org/fhir/ValueSet/binding-strength (Required) | Stopping time for the search. Accepted formats are: "yyyy-mm-dd hh:ii" or "yyyy-mm-dd". |
| OUT | return | 0..1 | Bundle | http://hl7.org/fhir/ValueSet/binding-strength (Required) | A bundle of appointment ressources. |
Search for a time period
Search appointments for a plan definition:
GET [base]/Appointment?_query=searchByPlan&planIcode=[UUID]&from=2020-11-10 12:00&to=2020-11-30 17:00
Response
HTTP/1.1 200 OK
[other headers]
Response Body
The response for the different searches will always be a bundle with 0…n entries.
{
"resourceType": "Bundle",
"id": "05163c62-bdb8-4b21-924a-04719932f55b",
"meta": {
"lastUpdated": "2021-03-10T13:56:59.410+01:00"
},
"type": "searchset",
"total": 1,
"link": [
{
"relation": "self",
"url": "/fhir/r4/*/Appointment?_query=searchByPlan&from=2021-03-07%2012%3A00&planIcode=3bb783e0-f9d8-4d9e-9cfa-d5d9e399ba61&to=2021-03-31%2017%3A00"
}
],
"entry": [
{
"fullUrl": "/fhir/r4/*/Appointment/22839",
"resource": {
"resourceType": "Appointment",
"id": "22839",
"identifier": [
{
"system": "http://cistec.com",
"value": "22839"
}
],
"status": "pending",
"serviceCategory": [
{
"coding": [
{
"system": "http://hl7.org/fhir/ValueSet/service-category",
"code": "35",
"display": "Hospital"
}
]
}
],
"start": "2021-03-11T08:00:00.000+01:00",
"end": "2021-03-11T08:10:00.000+01:00",
"participant": [
{
"actor": {
"reference": "Practitioner/PRACTITIONER",
"display": "Test Practitioner"
},
"status": "accepted"
}
]
}
}
]
}