Specialty Medication Enrollment
0.1.0 - STU1 Ballot

Publication Build: This will be filled in by the publication tooling

## 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