PCC-4
Query Medications
This section corresponds to Transaction PCC-3 of the IHE Patient Care Coordination Technical Framework. Transaction Query Medications is used by the Clinical Data Consumer and Medication Data Repository Actors.
Transaction Query Medications uses the same pattern as transaction PCC-1. Therefore, the Referenced Standards and Interaction Diagrams sections also serve to document the standards and interactions used in this transaction. Information specific to this transaction is described in futher detail below in the section on Domain Content.
Use Case Roles
Clinical Data Consumer | Medication Data Repository | |
- Actor
- Clinical Data Consumer
- Role
- Requests Requests a list of medications for a given patient matching a minimal set of selection criteria from the Medication Data Repository.
- Actor
- Medication Data Repository
- Role
- Returns medications for a given patient matching the selection criteria supplied by the Clinical Data Consumer.
Domain Content
This section lists the requirements specific to the Query Medications transaction.
Note: | Implementors of a Medications Data Repository Actor, or a Clinical Data Consumer Actor shall publish an HL7 Conformance Profile that indicates the vocabularies and code sets that they support for this transaction. |
Get Care Record Profile Query
careProvisionCode
A Clinical Data Consumer may specify the following values from the HL7 ActCode vocabulary (2.16.840.1.113883.5.4) to obtain the observations listed in the table below.
Code | Returns | Template Id |
---|---|---|
RXCAT | All Medications | Medications |
MEDLIST | All Medications | Medications |
CURMEDLIST | All active medications | Medications |
DISCHMEDLIST | Discharge Medications | Medications |
HISTMEDLIST | All Historical Medications | Medications |
A Clinical Data Consumer Actor may make requests using other codes to obtain information about specific medications, however, the Medication Data Repository Actor need not honor these codes.
Codes for medications may be found in RxNorm (2.16.840.1.113883.6.88), NDC (2.16.840.1.113883.6.69) and SNOMED CT (2.16.840.1.113883.6.96).
Note: | The code value specified in the query may represent a code found in <code> of the <substanceAdministration>, or any of its components, and thus may identify an act or a substance |
careProvisionReason
The <value> element of the <careProvisionReason> element may contain a value identifying a specific problem that was the reason for the medication.
A Medication Data Repository Actor that chooses to honor this query parameter shall return only those results that were for the indicated reason. Should the Diagnostic Data Repository Actor not support the use of the <careProvisionReason> element, it shall indicate this by raising the appropriate alert as decribed in the expected actions recorded in PCC-1.
Get Care Record Profile Response
A Medication Data Repository Actor shall respond to a query request by returning clinical statements matching the query parameter returned within <pertinentInformation3> data elements.
The clinical statements that are returned for by this transaction shall conform to the |Medications template.