Implementation Guide
ePA Basisfunktionalitäten
Version 1.3.2 - release

## Release Notes

### Version 1.3.2

#### Abhängigkeiten

- Die Abhängigkeit zu [gemIG_TI_Terminology] wurde auf Version 1.0.9-1 aktualisiert.

#### Anforderungen

Neue Anforderungen wurden hinzugefügt, bestehende geändert und nicht mehr benötigte gelöscht. Die folgenden Release Notes geben einen detaillierten Überblick über alle Anpassungen.

ÄND | IG-EPA25373L25-02 | Protokollierung von nicht erfolgreichen Zugriffen
NEU | IG-EPA28846UVL | Reihenfolge der Auswertung Legal Policy, Consent Decisions und Deny Policy
ÄND | IG-EPA29056FPX-02 | Protokolleinträge für Zugriffe auf den MHD Service
ÄND | IG-EPA72210MBU-02 | Protokollierung von Zugriffen auf die Protokolldaten
ÄND | IG-EPA81505MFF-02 | Protokolleinträge für Zugriffe auf den XDS Document Service
NEU | IG-EPA83763PTC | Health Record Relocation Service – Protokollierung der Zusammenführung von Daten des Medication Service
ÄND | IG-EPA86324UP3-01 | Maximale Größe des HTTP Header X-Requesting-Organization
ÄND | IG-EPA89078Y44-02 | Health Record Relocation Service – Protokollierung der Zusammenführung von Daten
ÄND | IG-EPA90980V11-02 | Befüllung der Elemente recorded, agent und source eines Audit Events
DEL | IG-TI82011VRG | Versionsprüfung bei Schreiboperationen im FHIR Data Service

Legende: NEU = Hinzugefügt | ÄND = Geändert | VERS = Verschoben | DEL = Entfernt

### Version 1.3.1

#### Terminologien

- Der Code SVC_ORG_HEADER_TOO_LARGE wurde aus dem CodeSystem EPAOperationOutcomeDetailsCS entfernt. Der Fehlerfall wird nicht mehr über eine FHIR-Ressource vom Typ OperationOutcome abgebildet, sondern über eine HTTP-Antwort mit dem Statuscode 431 und einem JSON Response-Body.

#### Anforderungen

Neue Anforderungen wurden hinzugefügt, bestehende geändert und nicht mehr benötigte gelöscht. Die folgenden Release Notes geben einen detaillierten Überblick über alle Anpassungen.

ÄND | IG-EPA07270W9D-01 | Push Notification Management- Protokollierung von Änderungen der Channel-Konfiguration
ÄND | IG-EPA14908QQV-01 | Medication Service - Protokolleinträge für Zugriffe auf den Medication Service
ÄND | IG-EPA25373L25-01 | Protokollierung von nicht erfolgreichen Zugriffen
ÄND | IG-EPA27775LWU-01 | Constraint Management - Protokolleinträge für Zugriffe auf das Constraint Management
ÄND | IG-EPA29056FPX-01 | Protokolleinträge für Zugriffe auf den MHD Service
ÄND | IG-EPA32002Z7B-02 | Profilanforderung an die FHIR Organization im Header X-Requesting-Organization
ÄND | IG-EPA39507N6L-04 | Non-FHIR HTTP Status Codes für alle Schnittstellen der ePA
ÄND | IG-EPA43183WW1-01 | Entitlement Management - Protokolleinträge für Zugriffe auf das Entitlement Management
ÄND | IG-EPA51779ZXV-01 | Consent Decision Management – Protokollierung geänderter Entscheidungen der User Specific Deny Policy Medication
ÄND | IG-EPA53113MJ4-01 | Consent Decision Management – Protokollierung geänderter Entscheidungen zu Sekundärnutzungszwecken
ÄND | IG-EPA60678PVT-01 | Protokolleinträge für RestrictedUpdateDocumentSet
ÄND | IG-EPA62942YH0-01 | Vorgabe für Verhalten bei leerer Ergebnisliste
ÄND | IG-EPA69406CJF-01 | Validierung von FHIR-Ressourceninstanzen bei Erstellung und Aktualisierung
ÄND | IG-EPA72210MBU-01 | Protokollierung von Zugriffen auf die Protokolldaten
ÄND | IG-EPA75442S6H-01 | Push Notification Management- Protokollierung der ePA-FdV-Instanz-Registrierung
ÄND | IG-EPA78949PKT-01 | Health Record Relocation Service - Protokollierung des Anbieterwechsels eines Aktenkontos
ÄND | IG-EPA81505MFF-01 | Protokolleinträge für Zugriffe auf den XDS Document Service
ÄND | IG-EPA82173QTJ-01 | Consent Decision Management – Protokollierung geänderter Entscheidungen zu Widersprüchen
NEU | IG-EPA87184BD2 | PractitionerRole Referenzen mit Anzeigetext
ÄND | IG-EPA89021CEX-01 | Protokollierung des Datenexports an das FDZ
ÄND | IG-EPA89078Y44-01 | Health Record Relocation Service – Protokollierung der Zusammenführung von Daten
ÄND | IG-EPA90980V11-01 | Befüllung der Elemente recorded, agent und source eines Audit Events
ÄND | IG-EPA95476FRN-01 | Protokolleinträge für Zugriffe auf den Patient Service

Legende: NEU = Hinzugefügt | ÄND = Geändert | VERS = Verschoben | DEL = Entfernt

### Version 1.3.0

#### EPA Patient

- Das Must-Support-Kennzeichen wird bei active entfernt, da TIPatient in Version 1.2.0 deren Nutzung per 0..0 ausschließt.

#### Generelle Prinzipien

- Der bisher spezifizierte Rückgabe HTTP Code "400 Bad Request" bei einer fehlschlagenden FHIR-Profilvalidierung wurde auf "422 Unprocessable Entity" angepasst.

#### Terminologien

- Aufnahme des Code DELETE in das Value Set EPAActivityProvenanceTypeVS zur eindeutigen Abbildung von Löschvorgängen.

#### Anforderungen

VERS | IG-EPA02347WQ8 | Audit Event Service: Implementierung der /metadata Funktion
NEU | IG-EPA07270W9D | Push Notification Management- Protokollierung von Änderungen der Channel-Konfiguration
NEU | IG-EPA08132EJS | Audit Event Service: Non-FHIR HTTP Error Code statusMismatch
NEU | IG-EPA08609JKL | Aufbewahrungsdauer der Protokolleinträge
ÄND | IG-EPA09567GLR-01 | Bevorzugte Verarbeitung der Literal-Referenz gegenüber der logischen Referenz im Reference-Element
NEU | IG-EPA12774JW3 | Lokal gespeicherte Protokolldaten anzeigen
NEU | IG-EPA14908QQV | Medication Service - Protokolleinträge für Zugriffe auf den Medication Service
NEU | IG-EPA17406TWV | Protokolldaten einsehen
NEU | IG-EPA18143SE6 | Aufbereitung der Protokolldaten für den Versicherten
NEU | IG-EPA18290U4U | Nicht zu protokollierende Zugriffe
NEU | IG-EPA23889BVZ | Nicht zu protokollierende Zugriffe auf Ordner "technical"
NEU | IG-EPA24512M1L | Schnittstellennutzung des Patient Service durch CS_ePA_KTR
NEU | IG-EPA25373L25 | Protokollierung von nicht erfolgreichen Zugriffen
NEU | IG-EPA27775LWU | Constraint Management - Protokolleinträge für Zugriffe auf das Constraint Management
NEU | IG-EPA29056FPX | Protokolleinträge für Zugriffe auf den MHD Service
ÄND | IG-EPA32002Z7B-01 | Profilanforderung an die FHIR Organization im Header X-Requesting-Organization
NEU | IG-EPA34501YHD | Status Code bei aktualisierter Patient-Instanz
NEU | IG-EPA35053RVM | Protokollierung von Nutzerzugriffen auf Ordner "technical"
NEU | IG-EPA38734DFC | Protokolldaten lokal speichern
NEU | IG-EPA40183ED3 | Speicherung der Protokolldaten
NEU | IG-EPA43183WW1 | Entitlement Management - Protokolleinträge für Zugriffe auf das Entitlement Management
NEU | IG-EPA47641VPS | Protokolldaten filtern
NEU | IG-EPA49593GT2 | FHIR Data Service – Aktenkontostatus bei fehlerhafter Datenmigration
NEU | IG-EPA50631N8A | Anzeige der Protokolldaten
NEU | IG-EPA50964Z2A | FHIR Data Service – Durchführung von Datenmigrationen
NEU | IG-EPA51779ZXV | Consent Decision Management – Protokollierung geänderter Entscheidungen der User Specific Deny Policy Medication
NEU | IG-EPA52346SFD | Status Code bei neu erstellter Patient-Instanz
NEU | IG-EPA53113MJ4 | Consent Decision Management – Protokollierung geänderter Entscheidungen zu Sekundärnutzungszwecken
NEU | IG-EPA55012GJA | Non-FHIR HTTP Error Code statusMismatch für Schnittstellen der ePA
NEU | IG-EPA60678PVT | Protokolleinträge für RestrictedUpdateDocumentSet
DEL | IG-EPA61142GF3 | Implementierung allgemeingültiger Anforderungen an Audit Event Service
NEU | IG-EPA61873SAN | Validierung von Patient-Ressourceninstanzen gegen das Profil EPAPatient
VERS | IG-EPA61922SAN-03 | Schnittstellennutzung des Audit Event Service
VERS | IG-EPA67312T3G | Schnittstellenimplementierung des Audit Event Service gemäß FHIR-Spezifikation im ePA-Aktensystem
NEU | IG-EPA69406CJF | Validierung von FHIR-Ressourceninstanzen bei Erstellung und Aktualisierung
NEU | IG-EPA69832BUU | Protokolleinträge für Zugriffe gleicher Art
NEU | IG-EPA70045U8J | Formatierung von Literal-Referenzen für interne Ressourcen
NEU | IG-EPA72210MBU | Protokollierung von Zugriffen auf die Protokolldaten
DEL | IG-EPA72343FGS | Implementierung allgemeingültiger Anforderungen an den Patient Service
NEU | IG-EPA73371E2T | Schnittstellennutzung des Patient Service durch ePA-FdV
NEU | IG-EPA74597GNF | Speichern der Profilversion
NEU | IG-EPA75442S6H | Push Notification Management- Protokollierung der ePA-FdV-Instanz-Registrierung
NEU | IG-EPA76010ZUP | Implementierung nicht-spezifizierter FHIR-Funktionen
NEU | IG-EPA78949PKT | Health Record Relocation Service - Protokollierung des Anbieterwechsels eines Aktenkontos
NEU | IG-EPA81505MFF | Protokolleinträge für Zugriffe auf den XDS Document Service
NEU | IG-EPA82173QTJ | Consent Decision Management – Protokollierung geänderter Entscheidungen zu Widersprüchen
NEU | IG-EPA86324UP3 | Maximale Größe des HTTP Header X-Requesting-Organization
NEU | IG-EPA89021CEX | Protokollierung des Datenexports an das FDZ
NEU | IG-EPA89078Y44 | Health Record Relocation Service – Protokollierung der Zusammenführung bei Konfliktpotential
NEU | IG-EPA90980V11 | Befüllung der Elemente recorded, agent und source eines Audit Events
NEU | IG-EPA95476FRN | Protokolleinträge für Zugriffe auf den Patient Service
NEU | IG-EPA95505YF8 | PAdES-Signatur in renderAuditEventsToPDF

Legende: NEU = Hinzugefügt | ÄND = Geändert | VERS = Verschoben | DEL = Entfernt

### Version 1.2.0

#### Generelle Prinzipien

- Unterstützung für die Organisationserkennung über den HTTP Header X-Requesting-Organization hinzugefügt, um aufrufende Organisationen eindeutig identifizieren zu können.

#### Terminologien

- Das Code System EPAOperationOutcomeDetailsCS wurde um den neuen Fehlercode SVC_ORG_HEADER_PROFILE_MISMATCH ergänzt, der eine fehlerhafte Profilvalidierung der im Header X-Requesting-Organization übermittelten Organization-Ressource kennzeichnet.
- Das Code System EPAAuditEventSourceTypeCS wurde um den neuen Code PUSHNOTMGMT ergänzt.

#### Provenance

- Das Provenance-Profile ePA-Änderungseintrag (EPAActivityProvenance) wurde hinzugefügt.

#### EPA Patient

- Must-Support-Kennzeichnen an den Elementen id, meta, active werden gesetzt, da sie nicht mehr TIPatient (1.1.1) verortet sind.

#### Anforderungen

NEU | IG-EPA08517MXA | Angabe der Art der Änderung im Änderungseintrag
NEU | IG-EPA09567GLR | Bevorzugte Verarbeitung der literal reference gegenüber der logischen Referenz im Reference-Element
NEU | IG-EPA12473JRM | Identifikation des FHIR Data Service als verantwortlicher Akteur
NEU | IG-EPA12496JW7 | Validierung der Telematik-ID aus dem Header X-Requesting-Organization gegen das ID-Token
NEU | IG-EPA16549D0W | Verwendung versionierter Referenzen im Änderungseintrag
NEU | IG-EPA18191M31 | Übernahme des verantwortlichen Akteurs aus dem X-Requesting-Organization Header
NEU | IG-EPA19082TMV | Verwendung des HTTP-Headers X-Requesting-Organization zur Identifikation der anfragenden Organisation
NEU | IG-EPA24393PGD | Statuscode bei inhaltsgleichem Update der Patient-Instanz
NEU | IG-EPA26606M0X | Verwendung des Profils EPAActivityProvenance für Änderungseinträge
NEU | IG-EPA30155FTA | Practitioner und Organization Referenzen mit Anzeigetext
NEU | IG-EPA32002Z7B | Profilanforderung an die FHIR Organization im Header X-Requesting-Organization
ÄND | IG-EPA39507N6L-03 | Non-FHIR HTTP Status Codes für Schnittstellen der ePA
NEU | IG-EPA46070CEJ | Setzen der fachlichen und technischen Zeitangaben
NEU | IG-EPA47086E4R | Format des HTTP-Headers X-Requesting-Organization
NEU | IG-EPA68177EZH | Ausschließliche Must-Support-Elementübernahme beim Schreiben
NEU | IG-EPA90831J7H | Fehler in Zeitfilter-Parametern
NEU | IG-TI19439LBP | Transaktionale Verarbeitung nach dem ACID-Prinzip im FHIR Data Service
NEU | IG-TI35915ZJ8 | Serielle Ausführung transaktionaler Bereiche im FHIR Data Service
NEU | IG-TI82011VRG | Versionsprüfung bei Schreiboperationen im FHIR Data Service

Legende: NEU = Hinzugefügt | ÄND = Geändert | VERS = Verschoben | DEL = Entfernt

### Version 1.1.5

#### Abhängigkeiten

- Die Abhängigkeit zu [gemIG_TI_Common] wurde auf Version 1.1.0 aktualisiert.

#### EPA Patient

- Das Profil EPAPatient wurde hinzugefügt. Es leitet sich vom TIPatient-Profil ab und macht die KVNR verpflichtend.

#### Capability Statement

- Das Capability Statement für den Patient Service wurde hinzugefügt.

#### Anforderungen

NEU | IG-EPA02347WQ8 | Audit Event Service: Implementierung der /metadata Funktion
NEU | IG-EPA03113XA9 | Patient Service: Implementierung der /metadata Funktion
ÄND | IG-EPA05084T1N-02 | Unterstützung von Zeitfiltern in der Render API: PDF Audit
ÄND | IG-EPA06824D29-02 | Erforderliche Benutzerinformationen für Schnittstellen
NEU | IG-EPA16440VQU | Umsetzung der Funktionalität eines Conditional Update gemäß FHIR
ÄND | IG-EPA39507N6L-02 | Non-FHIR HTTP Status Codes für Schnittstellen der ePA
ÄND | IG-EPA43250DGG | Zugriffsrechte gemäß Legal Policy für Audit-Event-Service-Schnittstellen
NEU | IG-EPA48451X8A | Zugriffsrechte für Patient Query API
ÄND | IG-EPA52233FBE-02 | HTTP-Fehlercode-Formatierung für ePA, bei der keine FHIR-Operationen oder Ressourcen zurückgegeben werden.
NEU | IG-EPA54345CTY | Zugriffsrechte für Versicherteninformationen hinzufügen/aktualisieren
ÄND | IG-EPA55253C0D-02 | Audit-Event-Service-Schnittstellen: Bereitstellung auf vordefinierten Pfaden im VAU-Kanal
NEU | IG-EPA57847FWU | Übermittlung von Versicherteninformationen durch das Client-System des Kostenträgers
ÄND | IG-EPA61922SAN-03 | Schnittstellennutzung des Audit Event Service
ÄND | IG-EPA67312T3G | Schnittstellenimplementierung des Audit Event Service gemäß FHIR-Spezifikation im ePA-Aktensystem
NEU | IG-EPA72343FGS | Implementierung allgemeingültiger Anforderungen an den Patient Service
NEU | IG-EPA76258E8H | Patient Service: Unterstützung definierter Suchparameter
ÄND | IG-EPA92949ABX-03 | HTTP-Statuscode für SVC_IDENTITY_MISMATCH Fehlermeldung
NEU | IG-EPA95082G5N | Fehlerreaktion bei ungültiger KVNR im Conditional Update
NEU | IG-EPA99876PHF | Patient-Schnittstellen: Bereitstellung auf vordefinierten Pfaden im VAU-Kanal
NEU | IG-TI28940QKS | Hostname in Bundle.entry.fullUrl für die ePA

Legende: NEU = Hinzugefügt | ÄND = Geändert | VERS = Verschoben | DEL = Entfernt

### Version 1.0.6-2

#### Terminologien

- Die verwendeten ValueSets enthalten nun eine vollständige Expansion

### Version 1.0.6-1

#### Abhängigkeiten

- Die Abhängigkeit zu [gemIG_TI_Terminology] wurde auf Version 1.0.5-4 aktualisiert.

### Version 1.0.6

#### Terminologien

- Das ValueSet EPAAuditEventSourceTypeVS wurde in EPAAuditEventServiceTypeVS umbenannt, um seine Nutzung sowohl für AuditEvent.agent[internal].type als auch für AuditEvent.source.type konsistent und verständlich abzubilden.
- Das CodeSystem EPA AuditEvent Source Type wurde um den Code AUDITSVC ("Audit Event Service") erweitert.

#### Abhängigkeiten

- Die Abhängigkeit zu [gemIG_TI_Common] wurde auf Version 1.0.1 aktualisiert.

#### Capability Statement

- Der fälschlicherweise weggefallene Suchparameter type auf AuditEvent wurde wieder hinzugefügt.

#### EPAAuditEvent

- Der zuvor festgelegte feste Wert true für das Feld AuditEvent.agent.requestor wurde entfernt, um die Rückwärtskompatibilität mit bestehenden Implementierungen sicherzustellen. Der empfohlene Wert bleibt true, wird jedoch nun nur noch als fachliche Empfehlung dokumentiert und nicht mehr technisch erzwungen.

#### Anforderungen

DEL | IG-EPA02347WQ8 | Audit Event Service: Implementierung der /metadata Funktion
ÄND | IG-EPA06824D29-02 | Erforderliche Benutzerinformationen für Schnittstellen
ÄND | IG-EPA20251N8N-02 | Standardsortierung des Suchergebnisses
VERS | IG-EPA43250DGG | Zugriffsrechte gemäß Legal Policy für Audit-Service-Schnittstellen
ÄND | IG-EPA55253C0D-02 | Audit-Event-Schnittstellen: Bereitstellung auf vordefinierten Pfaden im VAU-Kanal
ÄND | IG-EPA61922SAN-02 | Schnittstellennutzung des Audit Event Service
VERS | IG-EPA67312T3G | Schnittstellenimplementierung des Audit Event Service gemäß FHIR-Spezifikation im ePA-Aktensystem
ÄND | IG-EPA87655LVZ-02 | Standardsortierung des Suchergebnis in der PDF/A-Darstellung
ÄND | IG-EPA92949ABX-02 | HTTP-Statuscode für SVC_IDENTITY_MISMATCH Fehlermeldung

Legende: NEU = Hinzugefügt | ÄND = Geändert | VERS = Verschoben | DEL = Entfernt

### Version 1.0.5

#### Anforderungen

NEU | IG-EPA02347WQ8 | Implementierung der /metadata Funktion
NEU | IG-EPA04413PXH | Unterstützung definierter Suchparameter
NEU | IG-EPA04827GDY | Unterstützung des Parameter signed in der Render API: Audit
NEU | IG-EPA05084T1N | Unterstützung von Zeitfiltern in der Render API: PDF Audit
NEU | IG-EPA06824D29 | Erforderliche Benutzerinformationen für Audit-Service-Schnittstellen
NEU | IG-EPA20251N8N | Standardsortierung des Suchergebnisses
NEU | IG-EPA39507N6L | Non-FHIR HTTP Status Codes für Schnittstellen der ePA
NEU | IG-EPA43250DGG | Zugriffsrechte gemäß Legal Policy für Audit-Service-Schnittstellen
NEU | IG-EPA52233FBE | HTTP-Fehlercode-Formatierung für ePA, bei der keine FHIR-Operationen oder Ressourcen zurückgegeben werden.
NEU | IG-EPA55253C0D | Audit-Event-Schnittstellen: Bereitstellung auf vordefinierten Pfaden im VAU-Kanal
NEU | IG-EPA61142GF3 | Implementierung allgemeingültiger Anforderungen an Audit Event Service
NEU | IG-EPA61922SAN | Schnittstellennutzung des Audit Event Service
NEU | IG-EPA62942YH0 | Vorgabe für Verhalten bei leerer Ergebnisliste
NEU | IG-EPA67312T3G | Schnittstellenimplementierung des Audit Event Service gemäß FHIR-Spezifikation im ePA-Aktensystem
NEU | IG-EPA74030HZ0 | Vorgabe für Media Type bei erfolgreicher Ausgabe der Render API: PDF Audit
NEU | IG-EPA84771EZW | Erstellung und Rückgabe von Audit-Ereignislisten als PDF/A
NEU | IG-EPA87655LVZ | Standardsortierung des Suchergebnis in der PDF/A-Darstellung
NEU | IG-EPA92949ABX | HTTP-Statuscode für SVC_IDENTITY_MISMATCH Fehlermeldung

Legende: NEU = Hinzugefügt | ÄND = Geändert | VERS = Verschoben | DEL = Entfernt