| Package | hl7.fhir.us.meds |
| Type | CapabilityStatement |
| Id | client |
| FHIR Version | R3 |
| Source | http://hl7.org/fhir/us/meds/http://hl7.org/fhir/us/meds/STU2/CapabilityStatement-client.html |
| URL | http://hl7.org/fhir/us/meds/CapabilityStatement/client |
| Version | 1.2.0 |
| Status | draft |
| Date | 2017-03-08T00:00:00-05:00 |
| Name | US Meds Client |
| Realm | us |
| Authority | hl7 |
| Description | This resource defines the expected capabilities of the US Meds Client actor when conforming to the US Meds IG and It is expected that it will be used in conjuction with the US Core CapabilityStatement. Together they describe the complete list of actual profiles, RESTful operations, and search parameters supported by US Meds Clients. |
| Kind | requirements |
No resources found
No resources found
Note: links and images are rebased to the (stated) source
This section describes the expected capabilities of a client actor which is responsible for creating and initiating the queries for information about an individual patient.It is expected that this CapabilityStatement will be used with the US Core CapabilityStatement. Together they describe the basic expectations for the capabilities of a conformant client application. The complete list of actual profiles and dependencies on other profiles outside the FHIR specification RESTful interactions which includes the search and read operations that MAY be supported by the client
The US Meds Clent SHALL support fetching and querying of one or more US Meds profile(s), using the supported RESTful interactions and search parameters declared in the US Meds Server CapabilityStatement
The US Meds Clent SHOULD Declare a CapabilityStatement identifying the list of profiles, operations, search parameter supported.
US Core Servers SHALL implement the security requirements documented in the US-Core IG.
Summary of US Meds search criteria
Specific client search capabilities are described in detail below in each of the resource sections. The MedicationAdministration, MedicationDispense, MedicationStatement and MedicationRequest resources can represent a medication using either a code or refer to the Medication resource. When referencing a Medication resource, the resource may be contained or an external resource. The server application can choose any one way or more than one method, but if the an external reference to Medication is used, the server SHALL support the [_include]((http://hl7.org/fhir/STU3/http.html#include) parameter for searching this element. The client application SHALL support all above methods without causing the application to fail.
Supported Profiles: US Core Medication Profile
Supported Profiles: US Meds MedicationAdministration Profile
Search Criteria:
A client SHALL be capable of fetching a patient’s administered medications using:
FHIRGET /MedicationAdministration?patient=[id]
GET /MedicationAdministration?patient=[id]&_include=MedicationAdministration:medication
Supported Profiles: US Meds MedicationDispense Profile
Search Criteria:
A client SHALL be capable of fetching a patient’s dispensed medications using:
GET /MedicationDispense?patient=[id]
GET /MedicationDispense?patient=[id]&_include=MedicationDispense:medication
Supported Profiles: US Core MedicationRequest Profile
Search Criteria:
A client SHALL be capable of fetching all patient’s active medications orders using:
GET /MedicationRequest?patient=[id]&status=active
GET /MedicationRequest?patient=[id]&status=active&_include=MedicationRequest:medication
Supported Profiles: US Core MedicationStatement Profile
Search Criteria:
A client SHALL be capable of fetching all medications for a patient using:
GET /MedicationStatement?patient=[id]
GET /MedicationStatement?patient=[id]&_include=MedicationStatement:medication
A client SHALL be capable of fetching all active medications for a patient using:
GET /MedicationStatement?patient=[id]&status=active
GET /MedicationStatement?patient=[id]&status=active&_include=MedicationStatement:medication
A client SHALL be capable of fetching all medications for a patient for an encounter using:
GET /MedicationStatement?patient=[id]&context=[id]
GET /MedicationStatement?patient=[id]&context=[id]&_include=MedicationStatement:medication
{
"resourceType": "CapabilityStatement",
"id": "client",
"text": {
"status": "additional",
"div": "<!-- snip (see above) -->"
},
"url": "http://hl7.org/fhir/us/meds/CapabilityStatement/client",
"version": "1.2.0",
"name": "US Meds Client",
"status": "draft",
"date": "2017-03-08T00:00:00-05:00",
"publisher": "Health Level Seven International Pharmacy Work Group",
"contact": [
{
"telecom": [
{
"system": "other",
"value": "http://www.hl7.org/Special/committees/medication/index.cfm"
}
]
}
],
"description": "This resource defines the expected capabilities of the US Meds Client actor when conforming to the US Meds IG and It is expected that it will be used in conjuction with the US Core CapabilityStatement. Together they describe the complete list of actual profiles, RESTful operations, and search parameters supported by US Meds Clients.",
"kind": "requirements",
"fhirVersion": "3.0.0",
"format": [
"xml",
"json"
],
"rest": [
{
"mode": "client",
"resource": [
{
"type": "Medication",
"interaction": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "search-type",
"documentation": "IF the Medication Resource is used in a MedicationStatement or a MedicationRequest. Allows discovery of existing US Core Medication resources using different search criteria."
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "read",
"documentation": "IF the Medication Resource is used in a MedicationStatement or a MedicationRequest. Allows retrieval of a specific US Core Medication by id"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "history-instance",
"documentation": "Allows review of changes to US Core Medication instance over time"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "vread",
"documentation": "Allows retrieval of a historical version of a US Core Medication instance"
}
]
},
{
"type": "MedicationAdministration",
"interaction": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "search-type",
"documentation": "Allows discovery of existing US Meds MedicationAdministration resources using different search criteria"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "read",
"documentation": "Allows retrieval of a specific US Meds MedicationAdministration by id"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "history-instance",
"documentation": "Allows review of changes to US Meds MedicationAdministration instance over time"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "vread",
"documentation": "Allows retrieval of a historical version of a US Meds MedicationAdministration instance"
}
],
"searchInclude": [
"MedicationAdministration:medication"
],
"searchParam": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/medications-patient",
"type": "reference"
}
]
},
{
"type": "MedicationDispense",
"interaction": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "search-type",
"documentation": "Allows discovery of existing US Meds MedicationDispense resources using different search criteria"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "read",
"documentation": "Allows retrieval of a specific US Meds MedicationDispense by id"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "history-instance",
"documentation": "Allows review of changes to US Meds MedicationDispense instance over time"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "vread",
"documentation": "Allows retrieval of a historical version of a US Meds MedicationDispense instance"
}
],
"searchInclude": [
"MedicationDispense:medication"
],
"searchParam": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/medications-patient",
"type": "reference"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "required",
"valueString": "patient"
},
{
"url": "required",
"valueString": "status"
}
],
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-search-parameter-combination"
}
],
"type": "MedicationRequest",
"interaction": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "search-type",
"documentation": "Allows discovery of existing US Core MedicationRequest resources using different search criteria"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "read",
"documentation": "Allows retrieval of a specific US Core MedicationRequest by id"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "history-instance",
"documentation": "Allows review of changes to US Core MedicationRequest instance over time"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "vread",
"documentation": "Allows retrieval of a historical version of a US Core MedicationRequest instance"
}
],
"searchInclude": [
"MedicationRequest:medication"
],
"searchParam": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/medications-patient",
"type": "reference"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"name": "status",
"definition": "http://hl7.org/fhir/SearchParameter/medications-status",
"type": "token"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "required",
"valueString": "patient"
},
{
"url": "required",
"valueString": "status"
}
],
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-search-parameter-combination"
},
{
"extension": [
{
"url": "required",
"valueString": "patient"
},
{
"url": "required",
"valueString": "context"
}
],
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-search-parameter-combination"
}
],
"type": "MedicationStatement",
"interaction": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "search-type",
"documentation": "Allows discovery of existing US Core MedicationStatement resources using different search criteria"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "read",
"documentation": "Allows retrieval of a specific US Core MedicationStatement by id"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "history-instance",
"documentation": "Allows review of changes to US Core MedicationStatement instance over time"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"code": "vread",
"documentation": "Allows retrieval of a historical version of a US Core MedicationStatement instance"
}
],
"searchInclude": [
"MedicationStatement:medication"
],
"searchParam": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"name": "patient",
"definition": "http://hl7.org/fhir/SearchParameter/medications-patient",
"type": "reference"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
],
"name": "status",
"definition": "http://hl7.org/fhir/SearchParameter/medications-status",
"type": "token"
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "MAY"
}
],
"name": "category",
"definition": "http://hl7.org/fhir/SearchParameter/MedicationStatement-category",
"type": "reference"
}
]
}
]
}
]
}