Implementation Guide
TIFlow - Verordnungen für Arzneimittel
Version 2.0.0-ballot.2 - ballot

## FHIR-Artefakte

Diese Seite enthält eine Übersicht aller FHIR-Artefakte, die im Rahmen dieses Implementation Guide für den TI-Flow-Fachdienst definiert werden. Sie bilden die Grundlage für die strukturierte Abbildung und Verarbeitung von Medikationsdaten innerhalb des TI-Flow-Fachdienst. Dazu gehören Profile zur Spezifizierung von Ressourcen, ein Capability Statement zur Beschreibung der unterstützten Funktionen sowie Operation Definitions, die spezielle FHIR-Operationen für den Abruf und die Verwaltung von Medikationsdaten festlegen.

### Terminologien: Value Sets

Die folgenden Value Sets sind für die FHIR-Data-Service-Funktionalitäten festgelegt.

Tabelle: Value Sets

Bearbeiter eines E-Rezeptes | ValueSet der Organisationstyp-Codes eines Performers für den RX Task
TIFLOW EREZEPT Operation Outcome Details VS | E-Rezept-spezifische Codes, die im Rahmen des TIFlow in den OperationOutcomes.details angegeben werden können

### Terminologien: Code Systems

Tabelle: Code Systems

TIFLOW EREZEPT Operation Outcome Details CS | E-Rezept-spezifische Codes, die im Rahmen des TIFlow in den OperationOutcomes.details angegeben werden können

### Systemverhalten

#### Capability Statements

Das Capability Statement beschreibt die Anforderungen und Fähigkeiten, die ein Server für die konforme Implementierung des TI-Flow-Fachdienst umsetzen muss. Es handelt sich um eine Konformitätsbestätigung, die spezifiziert, welche Ressourcen, Interaktionen und Suchparameter das ePA-Aktensystem für den TI-Flow-Fachdienst unterstützen muss.

TIFlow Fachdienst Server Capabilities | CapabilityStatement für den E-Rezept-Fachdienst (Arzneimittel-Workflow)

Tabelle: Capability Statements

#### Operation Definitions

E-Rezept abbrechen | Diese Operation bricht den Workflow eines E-Rezepts ab und löscht alle Daten, die mit dieser Aufgabe zusammenhängen.
E-Rezept abrufen | Mit der $accept-Operation beansprucht eine Apotheke ein E-Rezept. Der Status der referenzierten Aufgabe ändert sich in 'in-progress'.
E-Rezept aktivieren | Diese Operation aktiviert die erstellte Aufgabe für das Rezept. Der Eingabeparameter muss das qualifizierte signierte Bundle des Rezepts enthalten. Der TI-Flow-Fachdienst validiert das Rezept, aktualisiert die Task-ressource und startet den Workflow.
E-Rezept Abgabe vollziehen | Die $close-Operation beendet den E-Rezept-Workflow und erstellt eine Quittung. Das Ergebnis dieses Vorgangs ist ein signiertes Bundle, das für weitere finanzielle Verarbeitung verwendet wird. Der Status der Aufgabe ändert sich anschließend in #completed.
E-Rezept erstellen | Diese Operation erstellt eine Aufgabe für die Verschreibung eines bestimmten Flowtypes.
E-Rezept vorläufig abgeben | Die Operation $dispense ermöglicht es der Apotheke, eine Ausgabe für ein Medikament durchzuführen, ohne den Status der Aufgabe zu ändern. Diese Aktion erlaubt es einem Frontend anzuzeigen, dass ein Medikament ausgegeben wurde, bevor es von der Apotheke abgeschlossen wird.
E-Rezept zurückgeben | Lehnt die Ausgabe eines E-Rezepts ab. Die Aufgabe wird in einen aktiven Zustand zurückgesetzt, das secret wird gelöscht, und der Task wird für jeden anderen Apotheker zugänglich oder kann vom Patienten gelöscht werden.

Tabelle: Operation Definitions

### Parameterprofile für Operationen

GEM ERP PR AcceptOperation Output | Dieses Profil definiert die Parameter für die Annahme eines Medikaments von AVS zum TI-Flow-Fachdienst. Dies kann für die $accept-Operation verwendet werden.
GEM ERP PR ActivateOperation Input | Dieses Profil definiert die Parameter für das Einstellen eines E-Rezeptes von PVS zum TI-Flow-Fachdienst.
GEM ERP PR ActivateOperation Output | Dieses Profil definiert die Parameter für die Aktivierung einer Aufgabe von PVS zum TI-Flow-Fachdienst. Dies kann für die $activate-Operation verwendet werden.
GEM ERP PR CloseOperation Input | Dieses Profil definiert die Parameter für das Schließen eines Workflows für ein Rezept vom AVS zum TI-Flow-Fachdienst. Dies kann für die Operationen $close und $dispense verwendet werden.
GEM ERP PR CloseOperation Output | Dieses Profil definiert die Parameter für die Ausgabe eines Medikaments von AVS an den TI-Flow-Fachdienst. Dies kann für die $close-Operation verwendet werden.
GEM ERP PR CreateOperation Input | Dieses Profil definiert die Parameter für die Erstellung einer Aufgabe von PVS zum TI-Flow-Fachdienst. Dies kann für die $create-Operation verwendet werden.
GEM ERP PR CreateOperation Output | Dieses Profil definiert die Parameter für die Erstellung einer Aufgabe von PVS zum TI-Flow-Fachdienst. Dies kann für die $create-Operation verwendet werden.
GEM ERP PR DispenseOperation Input | Dieses Profil definiert die Parameter für die Abgabe eines Medikaments von AVS an den TI-Flow-Fachdienst. Dies kann für die $dispense-Operation verwendet werden.

Tabelle: Parameterprofile

### Ressourcenprofile

GEM ERP PR Bundle OP Accept | Antwort des TI-Flow-Fachdienst auf die $accept-Operation
GEM ERP PR Communication DispReq | Anfrage zur Einlösung des E-Rezepts
GEM ERP PR Communication Reply | Antwort vom Leistungserbringer an den Patienten
GEM ERP PR Communication | Generische Workflow-Communication
GEM ERP PR Medication | Medikament zur Ausgabe des Rezepts
GEM ERP PR MedicationDispense | Dispensierung eines E-Rezepts
Task für E-Rezept | Task für die Verwaltung des E-Rezept-Workflows

Tabelle: Ressourcenprofile

### Datentypen

Tabelle: Datentypen

### Erweiterungen (Extension) Definitions

GEM ERP EX AvailabilityState | Extension zur Angabe von Typ des Verfügbarkeitsstatus für die Anfrage zur Medikamentenverfügbarkeit.
GEM ERP EX EU IS REDEEMABLE BY PATIENT AUTHORIZATION | Extension zur Angabe des Nutzers, ob das E-Rezept in der EU zur Einlösung verfügbar sein soll oder nicht.
GEM ERP EX EU IS REDEEMABLE BY PROPERTIES | Extension zur vom TI-Flow-Fachdienst ermittelten Angabe, ob das E-Rezept in der EU zur Einlösung verfügbar sein soll oder nicht.
GEM ERP EX LastMedicationDispense | Diese Erweiterung sollte in der Task-Ressource verwendet werden. Sie zeigt den Zeitstempel der letzten Ausgabe an.
GEM ERP EX SupplyOptionsType | Extension zur Angabe des bevorzugten Versorgungskanals

Tabelle: Extension Definitions

### Mapping Definitions (StructureMaps)

GEMErpPrMedicationMap | Auto-generated StructureMap for GEM_ERP_PR_Medication|1.6.1 -> EPAMedication|1.3.0
GEMErpPrMedicationdispenseMap | Auto-generated StructureMap for GEM_ERP_PR_MedicationDispense|1.6.1 -> EPAMedicationDispense|1.3.0
KBVPrErpBundleMap | Auto-generated StructureMap for transformation KBV_PR_ERP_Bundle|1.4.0 -> EPAOpProvidePrescriptionERPInputParameters|1.3.0
KBVPrErpMedicationCompoundingMap | Auto-generated StructureMap for KBV_PR_ERP_Medication_Compounding|1.4.0 -> EPAMedication|1.3.0
KBVPrErpMedicationFreetextMap | Auto-generated StructureMap for KBV_PR_ERP_Medication_FreeText|1.4.0 -> EPAMedication|1.3.0
KBVPrErpMedicationIngredientMap | Auto-generated StructureMap for KBV_PR_ERP_Medication_Ingredient|1.4.0 -> EPAMedication|1.3.0
KBVPrErpMedicationPznMap | Auto-generated StructureMap for KBV_PR_ERP_Medication_PZN|1.4.0 -> EPAMedication|1.3.0
KBVPrErpPrescriptionMap | Auto-generated StructureMap for KBV_PR_ERP_Prescription|1.4.0 -> EPAMedicationRequest|1.3.0
KBVPrForOrganizationMap | Auto-generated StructureMap for KBV_PR_FOR_Organization|1.3.0 -> OrganizationDirectory|1.0.0
KBVPrForPractitionerMap | Auto-generated StructureMap for KBV_PR_FOR_Practitioner|1.3.0 -> PractitionerDirectory|1.0.0

Tabelle: StructureMap

### Nutzung von Cross-Version-Extensions

Für die Profile der Ressourcen MedicationRequest, MedicationDispense und MedicationStatement werden die Backport-FHIR-Extensions `.renderedDosageInstruction` und `.effectiveDosePeriod` verwendet. Diese Elemente stammen aus FHIR R5 und wurden über den von der FHIR-Spezifikation definierten Cross-Version-Mechanismus nach R4 zurückportiert. Dieser Mechanismus wird u. a. bereits vom HL7 Java FHIR Validator unterstützt; andere Validatoren müssen gegebenenfalls das entsprechende Cross-Version-Paket nachladen.

Das offizielle Cross-Version-Paket war zum Releasezeitpunkt dieses Implementation Guides noch nicht final in der FHIR-Registry verfügbar. Die Package-ID lautet: `hl7.fhir.uv.xver-r5.r4`. Bis zur offiziellen Veröffentlichung kann der Inhalt des folgenden Snapshot-Releases verwendet werden: https://hl7.org/fhir/uv/xver-r5.r4/0.0.1-snapshot-2/

In diesem Paket sind die benötigten cross-version Extensions enthalten:

- MedicationDispense.renderedDosageInstruction

### Beispielinstanzen

Bundle

- Beispiel Accept-Bundle

- Beispielantwort fuer die $accept-Operation

- Communication searchset response for Rx

- MedicationDispense searchset response for Rx

- Task searchset response for Rx

- Quittungs-Bundle für abgeschlossene Rezeptabgabe

- Antwortbundle fuer GET /Consent

- Antwortbundle fuer GET /MedicationDispense

- Antwortbundle fuer GET /Task

Communication

- DiGA-Zuweisung des Patienten an die Krankenkasse

- Antwort-Nachricht der Apotheke an den Patienten

- Rx Communication request example

- Zuweisung des Patienten an die Apotheke

Consent

- Einwilligung fuer den Use Case CHARGCONS

Device

- Gerät für Quittungs-Bundle

Medication

- Beispiel-Medikament mit Einheiten

- Medikament-Kombipackung

- Medication-Rezeptur-FD

- Medikament-Rezeptur

- Medikament ohne Stärke-Code

- Medikament ohne Stärke-Numerator

- Einfaches Beispiel-Medikament

- Beispiel-Medikament Sumatriptan

MedicationDispense

- Zweites Beispiel Medikamentenabgabe

- Beispiel Medikamentenabgabe mit Dosierung nach Kombination des Wochentags

- Beispiel Medikamentenabgabe mit Dosierung nach Kombination des Intervals

- Beispiel Medikamentenabgabe mit Dosierung nach Interval

- Beispiel Medikamentenabgabe mit Dosierung nach 4er Schema

- Beispiel Medikamentenabgabe mit Dosierung nach Uhrzeitbezug

- Beispiel Medikamentenabgabe mit Dosierung nach Wochentagsbezug

- Beispiel Kombipackung Medikamentenabgabe

- Example Rezeptur Medication Dispense

- Beispiel Medikamentenabgabe ohne Medikament

- Beispiel Medikamentenabgabe

- Rx MedicationDispense example

OperationOutcome

- Example error response for Rx operations

Parameters

- Beispiel Close-Parameter

- Beispiel Close-Parameter für Kombipackung

- Beispiel Close-Parameter mit mehreren MedicationDispenses

- Example Close Parameters

- Example Dispense Parameters

- Example Dispense Parameters

- Example Dispense Parameters

- Example request parameters for Rx operations

Subscription

- Anfrage fuer POST /Subscription

- Antwort fuer POST /Subscription

Task

- Task angenommen und abgegeben via $dispense Operation

- Rx Task in ready state

- Task abgeschlossen durch Apotheke via $close Operation

- Task aktiviert durch (Z)PVS/KIS via $activate Operation

- Task erstellt durch Fachdienst via $create Operation

- Task erstellt durch Fachdienst via $create Operation

- Task angenommen durch Apotheke via $accept Operation

- Task mit mehreren MedicationDispenses