Medication Prescription and Dispense (MPD), published by Integrating the Healthcare Enterprise (IHE). This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IHE/pharm-mpd/tree/master and changes regularly. See the Directory of published versions

PHARM-5: Submit Medication Order

This section corresponds to transaction [PHARM-5] of the IHE Technical Framework. Transaction [PHARM-5] is used by the Order Placer and the Order Receiver actors. The Submit Medication Order [PHARM-5] transaction is used to transmit an medication order - typically a prescription.

X:Y.Z.1 Scope

The Submit Medication Order [PHARM-5] transaction passes a Medication Order from a Medication Order Placer to a Medication Order Consumer. The MeEdication Order can be

• a single-line Prescription
• a prescription as part of a group of prescriptions
• a proposal, or a draft
• a not-yet-validated prescription or order
• a medication instance order
• …

X:Y.Z.2 Actors Roles

Table X:Y.Z.2-1: Actor Roles

Actor	Role
​Medication Order Placer	Submits Medication Orders to the Medication Order Consumer
​Medication Order Receiver	Accepts Medication orders from the Medication Order Placer

X:Y.Z.3 Referenced Standards

FHIR-R5 HL7 FHIR Release 5.0

X:Y.Z.4 Messages

Figure X:Y.Z.4-1: Submit Medication Order Interactions

X:Y.Z.4.1 Submit Medication Order Request Message

The Medication Order Placer submits a MedicationRequest resource using the HTTP PUT or POST method to the /MedicationRequest endpoint.

X:Y.Z.4.1.1 Trigger Events

This method is invoked when the Medication Order Placer intends to submit one or more Medication Orders to a Medication Order Receiver - for example when submitting a prescription, or when submitting a draft.

X:Y.Z.4.1.2 Message Semantics

The content type of the HTTP body shall be either application/fhir+json or application/fhir+xml.

The Medication Order Placer shall assure the request is consistent and actionable before sending, e.g. in case of a prescription, all authorizations and approvals are present.

X:Y.Z.4.1.2.1 Resource content

• The Submit Medication Order is a MedicationRequest resource. The semantics of the request and data elements are captured in the Medication Order Data Model and the technical specification in the Medication Order profile.

X:Y.Z.4.1.3 Expected Actions

Upon receiving the Medication Order, the Medication Order Receiver is expected to store and/or forward the order.

X:Y.Z.4.2 Submit Medication Order Response

The Medication Order Consumer always returns The Medication Order Receiver SHALL return a HTTP Status code appropriate to the processing outcome, or informing of any error. The response SHALL conform to the FHIR general specifications on response codes and desired response detail level.

X:Y.Z.4.1.1 Trigger Events

This response is always expected and provides the Medication Order Placer with the ackowledgement of the request including any technical issues. The response shall immediately follow the request. In case any delayed validation of the order is expected, such validation shall not impede the immediate response to a Submit Medication Order.

X:Y.Z.4.1.2 Message Semantics

The response to a Submit Medication Order shall consist of:

• In case the request is accepted, the response shall have the response code 201 (Created)
• In case of any error, the response shall have the adequate error code (see FHIR RESTful API for information on error handling)

X:Y.Z.4.1.2.1 Resource content

• When the request is accepted (regardless of whether it may be acted upon), the response shall contain the resource that has been created from the request, including the id, version, etc. as assigned by the server. This allows the Medication Order Placer to confirm what has been accepted and track the request on that server by its internal id.
• In case of error, the response SHALL contain an OperationOutcome providing more information about the issue.

X:Y.Z.4.1.3 Expected Actions

Upon receiving the response to the Submit Medication Order, the Medication Order Placer can persist the information provided by the Medication Order Consumer (status, id, etc.) for future tracking, and can trigger a response to any issues, if they exist.