- The origin party confirms that the boxes were handed over, or reports a delivery problem.
- The destination party checks every box and accepts or disputes it.
- The destination party closes the order.
Confirm the delivery
Who can do it
- Permission
delivery.confirm(Confirm delivery). - The source location in your Location access (the order’s location when the source is a central warehouse or the order named no source).
- To see the delivered boxes by code you also need
fulfillment.read. Without it, the screen lists the ordered supplies instead.
delivery.confirm the screen says “You cannot confirm deliveries. Ask your clinic’s administrator for the permission.”
Where
- In Deliveries, open To deliver and select the order number. The section lists orders in Dispatched (
dispatched). - Right after dispatching, the Confirm the delivery link on the pick screen.
- From the custody detail, Confirm the delivery.
- Direct path:
console.muveya.com/fulfillment/:orderId/delivery.
fulfillment.read, the ordered supplies (Supply as “name · SKU”, Quantity as “10 × unit”).
Confirm a clean delivery
1
Check the boxes
Compare the boxes you hand over with What is being delivered.
2
Confirm
Select Confirm delivery. There is no extra confirmation dialog.
3
Read the answer
“Delivery confirmed. The destination now confirms the reception.” The order moves to Delivered (
delivered) and appears under To receive for the destination party.Report a delivery problem
Use this when the boxes could not be handed over properly.1
Open the problem form
Select Report a problem.
2
Say what happened
Choose one option in What happened (required) and add context in Details (optional), up to 2000 characters.
3
Send and confirm
Select Report problem. A dialog warns: “The order stops as a delivery problem, and its resolution is pending with the clinic’s owner.” Select Report problem again to send it, or Go back to keep the order as it is.
The answer is “The problem was recorded. The order is now a delivery problem.” The order moves to Delivery problem (
exception).
What the system records
- A delivery record with who confirmed, when, which boxes were handed over and, for a problem, the reason code and details. It is written once and cannot be changed: confirming again only says “This delivery was already recorded.”
- No stock movement. The boxes stay In transit until the destination receives them.
- The order status (
deliveredorexception) and the audit recordfulfillment.deliveredorfulfillment.delivery_exception.
When a delivery problem is reported
A delivery problem stops the order:- Its boxes stay In transit. They count in neither the source nor the destination warehouse.
- The order cannot be received or closed. The custody detail says “Resolution is pending with the clinic’s owner. Nothing more can be done here for now.”
- It is listed under Delivery problems for members with
fulfillment.read.
Receive the order
Who can do it
- Permission
receipt.confirm(Confirm receipt) and permissionfulfillment.read(View fulfillment). - The destination location in your Location access (the order’s location when the destination is a central warehouse).
- If the source and destination warehouses belong to two different locations, your Location access must not include the origin location, unless you have All locations in this account.
Where
- In Deliveries, open To receive and select the order number. The section lists orders in Delivered (
delivered). - From the custody detail, Receive the order.
- Direct path:
console.muveya.com/fulfillment/:orderId/receipt.
Steps
1
Check each box
The screen reminds you: “Check each box. Accept what arrived well; dispute what arrived damaged or is missing.” Every box starts as Accept.
2
Dispute the boxes with a problem
For each problem box, set Decision for box BX-000123 to Dispute, then fill in its fields (see the table below).
3
Describe the evidence
As soon as one box is disputed, Evidence of the problem appears and is required: “Describe what you saw and where the photos are. Required when you dispute a box.” Up to 2000 characters.
4
Confirm
Select Confirm reception. The answer is “Reception confirmed: every box was accepted.” or “Reception confirmed with disputed boxes. They go back to the warehouse they came from.” A link opens the order’s tracking page.
Photos cannot be attached on the console today. Describe in the evidence where the photos are kept.
What happens to each box
A disputed box is recorded back in the warehouse it came from, so send it back physically. The original Dispatched movement stays in the ledger: the return is a new, compensating movement, never an edit. To inspect a quarantined box later, see Boxes and Lot recall; no action releases a box from quarantine.
The order moves to Received (
received) when every box was accepted, or Partially received (partially_fulfilled) when at least one box was disputed. The audit record is fulfillment.received or fulfillment.received.disputed.
Partial quantities
Reception is whole-box: each box is accepted or disputed as a unit, and there is no field for a received quantity. If a box arrived with fewer units than expected, choose one of these:- Dispute the box (for example with Missing or Other) and describe the difference in the evidence. The whole box is recorded back at the source, where the count can be corrected.
- Accept the box and then correct its quantity at the destination with a stock correction.
Rules and limits
- Only an order in Delivered can be received.
- The reception must cover exactly the delivered boxes, each one once. The console builds this for you; if the delivery changed while the page was open, reload it.
- One reception can include up to 200 accepted and 200 disputed boxes.
- The first reception stands. Confirming again only says “This reception was already recorded.”
- The evidence text is stored with the reception but is not shown on the custody detail or returned by the API today. Per-box notes are returned by the API, not shown on the console.
Close the order
Closing is the last, administrative step. It moves no stock: every box was already received at the destination or returned to the origin.Who can do it
- Permission
fulfillment.close(Close fulfillment) and permissionfulfillment.read(View fulfillment), because the button is on the custody detail. - The same location rules as receiving: the destination party closes.
Steps
1
Open the order
In Deliveries, open To close and select the order number. The section lists orders in Received and Partially received.
2
Close it
The custody detail shows “Everything was received or returned. Close the order to finish it.” Select Close order.
3
Read the answer
“Order closed.” The order moves to Closed (
closed). A second attempt says “This order was already closed.”closed, and the audit record fulfillment.closed.
Rules
- Only orders in Received or Partially received can be closed. An order with a Delivery problem cannot be closed.
- A box still in transit blocks closing. After a reception, muveya moves each box into the destination or back to the origin. If one of those stock steps did not finish, the box is still In transit and closing answers “This order cannot be closed yet.” muveya retries the pending step in the background; check the Boxes table on the custody detail and try again later. If a box stays In transit, write to team@muveya.com.
What can go wrong
Related pages
Deliveries overview
Lifecycle, whole-box custody and permissions.
Custody history
Review the delivery, reception and closure records.
Stock corrections
Correct a box’s quantity after an accepted delivery.
Lot recall
Quarantine and follow boxes of a lot.