Implementation Guide
ePA Medication Service
Version 1.2.0-ballot.2 - draft

## CapabilityStatement: EPA CapabilityStatement für den Medication Service

Official URL: https://gematik.de/fhir/epa-medication/CapabilityStatement/epa-medication-service-server | Version: 1.2.0-ballot.2
Draft as of 2025-09-02 | Computable Name: EPAMedicationServiceServer

EPA CapabilityStatement für den Medication Service

Profile: Capability Statement Profil für TI FHIR Data Service

## EPA CapabilityStatement für den Medication Service

- Implementation Guide Version: 1.2.0-ballot.2
- FHIR Version: 4.0.1
- Supported Formats: `application/fhir+json`, `application/fhir+xml`
- Published on: 2025-09-02
- Published by: gematik GmbH

> 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.

This CapabilityStatement imports the CapabilityStatement EPA Basic Server

## FHIR RESTful Capabilities

### Mode: `server`

Summary of System-wide Operations

Conformance | Operation | Documentation
--- | --- | ---
SHALL | $provide-prescription-erp |
SHALL | $cancel-prescription-erp |
SHALL | $provide-dispensation-erp |
SHALL | $cancel-dispensation-erp |
SHALL | $medication-list |
SHALL | $medication-plan |
SHALL | $medication-plan-log |
SHALL | $add-emp-entry |
SHALL | $update-emp-entry |
SHALL | $batch-emp |
SHALL | $emp-commit |

### 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 Type | Profile | R | V-R | S | U | C | H-I | H-T | Searches | `_include` | `_revinclude` | Operations
--- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | ---
Medication | Supported Profiles EPA Medication eMP Medication EPA Pharmaceutical Product Medication EPA Medication PZN Ingredient | Y | Y | Y |  |  | Y | Y | _id, _lastUpdated, _has, identifier, code, status, ingredient-code, rx-prescription, context |  | `MedicationRequest:medication`, `MedicationDispense:medication`, `MedicationStatement:medication` |
MedicationRequest | Supported Profiles EPA MedicationRequest eMP-Eintrag | Y | Y | Y |  |  | Y | Y | _id, _lastUpdated, _has, identifier, authoredon, intent, status, requester, medication, context, activity, effective-dose-period | `MedicationRequest:medication`, `MedicationRequest:requester`, `MedicationRequest:activity` | `MedicationDispense:prescription`, `MedicationStatement:derived-from` |
MedicationDispense | Supported Profiles EPA MedicationDispense | Y | Y | Y |  |  | Y | Y | _id, _lastUpdated, _has, identifier, whenhandedover, prescription, performer, status, medication, rx-prescription | `MedicationDispense:medication`, `MedicationDispense:performer`, `MedicationDispense:prescription` | `MedicationStatement:derived-from` |
MedicationStatement | Supported Profiles EPA MedicationStatement | Y | Y | Y |  |  | Y | Y | _id, _lastUpdated, _has, identifier, medication, part-of, status, effective, rx-prescription, derived-from, context, based-on-emp | `MedicationStatement:medication`, `MedicationStatement:part-of`, `MedicationStatement:derived-from`, `MedicationStatement:based-on-emp` | `Provenance:target` | `$add-eml-entry`, `$cancel-eml-entry`, `$link-emp`, `$unlink-emp`
Organization | Supported Profiles Organization in gematik Directory TI Organization | Y | Y | Y |  |  | Y | Y | _id, _lastUpdated, _has, identifier, name |  | `MedicationDispense:performer`, `PractitionerRole:organization`, `MedicationRequest:requester` |
Practitioner | Supported Profiles Practitioner in gematik Directory TI Practitioner | Y | Y | Y |  |  | Y | Y | _id, _lastUpdated, _has, identifier, name |  | `PractitionerRole:practitioner`, `MedicationRequest:requester` |
PractitionerRole |  | Y | Y | Y |  |  | Y | Y | _id, _lastUpdated, _has, identifier, practitioner, organization | `PractitionerRole:practitioner`, `PractitionerRole:organization` | `MedicationDispense:performer`, `MedicationRequest:requester` |
Provenance | Supported Profiles ePA-Änderungseintrag eMP-Chronologieeintrag | Y |  | Y |  |  |  |  | _id, _lastUpdated, _has, identifier, agent, target, recorded, when, is-emp-chronology | `Provenance:agent`, `Provenance:target` |  |

#### Resource Conformance: SHALLMedication

Core FHIR Resource
Medication
Reference Policy
Interaction summary

- SHALL support `search-type`, `history-type`, `read`, `history-instance`, `vread`.

Supported Profiles

EPA Medication
eMP Medication
EPA Pharmaceutical Product Medication
EPA Medication PZN Ingredient

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.id
SHALL | _lastUpdated | `date` | Resource.meta.lastUpdated
SHALL | _has | `string` | Return resources linked to by the given target
SHALL | identifier | `token` | Medication.identifier
SHALL | code | `token` | Medication.code
SHALL | status | `token` | Medication.status
SHALL | ingredient-code | `token` | Medication.ingredient.item as CodeableConcept
SHALL | rx-prescription | `token` | Medication.extension
SHALL | context | `token` | Medication.extension:context

#### Resource Conformance: SHALLMedicationRequest

Core FHIR Resource
MedicationRequest
Reference Policy
Interaction summary

- SHALL support `search-type`, `history-type`, `read`, `history-instance`, `vread`.

Supported Profiles

EPA MedicationRequest
eMP-Eintrag

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.id
SHALL | _lastUpdated | `date` | Resource.meta.lastUpdated
SHALL | _has | `string` | Return resources linked to by the given target
SHALL | identifier | `token` | MedicationRequest.identifier
SHALL | authoredon | `date` | MedicationRequest.authoredOn
SHALL | intent | `token` | MedicationRequest.intent
SHALL | status | `token` | MedicationRequest.status
SHALL | requester | `reference` | MedicationRequest.requester
SHALL | medication | `reference` | MedicationRequest.medication as Reference
SHALL | context | `token` | MedicationRequest.extension:context
SHALL | activity | `reference` | MedicationRequest.extension:activity
SHALL | effective-dose-period | `date` | MedicationRequest.extension:effectiveDosePeriod

#### Resource Conformance: SHALLMedicationDispense

Core FHIR Resource
MedicationDispense
Reference Policy
Interaction summary

- SHALL support `search-type`, `history-type`, `read`, `history-instance`, `vread`.

Supported Profiles

EPA MedicationDispense

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.id
SHALL | _lastUpdated | `date` | Resource.meta.lastUpdated
SHALL | _has | `string` | Return resources linked to by the given target
SHALL | identifier | `token` | MedicationDispense.identifier
SHALL | whenhandedover | `date` | MedicationDispense.whenHandedOver
SHALL | prescription | `reference` | MedicationDispense.authorizingPrescription
SHALL | performer | `reference` | MedicationDispense.performer.actor
SHALL | status | `token` | MedicationDispense.status
SHALL | medication | `reference` | MedicationDispense.medication as Reference
SHALL | rx-prescription | `token` | MedicationDispense.extension

#### Resource Conformance: SHALLMedicationStatement

Core FHIR Resource
MedicationStatement
Reference Policy
Interaction summary

- SHALL support `search-type`, `history-type`, `read`, `history-instance`, `vread`.

Supported Profiles

EPA MedicationStatement

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.id
SHALL | _lastUpdated | `date` | Resource.meta.lastUpdated
SHALL | _has | `string` | Return resources linked to by the given target
SHALL | identifier | `token` | MedicationStatement.identifier
SHALL | medication | `reference` | MedicationStatement.medication as Reference
SHALL | part-of | `reference` | MedicationStatement.partOf as Reference
SHALL | status | `token` | MedicationStatement.status
SHALL | effective | `date` | MedicationStatement.effective
SHALL | rx-prescription | `token` | Medication.extension
SHALL | derived-from | `reference` | MedicationStatement.derivedFrom as Reference
SHALL | context | `token` | MedicationStatement.extension:context
SHALL | based-on-emp | `reference` | MedicationStatement.basedOn mit Extension:is-emp = true

Extended Operations

Conformance | Operation | Documentation
--- | --- | ---
SHALL | $add-eml-entry |
SHALL | $cancel-eml-entry |
SHALL | $link-emp |
SHALL | $unlink-emp |

#### Resource Conformance: SHALLOrganization

Core FHIR Resource
Organization
Reference Policy
Interaction summary

- SHALL support `search-type`, `history-type`, `read`, `history-instance`, `vread`.

Supported Profiles

Organization in gematik Directory
TI Organization

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.id
SHALL | _lastUpdated | `date` | Resource.meta.lastUpdated
SHALL | _has | `string` | Return resources linked to by the given target
SHALL | identifier | `token` | Organization.identifier
SHALL | name | `string` | Organization.name | Organization.alias

#### Resource Conformance: SHALLPractitioner

Core FHIR Resource
Practitioner
Reference Policy
Interaction summary

- SHALL support `search-type`, `history-type`, `read`, `history-instance`, `vread`.

Supported Profiles

Practitioner in gematik Directory
TI Practitioner

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.id
SHALL | _lastUpdated | `date` | Resource.meta.lastUpdated
SHALL | _has | `string` | Return resources linked to by the given target
SHALL | identifier | `token` | Practitioner.identifier
SHALL | name | `string` | Practitioner.name

#### Resource Conformance: SHALLPractitionerRole

Core FHIR Resource
PractitionerRole
Reference Policy
Interaction summary

- SHALL support `search-type`, `history-type`, `read`, `history-instance`, `vread`.

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.id
SHALL | _lastUpdated | `date` | Resource.meta.lastUpdated
SHALL | _has | `string` | Return resources linked to by the given target
SHALL | identifier | `token` | PractitionerRole.identifier
SHALL | practitioner | `reference` | PractitionerRole.practitioner
SHALL | organization | `reference` | PractitionerRole.organization

#### Resource Conformance: SHALLProvenance

Core FHIR Resource
Provenance
Reference Policy
Interaction summary

- SHALL support `search-type`, `read`.

Supported Profiles

ePA-Änderungseintrag
eMP-Chronologieeintrag

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.id
SHALL | _lastUpdated | `date` | Resource.meta.lastUpdated
SHALL | _has | `string` | Return resources linked to by the given target
SHALL | identifier | `token` | MedicationStatement.identifier
SHALL | agent | `reference` | Who participated
SHALL | target | `reference` | Target References - usually version specific
SHALL | recorded | `date` | When the activity was recorded / updated
SHALL | when | `date` | Provenance.occurred as dateTime
SHALL | is-emp-chronology | `token` | Provenance.extension:isEMPChronology