EPA CapabilityStatement für den Medication Service - ePA Medication Service v1.1.5

Implementation Guide
ePA Medication Service

Version 1.1.5 - ballot

CapabilityStatement: EPA CapabilityStatement für den Medication Service

Official URL: https://gematik.de/fhir/epa-medication/CapabilityStatement/epa-medication-service-server				Version: 1.1.5
Draft as of 2025-03-31				Computable Name: EPAMedicationServiceServer

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

Implementation Guide Version: 1.1.5
FHIR Version: 4.0.1
Supported Formats: application/fhir+json, application/fhir+xml
Supported Patch Formats:
Published on: 2025-03-31
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	V-R	S	U	C	H-I	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	y			y	_id, _lastUpdated, _has, 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	y			y	_id, _lastUpdated, _has, identifier, authoredon, status, requester, medication	`MedicationRequest:medication`, `MedicationRequest:performer`	`MedicationDispense:prescription`
MedicationDispense	https://gematik.de/fhir/epa-medication/StructureDefinition/epa-medication-dispense	y	y	y			y	_id, _lastUpdated, _has, identifier, whenhandedover, prescription, performer, status, medication	`MedicationDispense:medication`, `MedicationDispense:performer`, `MedicationDispense:prescription`
Organization	Supported Profiles Organization in gematik Directory	y	y	y			y	_id, _lastUpdated, _has, identifier, name		`MedicationDispense:perfomer`, `PractitionerRole:organization`, `MedicationRequest:requester`
Practitioner	Supported Profiles Practitioner in gematik Directory	y	y	y			y	_id, _lastUpdated, _has, identifier, name		`MedicationDispense:perfomer`, `PractitionerRole:practitioner`, `MedicationRequest:requester`
PractitionerRole		y	y	y			y	_id, _lastUpdated, _has, 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, vread, history-instance, search-type.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	_id	`token`	Resource.id
SHALL	_lastUpdated	`date`	Resource.meta.lastUpdated
SHALL	_has	`string`	Return resources linked to by the given target
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, vread, history-instance, search-type.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	_id	`token`	Resource.id
SHALL	_lastUpdated	`date`	Resource.meta.lastUpdated
SHALL	_has	`string`	Return resources linked to by the given target
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, vread, history-instance, search-type.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	_id	`token`	Resource.id
SHALL	_lastUpdated	`date`	Resource.meta.lastUpdated
SHALL	_has	`string`	Return resources linked to by the given target
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, vread, history-instance, 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	_has	`string`	Return resources linked to by the given target
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, vread, history-instance, 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	_has	`string`	Return resources linked to by the given target
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, vread, history-instance, search-type.

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	_id	`token`	Resource.id
SHALL	_lastUpdated	`date`	Resource.meta.lastUpdated
SHALL	_has	`string`	Return resources linked to by the given target
SHALL	identifier	`token`	PractitionerRole.identifier
SHALL	practitioner	`reference`	PractitionerRole.practitioner
SHALL	organization	`reference`	PractitionerRole.organization

Operations

Use