IHE Pharmacy Medication Overview
0.1.0 - ci-build International flag

IHE Pharmacy Medication Overview, published by Integrating the Healthcare Enterprise (IHE). This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IHE/pharm-meow/tree/r4-rr and changes regularly. See the Directory of published versions
Built from commit 8f4435f7.   Branch: r4-rr.

CapabilityStatement: Medication Overview Responder

Official URL: http://profiles.ihe.net/PHARM/MEOW/CapabilityStatement/MedicationOverviewResponder Version: 0.1.0
Active as of 2025-01-01 Computable Name: MedicationOverviewResponder

Copyright/Legal: IHE http://www.ihe.net/Governance/#Intellectual_Property

CapabilityStatement for the Medication Overview Responder actor in the IHE PHARM MEOW profile.

The Responder is a server that stores and/or assembles medication overview data for patients and serves it in response to Consumer requests. It supports PHARM-11 (Query Medication Resources) as a required capability, and optionally PHARM-12 (Retrieve Medication Document) when the Document Option is declared.

How the Responder obtains its data (continuous store, on-demand aggregation, document assembly) is an implementation concern outside the scope of this profile.

Raw OpenAPI-Swagger Definition file | Download

Medication Overview Responder

  • Implementation Guide Version: 0.1.0
  • FHIR Version: 4.0.1
  • Supported Formats: application/fhir+json, application/fhir+xml
  • Published on: 2025-01-01
  • Published by: Integrating the Healthcare Enterprise (IHE)

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

FHIR RESTful Capabilities

Mode: server

The Responder responds to PHARM-11 search queries with searchset Bundles containing MedicationTreatmentLine resources. With the Document Option, it also responds to PHARM-12 requests with MedicationOverviewBundle documents.

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRSUCSearches_include_revincludeOperations
MedicationStatementSupported Profiles
  Medication Treatment Line		yypatient, status, effective, category, _lastUpdatedMedicationStatement:medication, MedicationStatement:derivedFrom, MedicationStatement:partOfMedicationDispense:prescription, MedicationAdministration:request
CarePlanSupported Profiles
  Medication Treatment		y
MedicationRequest y
MedicationDispense y
MedicationAdministration y
MedicationSupported Profiles
  Medicinal product		y
BundleSupported Profiles
  Medication Overview Bundle		yytype, patient, date
Core FHIR Resource
MedicationStatement
Reference Policy
Interaction summary
  • Supports search-type, read.

Supported Profiles

Medication Treatment Line

Documentation

The Repository SHALL support search on MedicationStatement using the defined search parameters. The patient parameter is required on all searches.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

Required. Patient whose treatment lines are requested.

SHALLstatustoken

Filter by treatment line status.

SHALLeffectivedate

Filter by effective period.

SHALLcategorytoken

Filter by list category / type.

SHALL_lastUpdateddate

Filter by last update time (incremental sync support).

 
Core FHIR Resource
CarePlan
Reference Policy
Interaction summary
  • Supports read.

Supported Profiles

Medication Treatment

Documentation

Returned as an _include of MedicationStatement:partOf when MedicationTreatment grouping is present.

Core FHIR Resource
MedicationRequest
Reference Policy
Interaction summary
  • Supports read.

Documentation

Optionally returned as _include of MedicationStatement:derivedFrom (prescriptions).

Core FHIR Resource
MedicationDispense
Reference Policy
Interaction summary
  • Supports read.

Documentation

Optionally returned as _revinclude of MedicationDispense:prescription.

Core FHIR Resource
MedicationAdministration
Reference Policy
Interaction summary
  • Supports read.

Documentation

Optionally returned as _revinclude of MedicationAdministration:request.

Core FHIR Resource
Medication
Reference Policy
Interaction summary
  • Supports read.

Supported Profiles

Medicinal product

Documentation

Optionally returned as _include of MedicationStatement:medication.

Core FHIR Resource
Bundle
Reference Policy
Interaction summary
  • Supports read, search-type.

Supported Profiles

Medication Overview Bundle

Documentation

Document Option (PHARM-12). The Repository stores and serves MedicationOverviewBundle documents. Supports retrieval by logical id and by patient/type/date search.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLtypetoken

Filter by document type / medication list category.

SHALLpatientreference

Required for patient-scoped document search.

SHALLdatedate

Filter by document creation date.