Ihre Meinung macht den Unterschied
Jetzt Feedback zum gematik Fachportal geben!
Unterstützen Sie uns dabei, das gematik Fachportal weiter zu verbessern.
Was funktioniert gut? Wo sehen Sie Optimierungsbedarf? Nehmen Sie sich einen Moment Zeit und bringen Sie Ihre Perspektive ein.
C_12639_Anlage_V1.0.0
Prereleases:
C_12639_Anlage
1 Operation API: Medikationsliste abrufen (eML)
1.1 Einbindung der Patient-Instanz aus dem Patient Service in das Suchergebnis der Operation Medikationsliste abrufen (eML)
Alt:
IG-MED69057S0X - Einbindung der Patient-Instanz aus dem Patient Service in das Suchergebnis der Operation Medikationsliste abrufen (eML) - MUSS
Der Medication Service MUSS sicherstellen, dass die zugehörige Patient-Instanz aus dem Patient Service in das Suchergebnis der Operation Medikationsliste abrufen (eML) eingebunden wird.[<=]
Neu:
IG-MED69057S0X-01 - Einbindung der Patient-Instanz aus dem Patient Service in das Suchergebnis der Operation Medikationsliste abrufen (eML) - MUSS
Der Medication Service MUSS sicherstellen, dass die zugehörige Patient-Instanz aus dem Patient Service in das Suchergebnis der Operation Medikationsliste abrufen (eML) eingebunden wird, sofern sie vorhanden ist.[<=]
1.2 Patient-Instanz als erstes Element der ersten Ergebnisseite im Suchergebnis der Operation Medikationsliste abrufen (eML)
Alt:
IG-MED25360QCP - Patient-Instanz als erstes Element der ersten Ergebnisseite im Suchergebnis der Operation Medikationsliste abrufen (eML) - MUSS
Der Medication Service MUSS sicherstellen, dass die Patient-Instanz innerhalb des Suchergebnisses der Operation Medikationsliste abrufen (eML) immer als erstes Element der ersten Ergebnisseite zurückgegeben wird.[<=]
Neu:
IG-MED25360QCP-01 - Patient-Instanz als erstes Element der ersten Ergebnisseite im Suchergebnis der Operation Medikationsliste abrufen (eML) - MUSS
Der Medication Service MUSS sicherstellen, dass die Patient-Instanz innerhalb des Suchergebnisses der Operation Medikationsliste abrufen (eML) immer als erstes Element der ersten Ergebnisseite zurückgegeben wird. Liegt die Patient-Instanz aus dem Patient Service nicht vor, ist sie kein Bestandteil der zurückzuliefernden Suchergebnismenge.[<=]
1.3 Integrität der Suchergebnisseite bei Abruf der Medikationsliste (eML)
Alt:
IG-MED16008ST8-02 - Integrität der Suchergebnisseite bei Abruf der Medikationsliste (eML) - MUSS
Der Medication Service MUSS bei Berechnung der Anzahl von Elementen auf einer Suchergebnisseite per _count ausschließlich die MedicationStatement-Instanzen berücksichtigen (d.h. sich nicht auf die Gesamtanzahl der Einträge im FHIR Bundle beziehen). Die MedicationStatement-Instanzen sollen im FHIR Bundle mit entry.search.mode = "match" gekennzeichnet werden. Zugehörig referenzierte Ressourcen (d.h. Medication, MedicationRequest, MedicationDispense, Practitioner, PractitionerRole, Organization, Provenance und Patient) müssen zusätzlich in das FHIR Bundle aufgenommen und mit entry.search.mode = "include" markiert werden.[<=]
Neu:
IG-MED16008ST8-03 - Integrität der Suchergebnisseite bei Abruf der Medikationsliste (eML) - MUSS
Der Medication Service MUSS bei Berechnung der Anzahl von Elementen auf einer Suchergebnisseite per _count ausschließlich die MedicationStatement-Instanzen berücksichtigen (d.h. sich nicht auf die Gesamtanzahl der Einträge im FHIR Bundle beziehen). Die MedicationStatement-Instanzen sollen im FHIR Bundle mit entry.search.mode = "match" gekennzeichnet werden. Zugehörig referenzierte Ressourcen (d.h. Medication, MedicationRequest, MedicationDispense, Practitioner, PractitionerRole, Organization, Provenance und - sofern im Patient Service vorliegend - Patient) müssen zusätzlich in das FHIR Bundle aufgenommen und mit entry.search.mode = "include" markiert werden.[<=]
2 Render API: Medikationsliste abrufen (eML)
2.1 Schematischer Aufbau und Datenherkunft der generierten elektronischen Medikationsliste (eML)
Alt:
IG-MED64473BLY-02 - Schematischer Aufbau und Datenherkunft der generierten elektronischen Medikationsliste (eML) - MUSS
Der Medication Service MUSS die Medikationsliste in beiden Ausgabeformaten (d.h. PDF/A und XHTML) generieren können. Verbindliche Vorgaben für den schematischen Aufbau und die Benennung der Datenherkunft innerhalb des Medication Service erfolgen nachstehend. Liegen substituierte Arzneimittel vor, müssen diese pro Substitution als Listeneintrag für die Quelle herangezogen werden. Der identifizierenden Werte des Aktenkontoinhabers müssen unter Hinzuziehung der aktuellen Instanz von [EPAPatient] belegt werden.
| Name | Patient.name:Name.prefix Patient.name:Name.given Patient.name:Name.family |
|---|---|
| Geburtsdatum | Patient.birthDate im Format [TT.MM.JJJJ] |
| KVNR | Patient.identifier:KVNR |
| Spaltenkopf | FHIR-Profil
FHIR Element-ID |
Bemerkung |
|---|---|---|
| Verordnung | EPAMedicationRequest
MedicationRequest.authoredOn
und Beide Datenquellen aus der Verordnung sind zu verknüpfen: [PractitionerDirectory] bzw. [OrganizationDirectory] Practitioner.name + " " + Organization.name |
Bleibt leer bei Nachträgen |
| Dispensierung | EPAMedicationDispense
MedicationDispense.whenHandedOver
und [OrganizationDirectory] Organization.name in MedicationDispense.performer.actor |
Bleibt leer bei Nachträgen |
| Bearbeitung | [EPAActivityProvenance]
Provenance.recorded
und [TIOrganization] Organization.name in Provenance.agent.who |
Bleibt leer, wenn Provenance.agent.who der Medication Service |
| Wirkstoffname | Wenn vorhanden, dann wie folgt zu belegen:
EPAMedicationStatement bzw. EPAMedication Medication.ingredient.item[x]:itemCodeableConcept.text in MedicationStatement.medicationReference |
|
| Wirkstärke | Wenn vorhanden, dann wie folgt zu belegen:
EPAMedicationStatement bzw. EPAMedication Medication.ingredient.strength in MedicationStatement.medicationReference
Falls vorhanden, sind Numerator und Denominator mit jeweils den Belegungen zu value und unit getrennt mit Bruchstrich anzugeben. |
|
| Arzneimittelbezeichnung | Wenn vorhanden, dann bei Nicht-Wirkstoffverordnungen wie folgt zu belegen:
EPAMedicationStatement bzw. EPAMedication Medication.code.text in MedicationStatement.medicationReference |
|
| Form | Wenn vorhanden, dann wie folgt zu belegen:
EPAMedicationStatement bzw. EPAMedication Medication.form.coding |
|
| Dosierangabe | [DosageDgMP]
Wenn vorhanden, dann wie folgt zu belegen: MedicationStatement.extension:renderedDosageInstruction.valueMarkdown
ansonsten, falls vorhanden: Dosage.text in MedicationStatement.dosage |
|
| PZN | Bei PZN-Verordnung wie folgt zu belegen:
EPAMedicationStatement bzw. EPAMedication Medication.code.coding:pznCode in MedicationStatement.medicationReference
Bei PZN-basierter Abgabe zu einer Rezepturverordnung wie folgt zu belegen: EPAMedicationStatement bzw. EPAMedication Medication.ingredient.item[x]:itemCodeableConcept.coding:pznCode.code in MedicationStatement.medicationReference |
|
| eMP | Sofern ein Eintrag in EPAMedicationStatement mit
MedicationStatement.baseOn und .extension:isEmp.valueBoolean = true
existiert, wird hier ein X dargestellt. |
Tabelle: Schematischer Aufbau und Datenherkunft der generierten elektronischen Medikationsliste (eML)
[<=]
Neu:
IG-MED64473BLY-03 - Schematischer Aufbau und Datenherkunft der generierten elektronischen Medikationsliste (eML) - MUSS
Der Medication Service MUSS die Medikationsliste in beiden Ausgabeformaten (d.h. PDF/A und XHTML) generieren können. Verbindliche Vorgaben für den schematischen Aufbau und die Benennung der Datenherkunft innerhalb des Medication Service erfolgen nachstehend. Liegen substituierte Arzneimittel vor, müssen diese pro Substitution als Listeneintrag für die Quelle herangezogen werden. Der identifizierenden Werte des Aktenkontoinhabers müssen unter Hinzuziehung der aktuellen Instanz von [EPAPatient] belegt werden, sofern sie im Patient Service vorliegen. Liegt sie nicht vor, MUSS der Medication Service dennoch den schematischen Aufbau für die Identifikationsdaten beibehalten (d.h. Name und Geburtsdatum ohne Wert). Die KVNR wird aus dem intern verfügbaren Aktenkonto bezogen.
| Name | Patient.name:Name.prefix Patient.name:Name.given Patient.name:Name.family |
|---|---|
| Geburtsdatum | Patient.birthDate im Format [TT.MM.JJJJ] |
| KVNR | Patient.identifier:KVNR |
| Spaltenkopf | FHIR-Profil
FHIR Element-ID |
Bemerkung |
|---|---|---|
| Verordnung | EPAMedicationRequest
MedicationRequest.authoredOn
und Beide Datenquellen aus der Verordnung sind zu verknüpfen: [PractitionerDirectory] bzw. [OrganizationDirectory] Practitioner.name + " " + Organization.name |
Bleibt leer bei Nachträgen |
| Dispensierung | EPAMedicationDispense
MedicationDispense.whenHandedOver
und [OrganizationDirectory] Organization.name in MedicationDispense.performer.actor |
Bleibt leer bei Nachträgen |
| Bearbeitung | [EPAActivityProvenance]
Provenance.recorded
und [TIOrganization] Organization.name in Provenance.agent.who |
Bleibt leer, wenn Provenance.agent.who der Medication Service |
| Wirkstoffname | Wenn vorhanden, dann wie folgt zu belegen:
EPAMedicationStatement bzw. EPAMedication Medication.ingredient.item[x]:itemCodeableConcept.text in MedicationStatement.medicationReference |
|
| Wirkstärke | Wenn vorhanden, dann wie folgt zu belegen:
EPAMedicationStatement bzw. EPAMedication Medication.ingredient.strength in MedicationStatement.medicationReference
Falls vorhanden, sind Numerator und Denominator mit jeweils den Belegungen zu value und unit getrennt mit Bruchstrich anzugeben. |
|
| Arzneimittelbezeichnung | Wenn vorhanden, dann bei Nicht-Wirkstoffverordnungen wie folgt zu belegen:
EPAMedicationStatement bzw. EPAMedication Medication.code.text in MedicationStatement.medicationReference |
|
| Form | Wenn vorhanden, dann wie folgt zu belegen:
EPAMedicationStatement bzw. EPAMedication Medication.form.coding |
|
| Dosierangabe | [DosageDgMP]
Wenn vorhanden, dann wie folgt zu belegen: MedicationStatement.extension:renderedDosageInstruction.valueMarkdown
ansonsten, falls vorhanden: Dosage.text in MedicationStatement.dosage |
|
| PZN | Bei PZN-Verordnung wie folgt zu belegen:
EPAMedicationStatement bzw. EPAMedication Medication.code.coding:pznCode in MedicationStatement.medicationReference
Bei PZN-basierter Abgabe zu einer Rezepturverordnung wie folgt zu belegen: EPAMedicationStatement bzw. EPAMedication Medication.ingredient.item[x]:itemCodeableConcept.coding:pznCode.code in MedicationStatement.medicationReference |
|
| eMP | Sofern ein Eintrag in EPAMedicationStatement mit
MedicationStatement.baseOn und .extension:isEmp.valueBoolean = true
existiert, wird hier ein X dargestellt. |
Tabelle: Schematischer Aufbau und Datenherkunft der generierten elektronischen Medikationsliste (eML)
[<=]
3 Operation API: Medikationsplan abrufen (eMP)
3.1 Anzeige von eMP-Einträgen
Alt:
IG-MED71604H2P-02 - Anzeige von eMP-Einträgen - MUSS
Das ePA-Client-System MUSS mindestens die nachfolgenden Elemente eines eMP-Eintrags zur Anzeige bringen:
- Präfix Versichertennamens -
Patient.name:Name.prefix - Vorname des Versicherten -
Patient.name:Name.given - Nachname des Versicherten -
Patient.name:Name.family - Geburtsdatum -
Patient.birthDate - Versichertennummer -
Patient.identifier:KVNR - Verfassungsdatum -
MedicationRequest.authoredOn - Wirkstoff -
Medication.ingredient.item[x]:itemCodeableConcept.text - Handelsname -
Medication.code.textinMedicationRequest.medicationReference - Wirkstärke (Numerator, Denominator, Text) -
Medication.ingredient.strength.numeratorinMedicationRequest.medicationReference - Form -
Medication.form.coding - Hinweise für Versicherte -
MedicationRequest.extension:patientNote.valueAnnotation.text - Grund (ICD-10 Code) -
MedicationRequest.reasonCode.coding:icd-10-gm - Grund / Versicherter -
MedicationRequest.extension:reasonPatientInstruction.valueString - Anwendungszeitraum Start/Ende -
MedicationRequest.extension:effectiveDosePeriod - Dosierangabe -
MedicationRequest.extension:renderedDosageInstruction.valueMarkdown, sonst falls vorhanden:MedicationRequest.dosageInstruction.text - Tabellendosierung morgens/mittags/abends/Nacht -
MedicationRequest.dosageInstruction.timing.repeat.when - Hinweis für Mitbehandelnde -
MedicationRequest.note
[<=]
Neu:
IG-MED71604H2P-03 - Anzeige von eMP-Einträgen - MUSS
Das ePA-Client-System MUSS mindestens die nachfolgenden Elemente eines eMP-Eintrags zur Anzeige bringen:
- Präfix Versichertennamen - falls vorhanden:
Patient.name:Name.prefix - Vorname des Versicherten - falls vorhanden:
Patient.name:Name.given - Nachname des Versicherten - falls vorhanden:
Patient.name:Name.family - Geburtsdatum - falls vorhanden:
Patient.birthDate - Versichertennummer - falls vorhanden:
Patient.identifier:KVNR - Verfassungsdatum -
MedicationRequest.authoredOn - Wirkstoff -
Medication.ingredient.item[x]:itemCodeableConcept.text - Handelsname -
Medication.code.textinMedicationRequest.medicationReference - Wirkstärke (Numerator, Denominator, Text) -
Medication.ingredient.strength.numeratorinMedicationRequest.medicationReference - Form -
Medication.form.coding - Hinweise für Versicherte -
MedicationRequest.extension:patientNote.valueAnnotation.text - Grund (ICD-10 Code) -
MedicationRequest.reasonCode.coding:icd-10-gm - Grund / Versicherter -
MedicationRequest.extension:reasonPatientInstruction.valueString - Anwendungszeitraum Start/Ende -
MedicationRequest.extension:effectiveDosePeriod - Dosierangabe -
MedicationRequest.extension:renderedDosageInstruction.valueMarkdown, sonst falls vorhanden:MedicationRequest.dosageInstruction.text - Tabellendosierung morgens/mittags/abends/Nacht -
MedicationRequest.dosageInstruction.timing.repeat.when - Hinweis für Mitbehandelnde -
MedicationRequest.note
[<=]
3.2 Ergebnis und Datenmenge für die Operation Medikationsplan abrufen (eMP)
Alt:
IG-MED77392SBV - Ergebnis und Datenmenge für die Operation Medikationsplan abrufen (eMP) - MUSS
Der Medication Service MUSS sicherstellen, dass das Ergebnis der Operation Medikationsplan abrufen (eMP) ausschließlich relevante Instanzen des adressierten eMP-Chronologieeintrags enthält.
Das zurückgegebene FHIR Collection Bundle MUSS folgende Instanzen enthalten:
- Instanz des Profils EPAPatient aus dem Patient Service,
- die adressierte Provenance Instanz des Profils EMPChronologyProvenance,
- alle Versionen von Instanzen des Profils EMPMedicationRequest, die in Provenance.target (EMPChronologyProvenance) referenziert sind,
- alle Instanzen des Profils EMPMedication, die in MedicationRequest.medicationReference (EMPMedicationRequest) referenziert sind (eMP-Medikation),
- alle Instanzen des Profils EPAActivityProvenance, die in Provenance.target (EPAActivityProvenance) auf die relevanten Versionen von MedicationRequest (EMPMedicationRequest) verweisen,
- alle Instanzen des ResourceType Organization, die in Provenance.agent.who (EPAActivityProvenance) referenziert werden,
- falls vorhanden:
- jeweils die in MedicationRequest.activity (EMPMedicationRequest) referenzierte Instanz des Profils EPAMedicationStatement (erlaubter Status: unknown). Werden mehrere Instanzen des Profils EPAMedicationStatement referenziert, wird die gemäß MedicationStatement.effective jeweils jüngste Instanz verwendet.
- alle durch die relevanten Instanzen des Profils EPAMedicationStatement in MedicationStatement.derivedFrom referenzierten Instanzen des Profils EPAMedicationDispense,
- alle durch die relevanten Instanzen des Profils EPAMedicationStatement in MedicationStatement.derivedFrom referenzierten Instanzen des Profils EPAMedicationRequest,
- alle durch die relevanten Instanzen des Profils EPAMedicationRequest und EPAMedicationDispense in medicationReference referenzierten Instanzen des Profils EPAMedication,
- alle Instanzen des ResourceType Organization, die in MedicationDispense.performer.actor (EPAMedicationDispense) referenziert werden,
- alle Instanzen des ResourceType PractitionerRole, die in MedicationRequest.requester (EPAMedicationRequest) referenziert werden, sowie deren in PractitionerRole.practitioner referenzierte Instanzen des ResourceType Practitioner und in PractitionerRole.organization referenzierte Instanzen des ResourceType Organization.
[<=]
Neu:
IG-MED77392SBV-01 - Ergebnis und Datenmenge für die Operation Medikationsplan abrufen (eMP) - MUSS
Der Medication Service MUSS sicherstellen, dass das Ergebnis der Operation Medikationsplan abrufen (eMP) ausschließlich relevante Instanzen des adressierten eMP-Chronologieeintrags enthält.
Das zurückgegebene FHIR Collection Bundle MUSS folgende Instanzen enthalten:
- falls vorhanden, Instanz des Profils EPAPatient aus dem Patient Service,
- die adressierte Provenance Instanz des Profils EMPChronologyProvenance,
- alle Versionen von Instanzen des Profils EMPMedicationRequest, die in Provenance.target (EMPChronologyProvenance) referenziert sind,
- alle Instanzen des Profils EMPMedication, die in MedicationRequest.medicationReference (EMPMedicationRequest) referenziert sind (eMP-Medikation),
- alle Instanzen des Profils EPAActivityProvenance, die in Provenance.target (EPAActivityProvenance) auf die relevanten Versionen von MedicationRequest (EMPMedicationRequest) verweisen,
- alle Instanzen des ResourceType Organization, die in Provenance.agent.who (EPAActivityProvenance) referenziert werden,
- falls vorhanden:
- jeweils die in MedicationRequest.activity (EMPMedicationRequest) referenzierte Instanz des Profils EPAMedicationStatement (erlaubter Status: unknown). Werden mehrere Instanzen des Profils EPAMedicationStatement referenziert, wird die gemäß MedicationStatement.effective jeweils jüngste Instanz verwendet.
- alle durch die relevanten Instanzen des Profils EPAMedicationStatement in MedicationStatement.derivedFrom referenzierten Instanzen des Profils EPAMedicationDispense,
- alle durch die relevanten Instanzen des Profils EPAMedicationStatement in MedicationStatement.derivedFrom referenzierten Instanzen des Profils EPAMedicationRequest,
- alle durch die relevanten Instanzen des Profils EPAMedicationRequest und EPAMedicationDispense in medicationReference referenzierten Instanzen des Profils EPAMedication,
- alle Instanzen des ResourceType Organization, die in MedicationDispense.performer.actor (EPAMedicationDispense) referenziert werden,
- alle Instanzen des ResourceType PractitionerRole, die in MedicationRequest.requester (EPAMedicationRequest) referenziert werden, sowie deren in PractitionerRole.practitioner referenzierte Instanzen des ResourceType Practitioner und in PractitionerRole.organization referenzierte Instanzen des ResourceType Organization.
[<=]
4 Render API: Medikationsplan abrufen (eMP)
4.1 eMP-PDF/A: FHIR-Daten für die Operation
Alt:
IG-MED18735RJF - eMP-PDF/A: FHIR-Daten für die Operation - MUSS
Der Medication Service MUSS sicherstellen, dass das Ergebnis der Operation ausschließlich auf Daten basiert, die durch den aktuellen eMP-Chronologieeintrag referenziert werden. Für jeden durch den aktuellen eMP-Chronologieeintrag referenzierte Instanz des Profils EMPMedicationRequest sind u.a. Instanzen von folgenden Profilen relevant:
- EMPMedicationRequest im Status active,
- die vom ausgewählten EMPMedicationRequest referenzierte EMPMedication,
- aktuelle EPAPatient-Instanz.
[<=]
Neu:
IG-MED18735RJF-01 - eMP-PDF/A: FHIR-Daten für die Operation - MUSS
Der Medication Service MUSS sicherstellen, dass das Ergebnis der Operation ausschließlich auf Daten basiert, die durch den aktuellen eMP-Chronologieeintrag referenziert werden. Für jeden durch den aktuellen eMP-Chronologieeintrag referenzierte Instanz des Profils EMPMedicationRequest sind u.a. Instanzen von folgenden Profilen relevant:
- EMPMedicationRequest im Status active,
- die vom ausgewählten EMPMedicationRequest referenzierte EMPMedication,
- sofern vorhanden, aktuelle EPAPatient-Instanz.
[<=]
4.2 eMP-PDF/A: Datenherkunft Tabelleninhalte
Alt:
IG-MED80730R7R - eMP-PDF/A: Datenherkunft Tabelleninhalte - MUSS
Der Medication Service MUSS für den Medikationsplan im PDF/A-Format Daten aus den folgenden Quellen verwenden:
| Bezeichnung | FHIR-Profil
FHIR Element-ID |
Beispiel |
|---|---|---|
| Präfix | [EPAPatient]
Patient.name:Name.prefix |
"Dr." |
| Vorname | [EPAPatient]
Patient.name:Name.given |
"Horst" |
| Nachname | [EPAPatient]
Patient.name:Name.family |
"Graf van Himmelblau" |
| Erstellungszeitpunkt | Aktueller Systemzeitpunkt | "04.11.2025 10:13" |
| Geburtsdatum | [EPAPatient]
Patient.birthDate |
|
| Versichertennummer | [EPAPatient]
Patient.identifier:KVNR |
|
| Verfassungsdatum | EMPMedicationRequest
MedicationRequest.authoredOn |
|
| Wirkstoff | EMPMedication
Medication.ingredient.item[x]:itemCodeableConcept.text |
|
| Handelsname | EMPMedication
Medication.code.text in MedicationRequest.medicationReference |
|
| Stärke-Numerator | EMPMedication
Medication.ingredient.strength.numerator in MedicationRequest.medicationReference |
|
| Stärke-Denominator | EMPMedication
Medication.ingredient.strength.denominator in MedicationRequest.medicationReference |
|
| Stärke-Text | EMPMedication
Medication.ingredient.strength.extension:amountText in MedicationRequest.medicationReference |
|
| Form | EMPMedication
Falls vorhanden: Medication.form.coding.display,
ansonsten: Medication.form.coding.code |
|
| Hinweise | EMPMedicationRequest
MedicationRequest.extension:patientNote.valueAnnotation.text |
|
| Grund | EMPMedicationRequest
MedicationRequest.extension:reasonPatientInstruction.valueString |
|
| Anwendungszeitraum-Start | EMPMedicationRequest
MedicationRequest.extension:effectiveDosePeriod.start |
|
| Anwendungszeitraum-Ende | EMPMedicationRequest
MedicationRequest.extension:effectiveDosePeriod.end |
|
| Dosierinformation | EMPMedicationRequest
Falls vorhanden: MedicationRequest.extension:renderedDosageInstruction.valueMarkdown,
ansonsten, falls vorhanden: MedicationRequest.dosageInstruction.text |
|
| Tabellendosierung-morgens | EMPMedicationRequest
MedicationRequest.dosageInstruction.doseAndRate.doseQuantity.value aus derjenigen Dosierung in MedicationRequest.dosageInstruction, welche in MedicationRequest.dosageInstruction.timing.repeat.when den Wert 'MORN' enthält. |
|
| Tabellendosierung-mittags | EMPMedicationRequest
MedicationRequest.dosageInstruction.doseAndRate.doseQuantity.value aus derjenigen Dosierung in MedicationRequest.dosageInstruction, welche in MedicationRequest.dosageInstruction.timing.repeat.when den Wert 'NOON' enthält. |
|
| Tabellendosierung-abends | EMPMedicationRequest
MedicationRequest.dosageInstruction.doseAndRate.doseQuantity.value aus derjenigen Dosierung in MedicationRequest.dosageInstruction, welche in MedicationRequest.dosageInstruction.timing.repeat.when den Wert 'EVE' enthält. |
|
| Tabellendosierung-zur-Nacht | EMPMedicationRequest
MedicationRequest.dosageInstruction.doseAndRate.doseQuantity.value aus derjenigen Dosierung in MedicationRequest.dosageInstruction, welche in MedicationRequest.dosageInstruction.timing.repeat.when den Wert 'NIGHT' enthält. |
|
| Einheit | EMPMedicationRequest
MedicationRequest.dosageInstruction.doseAndRate.doseQuantity.unit.distinct() |
Tabelle: Datenherkünfte des generierten elektronischen Medikationsplans (eMP)
[<=]
Neu:
IG-MED80730R7R-01 - eMP-PDF/A: Datenherkunft Tabelleninhalte - MUSS
Der Medication Service MUSS für den Medikationsplan im PDF/A-Format Daten aus den folgenden Quellen verwenden:
| Bezeichnung | FHIR-Profil
FHIR Element-ID |
Beispiel |
|---|---|---|
| Präfix | falls vorhanden:
|
"Dr." |
| Vorname | falls vorhanden:
[EPAPatient] Patient.name:Name.given |
"Horst" |
| Nachname | falls vorhanden:
[EPAPatient] Patient.name:Name.family |
"Graf van Himmelblau" |
| Erstellungszeitpunkt | Aktueller Systemzeitpunkt | "04.11.2025 10:13" |
| Geburtsdatum | falls vorhanden:
[EPAPatient] Patient.birthDate |
|
| Versichertennummer | falls vorhanden:
[EPAPatient] Patient.identifier:KVNR,
sonst: KVNR aus dem intern verfügbaren Aktenkonto |
|
| Verfassungsdatum | EMPMedicationRequest
MedicationRequest.authoredOn |
|
| Wirkstoff | EMPMedication
Medication.ingredient.item[x]:itemCodeableConcept.text |
|
| Handelsname | EMPMedication
Medication.code.text in MedicationRequest.medicationReference |
|
| Stärke-Numerator | EMPMedication
Medication.ingredient.strength.numerator in MedicationRequest.medicationReference |
|
| Stärke-Denominator | EMPMedication
Medication.ingredient.strength.denominator in MedicationRequest.medicationReference |
|
| Stärke-Text | EMPMedication
Medication.ingredient.strength.extension:amountText in MedicationRequest.medicationReference |
|
| Form | EMPMedication
Falls vorhanden: Medication.form.coding.display,
ansonsten: Medication.form.coding.code |
|
| Hinweise | EMPMedicationRequest
MedicationRequest.extension:patientNote.valueAnnotation.text |
|
| Grund | EMPMedicationRequest
MedicationRequest.extension:reasonPatientInstruction.valueString |
|
| Anwendungszeitraum-Start | EMPMedicationRequest
MedicationRequest.extension:effectiveDosePeriod.start |
|
| Anwendungszeitraum-Ende | EMPMedicationRequest
MedicationRequest.extension:effectiveDosePeriod.end |
|
| Dosierinformation | EMPMedicationRequest
Falls vorhanden: MedicationRequest.extension:renderedDosageInstruction.valueMarkdown,
ansonsten, falls vorhanden: MedicationRequest.dosageInstruction.text |
|
| Tabellendosierung-morgens | EMPMedicationRequest
MedicationRequest.dosageInstruction.doseAndRate.doseQuantity.value aus derjenigen Dosierung in MedicationRequest.dosageInstruction, welche in MedicationRequest.dosageInstruction.timing.repeat.when den Wert 'MORN' enthält. |
|
| Tabellendosierung-mittags | EMPMedicationRequest
MedicationRequest.dosageInstruction.doseAndRate.doseQuantity.value aus derjenigen Dosierung in MedicationRequest.dosageInstruction, welche in MedicationRequest.dosageInstruction.timing.repeat.when den Wert 'NOON' enthält. |
|
| Tabellendosierung-abends | EMPMedicationRequest
MedicationRequest.dosageInstruction.doseAndRate.doseQuantity.value aus derjenigen Dosierung in MedicationRequest.dosageInstruction, welche in MedicationRequest.dosageInstruction.timing.repeat.when den Wert 'EVE' enthält. |
|
| Tabellendosierung-zur-Nacht | EMPMedicationRequest
MedicationRequest.dosageInstruction.doseAndRate.doseQuantity.value aus derjenigen Dosierung in MedicationRequest.dosageInstruction, welche in MedicationRequest.dosageInstruction.timing.repeat.when den Wert 'NIGHT' enthält. |
|
| Einheit | EMPMedicationRequest
MedicationRequest.dosageInstruction.doseAndRate.doseQuantity.unit.distinct() |
Tabelle: Datenherkünfte des generierten elektronischen Medikationsplans (eMP)
[<=]
5 Migrationsvorgaben
5.1 Migrationsschritte Version 1.3.0
Alt:
IG-MED98977HQ9-01 - Migrationsschritte Version 1.3.0 - MUSS
Der Medication Service MUSS bei der Migration auf die Version 1.3.0 die folgenden Schritte ausführen (oder gleichwertige Schritte, die zum selben Ergebnis führen):
- Für jede bestehende MedicationRequest-Instanz des Profils EPAMedicationRequest mit Status active oder completed:
- Erzeugen einer MedicationStatement-Instanz des Profils EPAMedicationStatement mit folgendem Inhalt:
- Setzen von MedicationStatement.extension[context] auf PRESCRIPTION
- Setzen der Referenz in MedicationStatement.medicationReference auf die Medication-Instanz, die in der zugehörigen MedicationRequest-Instanz angegeben ist
- Setzen von MedicationStatement.extension[RxPrescriptionProcessIdentifier] auf den Wert aus MedicationRequest.identifier[RxPrescriptionProcessIdentifier]
- Setzen der Referenz in MedicationStatement.subject auf die Instanz des Profils EPAPatient unter Verwendung einer logischen Referenz mit dem Identifier der Krankenversichertennummer (KVNR) des jeweiligen Versicherten gemäß dem Identifier-Profil für die 10-stellige Krankenversichertennummer (IdentifierKvid10)
- Setzen der Referenz in MedicationStatement.derivedFrom auf die aktuelle MedicationRequest-Instanz
- Setzen von MedicationStatement.dateAsserted mit dem Wert aus MedicationRequest.authoredOn
- Setzen von MedicationStatement.dosage mit dem Wert aus MedicationRequest.dosageInstruction
- Setzen von MedicationStatement.status mit dem Wert intended
- Setzen von MedicationStatement.effectivePeriod.start mit dem Wert aus MedicationRequest.authoredOn
- Berücksichtigung zugehöriger Dispensierungen:
- Ermitteln aller EPAMedicationDispense-Instanzen mit Status completed, die die aktuelle MedicationRequest-Instanz über MedicationDispense.authorizingPrescription referenzieren.
- Für erste gefundene MedicationDispense-Instanz:
- Setzen der Referenz in MedicationStatement.derivedFrom auf diese MedicationDispense-Instanz (additiv; die Referenz auf die MedicationRequest-Instanz bleibt bestehen).
- Falls MedicationDispense.dosageInstruction gesetzt ist, denselben Wert in MedicationStatement.dosage übernehmen (überschreibt ggf. zuvor gesetzte Werte).
- Setzen der Referenz in MedicationStatement.medicationReference auf die Medication-Instanz, die in der maßgeblichen MedicationDispense-Instanz angegeben ist.
- Setzen von MedicationStatement.effectivePeriod.start auf den Wert aus MedicationDispense.whenHandedOver.
- Setzen von MedicationStatement.status mit dem Wert unknown
- Für jede weitere gefundene MedicationDispense-Instanz:
- Erzeugen einer MedicationStatement-Instanz des Profils EPAMedicationStatement mit folgendem Inhalt:
- Setzen der Referenz in MedicationStatement.derivedFrom auf diese MedicationDispense-Instanz und zusätzlich auf die relevante MedicationRequest-Instanz.
- Falls MedicationDispense.dosageInstruction gesetzt ist, denselben Wert in MedicationStatement.dosage übernehmen.
- Setzen der Referenz in MedicationStatement.medicationReference auf die Medication-Instanz, die in der aktuellen MedicationDispense-Instanz angegeben ist.
- Setzen von MedicationStatement.effectivePeriod.start auf den Wert aus MedicationDispense.whenHandedOver.
- Setzen von MedicationStatement.status mit dem Wert unknown
- Erzeugen einer Provenance-Instanz des Profils EPAActivityProvenance für jede oben erzeugte MedicationStatement-Instanz:
- Setzen von Provenance.target auf die erzeugte MedicationStatement-Instanz
- Setzen von Provenance.activity mit dem Wert CREATE
- Setzen von Provenance.agent.who auf den Wert MEDICATIONSVC
Für alle im Rahmen der Migration erzeugten MedicationStatement- und Provenance-Ressourceninstanzen ist die meta.versionId
auf 1 zu setzen und meta.lastUpdated auf den Zeitpunkt der Durchführung der Migration zu setzen. Die
Provenance-Instanz hat dabei konkret über eine versionierte Referenz auf die neu erstellte MedicationStatement-Instanz zu verweisen.[<=]
Neu:
IG-MED98977HQ9-02 - Migrationsschritte Version 1.3.0 - MUSS
Der Medication Service MUSS bei der Migration auf die Version 1.3.0 die folgenden Schritte ausführen (oder gleichwertige Schritte, die zum selben Ergebnis führen):
- Für jede bestehende MedicationRequest-Instanz des Profils EPAMedicationRequest mit Status active oder completed:
- Erzeugen einer MedicationStatement-Instanz des Profils EPAMedicationStatement mit folgendem Inhalt:
- Setzen von MedicationStatement.extension[context] auf PRESCRIPTION
- Setzen der Referenz in MedicationStatement.medicationReference auf die Medication-Instanz, die in der zugehörigen MedicationRequest-Instanz angegeben ist
- Setzen von MedicationStatement.extension[RxPrescriptionProcessIdentifier] auf den Wert aus MedicationRequest.identifier[RxPrescriptionProcessIdentifier]
- Setzen der Referenz in MedicationStatement.subject auf - sofern vorhanden - die Instanz des Profils EPAPatient (anderenfalls aus dem intern verfügbaren Aktenkonto) unter Verwendung einer logischen Referenz mit dem Identifier der Krankenversichertennummer (KVNR) des jeweiligen Versicherten gemäß dem Identifier-Profil für die 10-stellige Krankenversichertennummer (IdentifierKvid10)
- Setzen der Referenz in MedicationStatement.derivedFrom auf die aktuelle MedicationRequest-Instanz
- Setzen von MedicationStatement.dateAsserted mit dem Wert aus MedicationRequest.authoredOn
- Setzen von MedicationStatement.dosage mit dem Wert aus MedicationRequest.dosageInstruction
- Setzen von MedicationStatement.status mit dem Wert intended
- Setzen von MedicationStatement.effectivePeriod.start mit dem Wert aus MedicationRequest.authoredOn
- Berücksichtigung zugehöriger Dispensierungen:
- Ermitteln aller EPAMedicationDispense-Instanzen mit Status completed, die die aktuelle MedicationRequest-Instanz über MedicationDispense.authorizingPrescription referenzieren.
- Für erste gefundene MedicationDispense-Instanz:
- Setzen der Referenz in MedicationStatement.derivedFrom auf diese MedicationDispense-Instanz (additiv; die Referenz auf die MedicationRequest-Instanz bleibt bestehen).
- Falls MedicationDispense.dosageInstruction gesetzt ist, denselben Wert in MedicationStatement.dosage übernehmen (überschreibt ggf. zuvor gesetzte Werte).
- Setzen der Referenz in MedicationStatement.medicationReference auf die Medication-Instanz, die in der maßgeblichen MedicationDispense-Instanz angegeben ist.
- Setzen von MedicationStatement.effectivePeriod.start auf den Wert aus MedicationDispense.whenHandedOver.
- Setzen von MedicationStatement.status mit dem Wert unknown
- Für jede weitere gefundene MedicationDispense-Instanz:
- Erzeugen einer MedicationStatement-Instanz des Profils EPAMedicationStatement mit folgendem Inhalt:
- Setzen der Referenz in MedicationStatement.derivedFrom auf diese MedicationDispense-Instanz und zusätzlich auf die relevante MedicationRequest-Instanz.
- Falls MedicationDispense.dosageInstruction gesetzt ist, denselben Wert in MedicationStatement.dosage übernehmen.
- Setzen der Referenz in MedicationStatement.medicationReference auf die Medication-Instanz, die in der aktuellen MedicationDispense-Instanz angegeben ist.
- Setzen von MedicationStatement.effectivePeriod.start auf den Wert aus MedicationDispense.whenHandedOver.
- Setzen von MedicationStatement.status mit dem Wert unknown
- Erzeugen einer Provenance-Instanz des Profils EPAActivityProvenance für jede oben erzeugte MedicationStatement-Instanz:
- Setzen von Provenance.target auf die erzeugte MedicationStatement-Instanz
- Setzen von Provenance.activity mit dem Wert CREATE
- Setzen von Provenance.agent.who auf den Wert MEDICATIONSVC
Für alle im Rahmen der Migration erzeugten MedicationStatement- und Provenance-Ressourceninstanzen ist die meta.versionId
auf 1 zu setzen und meta.lastUpdated auf den Zeitpunkt der Durchführung der Migration zu setzen. Die
Provenance-Instanz hat dabei konkret über eine versionierte Referenz auf die neu erstellte MedicationStatement-Instanz zu verweisen.[<=]
6 Patient Service: Query API
Hinweis: In der Query API zur optionalen Abfrage der Patient-Ressource gibt das ePA-Aktensystem standardmäßig den HTTP Status Code 404 mit Error Code MSG_UNKNOWN_TYPE zurück, sofern (noch) keine Patient-Ressourceninstanz vorliegt (siehe https://gemspec.gematik.de/ig/fhir/epa/1.3.0/query-api-patient.html). Hier ist keine Änderung notwendig.