Implementation Guide
ePA Basisfunktionalitäten
Version 1.3.0 - release

Release Notes

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

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.

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