Implementation Guide
ePA Medication Service
Version 1.2.0-ballot.2 - draft

## Resource Profile: eMP-Chronologieeintrag

Official URL: https://gematik.de/fhir/epa-medication/StructureDefinition/emp-chronology-provenance | Version: 1.2.0-ballot.2
Draft as of 2025-09-02 | Computable Name: EMPChronologyProvenance

Dieses Profil beschreibt die Verwendung der FHIR-Resource Provenance zur Abbildung eines eMP-Chronologieeintrags. Die Provenance-Instanz dokumentiert, welche eMP-Einträge (MedicationRequest-Instanzen) zu einem bestimmten Zeitpunkt als Teil des elektronischen Medikationsplans (eMP) gültig waren. Ein eMP-Chronologieeintrag wird immer dann erzeugt, wenn sich die eMP-relevanten Instanzen geändert haben oder neue eMP-Einträge hinzugekommen sind. Er referenziert sämtliche zum Erstellungszeitpunkt aktiven eMP-MedicationRequest-Instanzen, d.h. alle Ressourcen mit dem Status active oder on-hold. Dadurch wird der Zustand des Medikationsplans zu diesem Zeitpunkt nachvollziehbar. Der eMP-Chronologieeintrag ermöglicht somit eine eindeutige und versionssichere Rückverfolgung der Zusammensetzung des eMP über verschiedene Zeitpunkte hinweg.

Usages:

- Use this Profile: EPA Operation EMPEntry Output-Parameters and EPA Operation Link eMP Output Parameters
- Examples for this Profile: Provenance/0b383501-f078-464b-b984-9fdb6751601b, Provenance/2e112cb5-3b9f-4434-848e-26e27756cd30, Provenance/2e1ba746-1aef-4eef-b741-2dfc771c7001, Provenance/319fcc6e-049d-4eb1-9a5c-82c33438cf94 and Provenance/b467ce05-e0e5-4d71-9a0b-d824dbb492ef
- CapabilityStatements using this Profile: EPA Capability Statement für Clients des ePA Medication Service and EPA CapabilityStatement für den Medication Service

You can also check for usages in the FHIR IG Statistics

### Formal Views of Profile Content

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

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Provenance |  | 0..* | Provenance | Dieses Profil beschreibt einen eMP-Chronologieeintrag, der alle zum Erstellungszeitpunkt aktiven eMP-Einträge (active, on-hold) referenziert. Er entsteht bei Änderungen oder neuen Einträgen im eMP. Constraints: dom-2, dom-3, dom-4, dom-5, dom-6
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
Slices for extension |  | 1..* | Extension | Extension Slice: Unordered, Open by value:url
extension:isEMPChronology | S | 1..1 | (Complex) | Gibt an, ob diese Provenance-Instanz ein eMP-Chronologieeintrag ist. URL: https://gematik.de/fhir/epa-medication/StructureDefinition/is-emp-chronology-extension
extension |  | 0..0 |  |
url |  | 1..1 | uri | "https://gematik.de/fhir/epa-medication/StructureDefinition/is-emp-chronology-extension"
value[x] |  | 1..1 | boolean | Gibt an, ob diese Provenance-Instanz ein eMP-Chronologieeintrag ist. Required Pattern: true
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored Slice: Unordered, Open by value:url
target | S Σ C | 1..* | Reference(eMP-Eintrag) | Gibt die MedicationRequest-Instanzen an, die dem Profil EMPMedicationRequest entsprechen und im Rahmen der Änderung innerhalb des Medication Service erstellt oder aktualisiert wurden. Es muss eine versionierte Referenz (MedicationRequest/id/_history/vid) verwendet werden. Constraints: ref-1
reference | S Σ C | 0..1 | string | Literal reference, Relative, internal or absolute URL
occurred[x] | S | 0..1 | dateTime | Gibt den Zeitraum oder Zeitpunkt an, in dem die Änderung tatsächlich stattgefunden hat - also wann die Aktion inhaltlich durchgeführt wurde, z.B. das Erfassen oder Bearbeiten von Daten.
recorded | S Σ | 1..1 | instant | Gibt den technischen Zeitpunkt an, zu dem dieser eMP-Chronologieeintrag im Medication Service erstellt und persistiert wurde.
activity | S | 1..1 | CodeableConcept | Beschreibt die Art der Aktivität, die zur Erstellung des eMP-Chronologieeintrags im FHIR Data Service der ePA geführt hat. Verwendet wird UPDATE, da der Chronologieeintrag eine neue Zusammenstellung des aktuellen Stands der relevanten eMP-Instanzen darstellt. Binding: ProvenanceActivityType (extensible): The activity that took place. Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/v3-DataOperation
version |  | 0..1 | string | Version of the system - if relevant
code |  | 1..1 | code | Symbol in syntax defined by the system Fixed Value: UPDATE
display |  | 0..1 | string | Representation defined by the system
userSelected |  | 0..1 | boolean | If this coding was chosen directly by the user
text |  | 0..1 | string | Plain text representation of the concept
agent | S | 1..* | BackboneElement | Beschreibt die Art der Aktivität, die zur Erstellung des eMP-Chronologieeintrags geführt hat. Verwendet wird UPDATE, da der Chronologieeintrag den aktuellen Stand der eMP-relevanten Instanzen zusammenfasst, nachdem sich diese geändert haben oder neue Instanzen hinzugekommen sind.
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
type | S Σ | 1..1 | CodeableConcept | Gibt die Rolle oder Funktion an, die der Agent im Rahmen der dokumentierten Änderung eingenommen hat. Im Kontext dieses Profils ist ausschließlich die Rolle author zulässig, da jede Änderung im Medication Service fachlich verantwortet sein muss. Binding: EPA Provenance Participant Type ValueSet (required)
coding | S Σ | 1..1 | Coding | Code defined by a terminology system
system | S Σ | 1..1 | uri | Identity of the terminology system
code | S Σ | 1..1 | code | Symbol in syntax defined by the system
display | S Σ | 0..1 | string | Representation defined by the system
who | S Σ C | 1..1 | Reference(TI Organization | Organization in gematik Directory) | Who participated Constraints: ref-1
reference | S Σ C | 0..1 | string | Literal reference, Relative, internal or absolute URL
identifier | S Σ | 0..1 | IdentifierKvid10(1.5.4), IdentifierTelematikId(1.5.4), IdentifierEPAFHIRDataService | Logical reference, when literal reference is not known
display | S Σ | 0..1 | string | Text alternative for the resource
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet / Code | URI
Provenance.activity | extensible | Pattern Value: UPDATE `http://hl7.org/fhir/ValueSet/provenance-activity-type` From the FHIR Standard
Provenance.agent.type | required | EPAProvenanceParticipantTypeVS `https://gematik.de/fhir/epa/ValueSet/epa-provenance-participant-type-vs`

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | Provenance | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | Provenance | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() |
dom-4 | error | Provenance | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() |
dom-5 | error | Provenance | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | Provenance | A resource should have narrative for robust management : text.`div`.exists() |
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() |
ref-1 | error | Provenance.target, Provenance.agent.who | SHALL have a contained resource if a local reference is provided : reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids')) |

This structure is derived from Provenance

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Provenance |  | 0..* | Provenance | Dieses Profil beschreibt einen eMP-Chronologieeintrag, der alle zum Erstellungszeitpunkt aktiven eMP-Einträge (active, on-hold) referenziert. Er entsteht bei Änderungen oder neuen Einträgen im eMP.
extension |  | 1..* | Extension | Extension
Slices for extension |  |  |  | Content/Rules for all slices
extension:isEMPChronology | S | 1..1 | (Complex) | Gibt an, ob diese Provenance-Instanz ein eMP-Chronologieeintrag ist. URL: https://gematik.de/fhir/epa-medication/StructureDefinition/is-emp-chronology-extension
value[x] |  | 1..1 | boolean | Gibt an, ob diese Provenance-Instanz ein eMP-Chronologieeintrag ist. Required Pattern: true
target | S | 1..* | Reference(eMP-Eintrag) | Gibt die MedicationRequest-Instanzen an, die dem Profil EMPMedicationRequest entsprechen und im Rahmen der Änderung innerhalb des Medication Service erstellt oder aktualisiert wurden. Es muss eine versionierte Referenz (MedicationRequest/id/_history/vid) verwendet werden.
reference | S | 0..1 | string | Literal reference, Relative, internal or absolute URL
occurred[x] | S | 0..1 | dateTime | Gibt den Zeitraum oder Zeitpunkt an, in dem die Änderung tatsächlich stattgefunden hat - also wann die Aktion inhaltlich durchgeführt wurde, z.B. das Erfassen oder Bearbeiten von Daten.
recorded | S | 1..1 | instant | Gibt den technischen Zeitpunkt an, zu dem dieser eMP-Chronologieeintrag im Medication Service erstellt und persistiert wurde.
activity | S | 1..1 | CodeableConcept | Beschreibt die Art der Aktivität, die zur Erstellung des eMP-Chronologieeintrags im FHIR Data Service der ePA geführt hat. Verwendet wird UPDATE, da der Chronologieeintrag eine neue Zusammenstellung des aktuellen Stands der relevanten eMP-Instanzen darstellt. Required Pattern: At least the following
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/v3-DataOperation
code |  | 1..1 | code | Symbol in syntax defined by the system Fixed Value: UPDATE
agent | S | 1..* | BackboneElement | Beschreibt die Art der Aktivität, die zur Erstellung des eMP-Chronologieeintrags geführt hat. Verwendet wird UPDATE, da der Chronologieeintrag den aktuellen Stand der eMP-relevanten Instanzen zusammenfasst, nachdem sich diese geändert haben oder neue Instanzen hinzugekommen sind.
type | S | 1..1 | CodeableConcept | Gibt die Rolle oder Funktion an, die der Agent im Rahmen der dokumentierten Änderung eingenommen hat. Im Kontext dieses Profils ist ausschließlich die Rolle author zulässig, da jede Änderung im Medication Service fachlich verantwortet sein muss. Binding: EPA Provenance Participant Type ValueSet (required)
coding | S | 1..1 | Coding | Code defined by a terminology system
system | S | 1..1 | uri | Identity of the terminology system
code | S | 1..1 | code | Symbol in syntax defined by the system
display | S | 0..1 | string | Representation defined by the system
who | S | 1..1 | Reference(TI Organization | Organization in gematik Directory) | Who participated
reference | S | 0..1 | string | Literal reference, Relative, internal or absolute URL
identifier | S | 0..1 | IdentifierKvid10(1.5.4), IdentifierTelematikId(1.5.4), IdentifierEPAFHIRDataService | Logical reference, when literal reference is not known
display | S | 0..1 | string | Text alternative for the resource
Documentation for this format

#### Terminology Bindings (Differential)

Path | Conformance | ValueSet | URI
Provenance.agent.type | required | EPAProvenanceParticipantTypeVS `https://gematik.de/fhir/epa/ValueSet/epa-provenance-participant-type-vs`

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Provenance |  | 0..* | Provenance | Dieses Profil beschreibt einen eMP-Chronologieeintrag, der alle zum Erstellungszeitpunkt aktiven eMP-Einträge (active, on-hold) referenziert. Er entsteht bei Änderungen oder neuen Einträgen im eMP. Constraints: dom-2, dom-3, dom-4, dom-5, dom-6
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
Slices for extension |  | 1..* | Extension | Extension Slice: Unordered, Open by value:url
extension:isEMPChronology | S | 1..1 | (Complex) | Gibt an, ob diese Provenance-Instanz ein eMP-Chronologieeintrag ist. URL: https://gematik.de/fhir/epa-medication/StructureDefinition/is-emp-chronology-extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  |
url |  | 1..1 | uri | "https://gematik.de/fhir/epa-medication/StructureDefinition/is-emp-chronology-extension"
value[x] |  | 1..1 | boolean | Gibt an, ob diese Provenance-Instanz ein eMP-Chronologieeintrag ist. Required Pattern: true
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored Slice: Unordered, Open by value:url
target | S Σ C | 1..* | Reference(eMP-Eintrag) | Gibt die MedicationRequest-Instanzen an, die dem Profil EMPMedicationRequest entsprechen und im Rahmen der Änderung innerhalb des Medication Service erstellt oder aktualisiert wurden. Es muss eine versionierte Referenz (MedicationRequest/id/_history/vid) verwendet werden. Constraints: ref-1
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
reference | S Σ C | 0..1 | string | Literal reference, Relative, internal or absolute URL
type | Σ | 0..1 | uri | Type the reference refers to (e.g. "Patient") Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
identifier | Σ | 0..1 | Identifier | Logical reference, when literal reference is not known
display | Σ | 0..1 | string | Text alternative for the resource
occurred[x] | S | 0..1 | dateTime | Gibt den Zeitraum oder Zeitpunkt an, in dem die Änderung tatsächlich stattgefunden hat - also wann die Aktion inhaltlich durchgeführt wurde, z.B. das Erfassen oder Bearbeiten von Daten.
recorded | S Σ | 1..1 | instant | Gibt den technischen Zeitpunkt an, zu dem dieser eMP-Chronologieeintrag im Medication Service erstellt und persistiert wurde.
policy |  | 0..* | uri | Policy or plan the activity was defined by
location | C | 0..1 | Reference(Location) | Where the activity occurred, if relevant Constraints: ref-1
reason |  | 0..* | CodeableConcept | Reason the activity is occurring Binding: PurposeOfUse (extensible): The reason the activity took place.
activity | S | 1..1 | CodeableConcept | Beschreibt die Art der Aktivität, die zur Erstellung des eMP-Chronologieeintrags im FHIR Data Service der ePA geführt hat. Verwendet wird UPDATE, da der Chronologieeintrag eine neue Zusammenstellung des aktuellen Stands der relevanten eMP-Instanzen darstellt. Binding: ProvenanceActivityType (extensible): The activity that took place. Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/v3-DataOperation
version |  | 0..1 | string | Version of the system - if relevant
code |  | 1..1 | code | Symbol in syntax defined by the system Fixed Value: UPDATE
display |  | 0..1 | string | Representation defined by the system
userSelected |  | 0..1 | boolean | If this coding was chosen directly by the user
text |  | 0..1 | string | Plain text representation of the concept
agent | S | 1..* | BackboneElement | Beschreibt die Art der Aktivität, die zur Erstellung des eMP-Chronologieeintrags geführt hat. Verwendet wird UPDATE, da der Chronologieeintrag den aktuellen Stand der eMP-relevanten Instanzen zusammenfasst, nachdem sich diese geändert haben oder neue Instanzen hinzugekommen sind.
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
type | S Σ | 1..1 | CodeableConcept | Gibt die Rolle oder Funktion an, die der Agent im Rahmen der dokumentierten Änderung eingenommen hat. Im Kontext dieses Profils ist ausschließlich die Rolle author zulässig, da jede Änderung im Medication Service fachlich verantwortet sein muss. Binding: EPA Provenance Participant Type 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
coding | S Σ | 1..1 | Coding | Code defined by a terminology system
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 | S Σ | 1..1 | uri | Identity of the terminology system
version | Σ | 0..1 | string | Version of the system - if relevant
code | S Σ | 1..1 | code | Symbol in syntax defined by the system
display | S Σ | 0..1 | string | Representation defined by the system
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user
text | Σ | 0..1 | string | Plain text representation of the concept
role |  | 0..* | CodeableConcept | What the agents role was Binding: SecurityRoleType (example): The role that a provenance agent played with respect to the activity.
who | S Σ C | 1..1 | Reference(TI Organization | Organization in gematik Directory) | Who participated Constraints: ref-1
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
reference | S Σ C | 0..1 | string | Literal reference, Relative, internal or absolute URL
type | Σ | 0..1 | uri | Type the reference refers to (e.g. "Patient") Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
identifier | S Σ | 0..1 | IdentifierKvid10(1.5.4), IdentifierTelematikId(1.5.4), IdentifierEPAFHIRDataService | Logical reference, when literal reference is not known
display | S Σ | 0..1 | string | Text alternative for the resource
onBehalfOf | C | 0..1 | Reference(Practitioner | PractitionerRole | RelatedPerson | Patient | Device | Organization) | Who the agent is representing Constraints: ref-1
entity |  | 0..* | BackboneElement | An entity used in this activity
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
role | Σ | 1..1 | code | derivation | revision | quotation | source | removal Binding: ProvenanceEntityRole (required): How an entity was used in an activity.
what | Σ C | 1..1 | Reference(Resource) | Identity of entity Constraints: ref-1
agent |  | 0..* | See agent (Provenance) | Entity is attributed to this agent
signature |  | 0..* | Signature | Signature on target
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet / Code | URI
Provenance.language | preferred | CommonLanguages `http://hl7.org/fhir/ValueSet/languages` From the FHIR Standard
Additional Bindings | Purpose
AllLanguages | Max Binding
Provenance.target.type | extensible | ResourceType `http://hl7.org/fhir/ValueSet/resource-types` From the FHIR Standard
Provenance.reason | extensible | PurposeOfUse `http://terminology.hl7.org/ValueSet/v3-PurposeOfUse`
Provenance.activity | extensible | Pattern Value: UPDATE `http://hl7.org/fhir/ValueSet/provenance-activity-type` From the FHIR Standard
Provenance.agent.type | required | EPAProvenanceParticipantTypeVS `https://gematik.de/fhir/epa/ValueSet/epa-provenance-participant-type-vs`
Provenance.agent.role | example | SecurityRoleType `http://hl7.org/fhir/ValueSet/security-role-type` From the FHIR Standard
Provenance.agent.who.type | extensible | ResourceType `http://hl7.org/fhir/ValueSet/resource-types` From the FHIR Standard
Provenance.entity.role | required | ProvenanceEntityRole `http://hl7.org/fhir/ValueSet/provenance-entity-role|4.0.1` From the FHIR Standard

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | Provenance | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | Provenance | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() |
dom-4 | error | Provenance | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() |
dom-5 | error | Provenance | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | Provenance | A resource should have narrative for robust management : text.`div`.exists() |
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() |
ref-1 | error | Provenance.target, Provenance.location, Provenance.agent.who, Provenance.agent.onBehalfOf, Provenance.entity.what | SHALL have a contained resource if a local reference is provided : reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids')) |

This structure is derived from Provenance

Summary

Mandatory: 7 elements
Must-Support: 16 elements

Structures

This structure refers to these other structures:

- eMP-Eintrag (https://gematik.de/fhir/epa-medication/StructureDefinition/emp-medication-request)
- TI Organization (https://gematik.de/fhir/ti/StructureDefinition/ti-organization)
- Organization in gematik Directory (https://gematik.de/fhir/directory/StructureDefinition/OrganizationDirectory)
- Identifier-Profil für die 10-stellige Krankenversichertennummer (http://fhir.de/StructureDefinition/identifier-kvid-10)
- Identifier-Profil für die Telematik-ID (http://fhir.de/StructureDefinition/identifier-telematik-id)
- Identifikator Profil für ein FHIR Data Service der ePA (https://gematik.de/fhir/epa/StructureDefinition/identifier-epa-fhir-data-service)

Extensions

This structure refers to these extensions:

- https://gematik.de/fhir/epa-medication/StructureDefinition/is-emp-chronology-extension

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Provenance |  | 0..* | Provenance | Dieses Profil beschreibt einen eMP-Chronologieeintrag, der alle zum Erstellungszeitpunkt aktiven eMP-Einträge (active, on-hold) referenziert. Er entsteht bei Änderungen oder neuen Einträgen im eMP. Constraints: dom-2, dom-3, dom-4, dom-5, dom-6
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
Slices for extension |  | 1..* | Extension | Extension Slice: Unordered, Open by value:url
extension:isEMPChronology | S | 1..1 | (Complex) | Gibt an, ob diese Provenance-Instanz ein eMP-Chronologieeintrag ist. URL: https://gematik.de/fhir/epa-medication/StructureDefinition/is-emp-chronology-extension
extension |  | 0..0 |  |
url |  | 1..1 | uri | "https://gematik.de/fhir/epa-medication/StructureDefinition/is-emp-chronology-extension"
value[x] |  | 1..1 | boolean | Gibt an, ob diese Provenance-Instanz ein eMP-Chronologieeintrag ist. Required Pattern: true
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored Slice: Unordered, Open by value:url
target | S Σ C | 1..* | Reference(eMP-Eintrag) | Gibt die MedicationRequest-Instanzen an, die dem Profil EMPMedicationRequest entsprechen und im Rahmen der Änderung innerhalb des Medication Service erstellt oder aktualisiert wurden. Es muss eine versionierte Referenz (MedicationRequest/id/_history/vid) verwendet werden. Constraints: ref-1
reference | S Σ C | 0..1 | string | Literal reference, Relative, internal or absolute URL
occurred[x] | S | 0..1 | dateTime | Gibt den Zeitraum oder Zeitpunkt an, in dem die Änderung tatsächlich stattgefunden hat - also wann die Aktion inhaltlich durchgeführt wurde, z.B. das Erfassen oder Bearbeiten von Daten.
recorded | S Σ | 1..1 | instant | Gibt den technischen Zeitpunkt an, zu dem dieser eMP-Chronologieeintrag im Medication Service erstellt und persistiert wurde.
activity | S | 1..1 | CodeableConcept | Beschreibt die Art der Aktivität, die zur Erstellung des eMP-Chronologieeintrags im FHIR Data Service der ePA geführt hat. Verwendet wird UPDATE, da der Chronologieeintrag eine neue Zusammenstellung des aktuellen Stands der relevanten eMP-Instanzen darstellt. Binding: ProvenanceActivityType (extensible): The activity that took place. Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/v3-DataOperation
version |  | 0..1 | string | Version of the system - if relevant
code |  | 1..1 | code | Symbol in syntax defined by the system Fixed Value: UPDATE
display |  | 0..1 | string | Representation defined by the system
userSelected |  | 0..1 | boolean | If this coding was chosen directly by the user
text |  | 0..1 | string | Plain text representation of the concept
agent | S | 1..* | BackboneElement | Beschreibt die Art der Aktivität, die zur Erstellung des eMP-Chronologieeintrags geführt hat. Verwendet wird UPDATE, da der Chronologieeintrag den aktuellen Stand der eMP-relevanten Instanzen zusammenfasst, nachdem sich diese geändert haben oder neue Instanzen hinzugekommen sind.
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
type | S Σ | 1..1 | CodeableConcept | Gibt die Rolle oder Funktion an, die der Agent im Rahmen der dokumentierten Änderung eingenommen hat. Im Kontext dieses Profils ist ausschließlich die Rolle author zulässig, da jede Änderung im Medication Service fachlich verantwortet sein muss. Binding: EPA Provenance Participant Type ValueSet (required)
coding | S Σ | 1..1 | Coding | Code defined by a terminology system
system | S Σ | 1..1 | uri | Identity of the terminology system
code | S Σ | 1..1 | code | Symbol in syntax defined by the system
display | S Σ | 0..1 | string | Representation defined by the system
who | S Σ C | 1..1 | Reference(TI Organization | Organization in gematik Directory) | Who participated Constraints: ref-1
reference | S Σ C | 0..1 | string | Literal reference, Relative, internal or absolute URL
identifier | S Σ | 0..1 | IdentifierKvid10(1.5.4), IdentifierTelematikId(1.5.4), IdentifierEPAFHIRDataService | Logical reference, when literal reference is not known
display | S Σ | 0..1 | string | Text alternative for the resource
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet / Code | URI
Provenance.activity | extensible | Pattern Value: UPDATE `http://hl7.org/fhir/ValueSet/provenance-activity-type` From the FHIR Standard
Provenance.agent.type | required | EPAProvenanceParticipantTypeVS `https://gematik.de/fhir/epa/ValueSet/epa-provenance-participant-type-vs`

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | Provenance | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | Provenance | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() |
dom-4 | error | Provenance | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() |
dom-5 | error | Provenance | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | Provenance | A resource should have narrative for robust management : text.`div`.exists() |
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() |
ref-1 | error | Provenance.target, Provenance.agent.who | SHALL have a contained resource if a local reference is provided : reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids')) |

Differential View

This structure is derived from Provenance

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Provenance |  | 0..* | Provenance | Dieses Profil beschreibt einen eMP-Chronologieeintrag, der alle zum Erstellungszeitpunkt aktiven eMP-Einträge (active, on-hold) referenziert. Er entsteht bei Änderungen oder neuen Einträgen im eMP.
extension |  | 1..* | Extension | Extension
Slices for extension |  |  |  | Content/Rules for all slices
extension:isEMPChronology | S | 1..1 | (Complex) | Gibt an, ob diese Provenance-Instanz ein eMP-Chronologieeintrag ist. URL: https://gematik.de/fhir/epa-medication/StructureDefinition/is-emp-chronology-extension
value[x] |  | 1..1 | boolean | Gibt an, ob diese Provenance-Instanz ein eMP-Chronologieeintrag ist. Required Pattern: true
target | S | 1..* | Reference(eMP-Eintrag) | Gibt die MedicationRequest-Instanzen an, die dem Profil EMPMedicationRequest entsprechen und im Rahmen der Änderung innerhalb des Medication Service erstellt oder aktualisiert wurden. Es muss eine versionierte Referenz (MedicationRequest/id/_history/vid) verwendet werden.
reference | S | 0..1 | string | Literal reference, Relative, internal or absolute URL
occurred[x] | S | 0..1 | dateTime | Gibt den Zeitraum oder Zeitpunkt an, in dem die Änderung tatsächlich stattgefunden hat - also wann die Aktion inhaltlich durchgeführt wurde, z.B. das Erfassen oder Bearbeiten von Daten.
recorded | S | 1..1 | instant | Gibt den technischen Zeitpunkt an, zu dem dieser eMP-Chronologieeintrag im Medication Service erstellt und persistiert wurde.
activity | S | 1..1 | CodeableConcept | Beschreibt die Art der Aktivität, die zur Erstellung des eMP-Chronologieeintrags im FHIR Data Service der ePA geführt hat. Verwendet wird UPDATE, da der Chronologieeintrag eine neue Zusammenstellung des aktuellen Stands der relevanten eMP-Instanzen darstellt. Required Pattern: At least the following
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/v3-DataOperation
code |  | 1..1 | code | Symbol in syntax defined by the system Fixed Value: UPDATE
agent | S | 1..* | BackboneElement | Beschreibt die Art der Aktivität, die zur Erstellung des eMP-Chronologieeintrags geführt hat. Verwendet wird UPDATE, da der Chronologieeintrag den aktuellen Stand der eMP-relevanten Instanzen zusammenfasst, nachdem sich diese geändert haben oder neue Instanzen hinzugekommen sind.
type | S | 1..1 | CodeableConcept | Gibt die Rolle oder Funktion an, die der Agent im Rahmen der dokumentierten Änderung eingenommen hat. Im Kontext dieses Profils ist ausschließlich die Rolle author zulässig, da jede Änderung im Medication Service fachlich verantwortet sein muss. Binding: EPA Provenance Participant Type ValueSet (required)
coding | S | 1..1 | Coding | Code defined by a terminology system
system | S | 1..1 | uri | Identity of the terminology system
code | S | 1..1 | code | Symbol in syntax defined by the system
display | S | 0..1 | string | Representation defined by the system
who | S | 1..1 | Reference(TI Organization | Organization in gematik Directory) | Who participated
reference | S | 0..1 | string | Literal reference, Relative, internal or absolute URL
identifier | S | 0..1 | IdentifierKvid10(1.5.4), IdentifierTelematikId(1.5.4), IdentifierEPAFHIRDataService | Logical reference, when literal reference is not known
display | S | 0..1 | string | Text alternative for the resource
Documentation for this format

#### Terminology Bindings (Differential)

Path | Conformance | ValueSet | URI
Provenance.agent.type | required | EPAProvenanceParticipantTypeVS `https://gematik.de/fhir/epa/ValueSet/epa-provenance-participant-type-vs`

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Provenance |  | 0..* | Provenance | Dieses Profil beschreibt einen eMP-Chronologieeintrag, der alle zum Erstellungszeitpunkt aktiven eMP-Einträge (active, on-hold) referenziert. Er entsteht bei Änderungen oder neuen Einträgen im eMP. Constraints: dom-2, dom-3, dom-4, dom-5, dom-6
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
Slices for extension |  | 1..* | Extension | Extension Slice: Unordered, Open by value:url
extension:isEMPChronology | S | 1..1 | (Complex) | Gibt an, ob diese Provenance-Instanz ein eMP-Chronologieeintrag ist. URL: https://gematik.de/fhir/epa-medication/StructureDefinition/is-emp-chronology-extension
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..0 |  |
url |  | 1..1 | uri | "https://gematik.de/fhir/epa-medication/StructureDefinition/is-emp-chronology-extension"
value[x] |  | 1..1 | boolean | Gibt an, ob diese Provenance-Instanz ein eMP-Chronologieeintrag ist. Required Pattern: true
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored Slice: Unordered, Open by value:url
target | S Σ C | 1..* | Reference(eMP-Eintrag) | Gibt die MedicationRequest-Instanzen an, die dem Profil EMPMedicationRequest entsprechen und im Rahmen der Änderung innerhalb des Medication Service erstellt oder aktualisiert wurden. Es muss eine versionierte Referenz (MedicationRequest/id/_history/vid) verwendet werden. Constraints: ref-1
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
reference | S Σ C | 0..1 | string | Literal reference, Relative, internal or absolute URL
type | Σ | 0..1 | uri | Type the reference refers to (e.g. "Patient") Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
identifier | Σ | 0..1 | Identifier | Logical reference, when literal reference is not known
display | Σ | 0..1 | string | Text alternative for the resource
occurred[x] | S | 0..1 | dateTime | Gibt den Zeitraum oder Zeitpunkt an, in dem die Änderung tatsächlich stattgefunden hat - also wann die Aktion inhaltlich durchgeführt wurde, z.B. das Erfassen oder Bearbeiten von Daten.
recorded | S Σ | 1..1 | instant | Gibt den technischen Zeitpunkt an, zu dem dieser eMP-Chronologieeintrag im Medication Service erstellt und persistiert wurde.
policy |  | 0..* | uri | Policy or plan the activity was defined by
location | C | 0..1 | Reference(Location) | Where the activity occurred, if relevant Constraints: ref-1
reason |  | 0..* | CodeableConcept | Reason the activity is occurring Binding: PurposeOfUse (extensible): The reason the activity took place.
activity | S | 1..1 | CodeableConcept | Beschreibt die Art der Aktivität, die zur Erstellung des eMP-Chronologieeintrags im FHIR Data Service der ePA geführt hat. Verwendet wird UPDATE, da der Chronologieeintrag eine neue Zusammenstellung des aktuellen Stands der relevanten eMP-Instanzen darstellt. Binding: ProvenanceActivityType (extensible): The activity that took place. Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://terminology.hl7.org/CodeSystem/v3-DataOperation
version |  | 0..1 | string | Version of the system - if relevant
code |  | 1..1 | code | Symbol in syntax defined by the system Fixed Value: UPDATE
display |  | 0..1 | string | Representation defined by the system
userSelected |  | 0..1 | boolean | If this coding was chosen directly by the user
text |  | 0..1 | string | Plain text representation of the concept
agent | S | 1..* | BackboneElement | Beschreibt die Art der Aktivität, die zur Erstellung des eMP-Chronologieeintrags geführt hat. Verwendet wird UPDATE, da der Chronologieeintrag den aktuellen Stand der eMP-relevanten Instanzen zusammenfasst, nachdem sich diese geändert haben oder neue Instanzen hinzugekommen sind.
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
type | S Σ | 1..1 | CodeableConcept | Gibt die Rolle oder Funktion an, die der Agent im Rahmen der dokumentierten Änderung eingenommen hat. Im Kontext dieses Profils ist ausschließlich die Rolle author zulässig, da jede Änderung im Medication Service fachlich verantwortet sein muss. Binding: EPA Provenance Participant Type 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
coding | S Σ | 1..1 | Coding | Code defined by a terminology system
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 | S Σ | 1..1 | uri | Identity of the terminology system
version | Σ | 0..1 | string | Version of the system - if relevant
code | S Σ | 1..1 | code | Symbol in syntax defined by the system
display | S Σ | 0..1 | string | Representation defined by the system
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user
text | Σ | 0..1 | string | Plain text representation of the concept
role |  | 0..* | CodeableConcept | What the agents role was Binding: SecurityRoleType (example): The role that a provenance agent played with respect to the activity.
who | S Σ C | 1..1 | Reference(TI Organization | Organization in gematik Directory) | Who participated Constraints: ref-1
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
reference | S Σ C | 0..1 | string | Literal reference, Relative, internal or absolute URL
type | Σ | 0..1 | uri | Type the reference refers to (e.g. "Patient") Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
identifier | S Σ | 0..1 | IdentifierKvid10(1.5.4), IdentifierTelematikId(1.5.4), IdentifierEPAFHIRDataService | Logical reference, when literal reference is not known
display | S Σ | 0..1 | string | Text alternative for the resource
onBehalfOf | C | 0..1 | Reference(Practitioner | PractitionerRole | RelatedPerson | Patient | Device | Organization) | Who the agent is representing Constraints: ref-1
entity |  | 0..* | BackboneElement | An entity used in this activity
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
role | Σ | 1..1 | code | derivation | revision | quotation | source | removal Binding: ProvenanceEntityRole (required): How an entity was used in an activity.
what | Σ C | 1..1 | Reference(Resource) | Identity of entity Constraints: ref-1
agent |  | 0..* | See agent (Provenance) | Entity is attributed to this agent
signature |  | 0..* | Signature | Signature on target
Documentation for this format

#### Terminology Bindings

Path | Conformance | ValueSet / Code | URI
Provenance.language | preferred | CommonLanguages `http://hl7.org/fhir/ValueSet/languages` From the FHIR Standard
Additional Bindings | Purpose
AllLanguages | Max Binding
Provenance.target.type | extensible | ResourceType `http://hl7.org/fhir/ValueSet/resource-types` From the FHIR Standard
Provenance.reason | extensible | PurposeOfUse `http://terminology.hl7.org/ValueSet/v3-PurposeOfUse`
Provenance.activity | extensible | Pattern Value: UPDATE `http://hl7.org/fhir/ValueSet/provenance-activity-type` From the FHIR Standard
Provenance.agent.type | required | EPAProvenanceParticipantTypeVS `https://gematik.de/fhir/epa/ValueSet/epa-provenance-participant-type-vs`
Provenance.agent.role | example | SecurityRoleType `http://hl7.org/fhir/ValueSet/security-role-type` From the FHIR Standard
Provenance.agent.who.type | extensible | ResourceType `http://hl7.org/fhir/ValueSet/resource-types` From the FHIR Standard
Provenance.entity.role | required | ProvenanceEntityRole `http://hl7.org/fhir/ValueSet/provenance-entity-role|4.0.1` From the FHIR Standard

#### Constraints

Id | Grade | Path(s) | Details | Requirements
dom-2 | error | Provenance | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() |
dom-3 | error | Provenance | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() |
dom-4 | error | Provenance | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() |
dom-5 | error | Provenance | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() |
dom-6 | best practice | Provenance | A resource should have narrative for robust management : text.`div`.exists() |
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() |
ref-1 | error | Provenance.target, Provenance.location, Provenance.agent.who, Provenance.agent.onBehalfOf, Provenance.entity.what | SHALL have a contained resource if a local reference is provided : reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids')) |

This structure is derived from Provenance

Summary

Mandatory: 7 elements
Must-Support: 16 elements

Structures

This structure refers to these other structures:

- eMP-Eintrag (https://gematik.de/fhir/epa-medication/StructureDefinition/emp-medication-request)
- TI Organization (https://gematik.de/fhir/ti/StructureDefinition/ti-organization)
- Organization in gematik Directory (https://gematik.de/fhir/directory/StructureDefinition/OrganizationDirectory)
- Identifier-Profil für die 10-stellige Krankenversichertennummer (http://fhir.de/StructureDefinition/identifier-kvid-10)
- Identifier-Profil für die Telematik-ID (http://fhir.de/StructureDefinition/identifier-telematik-id)
- Identifikator Profil für ein FHIR Data Service der ePA (https://gematik.de/fhir/epa/StructureDefinition/identifier-epa-fhir-data-service)

Extensions

This structure refers to these extensions:

- https://gematik.de/fhir/epa-medication/StructureDefinition/is-emp-chronology-extension

Other representations of profile: CSV, Excel, Schematron