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

EPA CapabilityStatement für den Medication Service

EPA CapabilityStatement für den 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 Server

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

Resource.id

SHALL_lastUpdateddate

Resource.meta.lastUpdated

SHALL_hasstring

Return resources linked to by the given target

SHALLidentifiertoken

Medication.identifier

SHALLcodetoken

Medication.code

SHALLstatustoken

Medication.status

SHALLingredient-codetoken

Medication.ingredient.item as CodeableConcept

SHALLrx-prescriptiontoken

Medication.extension

SHALLcontexttoken

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
SHALL_idtoken

Resource.id

SHALL_lastUpdateddate

Resource.meta.lastUpdated

SHALL_hasstring

Return resources linked to by the given target

SHALLidentifiertoken

MedicationRequest.identifier

SHALLauthoredondate

MedicationRequest.authoredOn

SHALLstatustoken

MedicationRequest.status

SHALLrequesterreference

MedicationRequest.requester

SHALLmedicationreference

MedicationRequest.medication as Reference

SHALLcontexttoken

MedicationRequest.extension:context

SHALLactivityreference

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
SHALL_idtoken

Resource.id

SHALL_lastUpdateddate

Resource.meta.lastUpdated

SHALL_hasstring

Return resources linked to by the given target

SHALLidentifiertoken

MedicationDispense.identifier

SHALLwhenhandedoverdate

MedicationDispense.whenHandedOver

SHALLprescriptionreference

MedicationDispense.authorizingPrescription

SHALLperformerreference

MedicationDispense.performer.actor

SHALLstatustoken

MedicationDispense.status

SHALLmedicationreference

MedicationDispense.medication as Reference

SHALLrx-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
SHALL_idtoken

Resource.id

SHALL_lastUpdateddate

Resource.meta.lastUpdated

SHALL_hasstring

Return resources linked to by the given target

SHALLidentifiertoken

MedicationStatement.identifier

SHALLmedicationreference

MedicationStatement.medication as Reference

SHALLpart-ofreference

MedicationStatement.partOf as Reference

SHALLstatustoken

MedicationStatement.status

SHALLeffectivedate

MedicationStatement.effective

SHALLrx-prescriptiontoken

Medication.extension

SHALLderived-fromreference

MedicationStatement.derivedFrom as Reference

SHALLcontexttoken

MedicationStatement.extension:context

SHALLbased-on-empreference

MedicationStatement.basedOn mit Extension:is-emp = true

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

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Resource.id

SHALL_lastUpdateddate

Resource.meta.lastUpdated

SHALL_hasstring

Return resources linked to by the given target

SHALLidentifiertoken

Organization.identifier

SHALLnamestring

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
SHALL_idtoken

Resource.id

SHALL_lastUpdateddate

Resource.meta.lastUpdated

SHALL_hasstring

Return resources linked to by the given target

SHALLidentifiertoken

Practitioner.identifier

SHALLnamestring

Practitioner.name

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

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Resource.id

SHALL_lastUpdateddate

Resource.meta.lastUpdated

SHALL_hasstring

Return resources linked to by the given target

SHALLidentifiertoken

PractitionerRole.identifier

SHALLpractitionerreference

PractitionerRole.practitioner

SHALLorganizationreference

PractitionerRole.organization

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

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Resource.id

SHALL_lastUpdateddate

Resource.meta.lastUpdated

SHALL_hasstring

Return resources linked to by the given target

SHALLidentifiertoken

MedicationStatement.identifier

SHALLagentreference

Who participated

SHALLtargetreference

Target References - usually version specific

SHALLrecordeddate

When the activity was recorded / updated

SHALLwhendate

Provenance.occurred as dateTime

SHALLis-emp-chronologytoken

Provenance.extension:isEMPChronology

 

Operations

Use