# Release Notes - Implementation Guide ePA Basisfunktionalitäten v1.3.1

Implementation Guide

ePA Basisfunktionalitäten

Version 1.3.1 - release 

* [**Table of Contents**](toc.md)
* **Release Notes**

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

