RxGovernance

Full prescription edit. Pre-Dispensed prescriptions are updated in place; Dispensed prescriptions require a `reason` and the change is recorded as an amendment. DEA-tracked field changes on a controlled substance are blocked — caller must cancel-and-recreate instead.

Changed on
post/rx/governance/{id}/correct-dispense

Request

Path parameters

idstring required

Request body

reasonstring

Why the original figure was wrong. Required — this is a controlled correction.

lotIdstring nullable

Lot to re-dispense from. Empty defaults to the lot the original dispense drew from (lot-tracked items), so the printed label keeps its lot number and expiry.

containerIdstring nullable
locationIdstring nullable
witnessUserIdstring nullable
billingDispositionstring nullable

How to treat the bill when the dispense is on an invoice that holds money. Absent (default): the correction is refused with invoice_has_payment and the remedy is refund → correct → re-bill. "leaveAsCharged": perform the correction (stock, DEA, Rx — the records with legal weight) and leave the paid invoice exactly as charged, recording the divergence on the bill's audit trail and line note (ITE-680). Record truth only — never a price change. Requires string? CorrectDispenseDto.BillingReason and the Billing permission, and is rejected when the bill holds no money (the normal revert/void flows apply there).

billingReasonstring nullable

Why the bill is deliberately left as charged. Required with string? CorrectDispenseDto.BillingDisposition.

Response

OK

transactionIdstring nullable

The replacement dispense's transaction.

billingLeftAsChargedboolean

True when the correction ran in records-only mode: the paid invoice was left exactly as charged (divergence recorded on its audit trail), while stock, DEA and the prescription were corrected (ITE-680).

Changes

    • info

      added the new optional request property (media type: application/json)

    • info

      added the new optional request property (media type: text/json)

    • info

      added the new optional request property (media type: application/*+json)

    • info

      added the new optional request property (media type: application/json)

    • info

      added the new optional request property (media type: text/json)

    • info

      added the new optional request property (media type: application/*+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

      endpoint added