get-medication-plan-op
type: OperationDefinition
node role: treeRoot
id:
  v: get-medication-plan-op
meta:
  profile:
    v: https://gematik.de/fhir/ti/StructureDefinition/ti-operationdefinition
    l: ti-operationdefinition
text:
  status:
    v: generated
  div:
    v: 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.
extension:
  url:
    v: https://gematik.de/fhir/ti/StructureDefinition/extension-http-method
    l: extension-http-method
  value: Code
    v: GET
url:
  v: https://gematik.de/fhir/epa-medication/OperationDefinition/get-medication-plan-op
  l: get-medication-plan-op
version:
  v: 1.3.1
name:
  v: getMedicationPlan_MedicationSvc
title:
  v: Get Medication Plan (eMP)
status:
  v: active
kind:
  v: operation
date:
  v: 2026-03-20
publisher:
  v: gematik GmbH
contact:
  name:
    v: gematik GmbH
  telecom:
    system:
      v: url
    value:
      v: https://www.gematik.de
  telecom:
    system:
      v: email
    value:
      v: patientteam [ at ] gematik.de
description:
  v: 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.
jurisdiction:
  coding:
    system:
      v: urn:iso:std:iso:3166
      l: 3166
    code:
      v: DE
affects state:
  v: false
code:
  v: medication-plan
system:
  v: true
type:
  v: false
instance:
  v: false
parameter:
  name:
    v: provenance
  use:
    v: in
  min:
    v: 0
  max:
    v: 1
  documentation:
    v: 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.
  type:
    v: uuid
parameter:
  name:
    v: return
  use:
    v: out
  min:
    v: 1
  max:
    v: 1
  documentation:
    v: 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.
  type:
    v: Bundle