Skip to main content
A box is the unit muveya tracks: one container of one supply, with a printed code. This page covers finding a box, reading everything the box screen shows, printing and reprinting its label, separating part of it into a new container, and taking it out of use.

​
Find a box

​
Scan or type its code

Who can do it: members with inventory.read and access to the box’s warehouse. Where: Inventory, then Scan a code at the top of the Stock screen, or console.muveya.com/inventory/scan. The screen is titled Scan: “Read a label or type the code.”
1

Read the label

The Box code field has the focus when the screen opens, so a barcode reader types straight into it. You can also type the code by hand.
2

Find

Press Find (a reader that sends Enter does it for you). While it searches you see Searching….
3

Open

When the code exists in your warehouses, the box screen opens.
The code must match the label exactly; spaces at either end are ignored. When nothing is found, the screen says We could not find that box. The same message appears when the box is in a warehouse outside your access, or when you do not have inventory.read: muveya never reveals whether a code exists in a warehouse you cannot see.

​
Other ways to open a box

  • From the Stock list, select the supply name in a row.
  • From Lot recall, select a box code.
  • From the confirmation after receiving or separating, select Open box or Open.
  • From the Separated from and Separated into links on another box.

​
The box screen

The path is /inventory/boxes/:boxId. The title is the box code, and the line under it is the box status (for example Active or Used up). Back to stock returns to the list. While it loads you see Loading box….

​
Details

If the box’s stored unit cannot be confirmed, the screen adds The unit of this box needs review. Its quantities are shown without a unit until someone checks it.
The box screen does not list the lot, the expiry date or the serial numbers. The lot and the expiry date are printed on the label preview (see below). Serial numbers are not shown anywhere in the console yet; they are returned by GET /v1/inventory/boxes/{boxId} in the public API.

​
Separated containers

When a box was separated from another one, or other containers were separated from it, the screen shows: A related box in a warehouse outside your access is not named at all.

​
Movements

The Movements table lists the box’s whole ledger, oldest first. With no movements it says No movements yet. A column with no value for that movement shows a dash. Care references are never shown in this table; see Record use and move boxes. The Label section is on every box screen: “Print it and stick it on the container so a scanner finds this box.”
1

Show the label

Select Show the label for BX-7K3QM9. The links Print the label for after a receipt or a separation open the box with the label already shown.
2

Check the preview

The label shows the code as a Code 128 barcode, the code in text underneath, the supply name and SKU, what the box was received as (for example 3 × Box of 100) and, when the box has them, Lot and Expires with the date.
3

Print

Press Print label. Your browser’s print dialog opens and the page prints only the label, black on white, 62 mm wide, at the top-left corner of the sheet.
You can reprint a label as often as you need; printing records nothing. A code with characters outside plain letters, digits and common symbols prints as text only, without a barcode.

​
Actions on an active box

The forms below appear only while the box is Active, and each one only to members with its permission. When the box is in any other status the screen says This box is closed and takes no further movements. inventory.adjust includes inventory.consume and inventory.transfer.

​
Separate part of a box

Separating takes some units out of a box into a new, labeled container in the same warehouse, for example to take 20 gloves to a treatment room while the rest of the box stays on the shelf. Who can do it: inventory.transfer (Move boxes between warehouses) or inventory.adjust, with access to the box’s warehouse. Where: the box screen, section Separate part of this box: “Take some units out into a new container. It keeps this box’s lot and expiry.”
1

Quantity

Type the units in Quantity to separate. The hint gives the maximum, for example Up to 12 free units.
2

Label (optional)

Type the code you will write on the new container in Label for the new container (optional), or leave it empty: “Leave it empty and a label will be suggested.”
3

Separate

Press Separate.
4

Label the container

The screen confirms, for example, Separated 20 into BX-7K3QM9-F1. Write this code on the new container., shows the code on its own line, and offers Open BX-7K3QM9-F1 and Print the label for BX-7K3QM9-F1.

​
Rules

  • The quantity is a whole number from 1 up to the smaller of the box’s available units and its on hand minus one. At least one unit always stays in the box: to take everything, move the whole box instead.
  • Only free units can be separated, never units reserved for orders. When nothing is free the section says This box has no free units left to separate.
  • The box must be Active, not past its expiry date, not tracking serial numbers, and with a confirmed unit.
  • A typed label has up to 64 characters, spaces at either end removed, and must be unique in your dental clinic. Without one, muveya uses the original code followed by -F and a number: BX-7K3QM9-F1, then BX-7K3QM9-F2, skipping codes already in use.
  • The new container is Active, in the same warehouse, with the same supply, lot, expiry date, reception date and unit. It is not tied to a presentation: its quantity is in base units. It carries no reservation.

​
What the system records

  • A split_out movement (Separated out) on the original box, subtracting the quantity.
  • A new box linked to the original one.
  • A split_in movement (Separated in) on the new box, adding the same quantity.
Both movements share one separation identity, and the supply’s total on hand does not change. A repeated press or a retry after a lost answer never separates twice: it answers Already recorded. During picking, muveya can separate a box by itself so that an order ships exactly the units reserved for it. Those separations appear in the same history.

​
What can go wrong

​
Take a box out of use

Who can do it: inventory.adjust (Adjust and count stock), with access to the box’s warehouse. Where: the last section of the box screen, Take the box out of use: “Quarantine keeps it aside to check; expired and disposed boxes leave the usable stock. Its history stays.” It is shown only while the box is Active.
1

Choose the outcome

In What happens to it (Choose…), pick Quarantine, Mark as expired or Dispose. Pressing Continue without a choice shows Choose what happens to the box.
2

Give a reason (optional)

In Why, pick Damaged, Expired, Contaminated, Recalled by the supplier or Other.
3

Continue

Press Continue.
4

Confirm

A dialog asks, for example, Quarantine: box BX-7K3QM9? with “The box stops taking movements. This cannot be undone from the Console.” Press Yes, do it, or Keep the box active to cancel.
5

Read the result

The screen says Box BX-7K3QM9 is now: Quarantined. A repeated request says This was already recorded.

​
What the system records

One movement of the chosen type, with a change of 0, the reason you chose and you as the person who recorded it, and the box’s new status, in a single step. The box’s history and on hand stay as they were, but the box leaves usable stock: it can no longer be used, moved, separated, corrected or reserved for orders.

​
Rules and limits

  • The console offers this only for Active boxes. muveya also accepts disposing of a box that is already quarantined or expired, but there is no button for that yet; write to team@muveya.com if you need it recorded.
  • There is no action to return a box to Active.
  • To take every box of a lot out of use at once, use Lot recall.
  • This is marked as a sensitive action. In the current release a second factor is optional and does not block it; see Account security.

​
What can go wrong

Record use and move boxes

Consume from a box or move it.

Corrections

Fix what a box is said to hold.

Lot recall

Hold every box of a lot.

Picking

How boxes are picked and separated for orders.