Implementation Guide
ePA Medication Service
Version 1.2.0 - release

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
Active as of 2025-09-12 Computable Name: EPAMedicationServiceClient

Copyright/Legal: gematik GmbH / Dieser Implementation Guide ist lizenziert unter Apache License, Version 2.0.

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
  • FHIR Version: 4.0.1
  • Supported Formats: application/fhir+json, application/fhir+xml
  • Published on: 2025-09-12
  • 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

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
MedicationSupported Profiles
  EPA Medication
  eMP Medication
  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
MedicationRequestSupported Profiles
  EPA MedicationRequest
  eMP MedicationRequest
YYYYY_id, _lastUpdated, _has, identifier, authoredon, intent, status, requester, medication, context, activity, effective-dose-periodMedicationRequest:medication, MedicationRequest:requester, MedicationRequest:activityMedicationDispense:prescription, MedicationStatement:derived-from
MedicationDispenseSupported Profiles
  EPA MedicationDispense
YYYYY_id, _lastUpdated, _has, identifier, whenhandedover, prescription, performer, status, medication, rx-prescriptionMedicationDispense:medication, MedicationDispense:performer, MedicationDispense:prescriptionMedicationStatement:derived-from
MedicationStatementSupported Profiles
  EPA MedicationStatement
YYYYY_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, $cancel-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 Activity Provenance
  eMP Chronology Provenance
YY_id, _lastUpdated, _has, identifier, agent, target, recorded, when, is-emp-chronologyProvenance:agent, Provenance:target

Core FHIR Resource
Medication
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

 
Core FHIR Resource
MedicationRequest
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

MAYintenttoken

MedicationRequest.intent

MAYstatustoken

MedicationRequest.status

MAYrequesterreference

MedicationRequest.requester

MAYmedicationreference

MedicationRequest.medication as Reference

MAYcontexttoken

MedicationRequest.extension:context

MAYactivityreference

MedicationRequest.extension:activity

MAYeffective-dose-perioddate

MedicationRequest.extension:effectiveDosePeriod

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

Supported Profiles

EPA MedicationDispense

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

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

Supported Profiles

EPA MedicationStatement

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$cancel-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