Implementation Guide
ePA Basisfunktionalitäten
Version 1.3.1 - release

## Audit Event Service: Belegung der Protokolldaten

Die folgenden Festlegungen beschreiben die Belegung der Protokolldaten bei der Ausgabe über die FHIR-Schnittstelle des Audit Event Services. Definiert wird, welche Informationen in welchem AuditEvent-Element bereitzustellen sind und wie die Struktur der ausgegebenen AuditEvent-Ressourcen zu verwenden ist.

In der Struktur eines Protokolleintrages (Audit Event) sind folgende Zugriffsinformationen hinterlegt:

Information | Strukturelement
--- | ---
Wann ist der Zugriff erfolgt bzw. hat das Ereignis stattgefunden? | AuditEvent.recorded
Wer war der Akteur/Auslöser? | AuditEvent.agent
Welcher Art Service wurde angefragt? | AuditEvent.type
Worauf wurde zugegriffen? | AuditEvent.source
Welcher Art war der Zugriff? | AuditEvent.action
War der Zugriff erfolgreich? | AuditEvent.outcome
Informationen zu Daten/Dokumente/Objekte | AuditEvent.entity

Tabelle: Inhaltliche Definitionen eines Audit Event

Die spezifische Befüllung eines Audit Event wird durch die jeweiligen Services vorgegeben. Allgemeine Elemente sind wie folgt zu befüllen:

Der Audit Event Service MUSS die Audit-Event-Elemente AuditEvent.recorded, AuditEvent.agent und AuditEvent.source wie folgt befüllen.

Element [AuditEvent.] | Beschreibung | Beispiel
--- | --- | ---
recorded |  | Systemzeit bei Erstellung des Audit Event im Format YYYY-MM-DDThh:mm:ssZ | "2025-01-15T14:52:04.928Z"
agent[client].type.coding. |  | Information zum Auslöser des Audit Event gemäß des zulässigen Value Set |
system | Das verwendete Code System; fest vorgegebener Wert: "http://dicom.nema.org/resources/ontology/DCM" | "http://dicom.nema.org/resources/ontology/DCM"
code | Der verwendete Code aus dem Code System; Fest vorgegebener Wert: "110150" | "110150"
display | Der Bezeichner zur Anzeige aus dem Code System; Fest vorgegebener Wert: "Application" | "Application"
agent[client].who.identifier. |  | Identifikation des Auslösers des Audit Event gemäß der zulässigen Value Sets |
system | Das verwendete Code System | "https://gematik.de/fhir/sid/telematik-id"
value | <Telematik-Id> | "1-883110000092404"
agent[client]. | altId | <value> aus agent.who.identifier | "1-883110000092404"
name | <display_name> des auslösenden Akteurs aus dem ID-Token der User Session "Elektronische Patientenakte Fachdienst" für intern ausgelöste Audit Events | "E-Rezept-Fachdienst" "Elektronische Patientenakte Fachdienst" "Portugal" (Beispiel EU-Zugriff)
requestor | "true", wenn dieser "agent" Auslöser des AuditEvents ist oder wenn es der einzige beteiligte "agent" ist, ansonsten "false". |
agent[user].type.coding. |  | Information zum Auslöser des Audit Event gemäß des zulässigen Value Set |
system | Das verwendete Code System | "http://terminology.hl7.org/CodeSystem/v3-RoleClass"
code | Der verwendete Code aus dem Code System | "PROV"
display | Der Bezeichner zur Anzeige aus dem Code System | "healthcare provider"
agent[user].who.identifier. |  | Identifikation des Auslösers des Audit Event gemäß der zulässigen Value Sets |
system | Das verwendete Code System | "https://gematik.de/fhir/sid/telematik-id"
value | <Telematik-Id> oder <KVNR> | "2-121212121212121" "Z123456789"
agent[user]. | altId | <value> aus agent.who.identifier | "2-121212121212121" "Z123456789"
agent[user].role.coding. |  | Gilt nur für professionalOID = oid_ncpeh: Wert aus SOAP eHader des Request: healthProfessionalRole |
system | Das verwendete Code System | "urn:oid:1.3.6.1.4.1.12559.11.10.1.3.2.2.2"
code | Der verwendete Code aus dem Code System | "Resident Physician"
display | Der Bezeichner zur Anzeige aus dem Code System | "Resident Physician"
agent[user].extension |  | Gilt nur für professionalOID = oid_ncpeh: Wert aus SOAP Header des Request: healthcareFacilityType; extension mit url="https://gematik.de/fhir/epa/StructureDefinition/epa-healthcare-facility-type-extension" |
system | Das verwendete Code System | "urn:oid:2.16.840.1.113883.2.9.6.2.7"
code | Der verwendete Code aus dem Code System | "221"
display | Der Bezeichner zur Anzeige aus dem Code System | "Medical Doctors"
agent[user]. | name | Gilt nur für professionalOID = oid_ncpeh: Wert aus SOAP Header des Request: <leiName> / <healthProfessionalName> Andernfalls: <display_name> des auslösenden Akteurs aus dem ID-Token der User Session | EU-Zugriff: "Dr. Manuel Dos Santos / Clínica de Dos Santos" Anderenfalls: "John Doe"
requestor | Fest vorgegebener Wert "true" | false
agent[internal].type.coding. |  | Information zum Auslöser des Audit Event gemäß des zulässigen Value Sets |
system | Das verwendete Code System | "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"
code | Der verwendete Code aus dem Code System | "HRRSVC"
display | Der Bezeichner zur Anzeige aus dem Code System | " Health Record Relocation Service"
agent[internal]. | altId | Fest vorgegebener Wert "epa" | "epa"
name | Fest vorgegebener Wert "ePA" | "ePA"
requestor | Fest vorgegebener Wert "true" | "false"
source |  | Informationen zum auslösenden Service des Aktensystems |
source.observer. | display | Fester Wert "Elektronische Patientenakte Fachdienst" | "Elektronische Patientenakte Fachdienst"
source.type. |  | Der auslösende Service gemäß des zulässigen Value Set |
system | Das verwendete Code System | "https://gematik.de/fhir/epa/ValueSet/epa-auditevent-sourcetype-vs"
code | Der verwendete Code aus dem Code System | "CDMGMT"
display | Der Bezeichner zur Anzeige aus dem Code System | "Consent Decision Management"

Tabelle: Befüllung AuditEvent
Hinweis:
agent[client]: Angaben zur Applikation, z.B. eRezept-Fachdienst, NCPeH
agent[user]: Angaben zu LEI oder Vertreter oder Versicherter
agent[internal]: Angaben zu systemeigenen Services.

Hinweis: Die Speicherung von Protokolleinträgen durch einen Service erfordert einen berechtigten Benutzer, um den Zugriff auf den sicheren Datenspeicher zu gewährleisten. Daher wird die Erstellung von Protokolleinträgen immer übersprungen und es wird kein Protokolleintrag gespeichert, wenn diese Bedingung nicht erfüllt ist.

Falls für eine Operation ein Protokolleintrag gefordert ist und mit einem Fehler abgebrochen wird, MUSS der Audit Event Service jeweils einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen. Darüberhinaus und ergänzend zu den Vorgaben aus dem Profil EPAAuditEvent sind folgende Werte entsprechend zu belegen:

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.action | C, R, U, D | Create | Read | Update | Delete
AuditEvent.entity.name | <service name> | Service Name, wie für Protokollierung im Service gefordert
AuditEvent.entity.description | <operationId> | OperationId der mit einem Fehler abgebrochenen Operation, z.B. "providePrescription_MedicationSvc"
Nur bei FHIR Query API:
entity.detail.type | "search-parameters" |
entity.detail.value[x] | <ResourceType>?parameter1=<value>parameter2=<value>& ...mehr |

Tabelle: Audit Event Management - Protokollierung von Fehlern
Falls ein lesender Zugriff ("Read-Operation") durch den Versicherten erfolgt, DARF bei nicht erfolgreichen Zugriffen ein Protokolleintrag NICHT erzeugt werden.
Hinweis: Die Notwendigkeit eines Protokolleintrags gemäß IG-EPA40183ED3* entfällt, wenn ein Protokolleintrag mangels eines befugten Nutzers (kein Bezug des SecureDataStorageKeys möglich) nicht im SecureDataStorage abgelegt werden kann.

#### Beispiel AuditEvent für eine fehlgeschlagene Operation

    {
      "resourceType" : "AuditEvent",
      "id" : "64689b74-d485-4eca-802e-1c71183195ff",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-11-11T11:11:11.111Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "C",
      "recorded" : "2026-11-11T11:11:11.111Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PAT",
                "display" : "patient"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "http://fhir.de/sid/gkv/kvid-10",
              "value" : "A123456780"
            }
          },
          "altId" : "A123456780",
          "name" : "Erika Musterfrau",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "CDMGMT",
            "display" : "Consent Decision Management"
          }
        ]
      },
      "entity" : [
        {
          "name" : "ConsentDecision",
          "description" : "updateConsentDecision"
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="64689b74-d485-4eca-802e-1c71183195ff"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-11-11T11:11:11.111Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="C"/>
      <recorded value="2026-11-11T11:11:11.111Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PAT"/>
            <display value="patient"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10"/>
            <value value="A123456780"/>
          </identifier>
        </who>
        <altId value="A123456780"/>
        <name value="Erika Musterfrau"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="CDMGMT"/>
          <display value="Consent Decision Management"/>
        </type>
      </source>
      <entity>
        <name value="ConsentDecision"/>
        <description value="updateConsentDecision"/>
      </entity>
    </AuditEvent>

### Health Record Relocation Service

Der Health Record Relocation Service des neuen (importierenden) Aktensystems MUSS nach der erfolgreichen oder einer abgebrochenen Übertragung der Inhalte eines Aktenkontos vom bisherigen Anbieter einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen. Dabei ist folgende Wertebelegung zu berücksichtigen:

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.type | "object" |
AuditEvent.action | E | Übertrag von Daten eines Aktenkontos von einem anderen Anbieter
AuditEvent.agent.type | PAYOR | Umzug wurde ausgelöst vom Kostenträger
AuditEvent.entity.name | "HealthRecordRelocation" |
AuditEvent.entity.description | <operationId> |
AuditEvent.entity.detail | type | value[x] |
"OriginName" | <Name des Kostenträgers> | Name des Kostenträgers, von welchem ein bestehendes Aktenkonto übernommen wird

Tabelle: Health Record Relocation Service - Protokollierung einer Relocation

Hinweis: Der Health Record Relocation Service des bisherigen ePA-Aktensystemanbieters muss keinen Protokolleintrag gemäß IG-EPA78949PKT* erzeugen.

Der Health Record Relocation Service des neuen (importierenden) Aktensystems MUSS bei der Operation startPackageMergeImport jedes Hinzufügen eines Objekts zum Aktensystem (Merge) entsprechend der Protokollierungsregeln für das Objekt und der folgenden Vorgaben protokollieren.

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.agent.type | PAYOR | Die Zusammenführung der Daten wurde durch den Kostenträger ausgelöst
AuditEvent.source.type | HRRSVC | Der Protokolleintrag wurde durch den Health Record Relocation Service erstellt.
AuditEvent.entity.name | "SystemMerge" | Zusammenführung von Daten
AuditEvent.entity.description | "startPackageMergeImport"; | Identifier der auslösenden Operation

Tabelle: Health Record Relocation Service - Protokollierung der Zusammenführung von Daten

Hinweis: Bei der Zusammenführung (Merge) von Daten des Aktenkontos können auch Audit Event Instanzen übernommen werden. Diese werden gemäß [gemSpec_Aktensystem_ePAfueralle#A_28412-*] mit einem zusätzlichen `entity.detail` ergänzt und wie folgt belegt:

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.entity.detail.type | System-Zusammenführung |
AuditEvent.entity.detail.valueString | true |

Tabelle: Health Record Relocation Service - Markierung der Protokolle zusammengeführter Daten

#### Beispiel AuditEvent für einen regulären Aktenumzug

    {
      "resourceType" : "AuditEvent",
      "id" : "dc2cad66-28f3-4ad4-ae1b-c2f202217c4a",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-05-30T00:03:21.641Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "object"
      },
      "action" : "E",
      "recorded" : "2026-05-30T00:03:21.641Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PAYOR",
                "display" : "invoice payor"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "8-863110000022741"
            }
          },
          "altId" : "8-863110000022741",
          "name" : "Name des importierenden Kostenträgers",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "HRRSVC",
            "display" : "Health Record Relocation Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "HealthRecordRelocation",
          "description" : "startPackageImport",
          "detail" : [
            {
              "type" : "OriginName",
              "valueString" : "Name des exportierenden Kostenträgers "
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="dc2cad66-28f3-4ad4-ae1b-c2f202217c4a"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-05-30T00:03:21.641Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="object"/>
      </type>
      <action value="E"/>
      <recorded value="2026-05-30T00:03:21.641Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PAYOR"/>
            <display value="invoice payor"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="8-863110000022741"/>
          </identifier>
        </who>
        <altId value="8-863110000022741"/>
        <name value="Name des importierenden Kostenträgers"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="HRRSVC"/>
          <display value="Health Record Relocation Service"/>
        </type>
      </source>
      <entity>
        <name value="HealthRecordRelocation"/>
        <description value="startPackageImport"/>
        <detail>
          <type value="OriginName"/>
          <valueString value="Name des exportierenden Kostenträgers "/>
        </detail>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent für eine System-Merge-Operation, bei der ein Dokument zum XDS-Dokumentendienst hinzugefügt wird

    {
      "resourceType" : "AuditEvent",
      "id" : "8bedf920-ffcf-4cb7-b6ca-379f296d8740",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-03-12T14:43:33.244Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "document"
      },
      "action" : "E",
      "recorded" : "2026-03-12T14:43:33.244Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PAYOR",
                "display" : "invoice payor"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "8-863110000022741"
            }
          },
          "altId" : "8-863110000022741",
          "name" : "Name des Kostenträgers",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "HRRSVC",
            "display" : "Health Record Relocation Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "SystemMerge",
          "description" : "startPackageMergeImport",
          "detail" : [
            {
              "type" : "DocumentFormatCode",
              "valueString" : "urn:gematik:ig:Arztbrief:r3.1"
            },
            {
              "type" : "DocumentEntryTitle",
              "valueString" : "Arztbrief4711"
            },
            {
              "type" : "DocumentUniqueId",
              "valueString" : "187432aa-0d3f-4202-9ec5-a7e001855a3c"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="8bedf920-ffcf-4cb7-b6ca-379f296d8740"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-03-12T14:43:33.244Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="document"/>
      </type>
      <action value="E"/>
      <recorded value="2026-03-12T14:43:33.244Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PAYOR"/>
            <display value="invoice payor"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="8-863110000022741"/>
          </identifier>
        </who>
        <altId value="8-863110000022741"/>
        <name value="Name des Kostenträgers"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="HRRSVC"/>
          <display value="Health Record Relocation Service"/>
        </type>
      </source>
      <entity>
        <name value="SystemMerge"/>
        <description value="startPackageMergeImport"/>
        <detail>
          <type value="DocumentFormatCode"/>
          <valueString value="urn:gematik:ig:Arztbrief:r3.1"/>
        </detail>
        <detail>
          <type value="DocumentEntryTitle"/>
          <valueString value="Arztbrief4711"/>
        </detail>
        <detail>
          <type value="DocumentUniqueId"/>
          <valueString value="187432aa-0d3f-4202-9ec5-a7e001855a3c"/>
        </detail>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent für eine System-Merge-Operation, bei der ein Audit Event hinzugefügt wird

    {
      "resourceType" : "AuditEvent",
      "id" : "49280fa1-5096-4bc7-901e-22f5dd72f822",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2025-01-15T14:43:33.244Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "object"
      },
      "action" : "U",
      "recorded" : "2025-01-15T14:52:04.928Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PROV",
                "display" : "healthcare provider"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "1-883110000092404"
            }
          },
          "altId" : "1-883110000092404",
          "name" : "Praxis Dr. John Doe",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "XDSSVC",
            "display" : "XDS Document Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "XDS Document Service",
          "description" : "ProvideAndRegisterDocumentSet-b",
          "detail" : [
            {
              "type" : "DocumentFormatCode",
              "valueString" : "urn:gematik:ig:Arztbrief:r3.1"
            },
            {
              "type" : "DocumentEntryTitle",
              "valueString" : "Arztbrief4711"
            },
            {
              "type" : "DocumentUniqueId",
              "valueString" : "187432aa-0d3f-4202-9ec5-a7e001855a3c"
            },
            {
              "type" : "System-Zusammenführung",
              "valueString" : "true"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="49280fa1-5096-4bc7-901e-22f5dd72f822"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2025-01-15T14:43:33.244Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="object"/>
      </type>
      <action value="U"/>
      <recorded value="2025-01-15T14:52:04.928Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PROV"/>
            <display value="healthcare provider"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="1-883110000092404"/>
          </identifier>
        </who>
        <altId value="1-883110000092404"/>
        <name value="Praxis Dr. John Doe"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="XDSSVC"/>
          <display value="XDS Document Service"/>
        </type>
      </source>
      <entity>
        <name value="XDS Document Service"/>
        <description value="ProvideAndRegisterDocumentSet-b"/>
        <detail>
          <type value="DocumentFormatCode"/>
          <valueString value="urn:gematik:ig:Arztbrief:r3.1"/>
        </detail>
        <detail>
          <type value="DocumentEntryTitle"/>
          <valueString value="Arztbrief4711"/>
        </detail>
        <detail>
          <type value="DocumentUniqueId"/>
          <valueString value="187432aa-0d3f-4202-9ec5-a7e001855a3c"/>
        </detail>
        <detail>
          <type value="System-Zusammenführung"/>
          <valueString value="true"/>
        </detail>
      </entity>
    </AuditEvent>

### Constraint Management

Das Constraint Management MUSS für das Aufnehmen und Löschen von Einträgen in die General Deny Policy jeweils einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen. Dabei ist folgende Wertebelegung zu berücksichtigen:

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.type | "rest" | Bei Änderungen über die API
| "object" | Bei intern ausgelösten Änderungen (XDS Document Service confidentiality code ("CON"), Löschen von Dokumenten oder Ordnern)
AuditEvent.action | C, D |
AuditEvent.entity |  | Pro geändertem Eintrag der General Deny Policy ist ein entity-Element anzulegen, bei gleichzeitiger Verarbeitung von mehr als einem Eintrag (Batch-Operation) sind entsprechend mehrere entity-Einträge zu verwenden. Die Befüllung für entity.name und entity.description muss bei Verwendung von mehreren entity-Elementen gleich sein.
AuditEvent.entity.name | "GeneralDenyPolicy" | Hinzufügen oder Löschen von Einträgen der GeneralDenyPolicy
AuditEvent.entity.description | <operationId> | Id der verwendeten Operation,"internal" bei intern ausgelöster Änderung
AuditEvent.entity.detail | type | value[x] |
"DocumentTitle" | <XDSDocumentEntry.title> | wenn sich der Eintrag (Create oder Delete) der Policy auf ein Dokument bezieht
"RootDocumentId" | <rootDocumentId> | wenn sich der Eintrag (Create oder Delete) der Policy auf ein Dokument bezieht
"FolderTitle" | <XDSFolder.title> | wenn sich der Eintrag (Create oder Delete) der Policy auf einen Folder bezieht
"FolderEntryUUID" | <Folder.entryUUID> | wenn sich der Eintrag (Create oder Delete) der Policy auf einen Folder bezieht
"CategoryId" | <categoryId> | wenn sich der Eintrag (Create oder Delete) der Policy auf eine Kategorie bezieht

Tabelle: Constraint Management - Protokollierung Änderungen der General Deny Policy

#### Beispiel AuditEvent für das Verbergen einer Kategorie

    {
      "resourceType" : "AuditEvent",
      "id" : "12f84721-2ad9-4cfa-81c5-b1345bc74230",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2025-01-16T13:14:20.766Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "C",
      "recorded" : "2025-01-16T13:14:20.766Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PAT",
                "display" : "patient"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "http://fhir.de/sid/gkv/kvid-10",
              "value" : "A123456780"
            }
          },
          "altId" : "A123456780",
          "name" : "Erika Musterfrau",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "CONMGMT",
            "display" : "Constraint Management"
          }
        ]
      },
      "entity" : [
        {
          "name" : "GeneralDenyPolicy",
          "description" : "setDenyPolicyAssignment",
          "detail" : [
            {
              "type" : "CategoryId",
              "valueString" : "vaccination"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="12f84721-2ad9-4cfa-81c5-b1345bc74230"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2025-01-16T13:14:20.766Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="C"/>
      <recorded value="2025-01-16T13:14:20.766Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PAT"/>
            <display value="patient"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10"/>
            <value value="A123456780"/>
          </identifier>
        </who>
        <altId value="A123456780"/>
        <name value="Erika Musterfrau"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="CONMGMT"/>
          <display value="Constraint Management"/>
        </type>
      </source>
      <entity>
        <name value="GeneralDenyPolicy"/>
        <description value="setDenyPolicyAssignment"/>
        <detail>
          <type value="CategoryId"/>
          <valueString value="vaccination"/>
        </detail>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent für gleichzeitiges Verbergen von Dokumenten und einer Kategorie

    {
      "resourceType" : "AuditEvent",
      "id" : "532c1540-8403-4b57-8349-279f53443f23",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-03-10T13:50:04.047Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "C",
      "recorded" : "2026-03-10T13:50:04.047Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PAT",
                "display" : "patient"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "http://fhir.de/sid/gkv/kvid-10",
              "value" : "A123456780"
            }
          },
          "altId" : "A123456780",
          "name" : "Erika Musterfrau",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "CONMGMT",
            "display" : "Constraint Management"
          }
        ]
      },
      "entity" : [
        {
          "name" : "GeneralDenyPolicy",
          "description" : "batchSetDenyPolicyAssignment",
          "detail" : [
            {
              "type" : "DocumentTitle",
              "valueString" : "Befund von Dr. Mustermann"
            },
            {
              "type" : "RootDocumentId",
              "valueString" : "urn:uuid:0ab6dc6f-d5f2-4d89-8782-6794b6f372f2^^^^urn:gematik:iti:xds:2023:rootDocumentUniqueId"
            }
          ]
        },
        {
          "name" : "GeneralDenyPolicy",
          "description" : "batchSetDenyPolicyAssignment",
          "detail" : [
            {
              "type" : "DocumentTitle",
              "valueString" : "Brief von Dr. Mustermann"
            },
            {
              "type" : "RootDocumentId",
              "valueString" : "urn:uuid:256181de-e732-48d7-8cbb-acdc133dde66^^^^urn:gematik:iti:xds:2023:rootDocumentUniqueId"
            }
          ]
        },
        {
          "name" : "GeneralDenyPolicy",
          "description" : "batchSetDenyPolicyAssignment",
          "detail" : [
            {
              "type" : "CategoryId",
              "valueString" : "dental"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="532c1540-8403-4b57-8349-279f53443f23"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-03-10T13:50:04.047Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="C"/>
      <recorded value="2026-03-10T13:50:04.047Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PAT"/>
            <display value="patient"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10"/>
            <value value="A123456780"/>
          </identifier>
        </who>
        <altId value="A123456780"/>
        <name value="Erika Musterfrau"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="CONMGMT"/>
          <display value="Constraint Management"/>
        </type>
      </source>
      <entity>
        <name value="GeneralDenyPolicy"/>
        <description value="batchSetDenyPolicyAssignment"/>
        <detail>
          <type value="DocumentTitle"/>
          <valueString value="Befund von Dr. Mustermann"/>
        </detail>
        <detail>
          <type value="RootDocumentId"/>
          <valueString
                       value="urn:uuid:0ab6dc6f-d5f2-4d89-8782-6794b6f372f2^^^^urn:gematik:iti:xds:2023:rootDocumentUniqueId"/>
        </detail>
      </entity>
      <entity>
        <name value="GeneralDenyPolicy"/>
        <description value="batchSetDenyPolicyAssignment"/>
        <detail>
          <type value="DocumentTitle"/>
          <valueString value="Brief von Dr. Mustermann"/>
        </detail>
        <detail>
          <type value="RootDocumentId"/>
          <valueString
                       value="urn:uuid:256181de-e732-48d7-8cbb-acdc133dde66^^^^urn:gematik:iti:xds:2023:rootDocumentUniqueId"/>
        </detail>
      </entity>
      <entity>
        <name value="GeneralDenyPolicy"/>
        <description value="batchSetDenyPolicyAssignment"/>
        <detail>
          <type value="CategoryId"/>
          <valueString value="dental"/>
        </detail>
      </entity>
    </AuditEvent>

### Consent Decision Management

Das Consent Decision Management MUSS Bei Änderungen von Entscheidungen zu den widerspruchsfähigen Funktionen der ePA jeweils einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen. Für die Wertebelegung ist [gemSpec_Aktensystem_ePAfueralle#A_23874] zu berücksichtigen und die Protokollstruktur entsprechend zu belegen:

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.type | "rest" |
AuditEvent.action | U |
AuditEvent.entity.name | "ConsentDecision" | Eintrag protokolliert eine Widerspruchsentscheidung
AuditEvent.entity.description | <operationId> | Id der verwendeten Operation
AuditEvent.entity.detail | type | value[x] |
"ConsentClass" | <consent class> | z.B. "healthCareProcess"
"ConsentClassId" | <consent class Id> | z.B. "medication"
"ConsentDecision" | <consent decision> | "deny" oder "permit"

Tabelle: Consent Decision Management - Protokollierung Änderungen der Entscheidungen zu widerspruchsfähigen Funktionen der ePA

Hinweis: Die initiale Entscheidung zu den Widersprüchen bei Anlage eines Aktenkontos wird nicht protokolliert. Die spezifische Protokollierung erfolgt für Folgeänderungen.

Das Consent Decision Management MUSS bei jeder Änderung einer Widerspruchsentscheidung zur Verwendung der an das Forschungsdatenzentrum übermittelten Daten für bestimmte Sekundärnutzungszwecke einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen.

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.type | "rest" |
AuditEvent.action | U |
AuditEvent.entity.name | "DataUsagePurpose" | Eintrag protokolliert eine Widerspruchsentscheidung zu Sekundärnutzungszwecken
AuditEvent.entity.description | <operationId> | Id der verwendeten Operation
AuditEvent.entity.detail | type | value[x] | Liste aller geänderten Widersprüche zu Sekundärnutzungszwecken
"purpose id" | <consent decision> | Auswahl aus <purpose Id> mit den Werten: [purpose1, purpose2, purpose3, purpose4, purpose5, purpose6, purpose7, purpose8, purpose9, purpose10] und den Werten für die Widerspruchsentscheidung <consent decision>: ["permit", "deny"]

Tabelle: Consent Decision Management - Protokollierung Änderungen der Entscheidungen zu Widersprüchen gegen Zwecke der Sekundärnutzungs
Das Consent Decision Management MUSS für jede Änderung der User Specific Deny Policy Medication einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen:

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.type | "rest" |
AuditEvent.action | C, D |
AuditEvent.entity.name | "UdpMedication" | Eintrag protokolliert eine Änderung der User Specific Deny Policy für Medication Service
AuditEvent.entity.description | <operationId> | Id der verwendeten Operation
AuditEvent.entity.detail | type | value[x] |
"UserId" | <Telematik-ID der LEI> | Telematik-ID der LEI, welche zur User Specific Deny Policy Medication hinzugefügt oder gelöscht wurde
"UserName" | <displayName> | Name der LEI, welche zur User Specific Deny Policy Medication hinzugefügt oder gelöscht wurde

Tabelle: Consent- ecision Management - Protokollierung Änderungen der User Specific Deny Policy Medication

#### Beispiel AuditEvent für Änderungen an Consent Decisions

    {
      "resourceType" : "AuditEvent",
      "id" : "825c3fdd-b784-4370-8dd2-c1d3bed674ec",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2025-01-16T13:12:17.184Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "U",
      "recorded" : "2025-01-16T13:12:17.184Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PAT",
                "display" : "patient"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "http://fhir.de/sid/gkv/kvid-10",
              "value" : "A123456780"
            }
          },
          "altId" : "A123456780",
          "name" : "Erika Musterfrau",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "CDMGMT",
            "display" : "Consent Decision Management"
          }
        ]
      },
      "entity" : [
        {
          "name" : "ConsentDecision",
          "description" : "updateConsentDecision",
          "detail" : [
            {
              "type" : "ConsentClass",
              "valueString" : "healthCareProcess"
            },
            {
              "type" : "ConsentClassId",
              "valueString" : "erp-submission"
            },
            {
              "type" : "ConsentDecision",
              "valueString" : "deny"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="825c3fdd-b784-4370-8dd2-c1d3bed674ec"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2025-01-16T13:12:17.184Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="U"/>
      <recorded value="2025-01-16T13:12:17.184Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PAT"/>
            <display value="patient"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10"/>
            <value value="A123456780"/>
          </identifier>
        </who>
        <altId value="A123456780"/>
        <name value="Erika Musterfrau"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="CDMGMT"/>
          <display value="Consent Decision Management"/>
        </type>
      </source>
      <entity>
        <name value="ConsentDecision"/>
        <description value="updateConsentDecision"/>
        <detail>
          <type value="ConsentClass"/>
          <valueString value="healthCareProcess"/>
        </detail>
        <detail>
          <type value="ConsentClassId"/>
          <valueString value="erp-submission"/>
        </detail>
        <detail>
          <type value="ConsentDecision"/>
          <valueString value="deny"/>
        </detail>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent für Änderungen an Widersprüchen zur Sekundärdatennutzung

    {
      "resourceType" : "AuditEvent",
      "id" : "633ecbbf-d105-4e35-8c9f-0536ee7b6c59",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-10-03T02:00:04.322Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "U",
      "recorded" : "2026-10-03T02:00:04.322Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PAT",
                "display" : "patient"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "http://fhir.de/sid/gkv/kvid-10",
              "value" : "A123456780"
            }
          },
          "altId" : "A123456780",
          "name" : "Erika Musterfrau",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "CDMGMT",
            "display" : "Consent Decision Management"
          }
        ]
      },
      "entity" : [
        {
          "name" : "DataUsagePurpose",
          "description" : "updateDataUsagePurposes",
          "detail" : [
            {
              "type" : "purpose3",
              "valueString" : "deny"
            },
            {
              "type" : "purpose7",
              "valueString" : "permit"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="633ecbbf-d105-4e35-8c9f-0536ee7b6c59"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-10-03T02:00:04.322Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="U"/>
      <recorded value="2026-10-03T02:00:04.322Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PAT"/>
            <display value="patient"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10"/>
            <value value="A123456780"/>
          </identifier>
        </who>
        <altId value="A123456780"/>
        <name value="Erika Musterfrau"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="CDMGMT"/>
          <display value="Consent Decision Management"/>
        </type>
      </source>
      <entity>
        <name value="DataUsagePurpose"/>
        <description value="updateDataUsagePurposes"/>
        <detail>
          <type value="purpose3"/>
          <valueString value="deny"/>
        </detail>
        <detail>
          <type value="purpose7"/>
          <valueString value="permit"/>
        </detail>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent für den Ausschluss einer Leistungserbringerorganisation vom Medikationsprozess

    {
      "resourceType" : "AuditEvent",
      "id" : "daf3263b-41ba-420c-aacd-bf98dc16d315",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-04-28T21:17:03.047Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "C",
      "recorded" : "2026-04-28T21:17:03.047Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PAT",
                "display" : "patient"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "http://fhir.de/sid/gkv/kvid-10",
              "value" : "A123456780"
            }
          },
          "altId" : "A123456780",
          "name" : "Erika Musterfrau",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "CDMGMT",
            "display" : "Consent Decision Management"
          }
        ]
      },
      "entity" : [
        {
          "name" : "UdpMedication",
          "description" : "setUserSpecificMedicationDeny",
          "detail" : [
            {
              "type" : "UserId",
              "valueString" : "2-883110000092414"
            },
            {
              "type" : "UserName",
              "valueString" : "Zahnarztpraxis Norbert Freiherr Schomaker"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="daf3263b-41ba-420c-aacd-bf98dc16d315"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-04-28T21:17:03.047Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="C"/>
      <recorded value="2026-04-28T21:17:03.047Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PAT"/>
            <display value="patient"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10"/>
            <value value="A123456780"/>
          </identifier>
        </who>
        <altId value="A123456780"/>
        <name value="Erika Musterfrau"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="CDMGMT"/>
          <display value="Consent Decision Management"/>
        </type>
      </source>
      <entity>
        <name value="UdpMedication"/>
        <description value="setUserSpecificMedicationDeny"/>
        <detail>
          <type value="UserId"/>
          <valueString value="2-883110000092414"/>
        </detail>
        <detail>
          <type value="UserName"/>
          <valueString value="Zahnarztpraxis Norbert Freiherr Schomaker"/>
        </detail>
      </entity>
    </AuditEvent>

### Entitlement Management

Das Entitlement Management MUSS für das Erteilen und Entziehen von Befugnissen und das Setzen und Löschen von Befugnisausschlüssen jeweils einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen. Dabei ist folgende Wertebelegung zu berücksichtigen:

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.type | "rest" |
AuditEvent.action | C, D, U |
AuditEvent.entity.name | "UserBlocking" | Setzen und Löschen von Befugnisausschlüssen
"EntitlementManagement" | Erteilen oder Entziehen von Befugnissen
AuditEvent.entity.description | <operationId> | Id der verwendeten Operation
AuditEvent.entity.detail | type | value[x] |
"blockedUserName" | <Name der LEI> | Name der LEI, für die der Befugnisausschluss gesetzt bzw. der Ausschluss zurückgenommen wurde
"blockedUserId" | <Telematik-ID der LEI> | Telematik-ID der LEI, für die der Befugnisausschluss gesetzt bzw. der Ausschluss zurückgenommen wurde
"UserName" | <Name der Institution oder des Vertreters> | Name der Institution oder des Nutzers für die eine Befugnis erteilt oder gelöscht wurden
"UserId" | <Identifier der Institution oder des Vertreters> | ID der Institution oder des Nutzers für die eine Befugnis erteilt oder gelöscht wurden
"entitledValidTo" | <Endzeitpunkt der Gültigkeit der Befugnis> | Angabe des Endes einer erteilten Befugnis, Format gemäß [RFC3339] YYYY-MM-DDThh:mm:ssZ oder YYYY-MM-DDThh:mm:ss+/-time zone

Tabelle: Entitlement Management - Protokollierung Änderungen zu Befugnissen und Befugnisausschlüssen

Hinweis: Ein Update (“U”) eines Entitlements liegt vor, wenn ein existierendes Entitlement aufgrund des längeren Gültigkeitszeitraums eines neuen Entitlements überschrieben wird.

#### Beispiel AuditEvent für die Entitlementerstellung durch ein PVS

    {
      "resourceType" : "AuditEvent",
      "id" : "69b6ab63-03c5-4e4c-b9d8-dc68e51487c4",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-07-22T09:05:04.232Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "C",
      "recorded" : "2026-07-22T09:05:04.232Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PROV",
                "display" : "healthcare provider"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "1-883110000092404"
            }
          },
          "altId" : "1-883110000092404",
          "name" : "Praxis Dr. John Doe",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "ENTITMGMT",
            "display" : "Entitlement Management"
          }
        ]
      },
      "entity" : [
        {
          "name" : "EntitlementManagement",
          "description" : "setEntitlementPs",
          "detail" : [
            {
              "type" : "UserName",
              "valueString" : "Praxis Dr. John Doe"
            },
            {
              "type" : "UserId",
              "valueString" : "1-883110000092404"
            },
            {
              "type" : "entitledValidTo",
              "valueString" : "2026-10-20T22:59:59Z"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="69b6ab63-03c5-4e4c-b9d8-dc68e51487c4"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-07-22T09:05:04.232Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="C"/>
      <recorded value="2026-07-22T09:05:04.232Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PROV"/>
            <display value="healthcare provider"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="1-883110000092404"/>
          </identifier>
        </who>
        <altId value="1-883110000092404"/>
        <name value="Praxis Dr. John Doe"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="ENTITMGMT"/>
          <display value="Entitlement Management"/>
        </type>
      </source>
      <entity>
        <name value="EntitlementManagement"/>
        <description value="setEntitlementPs"/>
        <detail>
          <type value="UserName"/>
          <valueString value="Praxis Dr. John Doe"/>
        </detail>
        <detail>
          <type value="UserId"/>
          <valueString value="1-883110000092404"/>
        </detail>
        <detail>
          <type value="entitledValidTo"/>
          <valueString value="2026-10-20T22:59:59Z"/>
        </detail>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent für das Ausschließen einer Arztpraxis von der Befugnisvergabe (BlockedUser)

    {
      "resourceType" : "AuditEvent",
      "id" : "d36725fd-0d38-46fb-89f8-46e75a41ba97",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-11-03T19:05:22.117Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "C",
      "recorded" : "2026-11-03T19:05:22.117Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PAT",
                "display" : "patient"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "http://fhir.de/sid/gkv/kvid-10",
              "value" : "A123456780"
            }
          },
          "altId" : "A123456780",
          "name" : "Erika Musterfrau",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "ENTITMGMT",
            "display" : "Entitlement Management"
          }
        ]
      },
      "entity" : [
        {
          "name" : "UserBlocking",
          "description" : "setBlockedUserPolicyAssignment",
          "detail" : [
            {
              "type" : "blockedUserName",
              "valueString" : "Praxis Dr. John Doe"
            },
            {
              "type" : "blockedUserId",
              "valueString" : "1-883110000092404"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="d36725fd-0d38-46fb-89f8-46e75a41ba97"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-11-03T19:05:22.117Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="C"/>
      <recorded value="2026-11-03T19:05:22.117Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PAT"/>
            <display value="patient"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10"/>
            <value value="A123456780"/>
          </identifier>
        </who>
        <altId value="A123456780"/>
        <name value="Erika Musterfrau"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="ENTITMGMT"/>
          <display value="Entitlement Management"/>
        </type>
      </source>
      <entity>
        <name value="UserBlocking"/>
        <description value="setBlockedUserPolicyAssignment"/>
        <detail>
          <type value="blockedUserName"/>
          <valueString value="Praxis Dr. John Doe"/>
        </detail>
        <detail>
          <type value="blockedUserId"/>
          <valueString value="1-883110000092404"/>
        </detail>
      </entity>
    </AuditEvent>

### Push Notification Management

Das Push Notification Management MUSS für Erstellung und Änderung (CUD) von ePA-FdV-Instanz-Registrierungen jeweils einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen. Dabei ist folgende Wertebelegung zu berücksichtigen:

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.type | "rest" | Bei Änderungen über die API
| "object" | Bei intern ausgelösten Änderungen (internes Löschen einer ePA-FdV-Instanz-Registrierung nach Löschen Device Registration)
AuditEvent.action | C, U, D |
AuditEvent.entity.name | "PushNotificationManagement" |
AuditEvent.entity.description | <operationId> | Id der verwendeten Operation, "internal" bei intern ausgelöster Änderung
AuditEvent.entity.detail | type | value[x] |
"DisplayNamePusher" | <device_display_name aus der Pusher-Registrierung> |
"DisplayNameDevice" | <displayName der Device Registration> |

Tabelle: Push Notification Management - Protokollierung Änderungen der Pusherregistrierung

Hinweis: DisplayNamePusher und DisplayNameDevice können gleich lauten.

Das Push Notification Management MUSS für Änderungen der Channel-Konfiguration jeweils einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen. Dabei ist folgende Wertebelegung zu berücksichtigen:

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.type | "rest" | Bei Änderungen über die API
| "object" | Bei intern ausgelösten Änderungen (internes Löschen einer ePA-FdV-Instanz-Registrierung nach Löschen Device Registration)
AuditEvent.action | U |
AuditEvent.entity.name | "PushNotificationManagement" |
AuditEvent.entity.description | <operationId> | Id der verwendeten Operation, "internal" bei intern ausgelöster Änderung
AuditEvent.entity.detail | type | value[x] |
"channelId" | <[enabled, disabled]> | `value` wird auf den neuen Wert gesetzt
Die Kardinalität der <`channelId`> | <`value`> Paare ist 1 .. *. Für jeden geänderte Wert eines Channels ist ein Eintrag erforderlich. Erfolgt der Protokolleintrag aufgrund Löschung eines Pushers, so sind die Channels zu erfassen, die vor der Löschung den Wert `enabled` hatten
"DisplayNamePusher" | <device_display_name aus der Pusher-Registrierung> |
"DisplayNameDevice" | <displayName der Device Registration> |

Tabelle: Push Notification Management - Protokollierung Änderungen der Channelkonfiguration

#### Beispiel AuditEvent für die Registrierung eines ePA-FdV im Aktensystem für Pushnachrichten

    {
      "resourceType" : "AuditEvent",
      "id" : "27a03af4-5ebc-4dd6-83ba-7b775e5b664a",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-11-04T21:13:47.161Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "C",
      "recorded" : "2026-11-04T21:13:47.161Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PAT",
                "display" : "patient"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "http://fhir.de/sid/gkv/kvid-10",
              "value" : "A123456780"
            }
          },
          "altId" : "A123456780",
          "name" : "Erika Musterfrau",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "PUSHNOTMGMT",
            "display" : "Push Notification Management"
          }
        ]
      },
      "entity" : [
        {
          "name" : "PushNotificationManagement",
          "description" : "updatePusher",
          "detail" : [
            {
              "type" : "DisplayNamePusher",
              "valueString" : "Erikas Tablet"
            },
            {
              "type" : "DisplayNameDevice",
              "valueString" : "Erikas Tablet für ePA"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="27a03af4-5ebc-4dd6-83ba-7b775e5b664a"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-11-04T21:13:47.161Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="C"/>
      <recorded value="2026-11-04T21:13:47.161Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PAT"/>
            <display value="patient"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10"/>
            <value value="A123456780"/>
          </identifier>
        </who>
        <altId value="A123456780"/>
        <name value="Erika Musterfrau"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="PUSHNOTMGMT"/>
          <display value="Push Notification Management"/>
        </type>
      </source>
      <entity>
        <name value="PushNotificationManagement"/>
        <description value="updatePusher"/>
        <detail>
          <type value="DisplayNamePusher"/>
          <valueString value="Erikas Tablet"/>
        </detail>
        <detail>
          <type value="DisplayNameDevice"/>
          <valueString value="Erikas Tablet für ePA"/>
        </detail>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent für eine gelöschte Push-Registrierung aufgrund intern gelöschter Device-Registrierung

    {
      "resourceType" : "AuditEvent",
      "id" : "bfc506eb-a714-4373-a990-21d7144d3f58",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-05-04T03:47:16.983Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "object"
      },
      "action" : "D",
      "recorded" : "2026-05-04T03:47:16.983Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
                "code" : "PUSHNOTMGMT",
                "display" : "Push Notification Management"
              }
            ]
          },
          "altId" : "epa",
          "name" : "ePA",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "PUSHNOTMGMT",
            "display" : "Push Notification Management"
          }
        ]
      },
      "entity" : [
        {
          "name" : "PushNotificationManagement",
          "description" : "internal",
          "detail" : [
            {
              "type" : "DisplayNamePusher",
              "valueString" : "Erikas Tablet"
            },
            {
              "type" : "DisplayNameDevice",
              "valueString" : "Erikas Tablet für ePA"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="bfc506eb-a714-4373-a990-21d7144d3f58"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-05-04T03:47:16.983Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="object"/>
      </type>
      <action value="D"/>
      <recorded value="2026-05-04T03:47:16.983Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system
                    value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
            <code value="PUSHNOTMGMT"/>
            <display value="Push Notification Management"/>
          </coding>
        </type>
        <altId value="epa"/>
        <name value="ePA"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="PUSHNOTMGMT"/>
          <display value="Push Notification Management"/>
        </type>
      </source>
      <entity>
        <name value="PushNotificationManagement"/>
        <description value="internal"/>
        <detail>
          <type value="DisplayNamePusher"/>
          <valueString value="Erikas Tablet"/>
        </detail>
        <detail>
          <type value="DisplayNameDevice"/>
          <valueString value="Erikas Tablet für ePA"/>
        </detail>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent für die Änderung der abonnierten Push-Kanäle einer Push-Registrierung

    {
      "resourceType" : "AuditEvent",
      "id" : "4fb73d96-49eb-4b5d-9f12-3afcc7cb9802",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-09-06T21:02:02.002Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "U",
      "recorded" : "2026-09-06T21:02:02.002Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PAT",
                "display" : "patient"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "http://fhir.de/sid/gkv/kvid-10",
              "value" : "A123456780"
            }
          },
          "altId" : "A123456780",
          "name" : "Erika Musterfrau",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "PUSHNOTMGMT",
            "display" : "Push Notification Management"
          }
        ]
      },
      "entity" : [
        {
          "name" : "PushNotificationManagement",
          "description" : "updateChannelsOfPusher",
          "detail" : [
            {
              "type" : "xds.put",
              "valueString" : "enabled"
            },
            {
              "type" : "constraint.del",
              "valueString" : "disabled"
            },
            {
              "type" : "DisplayNamePusher",
              "valueString" : "Erikas Tablet"
            },
            {
              "type" : "DisplayNameDevice",
              "valueString" : "Erikas Tablet für ePA"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="4fb73d96-49eb-4b5d-9f12-3afcc7cb9802"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-09-06T21:02:02.002Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="U"/>
      <recorded value="2026-09-06T21:02:02.002Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PAT"/>
            <display value="patient"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10"/>
            <value value="A123456780"/>
          </identifier>
        </who>
        <altId value="A123456780"/>
        <name value="Erika Musterfrau"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="PUSHNOTMGMT"/>
          <display value="Push Notification Management"/>
        </type>
      </source>
      <entity>
        <name value="PushNotificationManagement"/>
        <description value="updateChannelsOfPusher"/>
        <detail>
          <type value="xds.put"/>
          <valueString value="enabled"/>
        </detail>
        <detail>
          <type value="constraint.del"/>
          <valueString value="disabled"/>
        </detail>
        <detail>
          <type value="DisplayNamePusher"/>
          <valueString value="Erikas Tablet"/>
        </detail>
        <detail>
          <type value="DisplayNameDevice"/>
          <valueString value="Erikas Tablet für ePA"/>
        </detail>
      </entity>
    </AuditEvent>

### Audit Event Service

Der Audit Event Service MUSS für die Zugriffe der Ombudsstelle oder eines Vertreters auf die protokollierten Daten jeweils einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen.

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.type | "rest" |
AuditEvent.action | R | Read
AuditEvent.entity.name | "AuditEvent" | Service Name
AuditEvent.entity.description | Passend zur ausgeführten Operation ein Wert aus folgender Liste: listAuditEvents getAuditEventById renderAuditEventsToPDF | operationId der zu protokollierenden Operation
AuditEvent.entity.detail | type | value[x] |
parameters | parameter1=<value>&parameter2=<value>& ...mehr | Nur bei getAuditEventList |
identifier | <id> des AuditEvents | Nur bei getAuditEvent |

Tabelle: Audit Event Service - Protokollierung Abrufe der AuditEvents
Hinweis: Zugriffe des Versicherten auf die Protokolle des Audit Event Service werden nicht protokolliert.

#### Beispiel AuditEvent für den Protokollabruf durch eine Ombudsstelle

    {
      "resourceType" : "AuditEvent",
      "id" : "c24dcb68-e61b-46fb-b11b-5f37dccf01f8",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2025-04-01T12:00:00.000Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "R",
      "recorded" : "2025-04-01T12:00:00.000Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-agent-type-client-cs",
                "code" : "OMBUDSOFFICE",
                "display" : "Ombuds Office"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "8-863110000012345"
            }
          },
          "altId" : "8-863110000012345",
          "name" : "Ombudsstelle einer Krankenkasse",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "AUDITSVC",
            "display" : "AuditEvent Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "AuditEvent",
          "description" : "renderAuditEventsToPDF"
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="c24dcb68-e61b-46fb-b11b-5f37dccf01f8"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2025-04-01T12:00:00.000Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="R"/>
      <recorded value="2025-04-01T12:00:00.000Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system
                    value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-agent-type-client-cs"/>
            <code value="OMBUDSOFFICE"/>
            <display value="Ombuds Office"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="8-863110000012345"/>
          </identifier>
        </who>
        <altId value="8-863110000012345"/>
        <name value="Ombudsstelle einer Krankenkasse"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="AUDITSVC"/>
          <display value="AuditEvent Service"/>
        </type>
      </source>
      <entity>
        <name value="AuditEvent"/>
        <description value="renderAuditEventsToPDF"/>
      </entity>
    </AuditEvent>

### Patient Service

Der Patient Service MUSS einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen und dabei folgende Wertebelegung berücksichtigen:

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.type | "rest" |
AuditEvent.action | U | Aktualisierung Basisdaten des Versicherten
AuditEvent.entity.name | Patient | Service Name
AuditEvent.entity.description | upsertPatient_PatientSvc | operationId der zu ausgeführten Operation

Tabelle: Patient Service - Protokollierung Änderungen der Patient Information

#### Beispiel AuditEvent für die Änderung der Patient-Information durch einen Kostenträger

    {
      "resourceType" : "AuditEvent",
      "id" : "2b2053e2-3e48-4f3d-880e-e8a1e9aa2f6b",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-01-31T01:17:12.359Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "U",
      "recorded" : "2026-01-31T01:17:12.359Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PAYOR",
                "display" : "invoice payor"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "8-863110000022741"
            }
          },
          "altId" : "8-863110000022741",
          "name" : "Name des Kostenträgers",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "PATSVC",
            "display" : "Patient Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "Patient",
          "description" : "upsertPatient"
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="2b2053e2-3e48-4f3d-880e-e8a1e9aa2f6b"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-01-31T01:17:12.359Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="U"/>
      <recorded value="2026-01-31T01:17:12.359Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PAYOR"/>
            <display value="invoice payor"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="8-863110000022741"/>
          </identifier>
        </who>
        <altId value="8-863110000022741"/>
        <name value="Name des Kostenträgers"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="PATSVC"/>
          <display value="Patient Service"/>
        </type>
      </source>
      <entity>
        <name value="Patient"/>
        <description value="upsertPatient"/>
      </entity>
    </AuditEvent>

### Medication Service

Der Medication Service MUSS einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen und dabei folgende Wertebelegung berücksichtigen:

Strukturelement [AuditEvent.] | Operationen der Operation API, Query API sowie Render API | Wert | Erläuterung
--- | --- | --- | ---
type |  | "rest" |
action | OperationId: providePrescription_MedicationSvc | "C" | Einstellen von Verschreibungsdaten
OperationId: provideDispensation_MedicationSvc | "C" | Einstellen einer Medikamentenabgabe
OperationId: cancelPrescription_MedicationSvc | "U" | Stornieren von Verschreibungsdaten
OperationId: cancelDispensation_MedicationSvc | "U" | Stornieren einer Medikamentenabgabe
OperationId: getMedicationList_MedicationSvc | "R" | Abruf der Medikationsliste
OperationId: renderMedicationListToHTML_MedicationSvc | "R" | Abruf der Medikationsliste im HTML-Format
OperationId: renderMedicationListToPDF_MedicationSvc | "R" | Abruf der Medikationsliste im PDF-Format
OperationId: listMedications_MedicationSvc | "R" | Abruf von Medikatimenteninformationen
OperationId: listMedicationDispenses_MedicationSvc | "R" | Abruf von Medikamentenabgabeinformationen
OperationId: listMedicationRequests_MedicationSvc | "R" | Abruf von Verschreibungsinformationen
OperationId: listMedicationStatements_MedicationSvc | "R" | Abruf von Medikationsinformationen
OperationId: listOrganizations_MedicationSvc | "R" | Abruf von Leistungserbringerinstitutionen
OperationId: listPractitioners_MedicationSvc | "R" | Abruf von Leistungserbringern
OperationId: listPractitionerRoles_MedicationSvc | "R" | Abruf von Zuordnungen von Leistungserbringenden zu Leistungserbringerinstitutionen
OperationId: listProvenances_MedicationSvc | "R" | Abruf von Änderungs- oder Medikationsplanchronologieeinträgen
OperationId: addEMLEntry_MedicationSvc | "C" | Eintrag in Medikationsliste hinzufügen
OperationId: cancelEMLEntry_MedicationSvc | "U" | Eintrag in Medikationsliste stornieren
OperationId: addEMPEntry_MedicationSvc | "C" | Eintrag in Medikationsplan hinzufügen
OperationId: updateEMPEntry_MedicationSvc | "U" | Eintrag in Medikationsplan aktualisieren
OperationId: linkEMP_MedicationSvc | "U" | Eintragsverknüpfung Medikationsplan/Medikationsliste
OperationId: unlinkEMP_MedicationSvc | "U" | Aufhebung Eintragsverknüpfung Medikationsplan/Medikationsliste
OperationId: renderMedicationPlanToPDF_MedicationSvc | "R" | Abruf des Medikationsplans im PDF-Format
OperationId: getMedicationPlan_MedicationSvc | "R" | Abruf des Medikationsplans
OperationId: getMedicationPlanChronologyLog_MedicationSvc | "R" | Abruf der Medikationsplanchronologie
OperationId: batchEMPEntries_MedicationSvc | "C" | Stapelbasierte Erstellung/Aktualisierung des Medikationsplans
entity.name |  | "Medication Service" | Service Name
entity.description |  | <operationId> | operationId der ausgeführten Operation
Nur bei FHIR Query API:
entity.detail.type |  | "search-parameters" |
entity.detail.value[x] |  | <ResourceType>?parameter1=<value>&parameter2=<value>& ...mehr | Suchkriterien in URL-Query-Notation

Tabelle: Medication Service - Protokollierung von Operations
Falls ein lesender Zugriff ("Read-Operation") durch den Versicherten erfolgt, DARF der Medication Service einen Protokolleintrag NICHT erzeugen.

Ereignisse, die gemäß [gemSpec_Aktensystem_ePAfueralle#A_26298] zu einer Übertragung neuer oder geänderter Daten an das Forschungsdatenzentrum (FDZ) führen, erzeugen grundsätzlich einen eigenen Protokolleintrag für den Vorgang gemäß der Vorgaben in IG-EPA14908QQV-*. Liegt kein Widerspruch des Versicherten gegen die Übermittlung der Daten an das FDZ vor und ist eine Übertragung der Daten des Ereignisses aufgrund der Pseudonymisierbarkeit dieser Daten möglich, so folgt auf das ursächliche Ereignis automatisch der Export der pseudonymisierten Daten.

Diese Übertragung der Daten muss für einen Versicherten aus der Protokollierung ersichtlich sein. Anstelle eines dedizierten Protokolleintrags für die Datenübertragung wird die Datenübertragung als ergänzendes entity.detail des auslösenden Ereignisses protokolliert. Aus dem Protokolleintrag des Ereignisses ist dann ersichtlich, ob die betroffenen Daten in pseudonymisierter Form auch der sekundären Datennutzung zugeführt wurden.

Der Medication Service MUSS einen Protokolleintrag gemäß A_24849* um das folgend aufgeführte `entity.detail` mit dem Wert `true` ergänzen, wenn aus der Operation eine Übertragung von Daten an das FDZ folgt. Diese Ergänzung MUSS entweder den Wert `false` haben oder entfallen, wenn aus der Operation keine Übertragung von Daten an das FDZ folgt.

Strukturelement | Wert | Erläuterung
--- | --- | ---
entity.detail.type | "data-submission" | Export an das Forschungsdatenzentrum
entity.detail.value[x] | "true" oder "false" |

Tabelle: Medication Service - Protokollierung der Verwendung für sekundäre Nutzungszwecke

#### Beispiel AuditEvent für den Medication Service beim Stornieren einer Dispensierung

    {
      "resourceType" : "AuditEvent",
      "id" : "669699b2-f131-4097-b13d-71413a58aa92",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2025-01-15T14:43:33.244Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "E",
      "recorded" : "2025-01-15T14:52:04.928Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://dicom.nema.org/resources/ontology/DCM",
                "code" : "110150",
                "display" : "Application"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "1-000000000000000"
            }
          },
          "altId" : "1-000000000000000",
          "name" : "E-Rezept-Fachdienst",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "MEDICATIONSVC",
            "display" : "Medication Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "Medication Service",
          "description" : "cancelDispensation_MedicationSvc"
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="669699b2-f131-4097-b13d-71413a58aa92"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2025-01-15T14:43:33.244Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="E"/>
      <recorded value="2025-01-15T14:52:04.928Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://dicom.nema.org/resources/ontology/DCM"/>
            <code value="110150"/>
            <display value="Application"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="1-000000000000000"/>
          </identifier>
        </who>
        <altId value="1-000000000000000"/>
        <name value="E-Rezept-Fachdienst"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="MEDICATIONSVC"/>
          <display value="Medication Service"/>
        </type>
      </source>
      <entity>
        <name value="Medication Service"/>
        <description value="cancelDispensation_MedicationSvc"/>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent des Medication Service für eine Suche

    {
      "resourceType" : "AuditEvent",
      "id" : "bbf292eb-665d-4724-a2bc-86fa93e89835",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2025-01-15T14:43:33.244Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "R",
      "recorded" : "2025-01-15T14:52:04.928Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PROV",
                "display" : "healthcare provider"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "1-883110000092404"
            }
          },
          "altId" : "1-883110000092404",
          "name" : "Praxis Dr. John Doe",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "MEDICATIONSVC",
            "display" : "Medication Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "Medication Service",
          "description" : "listMedicationRequests_MedicationSvc",
          "detail" : [
            {
              "type" : "search-parameters",
              "valueString" : "MedicationRequest?authoredon=2025-01-15&_revinclude=MedicationDispense:prescription"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="bbf292eb-665d-4724-a2bc-86fa93e89835"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2025-01-15T14:43:33.244Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="R"/>
      <recorded value="2025-01-15T14:52:04.928Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PROV"/>
            <display value="healthcare provider"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="1-883110000092404"/>
          </identifier>
        </who>
        <altId value="1-883110000092404"/>
        <name value="Praxis Dr. John Doe"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="MEDICATIONSVC"/>
          <display value="Medication Service"/>
        </type>
      </source>
      <entity>
        <name value="Medication Service"/>
        <description value="listMedicationRequests_MedicationSvc"/>
        <detail>
          <type value="search-parameters"/>
          <valueString
                       value="MedicationRequest?authoredon=2025-01-15&amp;_revinclude=MedicationDispense:prescription"/>
        </detail>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent für den Medication Service bei Verschreibungsdaten einstellen mit Datenübermittlung

    {
      "resourceType" : "AuditEvent",
      "id" : "15ad14c8-7fe4-479b-bd44-4bf0927b9478",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-09-17T12:07:21.117Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "E",
      "recorded" : "2026-09-17T12:07:21.117Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://dicom.nema.org/resources/ontology/DCM",
                "code" : "110150",
                "display" : "Application"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "1-000000000000000"
            }
          },
          "altId" : "1-000000000000000",
          "name" : "E-Rezept-Fachdienst",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "MEDICATIONSVC",
            "display" : "Medication Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "Medication Service",
          "description" : "providePrescription_MedicationSvc",
          "detail" : [
            {
              "type" : "data-submission",
              "valueString" : "true"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="15ad14c8-7fe4-479b-bd44-4bf0927b9478"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-09-17T12:07:21.117Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="E"/>
      <recorded value="2026-09-17T12:07:21.117Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://dicom.nema.org/resources/ontology/DCM"/>
            <code value="110150"/>
            <display value="Application"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="1-000000000000000"/>
          </identifier>
        </who>
        <altId value="1-000000000000000"/>
        <name value="E-Rezept-Fachdienst"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="MEDICATIONSVC"/>
          <display value="Medication Service"/>
        </type>
      </source>
      <entity>
        <name value="Medication Service"/>
        <description value="providePrescription_MedicationSvc"/>
        <detail>
          <type value="data-submission"/>
          <valueString value="true"/>
        </detail>
      </entity>
    </AuditEvent>

### MHD Service

Der MHD Service MUSS einen Protokolleintrag gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen und dabei folgende Wertebelegung berücksichtigen:

Strukturelement [AuditEvent.] | Operationen der FHIR Query API | Wert | Erläuterung
--- | --- | --- | ---
type |  | "rest" |
action | OperationId: findDocumentReferences_MHDSvc | "R" | Suche von Dokumenten
OperationId: retrieveDocument_MHDSvc | "R" | Abruf eines Dokuments
entity.name |  | "MHD Service" |
entity.description |  | <operationId> | operationId der ausgeführten Operation
entity.detail.type |  | "search-parameters" "file-name" | findDocumentReferences_MHDSvc retrieveDocument_MHDSvc
entity.detail.value[x] |  | <ResourceType>?parameter1=<value>&parameter2=<value> ...mehr | Suchkriterien in URL-Query-Notation (nur bei findDocumentReferences_MHDSvc) retrieveDocument_MHDSvc

Tabelle: MHD Service - Protokollierung MHD Operationen
Hinweis: Falls ein lesender Zugriff ("Read-Operation") durch den Versicherten erfolgt, DARF der MHD Service einen Protokolleintrag NICHT erzeugen.

#### Beispiel AuditEvent aus dem MHD-Service für eine Suche

    {
      "resourceType" : "AuditEvent",
      "id" : "b580f152-cf07-4ef4-aafb-e66c2da28f02",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-12-15T14:43:33.244Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "rest"
      },
      "action" : "R",
      "recorded" : "2026-12-15T14:43:33.244Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PROV",
                "display" : "healthcare provider"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "1-883110000092404"
            }
          },
          "altId" : "1-883110000092404",
          "name" : "Praxis Dr. John Doe",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "MHDSVC",
            "display" : "MHD Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "MHD Service",
          "description" : "findDocumentReferences_MHDSvc",
          "detail" : [
            {
              "type" : "search-parameters",
              "valueString" : "DocumentReference?patient.identifier=http://fhir.de/sid/gkv/kvid-10|G995030566&status=current&setting=http://www.ihe-d.de/fhir/CodeSystem/FachrichtungenAerztlich|ALL&_content=Kopf OR Zahl"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="b580f152-cf07-4ef4-aafb-e66c2da28f02"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-12-15T14:43:33.244Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="rest"/>
      </type>
      <action value="R"/>
      <recorded value="2026-12-15T14:43:33.244Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PROV"/>
            <display value="healthcare provider"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="1-883110000092404"/>
          </identifier>
        </who>
        <altId value="1-883110000092404"/>
        <name value="Praxis Dr. John Doe"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="MHDSVC"/>
          <display value="MHD Service"/>
        </type>
      </source>
      <entity>
        <name value="MHD Service"/>
        <description value="findDocumentReferences_MHDSvc"/>
        <detail>
          <type value="search-parameters"/>
          <valueString
                       value="DocumentReference?patient.identifier=http://fhir.de/sid/gkv/kvid-10|G995030566&amp;status=current&amp;setting=http://www.ihe-d.de/fhir/CodeSystem/FachrichtungenAerztlich|ALL&amp;_content=Kopf OR Zahl"/>
        </detail>
      </entity>
    </AuditEvent>

### XDS Document Service

Der XDS Document Service MUSS für die Operationen

- ProvideAndRegisterDocumentSet-b,
- RetrieveDocumentSet,
- RemoveMetadata,
- RegistryStoredQuery (entfällt, wenn Nutzung durch den Versicherten erfolgt)

Protokolleinträge gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen und dabei folgende Wertebelegung berücksichtigen:

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.type | "document" |
AuditEvent.action | C | Für ProvideAndRegisterDocumentSet-b ohne Replace-Option
U | Für ProvideAndRegisterDocumentSet-b mit Replace-Option
R | Für RegistryStoredQuery
R | Für RetrieveDocumentSet
D | Für Zugriffe mit RemoveMetadata
AuditEvent.entity.name | "XDS Document Service" | Service Name
AuditEvent.entity.description | <Operation> | ein Wert aus {ProvideAndRegisterDocumentSet-b, RetrieveDocumentSet, RemoveMetadata, RegistryStoredQuery}
Parameterwerte für die Operationen ProvideAndRegisterDocumentSet-b, RetrieveDocumentSet und RemoveMetadata
AuditEvent.entity.detail | type | value[x] |
"DocumentFormatCode" | <DocumentEntry.formatCode> | wenn in der entity Struktur ein XDSDocument beschrieben wird. kodiert als Datentyp "Coded String" gemäß [IHE-ITI- TF3]. Wenn es sich beim Wert von DocumentEntry.formatCode um den Code urn:ihe:iti:xds:2017:mimeTypeSufficient (Code System 1.3.6.1.4.1.19376.1.2.3) handelt, MUSS stattdessen der Wert von DocumentEntry.mimeType hier eingetragen werden.
"DocumentUniqueId" | <Document.uniqueId> | wenn in der entity Struktur ein XDSDocument beschrieben wird
"DocumentEntry.title" | <DocumentEntry.title> | wenn in der entity Struktur ein XDSDocument beschrieben wird
"Folder.title" | <Folder.title> | wenn in der entity Struktur ein XDSFolder beschrieben wird
"Folder.codeList" | <Folder.codeList> | wenn in der entity Struktur ein XDSFolder beschrieben wird kodiert als Datentyp "Coded String" gemäß [IHE-ITI-TF3] z.B. "pregnancy_childbirth^^^&1.2.276.0.76.5.512&ISO"
"Folder.entryUUID" | <Folder.entryUUID> | wenn in der entity Struktur ein XDSFolder beschrieben wird
Parameterwerte für die Operation RegistryStoredQuery der Schnittstellen I_Document_Management und I_Document_Management_Insurant (nur Vertreter)
AuditEvent.entity.detail | type | value[x] |
"QueryId" | <Parameter Query ID> | Der Wert MUSS der Parameter Query ID gemäß [IHE-ITI-TF2]#3.18.4.1.2.4 und für das Aktensystem definierten Anfragetypen entsprechen.

Tabelle: XDS Document Service - Protokollierung der Dokumentenoperationen

Hinweis: In der `AuditEvent.entity` Struktur sind Dokumente und/oder Folder zu berücksichtigen, die in der zu protokollierenden Operation referenziert werden.

Der XDS Document Service MUSS für die Operationen RestrictedUpdateDocumentSet Protokolleinträge gemäß [gemIG_ePA_Basic#IG-EPA90980V11] erzeugen und dabei folgende Wertebelegung berücksichtigen:

Strukturelement | Wert | Erläuterung
--- | --- | ---
AuditEvent.type | "document" |
AuditEvent.action | U |
AuditEvent.entity |  | Kann gemäß folgender Regeln mehrfach vorhanden sein
AuditEvent.entity.name | "XDS Document Service" | Service Name
AuditEvent.entity.description | "RestrictedUpdateDocumentSet" | Id der Operation
AuditEvent.entity.detail | type | value[x] |
"DocumentTitle" | <Titel des Dokuments> | Titel des betroffenen Dokuments. Dieser Eintrag ist pro entity einmal vorhanden und identisch in allen verwendeten entity des AuditEvents
geänderte Metadaten in jeweils einem `detail` | die geänderten Metadaten gemäß folgender Regeln

Tabelle: XDS Document Service - Protokollierung der Operation RestrictedUpdateDocumentSet

Nr. | Regeln für die Befüllung | Beispiel
--- | --- | ---
1 | Alle geänderten Metadaten MÜSSEN mit altem und neuem Wert in je einem `AuditEvent.entity.detail` protokolliert werden. Der Parameter `detail.type` enthält ein Kompositum aus Objekt (Document) und Attribut in Groß/Kleinschreibung (CamelCase). Einem alten Wert wird zusätzlich der Präfix "prev" vorangestellt. | "DocumentEntry.formatCode" wird zu "DocumentFormatCode", bzw. "prevDocumentFormatCode"
2 | Attributunterstrukturen werden ebenfalls in Groß/Kleinschreibung (CamelCase) erstellt. | "DocumentEntry.authorPerson" wird zu "DocumentAuthorPerson", bzw. "prevDocumentAuthorPerson"
3 | Das `detail.value[x]` (valueString) ist mit dem jeweiligen Wert zu belegen. Das Format der Zeichenkette entspricht der des Metadatums | Kann gemäß folgender Regeln mehrfach vorhanden sein
4 | Jede `AuditEvent.entity` MUSS ein detail mit dem Titel des betroffenen Dokuments enthalten ("DocumentTitle"), um den Bezug der | "DocumentTitle" | "Titel des Dokuments"
5 | Ist der Dokumententitel selbst Bestandteil der Änderung der Metadaten, MUSS dieses detail den neuen Titel des Dokuments enthalten (Das `entity.detail` zu "DocumentTitle" wird innerhalb einer `entity` nicht mehrfach aufgeführt). |
6 | Werden mehrere gleichartige Metadaten geändert, so MÜSSEN diese in jeweils einem eigenen `entity.detail` erfasst werden. |
7 | Eine geänderte Reihenfolge gleichartiger Metadaten ist keine Änderung der Metadaten und wird nicht protokolliert. |
8 | Erfolgen Änderungen an Attributunterstrukturen, deren übergreifendes Attribut eine Kardinalität (u .. v) mit v-u > 1 aufweist, so MÜSSEN die einzelnen Instanzen des übergreifenden Attributs in jeweils einer eigenen `AuditEvent.entity` erfasst werden. | Diese Regel ist bei Änderungen an Unterstrukturen zu "author" anzuwenden
9 | Werden mehrere `AuditEvent.entity` zur Separation von Instanzen übergreifender Attribute für die Protokollierung verwendet, dann MUSS in jeder dieser `AuditEvent.entity` die gleiche Angabe zu `name` und `description` enthalten sein |
10 | Werden mehrere `AuditEvent.entity` zur Separation von Instanzen übergreifender Attribute für die Protokollierung verwendet, dann MÜSSEN alle Änderungen an Metadaten (`detail`) ohne Bezug auf das übergreifende Attribut innerhalb der gleichen `AuditEvent.entity` aufgeführt werden. |
11 | Werden durch eine Operation die Metadaten mehrerer Dokumente verändert, dann MUSS pro Dokument mindestens eine `AuditEvent.entity`, im Bedarfsfall aufgrund von Änderungen an übergreifenden Attributen auch mehrere (siehe Regel Nr. 8), angelegt werden. `AuditEvent.entity` des gleichen Dokuments MÜSSEN im `AuditEvent` aufeinanderfolgen |

Tabelle: Regeln für die Protokollierung der Operation RestrictedUpdateDocumentSet

Hinweis zur Protokollierung der Operation RestrictedUpdateDocumentSet:
Ein Protokolleintrag für eine Operation RestrictedUpdateDocumentSet enthält in der Regel genau einen Eintrag `AuditEvent.entity` und darin die Liste der (`type` | `value`)-Pärchen mit den Änderungen an Metadaten in `entity.detail`, inklusive eines Eintrags für den Dokumententitel des betroffenen Dokuments. Als übergreifendes Attribut gibt es derzeit unter den änderbaren Metadaten nur das Attribut “author”. Dieses ist selbst kein änderbares Metadatum, sonder dient der Gruppierung der untergeordneten Metadaten (beispielsweise “authorPerson” oder “authorSpeciality”). Hat ein Dokument mehr als einen “author” (Instanz) zugeordnet, so muss im Protokoll der Bezug der Metadatenänderung eines “author” zu seiner Instanz erkennbar sein. Dieses wird durch die Verwendung einer jeweils eigenen `AuditEvent.entity` zu Separation ermöglicht.

Hinweis zur Protokollierung RestrictedUpdateDocumentSet:
Bei Änderungen von Metadaten eines übergreifenden Attributs (hier “author”) wird immer der vollständige Satz der resultierenden Attributunterstrukturen in der Operation angegeben (beispielsweise “authorPerson”, “authorSpeciality” und andere), auch wenn diese bisher schon vorhanden sind. Ein AuditEvent kann dann in zwei Varianten erstellt werden:

- Kurzform: In der `AuditEvent.entity` für die betroffene "author"-Instanz sind nur die tatsächlich geänderten Metadaten aufgeführt (Metadatum + prevMetadatum).
- Langform: Die Operation wird als vollständiger Austausch eines oder mehrerer "author"-Instanzen betrachtet. Es sind dann je eine `AuditEvent.entity` pro bisherigem "author" zu verwenden (nur prevMetadatum, alle Metadaten zu dieser "author"-Instanz werden entfernt) und je eine `AuditEvent.entity` pro "author" aus der Operation (nur Metadaten, alle Metadaten zu dieser "author"-Instanz kommen neu hinzu).

Die Auswahl der Variante obliegt dem realisierenden System.

Werden mehrere XDS Dokumente bzw Folder in der zu protokollierenden Operation referenziert und die Zugriffe sind gleicher Art (AuditEvent.action) KANN der XDS Document Service einen Protokolleintrag erzeugen, der mehreren AuditEvent.entity Strukturen enthält.

Das bedeutet, wenn in einer ProvideAndRegisterDocumentSet-b Operation zehn Dokumente eingestellt werden, kann für diesen Zugriff ein AuditEvent mit zehn Entity Strukturen erzeugt werden. Werden zehn Dokumente eingestellt und das zehnte Dokument ersetzt ein bereits vorhandenes, kann in einem Protokolleintrag das Einstellen (Create) mit neun Entity Strukturen dokumentiert und muss in einem weiteren Protokolleintrag ein Ersetzen (Update) (zehnte Dokument) protokolliert werden.

Werden mit der Operation RestrictedUpdateDocumentSet keine geänderten Metadaten eines referenzierten DocumentEntry gesendet, d.h. die gesendeten Metadateninhalte unterscheiden sich nicht von bereits persistierten Werten, DARF der XDS Document Service diesen Zugriff NICHT protokollieren.

#### Beispiel AuditEvent für eine XDS-Dokumentservice-Operation, bei der ein Dokument hinzugefügt wird

    {
      "resourceType" : "AuditEvent",
      "id" : "86604fc1-b356-57e3-8738-8ef36c8d608c",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2025-01-15T14:43:33.244Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "document"
      },
      "action" : "U",
      "recorded" : "2025-01-15T14:52:04.928Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PROV",
                "display" : "healthcare provider"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "1-883110000092404"
            }
          },
          "altId" : "1-883110000092404",
          "name" : "Praxis Dr. John Doe",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "XDSSVC",
            "display" : "XDS Document Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "XDS Document Service",
          "description" : "ProvideAndRegisterDocumentSet-b",
          "detail" : [
            {
              "type" : "DocumentFormatCode",
              "valueString" : "urn:gematik:ig:Arztbrief:r3.1"
            },
            {
              "type" : "DocumentEntryTitle",
              "valueString" : "Arztbrief4711"
            },
            {
              "type" : "DocumentUniqueId",
              "valueString" : "187432aa-0d3f-4202-9ec5-a7e001855a3c"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="86604fc1-b356-57e3-8738-8ef36c8d608c"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2025-01-15T14:43:33.244Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="document"/>
      </type>
      <action value="U"/>
      <recorded value="2025-01-15T14:52:04.928Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PROV"/>
            <display value="healthcare provider"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="1-883110000092404"/>
          </identifier>
        </who>
        <altId value="1-883110000092404"/>
        <name value="Praxis Dr. John Doe"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="XDSSVC"/>
          <display value="XDS Document Service"/>
        </type>
      </source>
      <entity>
        <name value="XDS Document Service"/>
        <description value="ProvideAndRegisterDocumentSet-b"/>
        <detail>
          <type value="DocumentFormatCode"/>
          <valueString value="urn:gematik:ig:Arztbrief:r3.1"/>
        </detail>
        <detail>
          <type value="DocumentEntryTitle"/>
          <valueString value="Arztbrief4711"/>
        </detail>
        <detail>
          <type value="DocumentUniqueId"/>
          <valueString value="187432aa-0d3f-4202-9ec5-a7e001855a3c"/>
        </detail>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent für einen EU-Zugriff mit Dokumentabruf

    {
      "resourceType" : "AuditEvent",
      "id" : "589b9862-7935-42f5-a06b-11a6f35833ee",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-11-02T12:05:13.117Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "document"
      },
      "action" : "R",
      "recorded" : "2026-11-02T12:05:13.117Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://dicom.nema.org/resources/ontology/DCM",
                "code" : "110150",
                "display" : "Application"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "9-000000000000000"
            }
          },
          "altId" : "9-000000000000000",
          "name" : "Portugal",
          "requestor" : true
        },
        {
          "extension" : [
            {
              "url" : "https://gematik.de/fhir/epa/StructureDefinition/epa-healthcare-facility-type-extension",
              "valueCoding" : {
                "system" : "urn:oid:2.16.840.1.113883.2.9.6.2.7",
                "code" : "221",
                "display" : "Medical Doctors"
              }
            }
          ],
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PROV",
                "display" : "healthcare provider"
              }
            ]
          },
          "role" : [
            {
              "coding" : [
                {
                  "system" : "urn:oid:1.3.6.1.4.1.12559.11.10.1.3.2.2.2",
                  "code" : "Resident Physician",
                  "display" : "Resident Physician"
                }
              ]
            }
          ],
          "name" : "Dr. Manuel Dos Santos / Clínica de Dos Santos",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "XDSSVC",
            "display" : "XDS Document Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "XDS Document Service",
          "description" : "RetrieveDocumentSet",
          "detail" : [
            {
              "type" : "DocumentFormatCode",
              "valueString" : "urn:gematik:ig:pka:v1.0"
            },
            {
              "type" : "DocumentEntryTitle",
              "valueString" : "Patient Summary"
            },
            {
              "type" : "DocumentUniqueId",
              "valueString" : "e196c836-c8c3-47ae-9b9a-7124cbfef42f"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="589b9862-7935-42f5-a06b-11a6f35833ee"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-11-02T12:05:13.117Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="document"/>
      </type>
      <action value="R"/>
      <recorded value="2026-11-02T12:05:13.117Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://dicom.nema.org/resources/ontology/DCM"/>
            <code value="110150"/>
            <display value="Application"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="9-000000000000000"/>
          </identifier>
        </who>
        <altId value="9-000000000000000"/>
        <name value="Portugal"/>
        <requestor value="true"/>
      </agent>
      <agent>
        <extension
                   url="https://gematik.de/fhir/epa/StructureDefinition/epa-healthcare-facility-type-extension">
          <valueCoding>
            <system value="urn:oid:2.16.840.1.113883.2.9.6.2.7"/>
            <code value="221"/>
            <display value="Medical Doctors"/>
          </valueCoding>
        </extension>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PROV"/>
            <display value="healthcare provider"/>
          </coding>
        </type>
        <role>
          <coding>
            <system value="urn:oid:1.3.6.1.4.1.12559.11.10.1.3.2.2.2"/>
            <code value="Resident Physician"/>
            <display value="Resident Physician"/>
          </coding>
        </role>
        <name value="Dr. Manuel Dos Santos / Clínica de Dos Santos"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="XDSSVC"/>
          <display value="XDS Document Service"/>
        </type>
      </source>
      <entity>
        <name value="XDS Document Service"/>
        <description value="RetrieveDocumentSet"/>
        <detail>
          <type value="DocumentFormatCode"/>
          <valueString value="urn:gematik:ig:pka:v1.0"/>
        </detail>
        <detail>
          <type value="DocumentEntryTitle"/>
          <valueString value="Patient Summary"/>
        </detail>
        <detail>
          <type value="DocumentUniqueId"/>
          <valueString value="e196c836-c8c3-47ae-9b9a-7124cbfef42f"/>
        </detail>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent für die Änderung der Metadaten eines XDS Dokuments

    {
      "resourceType" : "AuditEvent",
      "id" : "b5bd972a-39e0-4a19-a361-6b94b99d74d1",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-08-11T09:43:12.174Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "document"
      },
      "action" : "U",
      "recorded" : "2026-08-11T09:43:12.174Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PROV",
                "display" : "healthcare provider"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "1-883110000092404"
            }
          },
          "altId" : "1-883110000092404",
          "name" : "Praxis Dr. John Doe",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "XDSSVC",
            "display" : "XDS Document Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "XDS Document Service",
          "description" : "RestrictedUpdateDocumentSet",
          "detail" : [
            {
              "type" : "DocumentTitle",
              "valueString" : "Arztbrief0815 von Dr. Doe"
            },
            {
              "type" : "prevDocumentClassCode",
              "valueString" : "DOK^^^&urn:oid:1.3.6.1.4.1.19376.3.276.1.5.8&ISO"
            },
            {
              "type" : "DocumentClassCode",
              "valueString" : "BRI^^^&urn:oid:1.3.6.1.4.1.19376.3.276.1.5.8&ISO"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="b5bd972a-39e0-4a19-a361-6b94b99d74d1"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-08-11T09:43:12.174Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="document"/>
      </type>
      <action value="U"/>
      <recorded value="2026-08-11T09:43:12.174Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PROV"/>
            <display value="healthcare provider"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="1-883110000092404"/>
          </identifier>
        </who>
        <altId value="1-883110000092404"/>
        <name value="Praxis Dr. John Doe"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="XDSSVC"/>
          <display value="XDS Document Service"/>
        </type>
      </source>
      <entity>
        <name value="XDS Document Service"/>
        <description value="RestrictedUpdateDocumentSet"/>
        <detail>
          <type value="DocumentTitle"/>
          <valueString value="Arztbrief0815 von Dr. Doe"/>
        </detail>
        <detail>
          <type value="prevDocumentClassCode"/>
          <valueString
                       value="DOK^^^&amp;urn:oid:1.3.6.1.4.1.19376.3.276.1.5.8&amp;ISO"/>
        </detail>
        <detail>
          <type value="DocumentClassCode"/>
          <valueString
                       value="BRI^^^&amp;urn:oid:1.3.6.1.4.1.19376.3.276.1.5.8&amp;ISO"/>
        </detail>
      </entity>
    </AuditEvent>

#### Beispiel AuditEvent für die Änderung an mehreren ‘author’ Metadaten eines XDS Dokuments

Hinweis: Für das Beispiel wird angenommen, dass eine Zuordnung der ‘author’-Inhalte aus der Operation zu den hinterlegten ‘author’-Daten möglich ist (z.B.: anhand der ebRIM ‘author’ Classification)

    {
      "resourceType" : "AuditEvent",
      "id" : "2b503f39-9c66-40e2-8f93-260b70c7020b",
      "meta" : {
        "versionId" : "1",
        "lastUpdated" : "2026-08-11T10:01:43.903Z",
        "profile" : [
          🔗 "https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"
        ]
      },
      "type" : {
        "system" : "http://terminology.hl7.org/CodeSystem/audit-event-type",
        "code" : "document"
      },
      "action" : "U",
      "recorded" : "2026-08-11T10:01:43.903Z",
      "outcome" : "0",
      "agent" : [
        {
          "type" : {
            "coding" : [
              {
                "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
                "code" : "PROV",
                "display" : "healthcare provider"
              }
            ]
          },
          "who" : {
            "identifier" : {
              "system" : "https://gematik.de/fhir/sid/telematik-id",
              "value" : "1-883110000092404"
            }
          },
          "altId" : "1-883110000092404",
          "name" : "Praxis Dr. John Doe",
          "requestor" : true
        }
      ],
      "source" : {
        "observer" : {
          "display" : "Elektronische Patientenakte Fachdienst"
        },
        "type" : [
          {
            "system" : "https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs",
            "code" : "XDSSVC",
            "display" : "XDS Document Service"
          }
        ]
      },
      "entity" : [
        {
          "name" : "XDS Document Service",
          "description" : "RestrictedUpdateDocumentSet",
          "detail" : [
            {
              "type" : "DocumentTitle",
              "valueString" : "Arztbrief0815 von Dr. Doe"
            },
            {
              "type" : "DocumentAuthorSpecialilty",
              "valueString" : "071002^^^&urn:oid:1.2.276.0.76.5.514&ISO"
            },
            {
              "type" : "DocumentAuthorPerson",
              "valueString" : "^Doe^John^^^Dr"
            },
            {
              "type" : "prevDocumentClassCode",
              "valueString" : "DOK^^^&urn:oid:1.3.6.1.4.1.19376.3.276.1.5.8&ISO"
            },
            {
              "type" : "DocumentClassCode",
              "valueString" : "BRI^^^&urn:oid:1.3.6.1.4.1.19376.3.276.1.5.8&ISO"
            }
          ]
        },
        {
          "name" : "XDS Document Service",
          "description" : "RestrictedUpdateDocumentSet",
          "detail" : [
            {
              "type" : "DocumentTitle",
              "valueString" : "Arztbrief0815 von Dr. Doe"
            },
            {
              "type" : "prevDocumentAuthorSpecialilty",
              "valueString" : "201001^^^&urn:oid:1.2.276.0.76.5.514&ISO"
            }
          ]
        },
        {
          "name" : "XDS Document Service",
          "description" : "RestrictedUpdateDocumentSet",
          "detail" : [
            {
              "type" : "DocumentTitle",
              "valueString" : "Arztbrief0815 von Dr. Doe"
            },
            {
              "type" : "DocumentAuthorPerson",
              "valueString" : "^Doe-Mustermann^Jane^^^Dr"
            },
            {
              "type" : "prevDocumentAuthorPerson",
              "valueString" : "^Mustermann^Jane^^^Dr"
            }
          ]
        }
      ]
    }

    <AuditEvent xmlns="http://hl7.org/fhir">
      <id value="2b503f39-9c66-40e2-8f93-260b70c7020b"/>
      <meta>
        <versionId value="1"/>
        <lastUpdated value="2026-08-11T10:01:43.903Z"/>
        <profile
                 value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent|1.3.0"/>
      </meta>
      <type>
        <system value="http://terminology.hl7.org/CodeSystem/audit-event-type"/>
        <code value="document"/>
      </type>
      <action value="U"/>
      <recorded value="2026-08-11T10:01:43.903Z"/>
      <outcome value="0"/>
      <agent>
        <type>
          <coding>
            <system value="http://terminology.hl7.org/CodeSystem/v3-RoleClass"/>
            <code value="PROV"/>
            <display value="healthcare provider"/>
          </coding>
        </type>
        <who>
          <identifier>
            <system value="https://gematik.de/fhir/sid/telematik-id"/>
            <value value="1-883110000092404"/>
          </identifier>
        </who>
        <altId value="1-883110000092404"/>
        <name value="Praxis Dr. John Doe"/>
        <requestor value="true"/>
      </agent>
      <source>
        <observer>
          <display value="Elektronische Patientenakte Fachdienst"/>
        </observer>
        <type>
          <system
                  value="https://gematik.de/fhir/epa/CodeSystem/epa-auditevent-sourcetype-cs"/>
          <code value="XDSSVC"/>
          <display value="XDS Document Service"/>
        </type>
      </source>
      <entity>
        <name value="XDS Document Service"/>
        <description value="RestrictedUpdateDocumentSet"/>
        <detail>
          <type value="DocumentTitle"/>
          <valueString value="Arztbrief0815 von Dr. Doe"/>
        </detail>
        <detail>
          <type value="DocumentAuthorSpecialilty"/>
          <valueString value="071002^^^&amp;urn:oid:1.2.276.0.76.5.514&amp;ISO"/>
        </detail>
        <detail>
          <type value="DocumentAuthorPerson"/>
          <valueString value="^Doe^John^^^Dr"/>
        </detail>
        <detail>
          <type value="prevDocumentClassCode"/>
          <valueString
                       value="DOK^^^&amp;urn:oid:1.3.6.1.4.1.19376.3.276.1.5.8&amp;ISO"/>
        </detail>
        <detail>
          <type value="DocumentClassCode"/>
          <valueString
                       value="BRI^^^&amp;urn:oid:1.3.6.1.4.1.19376.3.276.1.5.8&amp;ISO"/>
        </detail>
      </entity>
      <entity>
        <name value="XDS Document Service"/>
        <description value="RestrictedUpdateDocumentSet"/>
        <detail>
          <type value="DocumentTitle"/>
          <valueString value="Arztbrief0815 von Dr. Doe"/>
        </detail>
        <detail>
          <type value="prevDocumentAuthorSpecialilty"/>
          <valueString value="201001^^^&amp;urn:oid:1.2.276.0.76.5.514&amp;ISO"/>
        </detail>
      </entity>
      <entity>
        <name value="XDS Document Service"/>
        <description value="RestrictedUpdateDocumentSet"/>
        <detail>
          <type value="DocumentTitle"/>
          <valueString value="Arztbrief0815 von Dr. Doe"/>
        </detail>
        <detail>
          <type value="DocumentAuthorPerson"/>
          <valueString value="^Doe-Mustermann^Jane^^^Dr"/>
        </detail>
        <detail>
          <type value="prevDocumentAuthorPerson"/>
          <valueString value="^Mustermann^Jane^^^Dr"/>
        </detail>
      </entity>
    </AuditEvent>

### Spezieller Ordner “technical”

Der XDS Document Service DARF Zugriffe auf den statischen Ordner "technical" oder dessen Inhalte NICHT protokollieren. Der XDS Document Service MUSS Nutzerzugriffe auf den Ordner "technical" dann protokollieren, wenn durch den Zugriff Dokumente Protokolldokumente einer ePA-2.6 Aktenkontomigration betroffen sind. Diese Protokollierung MUSS gemäß der Vorgaben in IG-EPA81505MFF-* erfolgen.