Implementation Guide
ePA Basisfunktionalitäten
Version 1.3.1 - release

## Release Notes

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

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

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

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

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

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

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

### Version 1.0.5

#### Anforderungen

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

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