Implementation Guide
ePA Medication Service
Version 1.2.0-ballot.1 - 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.1
Draft as of 2025-08-01 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.

EPA Capability Statement für Clients des ePA Medication Service

  • Implementation Guide Version: 1.2.0-ballot.1
  • FHIR Version: 4.0.1
  • Supported Formats: application/fhir+json, application/fhir+xml
  • Supported Patch Formats:
  • Published on: 2025-08-01
  • 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 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 TypeProfileRV-RSUCH-IH-TSearches_include_revincludeOperations
Medicationhttps://gematik.de/fhir/epa-medication/StructureDefinition/emp-medication
Additional supported profiles:
  EPA Pharmaceutical Product Medication
  EPA Medication PZN Ingredient
yyyyy_id, _lastUpdated, _has, identifier, code, status, ingredient-code, rx-prescription, contextMedicationRequest:medication, MedicationDispense:medication, MedicationStatement:medication
MedicationRequesthttps://gematik.de/fhir/epa-medication/StructureDefinition/emp-medication-requestyyyyy_id, _lastUpdated, _has, identifier, authoredon, status, requester, medication, context, activityMedicationRequest:medication, MedicationRequest:requester, MedicationRequest:activityMedicationDispense:prescription, MedicationStatement:derived-from
MedicationDispensehttps://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-dispenseyyyyy_id, _lastUpdated, _has, identifier, whenhandedover, prescription, performer, status, medication, rx-prescriptionMedicationDispense:medication, MedicationDispense:performer, MedicationDispense:prescriptionMedicationStatement:derived-from
MedicationStatementhttps://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-statementyyyyy_id, _lastUpdated, _has, identifier, medication, part-of, status, effective, rx-prescription, derived-from, context, based-on-empMedicationStatement:medication, MedicationStatement:part-of, MedicationStatement:derived-from, MedicationStatement:based-on-empProvenance:target$add-eml-entry, $update-eml-entry, $link-emp, $unlink-emp
OrganizationSupported Profiles
  Organization in gematik Directory
  TI Organization
yyyyy_id, _lastUpdated, _has, identifier, nameMedicationDispense:performer, PractitionerRole:organization, MedicationRequest:requester
PractitionerSupported Profiles
  Practitioner in gematik Directory
  TI Practitioner
yyyyy_id, _lastUpdated, _has, identifier, namePractitionerRole:practitioner, MedicationRequest:requester
PractitionerRole yyyyy_id, _lastUpdated, _has, identifier, practitioner, organizationPractitionerRole:practitioner, PractitionerRole:organizationMedicationDispense:performer, MedicationRequest:requester
ProvenanceSupported Profiles
  ePA-Änderungseintrag
  eMP-Chronologieeintrag
yy_id, _lastUpdated, _has, identifier, agent, target, recorded, when, is-emp-chronologyProvenance:agent, Provenance:target

Base System Profile
eMP Medication
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support search-type, history-type, read, history-instance, vread.

Search Parameters
ConformanceParameterTypeDocumentation
MAY_idtoken

Resource.id

MAY_lastUpdateddate

Resource.meta.lastUpdated

MAY_hasstring

Return resources linked to by the given target

MAYidentifiertoken

Medication.identifier

MAYcodetoken

Medication.code

MAYstatustoken

Medication.status

MAYingredient-codetoken

Medication.ingredient.item as CodeableConcept

MAYrx-prescriptiontoken

Medication.extension

MAYcontexttoken

Medication.extension:context

 
Base System Profile
eMP MedicationRequest
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support search-type, history-type, read, history-instance, vread.

Search Parameters
ConformanceParameterTypeDocumentation
MAY_idtoken

Resource.id

MAY_lastUpdateddate

Resource.meta.lastUpdated

MAY_hasstring

Return resources linked to by the given target

MAYidentifiertoken

MedicationRequest.identifier

MAYauthoredondate

MedicationRequest.authoredOn

MAYstatustoken

MedicationRequest.status

MAYrequesterreference

MedicationRequest.requester

MAYmedicationreference

MedicationRequest.medication as Reference

MAYcontexttoken

MedicationRequest.extension:context

MAYactivityreference

MedicationRequest.extension:activity

 
Base System Profile
EPA MedicationDispense
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support search-type, history-type, read, history-instance, vread.

Search Parameters
ConformanceParameterTypeDocumentation
MAY_idtoken

Resource.id

MAY_lastUpdateddate

Resource.meta.lastUpdated

MAY_hasstring

Return resources linked to by the given target

MAYidentifiertoken

MedicationDispense.identifier

MAYwhenhandedoverdate

MedicationDispense.whenHandedOver

MAYprescriptionreference

MedicationDispense.authorizingPrescription

MAYperformerreference

MedicationDispense.performer.actor

MAYstatustoken

MedicationDispense.status

MAYmedicationreference

MedicationDispense.medication as Reference

MAYrx-prescriptiontoken

MedicationDispense.extension

 
Base System Profile
EPA MedicationStatement
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support search-type, history-type, read, history-instance, vread.

Search Parameters
ConformanceParameterTypeDocumentation
MAY_idtoken

Resource.id

MAY_lastUpdateddate

Resource.meta.lastUpdated

MAY_hasstring

Return resources linked to by the given target

MAYidentifiertoken

MedicationStatement.identifier

MAYmedicationreference

MedicationStatement.medication as Reference

MAYpart-ofreference

MedicationStatement.partOf as Reference

MAYstatustoken

MedicationStatement.status

MAYeffectivedate

MedicationStatement.effective

MAYrx-prescriptiontoken

Medication.extension

MAYderived-fromreference

MedicationStatement.derivedFrom as Reference

MAYcontexttoken

MedicationStatement.extension:context

MAYbased-on-empreference

MedicationStatement.basedOn mit Extension:is-emp = true

 
Extended Operations
ConformanceOperationDocumentation
MAY$add-eml-entry
MAY$update-eml-entry
MAY$link-emp
MAY$unlink-emp
Core FHIR Resource
Organization
Reference Policy
Interaction summary
  • SHALL support search-type, history-type, read, history-instance, vread.

Search Parameters
ConformanceParameterTypeDocumentation
MAY_idtoken

Resource.id

MAY_lastUpdateddate

Resource.meta.lastUpdated

MAY_hasstring

Return resources linked to by the given target

MAYidentifiertoken

Organization.identifier

MAYnamestring

Organization.name | Organization.alias

 
Core FHIR Resource
Practitioner
Reference Policy
Interaction summary
  • SHALL support search-type, history-type, read, history-instance, vread.

Search Parameters
ConformanceParameterTypeDocumentation
MAY_idtoken

Resource.id

MAY_lastUpdateddate

Resource.meta.lastUpdated

MAY_hasstring

Return resources linked to by the given target

MAYidentifiertoken

Practitioner.identifier

MAYnamestring

Practitioner.name

 
Core FHIR Resource
PractitionerRole
Reference Policy
Interaction summary
  • SHALL support search-type, history-type, read, history-instance, vread.

Search Parameters
ConformanceParameterTypeDocumentation
MAY_idtoken

Resource.id

MAY_lastUpdateddate

Resource.meta.lastUpdated

MAY_hasstring

Return resources linked to by the given target

MAYidentifiertoken

PractitionerRole.identifier

MAYpractitionerreference

PractitionerRole.practitioner

MAYorganizationreference

PractitionerRole.organization

 
Core FHIR Resource
Provenance
Reference Policy
Interaction summary
  • SHALL support search-type, read.

Search Parameters
ConformanceParameterTypeDocumentation
MAY_idtoken

Resource.id

MAY_lastUpdateddate

Resource.meta.lastUpdated

MAY_hasstring

Return resources linked to by the given target

MAYidentifiertoken

MedicationStatement.identifier

MAYagentreference

Who participated

MAYtargetreference

Target References - usually version specific

MAYrecordeddate

When the activity was recorded / updated

MAYwhendate

Provenance.occurred as dateTime

MAYis-emp-chronologytoken

Provenance.extension:isEMPChronology

 

Operations

Use