Implementation Guide
ePA Medication Service
Version 1.0.5-1 - release

## FHIR-Artefakte

Diese Seite enthält eine Übersicht aller FHIR-Artefakte, die im Rahmen dieses Implementierungsleitfadens für den Medication Service definiert werden. Sie bilden die Grundlage für die strukturierte Abbildung und Verarbeitung von Medikationsdaten innerhalb des Medication Service. 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.

### Systemverhalten

#### Capability Statements

Das CapabilityStatement beschreibt die Anforderungen und Fähigkeiten, die ein Server für die konforme Implementierung des Medication Service umsetzen muss. Es handelt sich um eine Konformitätserklärung, die spezifiziert, welche Ressourcen, Interaktionen und Suchparameter das ePA-Aktensystem für den Medication Service unterstützen muss.

EPA CapabilityStatement für den the Medication Service | EPA CapabilityStatement für den the Medication Service

#### Operation Definitions

Cancel Dispensation eRP | The Cancel Dispensation eRP operation, used by the E-Rezept-Fachdienst, in the context of the ePA Medication Service, is applied to cancel or reverse information regarding the dispensation of a medication. This operation is necessary when a medication dispensation is cancelled by a pharmacist or when there is a return of the medication by the insurant. After the E-Rezept-Fachdienst performs this operation, the corresponding dispensation entry for the medication in the patient's ePA is marked as cancelled, which the goal in ensuring an accurate and up-to-date record of the patient's medication data.
Cancel Prescription eRP | The $cancel-prescription-erp operation is used by the E-Rezept-Fachdienst to cancel an already issued electronic prescription. This function is applied when a prescription is no longer needed for various reasons, such as changes in medication or errors in the initial issuance. After cancellation by the E-Rezept-Fachdienst, this information is transmitted to the ePA Medication Service, where the prescription is calculations. It can then no longer be used for dispensing medication. This process ensures accuracy and safety in the management of medications.
Get Medication List | Get a medication list
Provide Dispensation eRP | The Provide Dispensation eRP operation in the ePA Medication Service is used to record information about the dispensing of medications based on an electronic prescription in the patient's record. This operation comes into play when a patient receives their medication from a pharmacy. It documents that the medication has been dispensed as per the prescription, including details like the quantity, date of dispensing, and pharmacy information. This helps maintain a comprehensive overview of the patient's medication history.
Provide Prescription eRP | The Provide Prescription eRP operation in the ePA MedicationService is used to add electronic prescriptions to a patient's record. These prescriptions are already made by the E-Rezept-Fachdienst. This operation does not create new patient prescriptions; it just puts the ones made by the E-Rezept-Fachdienst into the patient's ePA, making sure they are stored safely and can be easily accessed.

#### Operation Outcome

EPA Medication Service OperationOutcome Code System | EPA Medication Service Operation Outcome Code System
EPA Medication Service Operation Outcome | Das Operation Outcome-Profil für den Medication Service der ePA.
EPA Medication Service Operation Outcome ValueSet | Enthält alle Codes für das Operation Outcome des Medication Service.

### Parameterprofile für Operationen

EPA Operation CancelDispensation ERP Input-Parameters | EPA Operation CancelDispensation ERP Input-Parameters
EPA Operation CancelPrescription ERP Input-Parameters | EPA Operation CancelPrescription ERP Input-Parameters
EPA Operation ProvideDispensation ERP Input-Parameters | EPA Operation ProvideDispensation ERP Input-Parameters
EPA Operation ProvidePrescription ERP Input-Parameters | EPA Operation ProvidePrescription ERP Input-Parameters
EPA Operation RxDispensation ERP Output-Parameters | EPA Operation RxDispensation ERP Output-Parameters
EPA Operation RxPrescription ERP Output-Parameters | EPA Operation RxPrescription ERP Output-Parameters

### Ressourcenprofile

EPA MedicationDispense | Defines the medication dispense resource for the Medication Service in the ePA system.
EPA Pharmaceutical Product Medication | Defines the medication resource for a component of a 'Kombipackung' for the Medication Service in the ePA system. These profiles are intended to inherit from EPAMedication, but due to tooling issues, this inheritance cannot currently be implemented.
EPA Medication PZN Ingredient | Defines the medication resource for a PZN ingredient of a compounding medication for the Medication Service in the ePA system. These profiles are intended to inherit from EPAMedication, but due to tooling issues, this inheritance cannot currently be implemented.
EPA MedicationRequest | Defines the medication request resource for the Medication Service in the ePA system.
EPA Medication | Defines the medication resource for the Medication Service in the ePA system.

### Datentypen

Medication Unique Identifier | This unique identifier is generated within the Medication Service. It is either a hash derived from a specific set of data elements of the Medication resource or a direct repetition of a single data element. This identifier ensures the distinct identification of Medication resources across the ePA system.
RxOriginatorProcessIdentifier | The RxOriginatorProcessIdentifier, generated within the Medication Service, links the prescriptionID from the E-Rezept-Fachdienst with the original input FHIR resource ID, facilitating accurate tracking and utilization of medication data in operational processes within digital healthcare systems.
RxPrescriptionProcessIdentifier | This transaction identifier is used to track medication prescription transactions between the E-Rezept-Fachdienst and the ePA. It is generated by the ePA Medication Service, ensuring a consistent and unique identification of each transaction. The identifier is composed of the PrescriptionId and the authoredOn-date of the operations parameters request, providing a robust mechanism for referencing and managing medication-related resources across systems.

### Erweiterungen (Extension) Definitions

DrugCategoryExtension | Extension for indicating the medication category.
Medication Type | Extension for EPAMedication types
IndicatorBVGExtension | Indicator of whether this regulation is made in reference to the 'Bundesentschädigungsgesetz' or the 'Bundesversorgungsgesetz'.
MedicationFormulationPackagingExtension | Information on the packaging of a formulation.
MedicationIngredientAmountExtensions | Free-text amount of the ingredient for classical Latin notations such as "ad 100.0" or "quantum satis," including the unit.
MedicationIngredientDarreichungsformExtension | Dosage form of an ingredient in a formulation.
MedicationIsVaccineExtension | Indicator of whether this is a vaccine.
MedicationManufacturingInstructionsExtension | Manufacturing instructions regarding the preparation of a formulation (Subscriptio).
MedicationPackagingSizeExtension | Specification of the package size according to divided quantity (e.g., 100, 2x25), only appears in conjunction with "unit" (e.g., 100 Stück).
MedicationTotalQuantityFormulationExtension | Total quantity of the formulation (without the unit).
MultiplePrescription | This FHIR Extension for multiple prescriptions adds details such as repetition count and time intervals for repeated medication orders to FHIR resources.
RxPrescriptionProcessIdentifierExtension | This extension is used to track medication prescription transactions between the E-Rezept-Fachdienst and the ePA. The RxPrescriptionProcessIdentifier is generated by the ePA Medication Service and consists of the PrescriptionId and the authoredOn date of the operation parameters request. It ensures consistent referencing and management of medication-related resources across different systems.

### Beispielinstanzen

Bundle

- ExampleEpaGetMedicationListBundle1

- ExampleSearchsetBundleEPAMedication

- ExampleSearchsetBundleEPAMedicationDispense

- ExampleSearchsetBundleEPAMedicationRequest

Medication

- ExampleEpaMedication1

- ExampleEpaMedication2

- ExampleEpaMedication3

- ExampleEpaMedication4

- CortisonDexpantenolMedication

- ExampleEPAMedicationMax

- Sample Medication Sumatripan

- TabletSprayKombipackung

MedicationDispense

- ExampleEpaMedicationDispense2

- ExampleEpaMedicationDispense1

MedicationRequest

- ExampleEpaMedicationRequest2

- ExampleEpaMedicationRequest1

OperationOutcome

- ExpOperationOutcomeSuccess

- ExpOperationOutcomeNoValidStructure

- ExpOperationOutcomeNotPermittedonCurrentDispensationStatus

- ExpOperationOutcomeNotPermittedCurrentPrescriptionStatus

- ExpOperationOutcomeOperationDispensationNotFound

- ExpOperationOutcomeUnresolvedReferenceinParameters

- ExpOperationOutcomeDuplicatePrescriptionDetected

- ExpOperationOutcomePrescriptionNotFound

Organization

- ExampleParametersOrganizationDirectory2

- ExampleParametersOrganizationDirectory1

Parameters

- ExampleEpaOpCancelDispensationERPInputParameters1

- ExampleEpaOpCancelPrescriptionERPInputParameters1

- ExampleEpaOpProvideDispensationERPInputParameters1

- ExampleEpaOpProvideDispensationERPInputParameters2

- ExampleEpaOpProvidePrescriptionERPInputParameters1

- ExampleEpaOpProvidePrescriptionERPInputParameters2

- ExampleEpaOpRxDispensationOutputParameters1

- ExampleEpaOpRxPrescriptionERPOutputParameters1

Practitioner

- ExampleParametersPractitionerDirectory

PractitionerRole

- ExampleEPAPractitionerRole