Bearbeiten von „ILF:E-Impfpass (Version 2)“ (Abschnitt)

= Funktionale Anforderungen=

== Darstellung==
Für die Darstellung des e-Impfpasses wird ein spezielles Stylesheet bereitgestellt, das im XML-Prolog referenziert wird ("ELGA_eimpf-stylesheet_v1.0.xsl"). 
Grundsätzlich werden die Daten aus den Entries dargestellt. Section.Text MUSS dennoch angegeben werden, da der CDA Rel. 2 Standard "Lesbarkeit für Menschen" ("human readability") vorschreibt.

<div class="landscape">

==Verwendung in der ELGA Infrastruktur==
===Vorgaben zu Dokument-Metadaten (XDS-Metadaten)===
{| class="wikitable"
! XDS-Mapping
! Optio-
nalität
! CDA-Element
clinicalDocument.
! Beispiel
! Erklärung
|-
| rowspan="2"|[[ILF:XDS_Metadaten_(Version_3)#uniqueId_2|uniqueId]]
| rowspan="2"|M
| rowspan="2"|.id
|
*@root="1.2.40.0.34.3.1.1058.1337.999021.1"
| rowspan="2"| Das "uniqueId"-Element beschreibt den global eindeutigen Identifier des CDA-Dokuments und kann mit oder ohne Extension angegeben werden.
|- 
|
*@root="1.2.40.0.34.3.1.1058.1337"
*@extension="999021.1"
|- 
| [[ILF:XDS_Metadaten_(Version_3)#classCode_.28und_classCodeDisplayName.29_2|classCode]]
| M
| .code
| 
*@code="11369-6"
*@displayName="HISTORY OF IMMUNIZATIONS"
*@codeSystem="2.16.840.1.113883.6.1"
| Bezeichnet die "Dokumentklasse". Zulässige Werte gemäß Value Set [https://termgit.elga.gv.at/ValueSet/elga-dokumentenklassen ELGA_Dokumentenklassen].
Aus Gründen der Kompatibilität zu IHE PCC und auch den Ableitungen im schweizer CH-VACD haben alle Impfungsdokumente den Code '''11369-6 History of Immunization Narrative'''.
|-
| rowspan="2"| [[ILF:XDS_Metadaten_(Version_3)#typeCode_.28und_typeCodeDisplayName.29_2|typeCode]] 
| rowspan="2"| M
| rowspan="2"| .code.translation 
| 
*@code="82593-5"
*@displayName="Immunization summary report"
*@codeSystem="2.16.840.1.113883.6.1"
| Zur Unterscheidung des Dokumenttyps erhält das Element clinicalDocument.code des '''"Kompletter Immunisierungsstatus"''' ein zusätzliches translation-Element.
|-
| 
*@code="87273-9"
*@displayName="Immunization note"
*@codeSystem="2.16.840.1.113883.6.1"
| Zur Unterscheidung des Dokumenttyps erhält das Element clinicalDocument.code des '''"Update Immunisierungsstatus"''' ein zusätzliches translation-Element.
|-
| rowspan="2"| [[ILF:XDS_Metadaten_(Version_3)#title_2|title]]
| rowspan="2"| M
| rowspan="2"| .title 
| "Kompletter Immunisierungsstatus"
| Für den lesenden Dokumentempfänger gedachter Titel des '''Kompletten Immunisierungsstatus'''.
|-
| "Update Immunisierungsstatus" 
| Für den lesenden Dokumentempfänger gedachter Titel des '''Update Immunisierungsstatus'''.
|-
| [[ILF:XDS_Metadaten_(Version_3)#formatCode_.28und_formatCodeDisplayName.29_2|formatCode]]
| M
| .hl7at:formatCode
| 
*<nowiki>@code="urn:hl7-at:eImpf:2.0.2+20250320"</nowiki>
*@displayName= "HL7 Austria e-Impfpass 2.0.2+20250320"
| Version des vom CDA erfüllten Implementierungsleitfaden e-Impfpass.
|-
| [[ILF:XDS_Metadaten_(Version_3)#practiceSettingCode_.28und_practiceSettingCodeDisplayName.29_2|practiceSettingCode]]
| M
| .hl7at:practiceSettingCode
| 
*@code="F023"
*@displayName="Interdisziplinärer Bereich"
*@codeSystem="1.2.40.0.34.5.12"
| Fachliche Zuordnung des CDA-Dokuments aus dem Value Set [https://termgit.elga.gv.at/ValueSet/elga-practicesetting ELGA_PracticeSetting].
|-
| [[ILF:XDS_Metadaten_(Version_3)#eventCodeList_.28und_eventCodeListDisplayName.29_2|eventCodeList]]
| M
| .documentationOf
.serviceEvent.code
| 
*@code="41000179103"
*@displayName="Immunization record (record artifact)"
*@codeSystem="2.16.840.1.113883.6.96"
*@codeSystemName="SNOMED CT"
| Code der Gesundheitsdienstleistung.
|-
| rowspan="2"| [[ILF:XDS_Metadaten_(Version_3)#serviceStartTime_.2F_serviceStopTime_2|serviceStartTime]]
| O
| rowspan="2"|.documentationOf.serviceEvent
.effectiveTime.low
|
Zeitpunkt des '''ältesten''' effectiveTime aus:
*"Immunization Entry":
**templateId 1.2.40.0.34.6.0.11.3.1
**substanceAdministration.effectiveTime und
*"Impfrelevante Erkrankungen Problem Entry":
**templateId 1.2.40.0.34.6.0.11.3.9
**act.effectiveTime.low
| Beginn der Gesundheitsdienstleistung bei '''Kompletter Immunisierungsstatus'''.
|-
| R
| Zeitpunkt des Behandlungsbeginns (aktueller Besuch).
| Beginn der Gesundheitsdienstleistung bei '''Update Immunisierungsstatus'''.
|-
| rowspan="2"| [[ILF:XDS_Metadaten_(Version_3)#serviceStartTime_.2F_serviceStopTime_2|serviceStopTime]]
| O
| rowspan="2"| .documentationOf.serviceEvent
.effectiveTime.high
|
Zeitpunkt des '''jüngsten''' effectiveTime aus:
*"Immunization Entry":
**templateId 1.2.40.0.34.6.0.11.3.1
**substanceAdministration.effectiveTime und
*"Impfrelevante Erkrankungen Problem Entry":
**templateId 1.2.40.0.34.6.0.11.3.9
**act.effectiveTime.high
| Ende der Gesundheitsdienstleistung bei '''Kompletter Immunisierungsstatus'''.
|-
| R
| Zeitpunkt des Behandlungsendes (aktuelle Behandlung, muss sich von Behandlungsbeginn unterscheiden)
| Ende der Gesundheitsdienstleistung bei '''Update Immunisierungsstatus'''.
|-
|}
</div>

==Versionierung & Stornierung==
Versionierung und Stornierung betrifft ausschließlich CDA-Dokumente vom Typ "Update Immunisierungsstatus".

Das von der e-Impfpass Anwendung erzeugte On-Demand Dokument "Kompletter Immunisierungsstatus" ist immer eine neue Version desselben CDA-Dokuments, d.h. es ändert sich nur die Versionsnummer (die SetID bleibt für alle Versionen des kompletten Immunisierungsstatus eines Patienten gleich).

===Versionierung von CDA-Dokumenten===
CDA-Dokumente vom Typ "Update Immunisierungsstatus" können über die IHE Transaktion ITI-41 versioniert werden. 
Die Inhalte werden von der zentralen e-Impfpass-Anwendung verarbeitet und alle Inhalte in den Datenbestand integriert. Das bedeutet, dass alle Daten, die bereits durch ein CDA-Dokument in den zentralen Datenbestand übernommen wurden, durch das Update ersetzt werden. Daten, die in der neu registrierten Version nicht enthalten sind, gelten als gelöscht. 
Die Fachlogik der zentralen e-Impfpass-Anwendung kann die Änderung oder Löschung verweigern, sollten dadurch inkonsistente Datenbestände entstehen (z.B. wenn Informationen gelöscht werden sollen, auf denen spätere Impfeinträge beruhen).

===Stornierung von CDA-Dokumenten===
CDA-Dokumente vom Typ "Update Immunisierungsstatus" können über IHE Transaktion ITI-57 storniert werden. Alle Inhalte, die ursprünglich durch das stornierte CDA-Dokument eingetragen wurden, werden gelöscht.
Die Fachlogik der zentralen e-Impfpass-Anwendung kann die Stornierung verweigern, sollten dadurch inkonsistente Datenbestände entstehen (z.B. wenn Informationen gelöscht werden sollen, auf denen spätere Impfeinträge beruhen).

==Impfempfehlungen==
Ein Ziel des e-Impfpasses ist, interessierten Ärztinnen und Ärzten sowie Bürgerinnen und Bürgern einen raschen Überblick über aktuelle zur Verfügung stehende Impfungen zu geben. Dazu werden vom e-Impfpass "Impfempfehlungen" ausgegeben. Eine Impfempfehlung enthält zu einer Impfung den jeweils nächsten fälligen Impftermin und dazu eine Handlungsempfehlung. Impfempfehlungen werden für alle Impfungen erstellt, die bereits mindestens einmal erhalten wurden oder die für die Person laut österreichischen Impfplan empfohlen sind.

Die Impfempfehlungen werden vom Expertensystem der zentralen Anwendung aktuell erstellt und gemeinsam mit dem On-Demand Dokument "Kompletter Immunisierungsstatus" ausgegeben. Das Expertensystem ist ein Teil der Fachlogik der zentralen Anwendung und bildet den jeweils aktuellen österreichischen Impfplan ab, der vom Nationalen Impfgremium herausgegeben wird. Der Impfplan wird in eine tabellarische Impfabfolge übersetzt und ins Expertensystem importiert. Zur Berechnung der Impfempfehlung werden folgende Parameter aus der persönlichen Impfdokumentation herangezogen:
* Alter der Person
* Geschlecht
* Bereits erhaltene Impfungen:
** Dosiskennung der letzten eingetragenen Impfung
** Impfstoff
** Impfschema (sofern abweichend vom Defaultschema)
* Durchgemachte impfrelevante Erkrankungen
* Indikation für Impfung ("Indikationsgruppen")

Automatisch erstellte Impfempfehlungen können mit individuellen Impfempfehlungen eines Arztes überschrieben werden, z.B. bei Vorliegen einer Antikörperbestimmung (Impftiter-Ergebnis). Die Begründung kann (z.B. mit dem Messwert als Kommentar) angegeben werden.

'''Dosiskennung''': Damit die nächste Impfung im Rahmen eines bestimmten Impfschemas korrekt berechnet werden kann, ist es nicht notwendig, dass alle bisher verabreichten Dosen einer Impfung dokumentiert werden. Es reicht, die jeweils letzte Dosis zu dokumentieren, dafür muss die Dosiskennung korrekt angegeben werden (z.B. "Dosis 3").

'''Impftiter''': Ergebnisse von Antikörperbestimmungen werden NICHT von der Berechnungslogik berücksichtigt. Wenn der Impftiter ein Abweichen vom automatisch berechneten Impftermin notwendig macht, muss vom Arzt eine individuelle Impfempfehlung erstellt werden, als Kommentar soll der Impftiter angegeben werden.

'''Handlungsempfehlung''': Für jede automatisch von der zentralen Anwendung ausgegebenen Impfempfehlung wird eine Handlungsempfehlung ausgegeben. Die Handlungsempfehlung wird durch einen Code repräsentiert (Element ''code'' im Immunization Recommendation Entry) und stammt aus dem Value Set [https://termgit.elga.gv.at/ValueSet/eimpf-specialcasevaccination eImpf_SpecialCaseVaccination]. Die Bedeutung der Codes ist im Value Set beschrieben (Bedeutung, Anwendungsbeschreibung, Hinweise). Zur einfacheren Darstellung werden die Handlungsempfehlungen mittels Stylesheet gruppiert und bestimmten farbigen Icons zugewiesen; die Zuordnung erfolgt über eine hierarchische Strukturierung im Value Set (Ebene 0 = Icon, Ebene 1 = Handlungsempfehlung).
===Empfehlung, keine Impfung durchzuführen (Kontraindikation)===
Eine Sonderform der Impfempfehlung ist die Empfehlung, KEINE Impfung durchzuführen, wenn eine medizinisch begründete Kontraindikation gegen eine bestimmte Impfung vorliegt. 
Für die Angabe einer Kontraindikation sind neben vom berechtigten dokumentierenden Arzt (Author) für einen Patienten folgende Daten einzutragen: 
* Impfziel
* Zeitraum, in dem die Kontraindikation gilt
* Begründung der Kontraindikation
* Optional: Impfstoff
Vom Expertensystem der zentralen Anwendung wird im Kompletten Immunisierungsstatus eine entsprechende Handlungsempfehlung ergänzt ("Impfung nicht indiziert").
{{BeginYellowBox}}
Die Angabe von Kontraindikationen ist technisch zwar möglich, wird zurzeit aber '''NICHT''' unterstützt.
{{EndYellowBox}}

== Mehrsprachigkeit und grenzüberschreitender Austausch ==
Mehrsprachigkeit wird in dieser Version nicht unterstützt, ist aber für die Zukunft angedacht. Die entsprechenden Strukturen im Leitfaden sind bereits angelegt.