Deliveries overview

A delivery is the physical journey of an approved order: muveya reserves boxes of stock for it, someone picks and dispatches them from the source warehouse, someone confirms the handoff, and the destination receives and closes the order. muveya records every step as custody of whole boxes, so you can always say which box left which warehouse, who handed it over and who received it. In the API and in the code this process is called fulfillment. In the console it lives under Deliveries.

​

Where to find it

• Deliveries in the main navigation opens console.muveya.com/fulfillment. The item appears only to members who hold at least one custody permission (see Permissions for each step).
• Home shows the cards Orders to prepare, Deliveries to confirm, Orders to receive and Orders to close when something waits for you. Each card opens Deliveries.
• On an order’s page, Follow the delivery opens the custody detail of that order. See Create and track orders.

​

The Deliveries screen

The screen is titled Deliveries (“Orders of your clinics to prepare, deliver, receive or close.”) and shows one section per custody step you take part in. You only see the sections your permissions allow. Each section is a table with these columns: Rules of the list:

• You see the orders of the locations in your Location access. With All locations in this account you see every location’s orders.
• Each section shows up to 50 orders, newest first. When there are more, the section says “Showing the first 50. Finish these to see the rest.”
• An empty section says “Nothing here right now.”
• If you hold no custody permission, the screen says “You do not take part in deliveries. Ask your clinic’s administrator if you should prepare, deliver or receive orders.”

​

The custody lifecycle

An order enters custody when it is approved, either by a person in Order approvals or automatically by the approval policy. From there the custody record moves through these statuses: The order’s own status follows the same steps (allocated, picking, dispatched, delivered, exception, received, partially_fulfilled, closed), so the Orders screen and Deliveries always agree.

​

Step 1: automatic stock reservation

Nobody reserves stock by hand. When an order is approved, muveya reserves it on its own:

1. For each order line it looks at the usable boxes of that supply: boxes in state Active, not past their expiry date, and measured in the same unit as the order line.
2. If the order names a source warehouse (Take stock from on the order), only that warehouse’s boxes count.
3. It ranks the boxes FEFO (first expiry, first out: the earliest expiry date first, boxes without an expiry date last, then the oldest reception) whenever at least one candidate box has an expiry date, and FIFO (the oldest reception first) otherwise.
4. It reserves from the first box, then the next, until the line’s quantity is covered. One line can draw from several boxes, and a box can be reserved for only part of its content.
5. The reservation is all or nothing. If any line cannot be covered, muveya releases everything it reserved for that order and leaves the order in Approved.

These reservations appear in the order’s history as Reserved movements made by Muveya (automatic). If an approved order could not be reserved:

• It does not appear in Deliveries, and its order page keeps saying “The order is moving to its next step. This screen refreshes by itself in a few seconds.”
• muveya tries again each time another order of the same dental clinic account is approved. There is no retry button on the console today.
• Receive or move the missing stock (Receive stock, Use and move stock). If the order still stays in Approved, write to team@muveya.com with the order number.

​

Whole-box custody

muveya moves custody one whole box at a time. A box (any labeled container with a code such as BX-000123) is picked, dispatched, delivered and received as one unit. What that means in practice:

• A box sized to the order travels as it is.
• A box that holds more than the order needs is split when you scan it: muveya separates exactly the reserved quantity into a new container with its own label, and only that new container travels. The rest stays in the original box, in its warehouse. See Separating a box at pick time.
• Reception is per box. The destination accepts or disputes each whole box. There is no way to accept part of a box. If a box arrived with fewer units than its label says, see Partial quantities.
• While a box travels it is In transit. It no longer counts in the source warehouse and does not count in the destination until it is accepted.

For how boxes are labeled and tracked in general, see Boxes.

​

Permissions for each step

Each custody step has its own permission. Permissions are never inherited from a role name: a member can do a step only if an administrator granted that exact permission on the Team screen. See Roles and permissions. Some console screens need two permissions together:

• Dispatching happens on the pick screen, which opens only with fulfillment.pick. A member with fulfillment.dispatch alone sees the order under To prepare but cannot dispatch it from the console.
• Receiving box by box needs receipt.confirm and fulfillment.read. Without fulfillment.read the receipt screen says “To receive box by box you also need permission to view deliveries. Ask your clinic’s administrator.”
• Closing is done on the custody detail, which needs fulfillment.read. A member with fulfillment.close alone cannot reach the Close order button.

​

Origin party and destination party

Every delivery has two sides, and muveya checks each step against the side it belongs to.

• Origin party: the people who prepare, dispatch and hand over the boxes. muveya checks their Location access against the location that owns the source warehouse. When the source is a central warehouse, or the order named no source, it checks the order’s location instead.
• Destination party: the people who receive and close. muveya checks their Location access against the location that owns the destination warehouse, or the order’s location when the destination is a central warehouse.

Additional rules:

• Picking and viewing are checked against the order’s location.
• Warehouse access matters for the origin. To scan a box, your Warehouse access must include the warehouse the box is in; a box outside it is treated as “not reserved for this order”. Dispatching also needs access to the warehouse of each box.
• Separation of duties between locations. When the source and destination warehouses belong to two different locations, a member whose Location access includes the origin location cannot receive or close that order. muveya answers “Your account does not have permission for this action.” Members with All locations in this account are not blocked by this rule; their permissions alone decide.
• An order outside your locations behaves as if it did not exist: the custody detail and receipt screens say “This delivery does not exist or you cannot see it.”, and the pick and delivery screens say “This record is not available in the active dental clinic account.”

​

What the system records

The ledger is append-only: a disputed box is not erased from the dispatch, it gets a new Returned movement. The custody detail shows all of this for one order; see Custody history. There is no audit log screen on the console today. Every custody action is safe to repeat. Dispatching, confirming a delivery, confirming a reception or closing an order a second time does not change anything: the screen answers that it was already recorded.

​

Related pages