# C_12580_Anlage

Änderung in IG Telematikinfrastruktur (TI) Common:

IG-TI52070SA6 - Bundle.entry.request und Bundle.entry.esponse innerhalb des _history Bundles

(https://gemspec.gematik.de/fhir/ig/ti/1.1.1/general-principles.html#IG-TI52070SA6 )

Alt:
IG-TI52070SA6 - Bundle.entry.request und Bundle.entry.esponse innerhalb des _history Bundles - MUSS
Der FHIR Data Service MUSS innerhalb des _history Bundle für jede Version einer FHIR-Instanz die zugehörigen entry.request- und entry.response-Elemente bereitstellen.

- Das entry.request-Element MUSS die Methode (method) und die URL (url) enthalten, unter der diese spezifische Version abrufbar ist.
- Das entry.response-Element MUSS den Status (status) sowie das Datum der letzten Änderung (lastModified) enthalten.

EPA-Medication-Service, EPA-Patient-Service [<=]
Neu:
IG-TI52070SA6-01 - Bundle.entry.request und Bundle.entry.response innerhalb des _history Bundles - MUSS
Der FHIR Data Service MUSS innerhalb des _history Bundle für jede Version einer FHIR-Instanz die zugehörigen entry.request- und entry.response-Elemente bereitstellen.

- Bundle.entry.request.method gibt die HTTP-äquivalente Aktion an, die zur Entstehung der jeweiligen Version der Ressourceinstanz geführt hat. POST für das Anlegen, PUT für eine Aktualisierung, DELETE für das Löschen der Ressourceinstanz.
- Bundle.entry.request.url enthält die äquivalente Ressourcen-URL relativ zum FHIR-Endpunkt, aus der die versionsspezifische Abruf-URL ResourceType/{id}/_history/{versionId} abgeleitet werden kann.
- Bundle.entry.response.status enthält den HTTP-ähnlichen Status der internen Verarbeitung (z. B. 201 Created oder 200 OK).
- Bundle.entry.response.lastModified gibt das Datum und die Uhrzeit der letzten Änderung der jeweiligen Version der Ressourceinstanz an und stimmt mit meta.lastUpdated überein, sofern Bundle.entry.resource vorhanden ist.
- Bundle.entry.response.location enthält die vollständige versionsspezifische Ressourcen-URL (z. B. ResourceType/{id}/_history/{versionId}), sofern die entsprechende Version der Ressourceinstanz einzeln abrufbar ist.

EPA-Medication-Service, EPA-Patient-Service [<=]

Hinweis:
Die in Bundle.entry.request.method und Bundle.entry.request.url abgebildete Interaktion ist die HTTP-äquivalente Repräsentation der internen Persistenz des FHIR Data Service. Sie muss nicht der tatsächlich aufgerufenen fachlichen FHIR-Operation entsprechen.

IG-TI23978E7A - Bundle.entry.request und Bundle.entry.response innerhalb des _history-Bundles bei gelöschten FHIR-Instanzen

(https://gemspec.gematik.de/ig/fhir/ti/1.1.1/general-principles.html#IG-TI23978E7A)

Alt:

IG-TI23978E7A - Bundle.entry.request und Bundle.entry.response innerhalb des _history-Bundles bei gelöschten FHIR-Instanzen - MUSS
Der FHIR Data Service MUSS innerhalb des _history Bundle auch gelöschte Versionen einer FHIR-Instanz dokumentieren.

- Das entry.request-Element MUSS die Methode (method = DELETE) und die URL (url) enthalten.
- Das entry.response-Element MUSS den Status (status = 200 OK) sowie das Löschdatum (lastModified) enthalten.
- Das entry.resource-Element DARF für die gelöschte Version NICHT enthalten sein

EPA-Medication-Service [<=]

Neu:

IG-TI23978E7A-01 - Repräsentation gelöschter Versionen in Bundle.entry.request und Bundle.entry.response innerhalb eines _history-Bundles - MUSS
Der FHIR Data Service MUSS innerhalb des _history Bundle auch gelöschte Versionen einer FHIR-Instanz dokumentieren.
Für gelöschte Versionen gilt:

- Bei gelöschten Ressourceinstanzen wird das Element Bundle.entry.resource nicht ausgegeben.
- Bundle.entry.request.method hat für gelöschte Ressourceinstanzen den Wert DELETE.
- Bundle.entry.request.url enthält die REST-äquivalente Ressourcen-URL relativ zum FHIR-Endpunkt, ResourceType/{id}.
- Bundle.entry.response.status enthält den Wert 200 OK.
- Bundle.entry.response.lastModified enthält das Löschdatum der Ressourceinstanz.

EPA-Medication-Service [<=]

Hinweis:
Gelöschte Versionen enthalten keine Ressourcendarstellung. Die dokumentierte DELETE Aktion entspricht der internen Kennzeichnung der Ressource als gelöscht. Die Löschzeit kann mit dem Zeitpunkt der internen Markierung übereinstimmen, der in lastModified angegeben wird.

Änderung in Healthrecord relocation export package.adoc (ref-epa-healthrecordmigration)

Kapitel "Medication":

....

Jede FHIR-Ressource wird dabei im Format JSON als jeweils eine Datei abgelegt. Dateien versionierbarer Ressourcen verwenden dafür vollständige History-Bundle mit allen Versionen. Der Dateiname ist M_nnnnnn.json mit 'nnnnnn' aus der Menge {000000, 999999}, beginnend mit 'nnnnnn' = 000000 und fortlaufender Zählung.

......

Das Beispiel wird geändert:

Beispiel: Inhalt M_123456.json (Resource: MedicationRequest gemäß Profil EMPMedicationRequest mit allen Versionen in einem Bundle)

    {
      "resourceType" : "Bundle",
      "id" : "31a277f5-6ed9-4ee2-a864-4abc26b5de5b",
      "type" : "history",
      "total" : 3,
      "entry" : [
        {
          "fullUrl" : "http://epa4all/epa/medication/api/v1/fhir/MedicationRequest/1959b8cd-58d2-4961-aa10-74d7e68896403",
          "request" : {
            "method" : "DELETE",
            "url" : "MedicationRequest/1959b8cd-58d2-4961-aa10-74d7e68896403"
          },
          "response" : {
            "status" : "200 OK",
            "lastModified" : "2026-08-22T15:00:00.000Z"
          }
        },
        {
          "fullUrl" : "http://epa4all/epa/medication/api/v1/fhir/MedicationRequest/1959b8cd-58d2-4961-aa10-74d7e68896403",
          "resource" : {
            "resourceType" : "MedicationRequest",
            "id" : "1959b8cd-58d2-4961-aa10-74d7e68896403",
            "meta" : {
              "versionId" : "2",
              "lastUpdated" : "2026-08-22T14:50:10.000Z",
              "profile" : [
                "https://gematik.de/fhir/epa-medication/StructureDefinition/emp-medication-request"
              ]
            },
            "extension" : [
              {
                "url" : "https://gematik.de/fhir/epa-medication/StructureDefinition/context-extension",
                "valueCode" : "EMP"
              },
              {
                "url" : "https://gematik.de/fhir/epa-medication/StructureDefinition/reason-patient-instruction-extension",
                "valueString" : "akuten Behandlung von Migräneanfällen mit und ohne Aura"
              },
              {
                "url" : "https://gematik.de/fhir/epa-medication/StructureDefinition/patient-note-extension",
                "valueAnnotation" : {
                  "text" : "Bitte schützen Sie das Arzneimittel vor hohen Temperaturen und direkter Sonneneinstrahlung."
                }
              },
              {
                "url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-MedicationRequest.effectiveDosePeriod",
                "valuePeriod" : {
                  "start" : "2026-08-22",
                  "end" : "2026-08-25"
                }
              },
              {
                "url" : "https://gematik.de/fhir/epa-medication/StructureDefinition/emp-origin-medication-extension",
                "valueReference" : {
                  "reference" : "Medication/9cbf1803-e125-40d3-ad68-1e155f71e252"
                }
              },
              {
                "url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-MedicationRequest.renderedDosageInstruction",
                "valueMarkdown" : "1-0-0-0 Stück"
              },
              {
                "extension" : [
                  {
                    "url" : "algorithmVersion",
                    "valueString" : "1.0.1"
                  },
                  {
                    "url" : "language",
                    "valueCode" : "de-DE"
                  }
                ],
                "url" : "http://ig.fhir.de/igs/medication/StructureDefinition/GeneratedDosageInstructionsMeta"
              },
              {
                "url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-MedicationRequest.renderedDosageInstruction",
                "valueMarkdown" : "1-0-2-0 Stück"
              }
            ],
            "status" : "active",
            "intent" : "plan",
            "medicationReference" : {
              "reference" : "Medication/9cbf1803-e125-40d3-ad68-1e155f71e252"
            },
            "subject" : {
              "identifier" : {
                "system" : "http://fhir.de/sid/gkv/kvid-10",
                "value" : "X110411319"
              }
            },
            "authoredOn" : "2026-08-22",
            "note" : [
              {
                "text" : "Hinweis für den LE"
              }
            ],
            "dosageInstruction" : [
              {
                "timing" : {
                  "repeat" : {
                    "frequency" : 1,
                    "period" : 1,
                    "periodUnit" : "d",
                    "when" : [
                      "MORN"
                    ]
                  }
                },
                "doseAndRate" : [
                  {
                    "doseQuantity" : {
                      "value" : 1,
                      "unit" : "Stück",
                      "system" : "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BMP_DOSIEREINHEIT",
                      "code" : "1"
                    }
                  }
                ]
              },
              {
                "timing" : {
                  "repeat" : {
                    "frequency" : 1,
                    "period" : 1,
                    "periodUnit" : "d",
                    "when" : [
                      "MORN"
                    ]
                  }
                },
                "doseAndRate" : [
                  {
                    "doseQuantity" : {
                      "value" : 1,
                      "unit" : "Stück",
                      "system" : "http://unitsofmeasure.org",
                      "code" : "1"
                    }
                  }
                ]
              },
              {
                "timing" : {
                  "repeat" : {
                    "frequency" : 1,
                    "period" : 1,
                    "periodUnit" : "d",
                    "when" : [
                      "EVE"
                    ]
                  }
                },
                "doseAndRate" : [
                  {
                    "doseQuantity" : {
                      "value" : 2,
                      "unit" : "Stück",
                      "system" : "http://unitsofmeasure.org",
                      "code" : "1"
                    }
                  }
                ]
              }
            ]
          },
          "request" : {
            "method" : "PUT",
            "url" : "MedicationRequest/1959b8cd-58d2-4961-aa10-74d7e68896403"
          },
          "response" : {
            "status" : "200 OK",
            "location" : "MedicationDispense/1959b8cd-58d2-4961-aa10-74d7e68896403/_history/2",
            "lastModified" : "2026-08-22T14:50:10.000Z"
          }
        },
        {
          "fullUrl" : "http://epa4all/epa/medication/api/v1/fhir/MedicationRequest/1959b8cd-58d2-4961-aa10-74d7e68896403",
          "resource" : {
            "resourceType" : "MedicationRequest",
            "id" : "1959b8cd-58d2-4961-aa10-74d7e68896403",
            "meta" : {
              "versionId" : "1",
              "lastUpdated" : "2026-08-22T14:43:33.244Z",
              "profile" : [
                "https://gematik.de/fhir/epa-medication/StructureDefinition/emp-medication-request"
              ]
            },
            "extension" : [
              {
                "url" : "https://gematik.de/fhir/epa-medication/StructureDefinition/context-extension",
                "valueCode" : "EMP"
              },
              {
                "url" : "https://gematik.de/fhir/epa-medication/StructureDefinition/reason-patient-instruction-extension",
                "valueString" : "akuten Behandlung von Migräneanfällen mit und ohne Aura"
              },
              {
                "url" : "https://gematik.de/fhir/epa-medication/StructureDefinition/patient-note-extension",
                "valueAnnotation" : {
                  "text" : "Bitte schützen Sie das Arzneimittel vor hohen Temperaturen und direkter Sonneneinstrahlung."
                }
              },
              {
                "url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-MedicationRequest.effectiveDosePeriod",
                "valuePeriod" : {
                  "start" : "2026-08-22",
                  "end" : "2026-08-25"
                }
              },
              {
                "url" : "https://gematik.de/fhir/epa-medication/StructureDefinition/emp-origin-medication-extension",
                "valueReference" : {
                  "reference" : "Medication/9cbf1803-e125-40d3-ad68-1e155f71e252"
                }
              },
              {
                "url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-MedicationRequest.renderedDosageInstruction",
                "valueMarkdown" : "1-0-0-0 Stück"
              },
              {
                "extension" : [
                  {
                    "url" : "algorithmVersion",
                    "valueString" : "1.0.1"
                  },
                  {
                    "url" : "language",
                    "valueCode" : "de-DE"
                  }
                ],
                "url" : "http://ig.fhir.de/igs/medication/StructureDefinition/GeneratedDosageInstructionsMeta"
              }
            ],
            "status" : "active",
            "intent" : "plan",
            "medicationReference" : {
              "reference" : "Medication/9cbf1803-e125-40d3-ad68-1e155f71e252"
            },
            "subject" : {
              "identifier" : {
                "system" : "http://fhir.de/sid/gkv/kvid-10",
                "value" : "X110411319"
              }
            },
            "authoredOn" : "2026-08-22",
            "note" : [
              {
                "text" : "Hinweis für den LE"
              }
            ],
            "dosageInstruction" : [
              {
                "timing" : {
                  "repeat" : {
                    "frequency" : 1,
                    "period" : 1,
                    "periodUnit" : "d",
                    "when" : [
                      "MORN"
                    ]
                  }
                },
                "doseAndRate" : [
                  {
                    "doseQuantity" : {
                      "value" : 1,
                      "unit" : "Stück",
                      "system" : "https://fhir.kbv.de/CodeSystem/KBV_CS_SFHIR_BMP_DOSIEREINHEIT",
                      "code" : "1"
                    }
                  }
                ]
              }
            ]
          },
          "request" : {
            "method" : "POST",
            "url" : "MedicationRequest"
          },
          "response" : {
            "status" : "201 Created",
            "location" : "MedicationRequest/1959b8cd-58d2-4961-aa10-74d7e68896403/_history/1",
            "lastModified" : "2026-08-22T14:43:33.244Z"
          }
        }
      ]
    }