get-medication-plan-op
type: OperationDefinition
node role: treeRoot
resource.id:
  value: get-medication-plan-op
resource.meta:
  meta.profile:
    value: https://gematik.de/fhir/ti/StructureDefinition/ti-operationdefinition
    index: 0
    link: https://gematik.de/fhir/ti/StructureDefinition/ti-operationdefinition
domain resource.text:
  narrative.status:
    value: generated
  narrative.div: Generated Narrative: OperationDefinition get-medication-plan-op Profile: OperationDefinition Profil für TI FHIR Data Service URL: [base]/$medication-plan Parameters Use Name Scope Cardinality Type Binding Documentation IN provenance 0..1 uuid Die UUID der Provenance-Instanz, die eine bestimmte Version des elektronischen Medikationsplans (eMP) identifiziert. Diese Provenance-Instanz repräsentiert den Zustand zu einem bestimmten Zeitpunkt und bündelt die zu diesem Zeitpunkt aktiven eMP-Elemente. Wird kein provenance-Parameter angegeben, liefert die Operation den aktuellsten bekannten Zustand des eMP zurück. OUT return 1..1 Bundle Ein Bundle vom Typ collection, das alle relevanten Ressourceninstanzen enthält, die zum angegebenen eMP-Zustand gehören. Diese Ressourcen stammen aus dem Datenraum des Medication Service und bilden gemeinsam den logischen Medikationsplan zum gewünschten Stand ab.
domain resource.extension:
  index: 0
  extension.url:
    value: https://gematik.de/fhir/ti/StructureDefinition/extension-http-method
  extension.value code:
    value: GET
operation definition.url:
  value: https://gematik.de/fhir/epa-medication/OperationDefinition/get-medication-plan-op
operation definition.version:
  value: 1.3.2
operation definition.name:
  value: getMedicationPlan_MedicationSvc
operation definition.title:
  value: Get Medication Plan (eMP)
operation definition.status:
  value: active
operation definition.kind:
  value: operation
operation definition.date:
  value: 2026-03-20
operation definition.publisher:
  value: gematik GmbH
operation definition.contact:
  index: 0
  contact detail.name:
    value: gematik GmbH
  contact detail.telecom:
    index: 0
    contact point.system:
      value: url
    contact point.value:
      value: https://www.gematik.de
  contact detail.telecom:
    index: 1
    contact point.system:
      value: email
    contact point.value:
      value: patientteam [ at ] gematik.de
operation definition.description:
  value: Diese Operation ermöglicht den gezielten Abruf eines elektronischen Medikationsplans (eMP) aus dem Datenraum des Medication Service. Der zurückgegebene Medikationsplan besteht aus einer Sammlung relevanter Ressourceninstanzen, die zu einem bestimmten Zeitpunkt gemeinsam gültig waren, sowie die zugehörige Versicherteninformation (Patient) aus dem Patient Service. Die Operation akzeptiert optional eine Provenance-Referenz.id als Eingabeparameter. Wird diese übergeben, liefert die Operation exakt den Zustand des Medikationsplans, wie er durch diese Provenance-Version beschrieben ist. So kann auch ein vergangener Stand des eMP nachvollziehbar wiedergegeben werden. Wird keine Provenance angegeben, gibt die Operation den aktuellsten Stand des Medikationsplans zurück - also die derzeit gültige Kombination aus aktiven und pausierten Medikationsdaten. Das Ergebnis ist ein Bundle vom Typ collection, das alle zugehörigen Ressourcendaten enthält.
operation definition.jurisdiction:
  index: 0
  codeable concept.coding:
    index: 0
    coding.system:
      value: urn:iso:std:iso:3166
    coding.code:
      value: DE
operation definition.affects state:
  value: false
operation definition.code:
  value: medication-plan
operation definition.system:
  value: true
operation definition.type:
  value: false
operation definition.instance:
  value: false
operation definition.parameter:
  index: 0
  operation definition.parameter.name:
    value: provenance
  operation definition.parameter.use:
    value: in
  operation definition.parameter.min:
    value: 0
  operation definition.parameter.max:
    value: 1
  operation definition.parameter.documentation:
    value: Die UUID der Provenance-Instanz, die eine bestimmte Version des elektronischen Medikationsplans (eMP) identifiziert. Diese Provenance-Instanz repräsentiert den Zustand zu einem bestimmten Zeitpunkt und bündelt die zu diesem Zeitpunkt aktiven eMP-Elemente. Wird kein provenance-Parameter angegeben, liefert die Operation den aktuellsten bekannten Zustand des eMP zurück.
  operation definition.parameter.type:
    value: uuid
operation definition.parameter:
  index: 1
  operation definition.parameter.name:
    value: return
  operation definition.parameter.use:
    value: out
  operation definition.parameter.min:
    value: 1
  operation definition.parameter.max:
    value: 1
  operation definition.parameter.documentation:
    value: Ein Bundle vom Typ collection, das alle relevanten Ressourceninstanzen enthält, die zum angegebenen eMP-Zustand gehören. Diese Ressourcen stammen aus dem Datenraum des Medication Service und bilden gemeinsam den logischen Medikationsplan zum gewünschten Stand ab.
  operation definition.parameter.type:
    value: Bundle