MedicationRequests

Capture a request (front desk, Inventory permission). Nothing billable is created; the request lands in the provider's approve queue. OTC items auto-approve and rest at Approved until pickup.

Changed on
post/medication-requests

Request

Request body

patientIdstring
inventoryItemIdstring nullable

The requested med, when the capturer could identify it.

freeTextMedicationstring nullable

"She called it the white pills" — must be resolved before approval.

notesstring nullable
sourcestring nullable

staff | phone | client-app. Defaults to phone (the multi-day lane's main source).

fulfillmentMethodstring nullable

Suggested fulfillment; the approving provider decides.

renewalOfPrescriptionIdstring nullable

Prior Rx this request renews, when captured from medication history (Phase 3 UI).

suggestedProviderIdstring nullable
suggestedDosagestring nullable
suggestedFrequencystring nullable
suggestedDurationstring nullable
suggestedInstructionsstring nullable

Response

Created

idstring
patientIdstring
patientNamestring nullable
clientIdstring nullable
inventoryItemIdstring nullable
medicationNamestring nullable
freeTextMedicationstring nullable
notesstring nullable
sourcestring
isOtcboolean
isControlledboolean

Whether the linked inventory item carries any DEA/controlled-substance signal. Mirrors the approval gate's own controlled test (RxGovernanceService.IsControlledItem): a controlled item always needs a primary provider to approve or deny, whatever RxGovernanceSettings says. False for an unresolved free-text request — there is no item to judge yet, so read it together with InventoryItemId.

fulfillmentMethodstring nullable
statusstring
billingStatestring

Derived: none | quoted | quote_removed | unbilled | invoiced | paid. "unbilled" is the "Ready to bill" worklist predicate.

requestedByIdstring nullable
requestedByNamestring nullable
requestedAtstring date-time
approvedByIdstring nullable
approvedByNamestring nullable
approvedAtstring date-time nullable
deniedByIdstring nullable
deniedAtstring date-time nullable
denialReasonstring nullable
cancelledByIdstring nullable
cancelledAtstring date-time nullable
cancelReasonstring nullable
dispensedAtstring date-time nullable
prescriptionIdstring nullable
prescriptionItemIdstring nullable
estimateIdstring nullable
estimateLineItemIdstring nullable
targetEstimateIdstring nullable

The estimate chosen at capture for the line approval will create (ITE-1713). string? MedicationRequestDto.EstimateId is where the line actually is, once it exists.

targetEstimateNumberstring nullable
targetEstimateIsVisitboolean

True when string? MedicationRequestDto.TargetEstimateId is a visit's (appointment's) estimate.

targetEstimateIsOpenboolean

False when string? MedicationRequestDto.TargetEstimateId has been invoiced or declined since capture: approval will put the line on a fresh estimate instead, so it is not a usable choice.

invoiceIdstring nullable
renewalOfPrescriptionIdstring nullable
suggestedProviderIdstring nullable
suggestedDosagestring nullable
suggestedFrequencystring nullable
suggestedDurationstring nullable
suggestedInstructionsstring nullable
createdAtstring date-time
updatedAtstring date-time

Changes

    • info

      added the optional property ///// to the response with the status (media type: text/plain)

    • info

      added the optional property ///// to the response with the status (media type: application/json)

    • info

      added the optional property ///// to the response with the status (media type: text/json)

    • info

      added the optional property to the response with the status (media type: text/plain)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: text/json)

    • info

      added the optional property to the response with the status (media type: text/plain)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: text/json)

    • info

      added the optional property to the response with the status (media type: text/plain)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: text/json)

    • info

      added the optional property to the response with the status (media type: text/plain)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: text/json)

    • info

      added the optional property to the response with the status (media type: text/plain)

    • info

      added the optional property to the response with the status (media type: application/json)

    • info

      added the optional property to the response with the status (media type: text/json)