Implementation Guide
ePA Medication Service
Version 1.3.2 - release

## Extension: DrugCategoryExtension

Official URL: https://gematik.de/fhir/epa-medication/StructureDefinition/drug-category-extension | Version: 1.3.0
Active as of 2025-12-15 | Computable Name: DrugCategoryExtension
Copyright/Legal: gematik GmbH / Dieses Artefakt ist lizenziert unter Apache License, Version 2.0.

Extension for indicating the medication category.

Context of Use

This extension may be used on the following element(s):

- Element ID Element

Usage info

Usages:

- Use this Extension: EPA Pharmaceutical Product Medication, EPA Medication PZN Ingredient and EPA Medication
- Examples for this Extension: Bundle/example-epa-batch-emp-request-bundle, Bundle/example-epa-batch-emp-response-bundle, Bundle/example-get-medication-list-bundle1, Bundle/example-get-medication-plan-bundle-1... Show 25 more, Bundle/example-searchset-medication, Medication/1254591a-dd2d-4d17-b8f8-ee3155da0699, Medication/13c66845-d0ce-43e1-9b0b-884cbbe8df7f, Medication/1412aa4f-a9ed-45f2-8916-063fee7eb025, Medication/19549515-60a8-4e1c-b86a-49518053fe9f, Medication/312d581c-f5e7-4faa-9de5-c4e1568c6db2, Medication/3f0b0cb0-e8cf-4aaf-bad8-01a51619417b, Medication/56ca34f1-a3f3-42f7-95a2-f5a6423c2031, Medication/659c0be1-2ec8-4137-9698-dcffee811934, Medication/83d7ad1c-47d1-4524-829a-5b86ce333bbc, Medication/87f08ba2-da7e-467e-86aa-404d9035297c, Medication/CortisonDexpantenol, Medication/a2aa2baf-c37d-40e0-bff5-f6e8a58dc2c3, Medication/ab8addbd-c4c7-48d2-bf4b-4a7c99f9fd6e, Medication/bb91cde8-0426-4f4b-a766-5d818d0605bd, Medication/deecd514-235d-41df-a664-e3672208f410, Medication/fc7b28e8-05ac-4ac8-86d7-7677d9c6134e, Parameters/example-epa-op-add-emp-entry-input-parameters-1, Parameters/example-epa-op-emp-entry-output-parameters-1, Parameters/example-epa-op-emp-entry-output-parameters-2, Parameters/example-epa-op-provide-dispensation-erp-input-parameters-1, Parameters/example-epa-op-provide-dispensation-erp-input-parameters-2, Parameters/example-epa-op-provide-dispensation-erp-input-parameters-3, Parameters/example-epa-op-provide-prescription-erp-input-parameters-1 and Parameters/example-epa-op-provide-prescription-erp-input-parameters-2

You can also check for usages in the FHIR IG Statistics

### Formal Views of Extension Content

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

- Text Summary
- Differential Table
- Snapshot Table
- All

This structure is derived from Extension

Summary

Simple Extension with the type Coding: Extension for indicating the medication category.

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "https://gematik.de/fhir/epa-medication/StructureDefinition/drug-category-extension"
value[x] |  | 1..1 | Coding | Value of extension Binding: TI Drug Category ValueSet (required)
code |  | 0..1 | code | Category
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "https://gematik.de/fhir/epa-medication/StructureDefinition/drug-category-extension"
value[x] |  | 1..1 | Coding | Value of extension Binding: TI Drug Category ValueSet (required)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | Σ | 0..1 | uri | Identity of the terminology system
version | Σ | 0..1 | string | Version of the system - if relevant
code | Σ | 0..1 | code | Category
display | Σ | 0..1 | string | Representation defined by the system
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user
Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type Coding: Extension for indicating the medication category.

Differential View

This structure is derived from Extension

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Extension
extension |  | 0..0 |  | Extension
url |  | 1..1 | uri | "https://gematik.de/fhir/epa-medication/StructureDefinition/drug-category-extension"
value[x] |  | 1..1 | Coding | Value of extension Binding: TI Drug Category ValueSet (required)
code |  | 0..1 | code | Category
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Extension |  | 0..* | Extension | Extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  | Extension Slice: Unordered, Open by value:url
url |  | 1..1 | uri | "https://gematik.de/fhir/epa-medication/StructureDefinition/drug-category-extension"
value[x] |  | 1..1 | Coding | Value of extension Binding: TI Drug Category ValueSet (required)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | Σ | 0..1 | uri | Identity of the terminology system
version | Σ | 0..1 | string | Version of the system - if relevant
code | Σ | 0..1 | code | Category
display | Σ | 0..1 | string | Representation defined by the system
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user
Documentation for this format

Other representations of profile: CSV, Excel, Schematron

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Extension.value[x] | Base | required | TI Drug Category ValueSet | 📦1.0.9 | TI Terminology v1.0

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`