Anfrage zum Ausstellen einer Verordnung (ServiceRequest)

Motivation

In jeder Übertragung gibt es genau einen MessageHeader. Dieser hält vier wesentliche Informationen

  • Adresse des Absenders
  • Adresse des Empfängers
  • .eventCode zur Angabe des Anwendungsfalls
  • Unter .focus angegebene Ressourcen, die als Startpunkt der Auswertung angesehen werden können

Diese Informationen können in dem vorliegenden Profil angegeben werden.

Hinweis: MessageHeader.destination.receiver ist bewusst offen spezifiziert worden. Je genauer der Empfänger in der Nachricht angegeben werden kann, desto besser. Daher sollte z.B. unter MessageHeader.destination.receiver.identifier nach Möglichkeit die Telematik-ID des Empfängers angegeben werden. Dies ermöglicht eine genauere Zustellung im empfangenden System.

Kompatibilität

Dieses Profil basiert auf dem Profil MessageHeader der FHIR-Core Spezifikation (R4).

Profil

Die folgende FHIR Ressource stellt eine Anfrage an eine verordnende LEI dar. Enthalten sein muss eine strukturelle Angabe der angefragten Medikation.

idS Σ1..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
eventCodingCoding
eventUriuri
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
nameΣ0..1string
targetΣ I0..1Reference(Device)
endpointS Σ1..1url
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ0..1uriBinding
identifierS Σ0..1Identifier
displayS Σ0..1string
id0..1string
extensionI0..*Extension
referenceS Σ I0..1string
typeΣ0..1uriBinding
identifierS Σ0..1Identifier
displayS Σ1..1string
entererΣ I0..1Reference(Practitioner | PractitionerRole)
authorΣ I0..1Reference(Practitioner | PractitionerRole)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
nameS Σ1..1string
softwareS Σ1..1string
versionS Σ1..1string
id0..1string
extensionI0..*Extension
systemΣ I0..1codeBindingFixed Value
valueΣ0..1string
useΣ ?!0..1codeBinding
rankΣ0..1positiveInt
periodΣ I0..1Period
endpointS Σ1..1url
responsibleΣ I0..1Reference(Practitioner | PractitionerRole | Organization)
reasonΣ0..1CodeableConcept
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
identifierΣ1..1id
codeΣ1..1codeBinding
detailsΣ I0..1Reference(OperationOutcome)
focusS Σ I1..*Reference(Resource)
definitionΣ0..1canonical(MessageDefinition)

Folgende Felder sind entsprechend zu befüllen, bzw. können befüllt werden:

idshortcomment
MessageHeader.idEindeutige ID der Nachricht, anzugeben als UUID
MessageHeader.event[x]
MessageHeader.destinationAngaben zum Empfänger der Nachricht
MessageHeader.destination.endpointAdresse des Empfängers der Nachricht

Bspw. KIM- oder TIM-Adresse des Empfängers. Die FHIR Ressource sieht hier eine URL vor. Bspw. kann hier eine KIM-Adresse genutzt werden. Diese beginnt mit 'mailto:', da der Datentyp url ist.

MessageHeader.destination.receiver
MessageHeader.destination.receiver.identifierIdentifier des Empfängers der Nachricht

Bspw. kann hier die Telematik-ID des Empfängers angegeben werden

MessageHeader.destination.receiver.displayAnzeigename des Empfängers der Nachricht
MessageHeader.sender
MessageHeader.sender.referenceRessource des Absenders der Nachricht

Hier kann eine FHIR-Ressource referenziert werden, die den Absender der Nachricht repräsentiert. Bspw. ein Practitioner oder eine Organization.

MessageHeader.sender.identifierBusiness Identifer des Absenders der Nachricht

Bspw. kann hier die Telematik-ID des Absenders angegeben werden

MessageHeader.sender.displayAnzeigename des Absenders der Nachricht

Es muss mindestens ein Anzeigename angegeben werden, um den Absender der Nachricht anzeigen zu können

MessageHeader.sourceAngabe der Informationen des Absendenden Systems

Diese Infomation ist verpflichtend

MessageHeader.source.nameName des Softwareherstellers

Diese Infomation ist verpflichtend, um das sendende System identifizieren zu können

MessageHeader.source.softwareName der Software

Diese Infomation ist verpflichtend, um das sendende System identifizieren zu können

MessageHeader.source.versionVersion der Software

Diese Infomation ist verpflichtend, um das sendende System identifizieren zu können

MessageHeader.source.contactE-Mail Kontaktmöglichkeit zum Hersteller

Es ist mindestens eine E-Mail anzugeben, um Kontakt mit dem Hersteller herstellen zu können

MessageHeader.source.contact.system
MessageHeader.source.endpointAdresse des Absenders der Nachricht

Bspw. KIM- oder TIM-Adresse des Absenders. Die FHIR Ressource sieht hier eine URL vor. Bspw. kann hier eine KIM-Adresse genutzt werden. Diese beginnt mit 'mailto:', da der Datentyp url ist.

MessageHeader.focus

Beispiel

Valides Beispiel einer Verordnungsanfrage:

{
    "resourceType": "MessageHeader",
    "id": "ExampleMessageHeaderAppTransportFramework",
    "meta": {
        "profile":  [
            "https://gematik.de/fhir/atf/StructureDefinition/message-header-app-transport"
        ]
    },
    "source": {
        "contact": {
            "system": "email",
            "value": "support@topdoc-systems.de"
        },
        "name": "TopDoc Systems",
        "software": "TopDoc TI",
        "version": "2.4.5",
        "endpoint": "mailto:sender@example.peter.kim.telematik"
    },
    "eventCoding": {
        "code": "atf;Empfangsbestaetigung",
        "system": "https://gematik.de/fhir/atf/CodeSystem/operation-identifier-cs"
    },
    "sender": {
        "identifier": {
            "system": "https://gematik.de/fhir/sid/telematik-id",
            "value": "1-test-telematik-id"
        },
        "display": "Sender Example"
    },
    "destination":  [
        {
            "endpoint": "mailto:receiver@example.klaus.kim.telematik",
            "receiver": {
                "identifier": {
                    "system": "https://gematik.de/fhir/sid/telematik-id",
                    "value": "3-test-telematik-id"
                },
                "display": "Receiver Example"
            }
        }
    ],
    "focus":  [
        {
            "reference": "urn:uuid:86a87254-ce15-11ed-afa1-0242ac120004"
        }
    ]
}