This page is part of the Specialty Medication Enrollment (v0.1.0: STU1 Ballot 1) based on FHIR R4. . For a full list of available versions, see the Directory of published versions

Message Structures

Query Request Message

The Query message requests information from a patient’s health records. It identifies the patient and specifies searches to be performed on the responding system’s server.

It is a message Bundle with:

• an event type equal to query
• a Parameters resource as the focus (see below)
  • Search strings are specified in query-string parameter elements
• a mandatory Patient resource representing the requesting party’s understanding of the patient
• an optional Patient representing the patient in the responder’s system
• optional MedicationRequest, Practitioner, Organization resources to represent the associated specialty prescription

See Processing Detail for patient matching and other processing expectations.

Parameter	Cardinality	Type	Description, profile
query-string	1..*	string	Search string. See Search Conventions
requester-patient	1..1	Patient	Patient resource representing the requesting party's understanding of the patient Profile: specialty-rx-patient
responder-patient	0..1	Patient	Patient resource representing the responding party's understanding of the patient, if available Profile: specialty-rx-patient
medication-request	0..1	MedicationRequest	The associated specialty prescription, which may be included to assist patient matching Profile: specialty-rx-medicationrequest
prescriber	0..1	Practitioner	The prescriber of the associated specialty prescription Profile: specialty-rx-practitioner
pharmacy	0..1	Organization	The pharmacy dispensing the associated specialty prescription Profile: specialty-rx-organization-pharmacy

Query Response Message

The Query Response message returns the requested information from a patient’s health records.

It is a message Bundle with:

• an event type equal to query-response
• a Parameters resource as the focus (see below)
• a mandatory Patient resource representing the requesting party’s understanding of the patient
• a mandatory Patient representing the patient in the responder’s system
• Searchset bundle(s) containing search results

See Processing Detail for patient matching and other processing expectations.

Parameter	Cardinality	Type	Description, profile
requester-patient	1..1	Patient	Patient resource representing the requesting party's understanding of the patient Profile: specialty-rx-patient
responder-patient	1..1	Patient	Patient resource representing the responding party's understanding of the patient Profile: specialty-rx-patient
search-result	1..*	Bundle	Searchset bundle containing the results from a single search contained in the request Profile: specialty-rx-bundle-search-result

Query Response - Unsolicited Message

The Query Response - Unsolicited message transmits information from a patient’s health record to a stakeholder involved in fulfillment of a specialty medication. This message is not preceded by a request but instead is by a process event–typically sent when the medication is prescribed.

It is a message Bundle with:

• an event type equal to query-response-unsolicited
• a Parameters resource as the focus (see below)
• a mandatory Patient representing the patient in the sender’s system
• mandatory MedicationRequest, Practitioner, Organization resources to represent the associated specialty prescription
• Searchset bundle(s) containing patient data captured as search results

See Processing Detail for patient matching and other processing expectations.

Parameter	Cardinality	Type	Description, profile
source-patient	1..1	Patient	Patient resource representing the data source's understanding of the patient Profile: specialty-rx-patient
medication-request	1..1	MedicationRequest	The associated specialty prescription Profile: specialty-rx-medicationrequest
prescriber	1..1	Practitioner	The prescriber of the associated specialty prescription Profile: specialty-rx-practitioner
pharmacy	1..1	Organization	The pharmacy dispensing the associated specialty prescription Profile: specialty-rx-organization-pharmacy
search-result	1..*	Bundle	Searchset bundle containing the results from a single search of patient data Profile: specialty-rx-bundle-search-result