Implementation Guide
ePA Basisfunktionalitäten
Version 1.2.0-ballot.1 - draft

: Capability Statement für Clients des ePA Audit Event Service - XML Representation

Draft as of 2025-08-01

Raw xml | Download


<CapabilityStatement xmlns="http://hl7.org/fhir">
  <id value="epa-audit-event-client"/>
  <meta>
    <profile
             value="https://gematik.de/fhir/ti/StructureDefinition/ti-capability-statement"/>
  </meta>
  <extension
             url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-header">
    <extension url="name">
      <valueString value="X-Request-ID"/>
    </extension>
    <extension url="type">
      <valueString value="string"/>
    </extension>
    <extension url="description">
      <valueString value="UUID of the request message"/>
    </extension>
    <extension url="format">
      <valueString value="uuid"/>
    </extension>
    <extension url="required">
      <valueBoolean value="false"/>
    </extension>
  </extension>
  <extension
             url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-header">
    <extension url="name">
      <valueString value="x-insurantid"/>
    </extension>
    <extension url="type">
      <valueString value="string"/>
    </extension>
    <extension url="description">
      <valueString value="Health Record Identifier"/>
    </extension>
    <extension url="pattern">
      <valueString value="^[A-Z]{1}\d{9}$"/>
    </extension>
    <extension url="required">
      <valueBoolean value="true"/>
    </extension>
  </extension>
  <extension
             url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-header">
    <extension url="name">
      <valueString value="x-useragent"/>
    </extension>
    <extension url="type">
      <valueString value="string"/>
    </extension>
    <extension url="description">
      <valueString value="user agent information"/>
    </extension>
    <extension url="pattern">
      <valueString value="^[a-zA-Z0-9]{20}\/[a-zA-Z0-9\-\.]{1,15}$"/>
    </extension>
    <extension url="required">
      <valueBoolean value="true"/>
    </extension>
  </extension>
  <extension
             url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
    <extension url="statusCode">
      <valueString value="403"/>
    </extension>
    <extension url="description">
      <valueString
                   value="Requestor not authorized (no user session with valid ID-Token available)"/>
    </extension>
    <extension url="responseType">
      <valueString value="application/json"/>
    </extension>
    <extension url="errorCode">
      <valueString value="invalAuth"/>
    </extension>
  </extension>
  <extension
             url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
    <extension url="statusCode">
      <valueString value="403"/>
    </extension>
    <extension url="description">
      <valueString value="Requestor has no valid entitlement"/>
    </extension>
    <extension url="responseType">
      <valueString value="application/json"/>
    </extension>
    <extension url="errorCode">
      <valueString value="notEntitled"/>
    </extension>
  </extension>
  <extension
             url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
    <extension url="statusCode">
      <valueString value="403"/>
    </extension>
    <extension url="description">
      <valueString
                   value="Requestor role is not in the list of allowed user groups"/>
    </extension>
    <extension url="responseType">
      <valueString value="application/json"/>
    </extension>
    <extension url="errorCode">
      <valueString value="invalidOid"/>
    </extension>
  </extension>
  <extension
             url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
    <extension url="statusCode">
      <valueString value="403"/>
    </extension>
    <extension url="description">
      <valueString
                   value="Device registration does not exist (if requestor role is oid_versicherter only)"/>
    </extension>
    <extension url="responseType">
      <valueString value="application/json"/>
    </extension>
    <extension url="errorCode">
      <valueString value="unregisteredDevice"/>
    </extension>
  </extension>
  <extension
             url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
    <extension url="statusCode">
      <valueString value="404"/>
    </extension>
    <extension url="description">
      <valueString value="Health record is in state UNKNOWN or INITIALIZED"/>
    </extension>
    <extension url="responseType">
      <valueString value="application/json"/>
    </extension>
    <extension url="errorCode">
      <valueString value="noHealthRecord"/>
    </extension>
  </extension>
  <extension
             url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
    <extension url="statusCode">
      <valueString value="409"/>
    </extension>
    <extension url="description">
      <valueString
                   value="Health record is in state SUSPENDED or MAINTENANCE"/>
    </extension>
    <extension url="responseType">
      <valueString value="application/json"/>
    </extension>
    <extension url="errorCode">
      <valueString value="statusMismatch"/>
    </extension>
  </extension>
  <extension
             url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
    <extension url="statusCode">
      <valueString value="500"/>
    </extension>
    <extension url="description">
      <valueString value="Any other error"/>
    </extension>
    <extension url="responseType">
      <valueString value="application/json"/>
    </extension>
    <extension url="errorCode">
      <valueString value="internalError"/>
    </extension>
  </extension>
  <extension
             url="https://gematik.de/fhir/ti/StructureDefinition/extension-base-url">
    <valueString value="http://epa4all/epa/audit/api/v1/fhir"/>
  </extension>
  <url
       value="https://gematik.de/fhir/epa/CapabilityStatement/epa-audit-event-client"/>
  <version value="1.2.0-ballot.1"/>
  <name value="EPAAuditEventClient"/>
  <title
         value="Capability Statement für Clients des ePA Audit Event Service"/>
  <status value="draft"/>
  <date value="2025-08-01"/>
  <publisher value="gematik GmbH"/>
  <contact>
    <telecom>
      <system value="url"/>
      <value value="https://www.gematik.de"/>
    </telecom>
  </contact>
  <description
               value="Dieses Capability Statement legt die Anforderungen an ePA Clients fest, die den Audit Event Service der verwenden. Es definiert die unterstützten Interaktionen, erforderliche HTTP Header sowie erwartete Statuscodes."/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="DE"/>
    </coding>
  </jurisdiction>
  <kind value="requirements"/>
  <imports
           value="https://gematik.de/fhir/epa/CapabilityStatement/epa-basic-client">🔗 
    <extension
               url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
      <valueCode value="SHALL"/>
    </extension>
  </imports>
  <fhirVersion value="4.0.1"/>
  <format value="application/fhir+json"/>
  <format value="application/fhir+xml"/>
  <rest>
    <mode value="client"/>
    <resource>
      <extension
                 url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
        <valueCode value="SHALL"/>
      </extension>
      <type value="AuditEvent"/>
      <profile
               value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent">🔗 
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHALL"/>
        </extension>
      </profile>
      <supportedProfile
                        value="https://gematik.de/fhir/epa/StructureDefinition/epa-auditevent">🔗 
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHALL"/>
        </extension>
      </supportedProfile>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHALL"/>
        </extension>
        <extension
                   url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
          <extension url="statusCode">
            <valueString value="200"/>
          </extension>
          <extension url="description">
            <valueString value="Successful operation"/>
          </extension>
        </extension>
        <extension
                   url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
          <extension url="statusCode">
            <valueString value="400"/>
          </extension>
          <extension url="description">
            <valueString value="Unknown search parameter"/>
          </extension>
          <extension url="responseType">
            <valueString value="TIOperationOutcome"/>
          </extension>
          <extension url="errorCode">
            <valueString value="MSG_PARAM_UNKNOWN"/>
          </extension>
        </extension>
        <extension
                   url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
          <extension url="statusCode">
            <valueString value="400"/>
          </extension>
          <extension url="description">
            <valueString value="Invalid query parameter(s)"/>
          </extension>
          <extension url="responseType">
            <valueString value="TIOperationOutcome"/>
          </extension>
          <extension url="errorCode">
            <valueString value="MSG_BAD_SYNTAX"/>
          </extension>
        </extension>
        <extension
                   url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
          <extension url="statusCode">
            <valueString value="400"/>
          </extension>
          <extension url="description">
            <valueString value="Invalid request"/>
          </extension>
          <extension url="responseType">
            <valueString value="TIOperationOutcome"/>
          </extension>
          <extension url="errorCode">
            <valueString value="MSG_BAD_FORMAT"/>
          </extension>
        </extension>
        <extension
                   url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
          <extension url="statusCode">
            <valueString value="404"/>
          </extension>
          <extension url="description">
            <valueString value="Unknown resource type"/>
          </extension>
          <extension url="responseType">
            <valueString value="TIOperationOutcome"/>
          </extension>
          <extension url="errorCode">
            <valueString value="MSG_UNKNOWN_TYPE"/>
          </extension>
        </extension>
        <code value="search-type"/>
      </interaction>
      <interaction>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="SHALL"/>
        </extension>
        <extension
                   url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
          <extension url="statusCode">
            <valueString value="200"/>
          </extension>
          <extension url="description">
            <valueString value="Successful operation"/>
          </extension>
        </extension>
        <extension
                   url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
          <extension url="statusCode">
            <valueString value="400"/>
          </extension>
          <extension url="description">
            <valueString value="Invalid request"/>
          </extension>
          <extension url="responseType">
            <valueString value="TIOperationOutcome"/>
          </extension>
          <extension url="errorCode">
            <valueString value="MSG_BAD_FORMAT"/>
          </extension>
        </extension>
        <extension
                   url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
          <extension url="statusCode">
            <valueString value="404"/>
          </extension>
          <extension url="description">
            <valueString value="Unknown resource type"/>
          </extension>
          <extension url="responseType">
            <valueString value="TIOperationOutcome"/>
          </extension>
          <extension url="errorCode">
            <valueString value="MSG_UNKNOWN_TYPE"/>
          </extension>
        </extension>
        <extension
                   url="https://gematik.de/fhir/ti/StructureDefinition/extension-http-response-info">
          <extension url="statusCode">
            <valueString value="404"/>
          </extension>
          <extension url="description">
            <valueString value="Resource is not known"/>
          </extension>
          <extension url="responseType">
            <valueString value="TIOperationOutcome"/>
          </extension>
          <extension url="errorCode">
            <valueString value="MSG_RESOURCE_ID_FAIL"/>
          </extension>
        </extension>
        <code value="read"/>
      </interaction>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="MAY"/>
        </extension>
        <name value="_id"/>
        <definition value="http://hl7.org/fhir/SearchParameter/Resource-id"/>
        <type value="token"/>
        <documentation value="Resource.id"/>
      </searchParam>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="MAY"/>
        </extension>
        <name value="_lastUpdated"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/Resource-lastUpdated"/>
        <type value="date"/>
        <documentation value="Resource.meta.lastUpdated"/>
      </searchParam>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="MAY"/>
        </extension>
        <name value="action"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/AuditEvent-action"/>
        <type value="token"/>
        <documentation value="AuditEvent.action"/>
      </searchParam>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="MAY"/>
        </extension>
        <name value="altid"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/AuditEvent-altid"/>
        <type value="token"/>
        <documentation value="AuditEvent.agent.altId"/>
      </searchParam>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="MAY"/>
        </extension>
        <name value="date"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/AuditEvent-date"/>
        <type value="date"/>
        <documentation value="AuditEvent.recorded"/>
      </searchParam>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="MAY"/>
        </extension>
        <name value="outcome"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/AuditEvent-outcome"/>
        <type value="token"/>
        <documentation value="AuditEvent.outcome"/>
      </searchParam>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="MAY"/>
        </extension>
        <name value="entity-name"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/AuditEvent-entity-name"/>
        <type value="string"/>
        <documentation value="AuditEvent.entity.name"/>
      </searchParam>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="MAY"/>
        </extension>
        <name value="agent-name"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/AuditEvent-agent-name"/>
        <type value="string"/>
        <documentation value="AuditEvent.agent.name"/>
      </searchParam>
      <searchParam>
        <extension
                   url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
          <valueCode value="MAY"/>
        </extension>
        <name value="type"/>
        <definition
                    value="http://hl7.org/fhir/SearchParameter/AuditEvent-type"/>
        <type value="token"/>
        <documentation value="AuditEvent.type"/>
      </searchParam>
    </resource>
  </rest>
</CapabilityStatement>