# EPA Activity Provenance - Implementation Guide ePA Basisfunktionalitäten v1.3.2

Implementation Guide

ePA Basisfunktionalitäten

Version 1.3.2 - release 

* [**Table of Contents**](toc.md)
* [**FHIR-Artefakte**](artifacts.md)
* **EPA Activity Provenance**

## Resource Profile: EPA Activity Provenance 

| | |
| :--- | :--- |
| *Official URL*:https://gematik.de/fhir/epa/StructureDefinition/epa-activity-provenance | *Version*:1.3.0 |
| Active as of 2025-09-12 | *Computable Name*:EPAActivityProvenance |
| **Copyright/Legal**: gematik GmbH / Dieses Artefakt ist lizenziert unter [Apache License](./license.md), Version 2.0. | |

 
Dieses Profil beschreibt die Verwendung der FHIR-Resource Provenance zur Dokumentation von Änderungen und Aktivitäten im Rahmen ePA FHIR Data Services. Es ermöglicht die strukturierte Nachverfolgung, wer zu welchem Zeitpunkt welche Ressourcen erstellt oder verändert hat. Der ePA Änderungseintrag dient damit als technischer und fachlicher Nachweis über den Ursprung und die Verantwortlichkeit von Einträgen in der ePA. 

**Usages:**

* Examples for this Profile: [Provenance/c7b6dcfc-d535-4f8f-9d86-841693f788d1](Provenance-c7b6dcfc-d535-4f8f-9d86-841693f788d1.md) and [Provenance/fdfc2842-bfff-436f-ab13-74785d0188c0](Provenance-fdfc2842-bfff-436f-ab13-74785d0188c0.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/resource/de.gematik.epa|current/StructureDefinition/StructureDefinition-epa-activity-provenance.json)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-epa-activity-provenance.csv), [Excel](StructureDefinition-epa-activity-provenance.xlsx), [Schematron](StructureDefinition-epa-activity-provenance.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "epa-activity-provenance",
  "url" : "https://gematik.de/fhir/epa/StructureDefinition/epa-activity-provenance",
  "version" : "1.3.0",
  "name" : "EPAActivityProvenance",
  "title" : "EPA Activity Provenance",
  "status" : "active",
  "experimental" : false,
  "date" : "2025-09-12",
  "publisher" : "gematik GmbH",
  "contact" : [{
    "name" : "gematik GmbH",
    "telecom" : [{
      "system" : "url",
      "value" : "https://www.gematik.de"
    },
    {
      "system" : "email",
      "value" : "patientteam [ at ] gematik.de"
    }]
  }],
  "description" : "Dieses Profil beschreibt die Verwendung der FHIR-Resource Provenance zur Dokumentation von Änderungen und Aktivitäten im Rahmen ePA FHIR Data Services. Es ermöglicht die strukturierte Nachverfolgung, wer zu welchem Zeitpunkt welche Ressourcen erstellt oder verändert hat.\nDer ePA Änderungseintrag dient damit als technischer und fachlicher Nachweis über den Ursprung und die Verantwortlichkeit von Einträgen in der ePA.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "DE"
    }]
  }],
  "copyright" : "gematik GmbH / Dieses Artefakt ist lizenziert unter [Apache License](./license.html), Version 2.0.",
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "workflow",
    "uri" : "http://hl7.org/fhir/workflow",
    "name" : "Workflow Pattern"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "w3c.prov",
    "uri" : "http://www.w3.org/ns/prov",
    "name" : "W3C PROV"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "fhirauditevent",
    "uri" : "http://hl7.org/fhir/auditevent",
    "name" : "FHIR AuditEvent Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Provenance",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Provenance",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Provenance",
      "path" : "Provenance",
      "short" : "Dieses Profil beschreibt die Verwendung der FHIR-Resource Provenance zur Dokumentation von Änderungen und Aktivitäten im Rahmen der ePA FHIR Data Services."
    },
    {
      "id" : "Provenance.target",
      "path" : "Provenance.target",
      "short" : "Gibt die Ressource(n) an, die im Rahmen der Änderung innerhalb der ePA erstellt oder aktualisiert wurden. Es muss eine versionierte Referenz (ResourceType/id/_history/vid) verwendet werden.",
      "definition" : "Gibt die Ressource(n) an, die im Rahmen der Änderung innerhalb der ePA erstellt oder aktualisiert wurden.\nEs muss eine versionierte Referenz (ResourceType/id/_history/vid) verwendet werden, um eindeutig die durch diese Änderung entstandene Version der betroffenen Ressource anzugeben.\nDadurch wird eine eindeutige, nachvollziehbare Zuordnung zwischen einer fachlichen Änderung und dem resultierenden Ressourcenzustand gewährleistet.",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.target.reference",
      "path" : "Provenance.target.reference",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.target.display",
      "path" : "Provenance.target.display",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.occurred[x]",
      "path" : "Provenance.occurred[x]",
      "short" : "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.",
      "type" : [{
        "code" : "dateTime"
      }],
      "mustSupport" : true
    },
    {
      "id" : "Provenance.recorded",
      "path" : "Provenance.recorded",
      "short" : "Gibt den technischen Zeitpunkt an, zu dem dieser Provenance-Eintrag im FHIR Data Service erstellt und persistiert wurde.",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.activity",
      "path" : "Provenance.activity",
      "short" : "Beschreibt die Art der Aktivität, die zu der Änderung im FHIR Data Service der ePA geführt hat. Beispiel CREATE | UPDATE",
      "min" : 1,
      "mustSupport" : true,
      "binding" : {
        "strength" : "required",
        "valueSet" : "https://gematik.de/fhir/epa/ValueSet/epa-activity-provenance-type-vs"
      }
    },
    {
      "id" : "Provenance.activity.coding",
      "path" : "Provenance.activity.coding",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.activity.coding.system",
      "path" : "Provenance.activity.coding.system",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.activity.coding.version",
      "path" : "Provenance.activity.coding.version",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.activity.coding.code",
      "path" : "Provenance.activity.coding.code",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.activity.coding.display",
      "path" : "Provenance.activity.coding.display",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.agent",
      "path" : "Provenance.agent",
      "short" : "Gibt den verantwortlichen Leistungserbringer, die Leistungserbringerinstitution oder das System an, das die Änderung im FHIR Data Service der ePA durchgeführt hat.",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.agent.type",
      "path" : "Provenance.agent.type",
      "short" : "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 FHIR Data Service der ePA fachlich verantwortet sein muss.",
      "definition" : "Gibt die Rolle oder Funktion an, die der Agent im Rahmen der dokumentierten Änderung eingenommen hat.\nWährend agent.who beschreibt, wer die Änderung durchgeführt hat (z.B. ein System oder eine Institution), legt agent.type fest, in welcher Eigenschaft oder mit welcher funktionalen Verantwortung diese Aktion erfolgt ist. Im Kontext dieses Profils ist ausschließlich die Rolle author zulässig, da jede Änderung im FHIR Data Service der ePA fachlich verantwortet sein muss.",
      "min" : 1,
      "mustSupport" : true,
      "binding" : {
        "strength" : "required",
        "valueSet" : "https://gematik.de/fhir/epa/ValueSet/epa-provenance-participant-type-vs"
      }
    },
    {
      "id" : "Provenance.agent.type.coding",
      "path" : "Provenance.agent.type.coding",
      "min" : 1,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.agent.type.coding.system",
      "path" : "Provenance.agent.type.coding.system",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Provenance.agent.type.coding.code",
      "path" : "Provenance.agent.type.coding.code",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Provenance.agent.type.coding.display",
      "path" : "Provenance.agent.type.coding.display",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.agent.who",
      "path" : "Provenance.agent.who",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.org/fhir/StructureDefinition/Practitioner",
        "http://hl7.org/fhir/StructureDefinition/Organization",
        "http://hl7.org/fhir/StructureDefinition/PractitionerRole"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Provenance.agent.who.reference",
      "path" : "Provenance.agent.who.reference",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.agent.who.identifier",
      "path" : "Provenance.agent.who.identifier",
      "type" : [{
        "code" : "Identifier",
        "profile" : ["http://fhir.de/StructureDefinition/identifier-telematik-id",
        "https://gematik.de/fhir/epa/StructureDefinition/identifier-epa-fhir-data-service"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Provenance.agent.who.identifier.system",
      "path" : "Provenance.agent.who.identifier.system",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.agent.who.identifier.value",
      "path" : "Provenance.agent.who.identifier.value",
      "mustSupport" : true
    },
    {
      "id" : "Provenance.agent.who.display",
      "path" : "Provenance.agent.who.display",
      "mustSupport" : true
    }]
  }
}

```
