Implementation Guide
ePA Basisfunktionalitäten
Version 1.3.0 - 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"
purposeOfEvent Zweck(e) des protokollierten Ereignisses gemäß des zulässigen Value Set; nur zu belegen, wenn explizit bei entsprechender Protokollierungsanforderung gefordert
system Das verwendete Code System "https://gematik.de/fhir/epa/ValueSet/epa-auditevent-purpose-of-event-vs"
code Der verwendete Code aus dem Code System "EXPORTFDZ"
display Der Bezeichner zur Anzeige aus dem Code System "Export für das Forschungsdatenzentrum Gesundheit"
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
  1. "E-Rezept-Fachdienst"
  2. "Elektronische Patientenakte Fachdienst"
  3. "Portugal" (Beispiel EU-Zugriff)
requestor Fest vorgegebener Wert "false" "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>
  1. "2-121212121212121"
  2. "Z123456789"
agent[user]. altId <value> aus agent.who.identifier
  1. "2-121212121212121"
  2. "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 "false" 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 "false" "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 Prozessen.

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 - Fehler

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:

<tr valign=" </tr>
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

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 entsprechend der Protokollierungsregeln für das Objekt protokollieren, wobei für
  • agent.type und source.type "HRRSVC"  (Health Record Relocation Service), für
  • entity.name= "SystemMerge" und für
  • entity.description="startPackageMergeImport" 
zu nutzen ist.

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:

  • detail.type="System-Zusammenführung",
  • detail.valueString="true"

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.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

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>


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 - Widersprüche für 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 - Widersprüche zu Sekundärnutzungszwecken

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-Decision-Management-Protokollierung - User Specific Deny Policy Medication

{
  "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

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

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

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

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

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

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 FDZ

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

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

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 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.