Implementation Guide
ePA Medication Service
Version 1.0.5-1 - release

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

Official URL: https://gematik.de/fhir/epa-medication/CapabilityStatement/epa-medication-service-server | Version: 1.0.5-1
Active as of 2025-02-28 | Computable Name: EPAMedicationServiceServer

EPA CapabilityStatement für den the Medication Service

### OpenAPI

Die bereitgestellte OpenAPI-Definition dient ausschließlich als Hilfestellung bei der Implementierung. Sie enthält nicht alle möglichen Fehlercodes oder Rückgabewerte und kann daher nicht als normativ betrachtet werden. Für eine vollständige und korrekte Implementierung sind die offiziellen Spezifikationen und begleitenden Dokumentationen maßgeblich.

Raw OpenAPI-Swagger Definition file | Download

Generated Narrative: CapabilityStatement epa-medication-service-server

## EPA CapabilityStatement für den the Medication Service

- Implementation Guide Version: 1.0.5-1
- FHIR Version: 4.0.1
- Supported Formats: `application/fhir+json`
- Supported Patch Formats:
- Published on: 2025-02-28
- 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.

## FHIR RESTful Capabilities

### Mode: `server`

Summary of System-wide Interactions

### 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 | S | U | C | Searches | `_include` | `_revinclude` | Operations
--- | --- | --- | --- | --- | --- | --- | --- | --- | ---
Medication | https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication Additional supported profiles: EPA Pharmaceutical Product Medication EPA Medication PZN Ingredient | y | y |  |  | _id, _lastUpdated, identifier, code, status, ingredient-code | `Medication:ingredient` | `MedicationRequest:medication`, `MedicationDispense:medication`, `Medication:ingredient` |
MedicationRequest | https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-request | y | y |  |  | _id, _lastUpdated, identifier, authoredon, status, requester, medication | `MedicationRequest:medication`, `MedicationRequest:performer` | `MedicationDispense:prescription` |
MedicationDispense | https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-dispense | y | y |  |  | _id, _lastUpdated, identifier, whenhandedover, prescription, performer, status, medication | `MedicationDispense:medication`, `MedicationDispense:performer`, `MedicationDispense:prescription` |  |
Organization | Supported Profiles Organization in gematik Directory | y | y |  |  | _id, _lastUpdated, identifier, name |  | `MedicationDispense:perfomer`, `PractitionerRole:organization`, `MedicationRequest:requester` |
Practitioner | Supported Profiles Practitioner in gematik Directory | y | y |  |  | _id, _lastUpdated, identifier, name |  | `MedicationDispense:perfomer`, `PractitionerRole:practitioner`, `MedicationRequest:requester` |
PractitionerRole |  | y | y |  |  | _id, _lastUpdated, identifier, practitioner, organization | `PractitionerRole:practitioner`, `PractitionerRole:organization` | `MedicationDispense:perfomer`, `MedicationRequest:requester` |

#### Resource Conformance: SHALL Medication

Base System Profile
EPA Medication
Profile Conformance
SHALL
Reference Policy

Supported Profiles

EPA Pharmaceutical Product Medication
EPA Medication PZN Ingredient

Interaction summary

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

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.​id
SHALL | _lastUpdated | `date` | Resource.​meta.​lastUpdated
SHALL | identifier | `token` | Medication.identifier
SHALL | code | `token` | Medication.code
SHALL | status | `token` | Medication.status
SHALL | ingredient-code | `token` | Medication.ingredient.item as CodeableConcept

#### Resource Conformance: SHALL MedicationRequest

Base System Profile
EPA MedicationRequest
Profile Conformance
SHALL
Reference Policy

Interaction summary

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

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.​id
SHALL | _lastUpdated | `date` | Resource.​meta.​lastUpdated
SHALL | identifier | `token` | MedicationRequest.identifier
SHALL | authoredon | `date` | MedicationRequest.authoredOn
SHALL | status | `token` | MedicationRequest.status
SHALL | requester | `reference` | MedicationRequest.requester
SHALL | medication | `reference` | MedicationRequest.medication as Reference

#### Resource Conformance: SHALL MedicationDispense

Base System Profile
EPA MedicationDispense
Profile Conformance
SHALL
Reference Policy

Interaction summary

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

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.​id
SHALL | _lastUpdated | `date` | Resource.​meta.​lastUpdated
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

#### Resource Conformance: SHALL Organization

Core FHIR Resource
Organization
Reference Policy
Interaction summary

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

Supported Profiles

Organization in gematik Directory

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.​id
SHALL | _lastUpdated | `date` | Resource.​meta.​lastUpdated
SHALL | identifier | `token` | Organization.identifier
SHALL | name | `string` | Organization.name | Organization.alias

#### Resource Conformance: SHALL Practitioner

Core FHIR Resource
Practitioner
Reference Policy
Interaction summary

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

Supported Profiles

Practitioner in gematik Directory

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.​id
SHALL | _lastUpdated | `date` | Resource.​meta.​lastUpdated
SHALL | identifier | `token` | Practitioner.identifier
SHALL | name | `string` | Practitioner.name

#### Resource Conformance: SHALL PractitionerRole

Core FHIR Resource
PractitionerRole
Reference Policy
Interaction summary

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

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | _id | `token` | Resource.​id
SHALL | _lastUpdated | `date` | Resource.​meta.​lastUpdated
SHALL | identifier | `token` | PractitionerRole.identifier
SHALL | practitioner | `reference` | PractitionerRole.practitioner
SHALL | organization | `reference` | PractitionerRole.organization

### Operations

#### Use