Standardized Medication Profile (SMP) FHIR IG
1.0.0 - STU 1 United States of America flag

Standardized Medication Profile (SMP) FHIR IG, published by HL7 International / Pharmacy. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/smp-ig/ and changes regularly. See the Directory of published versions

CapabilityStatement: smp-server

Official URL: http://hl7.org/fhir/us/smp/CapabilityStatement/smp-server Version: 1.0.0
Standards status: Trial-use Maturity Level: 1 Computable Name: SMP_Server

This resource defines the expected capabilities of the SMP Server actor when conforming to the SMP IG and It is expected that it will be used in conjunction with the US Core CapabilityStatement. Together they describe the complete list of actual profiles and RESTful operations supported by SMP servers. SMP Server requirements may also be impacted by the rules of local jurisdictions or other contextual requirements.

Raw OpenAPI-Swagger Definition file | Download

  • Implementation Guide Version: 1.0.0
  • FHIR Version: 4.0.1
  • Supported Formats: SHALL support json, SHOULD support xml
  • Published on: 2024-04-29 00:00:00-0600
  • Published by: HL7 International / Pharmacy

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

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)

Core FHIR Resource
List
Reference Policy
Interaction summary
  • SHALL support
    read

    Allows retrieval of medication list for the various point in time information.

  • SHOULD support
    update

    Allows for the maintenance of the medication lists.

    create

    Allows for the creation of a medication list.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

Allows retrieving medication lists for the patient

SHOULDcodetoken

Allows retrieving specific kinds of medication lists

 
Extended Operations
ConformanceOperationDocumentation
MAY$smp-query

Operation used to retrieve individual patient's medication history

MAY$smp-submit

Operation used to submit individual patient's medication list for storage

Core FHIR Resource
MedicationStatement
Reference Policy
Interaction summary
  • SHALL support
    read

    Allows retrieval of medication details.

  • SHOULD support
    update

    Allows for the maintenance of the medication details.

    create

    Allows for the creation of a medication details. (Mandatory if creation of Medication lists enabled.)

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

Allows retrieving medication statements for a patient

SHOULDstatustoken

Allows filtering by medication statement status

 
Core FHIR Resource
Medication
Reference Policy
Interaction summary
  • SHOULD support
    read

    Allows retrieval medication details

  • MAY support
    create

    Allows for the creation of a medication.

Core FHIR Resource
MedicationRequest
Reference Policy
Interaction summary
  • SHOULD support
    read

    Allows retrieval of .

  • MAY support
    create

    Allows for the creation of a medication.

    update

    Allows for the maintenance of a MedicationRequest as required.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

Allows retrieving medication requests for a patient

SHOULDintenttoken

Allows filtering by medication request intent

SHOULDstatustoken

Allows filtering by medication request status

 
Core FHIR Resource
MedicationAdministration
Reference Policy
Interaction summary
  • SHOULD support
    read

    Allows retrieval medication details.

  • MAY support
    create

    Allows for the creation of a medication.

    update

    Allows for the maintenance of a MedicationAdministration as required.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

Allows retrieving medication administrations for a patient

SHOULDstatustoken

Allows filtering by medication administration status

 
Core FHIR Resource
CarePlan
Reference Policy
Interaction summary
  • SHOULD support
    read

    Allows retrieval medication action plan details.

  • MAY support
    create

    Allows for the creation of a medication action plan.

    update

    Allows for the maintenance of a CarePlan as required.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

Allows retrieving medication action plans for a patient

 
Core FHIR Resource
DetectedIssue
Reference Policy
Interaction summary
  • SHOULD support
    read

    Allows retrieval medication action plan detected issue details.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference

Allows retrieving medication action plans for a patient

 
Core FHIR Resource
Patient
Reference Policy
Interaction summary
  • SHALL support
    read

    Required for identification and retrieval of patient medication information

Supported Profiles

US Core Patient Profile

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Allows retrieval of patient by id. Aligns with US Core requirement and FHIR base spec.

 
Core FHIR Resource
Bundle
Reference Policy
Interaction summary
  • MAY support
    read

    Allows retrieval of collection-type medication list bundles from a repository. Does NOT apply to transaction bundles which are ephemeral. If the smp-query operation on List is implemented, this capability becomes mandatory.

Documentation

Supports three Bundle profiles: (1) Bundle Medication List profile (type=collection) for retrieving medication lists with supporting resources - supports read interaction; (2) Bundle Medication List Maintenance profile (type=transaction) for submitting create/update operations - transaction bundles are ephemeral processing instructions and are not stored as resources, so the read interaction does not apply to them; (3) Bundle Medication Action Plan (type=document) for submitting a medication action plan consisting of detected issues and an unstructured document attachment.