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

## CapabilityStatement: EPA Capability Statement für Clients des ePA Medication Service

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

Dieses Capability Statement legt die Anforderungen an ePA Clients fest, die den Medication Service der verwenden. Es definiert die unterstützten Interaktionen, erforderliche HTTP Header sowie erwartete Status Codes.

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

## EPA Capability Statement für Clients des ePA 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 Client

## FHIR RESTful Capabilities

### Mode: `client`

Summary of System-wide Operations

Conformance | Operation | Documentation
--- | --- | ---
MAY | $provide-prescription-erp |
MAY | $cancel-prescription-erp |
MAY | $provide-dispensation-erp |
MAY | $cancel-dispensation-erp |
MAY | $medication-list |
MAY | $medication-plan |
MAY | $medication-plan-log |
MAY | $add-emp-entry |
MAY | $update-emp-entry |
MAY | $batch-emp |
MAY | $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
--- | --- | --- | ---
MAY | _id | `token` | Resource.id
MAY | _lastUpdated | `date` | Resource.meta.lastUpdated
MAY | _has | `string` | Return resources linked to by the given target
MAY | identifier | `token` | Medication.identifier
MAY | code | `token` | Medication.code
MAY | status | `token` | Medication.status
MAY | ingredient-code | `token` | Medication.ingredient.item as CodeableConcept
MAY | rx-prescription | `token` | Medication.extension
MAY | 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
--- | --- | --- | ---
MAY | _id | `token` | Resource.id
MAY | _lastUpdated | `date` | Resource.meta.lastUpdated
MAY | _has | `string` | Return resources linked to by the given target
MAY | identifier | `token` | MedicationRequest.identifier
MAY | authoredon | `date` | MedicationRequest.authoredOn
MAY | intent | `token` | MedicationRequest.intent
MAY | status | `token` | MedicationRequest.status
MAY | requester | `reference` | MedicationRequest.requester
MAY | medication | `reference` | MedicationRequest.medication as Reference
MAY | context | `token` | MedicationRequest.extension:context
MAY | activity | `reference` | MedicationRequest.extension:activity
MAY | 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
--- | --- | --- | ---
MAY | _id | `token` | Resource.id
MAY | _lastUpdated | `date` | Resource.meta.lastUpdated
MAY | _has | `string` | Return resources linked to by the given target
MAY | identifier | `token` | MedicationDispense.identifier
MAY | whenhandedover | `date` | MedicationDispense.whenHandedOver
MAY | prescription | `reference` | MedicationDispense.authorizingPrescription
MAY | performer | `reference` | MedicationDispense.performer.actor
MAY | status | `token` | MedicationDispense.status
MAY | medication | `reference` | MedicationDispense.medication as Reference
MAY | 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
--- | --- | --- | ---
MAY | _id | `token` | Resource.id
MAY | _lastUpdated | `date` | Resource.meta.lastUpdated
MAY | _has | `string` | Return resources linked to by the given target
MAY | identifier | `token` | MedicationStatement.identifier
MAY | medication | `reference` | MedicationStatement.medication as Reference
MAY | part-of | `reference` | MedicationStatement.partOf as Reference
MAY | status | `token` | MedicationStatement.status
MAY | effective | `date` | MedicationStatement.effective
MAY | rx-prescription | `token` | Medication.extension
MAY | derived-from | `reference` | MedicationStatement.derivedFrom as Reference
MAY | context | `token` | MedicationStatement.extension:context
MAY | based-on-emp | `reference` | MedicationStatement.basedOn mit Extension:is-emp = true

Extended Operations

Conformance | Operation | Documentation
--- | --- | ---
MAY | $add-eml-entry |
MAY | $cancel-eml-entry |
MAY | $link-emp |
MAY | $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
--- | --- | --- | ---
MAY | _id | `token` | Resource.id
MAY | _lastUpdated | `date` | Resource.meta.lastUpdated
MAY | _has | `string` | Return resources linked to by the given target
MAY | identifier | `token` | Organization.identifier
MAY | 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
--- | --- | --- | ---
MAY | _id | `token` | Resource.id
MAY | _lastUpdated | `date` | Resource.meta.lastUpdated
MAY | _has | `string` | Return resources linked to by the given target
MAY | identifier | `token` | Practitioner.identifier
MAY | 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
--- | --- | --- | ---
MAY | _id | `token` | Resource.id
MAY | _lastUpdated | `date` | Resource.meta.lastUpdated
MAY | _has | `string` | Return resources linked to by the given target
MAY | identifier | `token` | PractitionerRole.identifier
MAY | practitioner | `reference` | PractitionerRole.practitioner
MAY | 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
--- | --- | --- | ---
MAY | _id | `token` | Resource.id
MAY | _lastUpdated | `date` | Resource.meta.lastUpdated
MAY | _has | `string` | Return resources linked to by the given target
MAY | identifier | `token` | MedicationStatement.identifier
MAY | agent | `reference` | Who participated
MAY | target | `reference` | Target References - usually version specific
MAY | recorded | `date` | When the activity was recorded / updated
MAY | when | `date` | Provenance.occurred as dateTime
MAY | is-emp-chronology | `token` | Provenance.extension:isEMPChronology