> ## Documentation Index
> Fetch the complete documentation index at: https://muveya.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Lot recall

> Find every box of a lot wherever it is, trace what was used or dispatched, and take the whole lot out of use in one step

When a supplier recalls a lot, you need to know where every unit of it is and stop anyone from using it. The **Lot recall** screen finds every box of one supply that carries that lot, in any status, and quarantines all the boxes still in use in a single confirmed step.

## Who can do it

| Task | Permission | Without it |
| - | - | - |
| Find a lot and read its boxes | `inventory.read` | The screen says **You don’t have permission to view stock. Ask an administrator for access.** |
| Quarantine the lot | `inventory.adjust` | The screen says **You can find a lot. Quarantining it requires permission to adjust stock.** |

Both only reach boxes in the warehouses of your access. For a complete recall, have it run by someone whose access covers every warehouse.

## Where

**Inventory** in the main navigation, then **Lot recall** at the top of the **Stock** screen, or `console.muveya.com/inventory/lots`. The screen is titled **Lot recall**: "Find every box of a lot, wherever it is, and take the lot out of use in one step."

## Find every box of a lot

<Steps>
  <Step title="Choose the supply">
    In **Supply** (**Choose the supply**), pick the supply the lot belongs to. Every supply is listed, active or not. Leaving it empty shows **Choose the supply the lot belongs to.**
  </Step>

  <Step title="Type the lot">
    Type it in **Lot number**, "As printed on the package or in the recall notice.", up to 120 characters. Leaving it empty shows **Enter the lot number.**
  </Step>

  <Step title="Find boxes">
    Press **Find boxes**. While it searches you see **Looking for the boxes of this lot…**.
  </Step>

  <Step title="Read the summary">
    The results are titled with the lot and the supply, for example **Lot L2409-A · Nitrile gloves M · GLV-NIT-M**, followed by a count such as **Boxes found: 6 · Still in use: 4**.
  </Step>
</Steps>

The lot must match what was typed when the boxes were received; spaces at either end are ignored. Containers separated from a box of the lot keep its lot, so they are found too. When nothing matches, the screen says **No box in your warehouses carries lot L2409-A of this supply. Check the lot as printed; spaces at either end don’t matter.**

The list shows up to 200 boxes, grouped by warehouse and then by reception date. With more, it adds **Showing the first 200 boxes of this lot.**

## Read the results

| Column | What it shows |
| - | - |
| **Box** | The box code, as a link to the box. |
| **Warehouse** | Where the box is now. **Warehouse not available** if it can no longer be named. |
| **Status** | The box status. |
| **On hand** | Units in the box now, with the unit. |
| **Last movement** | The latest movement and its date, for example `Used · Sep 12, 2026, 10:40 AM`. **No movements yet** when there is none. |

What each status means for the recall:

| Status | Meaning | What the recall does |
| - | - | - |
| **Active** | Still in use. | Quarantines it. |
| **Quarantined**, **Expired**, **Disposed** | Already out of use. | Leaves it as it is. |
| **Used up** | Every unit already left the box. | Leaves it as it is. Trace its exits (below). |
| **In transit** | Dispatched for an order and not yet received. | Does **not** hold it. Recall the lot again once it arrives. |

## Trace what was used or dispatched

The lot screen tells you where each box is and what happened to it last. To follow every unit:

* **Open each box.** Its **Movements** list every exit with the room or area, **What happened**, **Purpose**, **Responsible**, **Recorded by** and the date. A box **Used up** has already let all its units go. See [Boxes and labels](/docs/en/inventory/boxes).
* **Check the rooms.** On [Usage by room](/docs/en/inventory/use-and-moves), filter by room and dates and compare the date and quantity with the box's exits. Members with `orders.patient_ref.read` also see the care reference of each exit, which lets the clinical team find the treatments involved. That screen does not filter by lot.
* **Follow orders.** A box that shows **Dispatched** or **In transit** left for an order. Follow the order in [Custody history](/docs/en/deliveries/custody-history).
* **Follow separated containers.** The original box lists them under **Separated into**, and they also appear in the lot results.

## Take the lot out of use

The section **Take the lot out of use** appears below the results: "Each box of this lot that is still in use goes into quarantine: it stops taking movements and is never picked for an order. Boxes already out of use stay as they are."

<Steps>
  <Step title="Check the boxes in transit">
    If some boxes are on their way, the screen warns, for example, **In transit, not held by this recall: 1. When they arrive, find this lot again and quarantine them.**
  </Step>

  <Step title="Choose the reason">
    In **Why**, keep **Recalled by the supplier** (the default) or choose **Damaged**, **Expired**, **Contaminated** or **Other**.
  </Step>

  <Step title="Quarantine">
    Press **Quarantine lot**.
  </Step>

  <Step title="Confirm">
    A dialog asks **Quarantine lot L2409-A?** and says, for example, "Boxes still in use that go into quarantine: 4. They stop taking movements and are never picked for an order. This can’t be undone from the Console." It also repeats how many boxes in transit are not held. Press **Yes, quarantine the lot**, or **Keep the lot in use** to cancel.
  </Step>

  <Step title="Read the result">
    The screen says, for example, **Quarantined boxes of lot L2409-A: 4.**, then **Already out of use and left as they were: 2.** and **In transit and not held: 1. When they arrive, find this lot again and quarantine them.** when they apply.
  </Step>
</Steps>

When no box is in use and none is in transit, the section says **Every box of this lot is already out of use.**

### What the system records

* For each **Active** box: a `quarantine` movement (**Quarantined**) with a change of `0`, the reason and you as the person who recorded it, and the box's status set to **Quarantined**. Each box gets its own movement.
* One audit record, `inventory.lot.quarantined`, naming the supply, the lot, the reason, the boxes held and the boxes left as they were.
* Boxes in any other status are reported with their current status and not changed.

A quarantined box can no longer be used, moved, separated, corrected or picked for an order. Its history and recorded quantity stay.

### Rules and limits

* The recall acts on **every** box of the lot in your warehouses, including any beyond the 200 listed. The count in the dialog covers only the listed boxes.
* Boxes in transit are not held, because receiving them makes them usable at the destination. Once they arrive, find the lot again and quarantine it again.
* If the result was lost (for example the connection dropped), the list reloads and shows which boxes are already **Quarantined**. If some are still **Active**, press **Quarantine lot** again: boxes already held are not held twice. When everything had already been recorded, the screen answers **This recall was already recorded. Nothing else changed.**
* Running the recall again later, for example after more boxes of the lot were received, holds the new active boxes and reports the rest as already out of use.
* There is no action to release a box from quarantine.
* Disposing of quarantined boxes is not available in the console yet. They stay quarantined, which keeps them out of every movement. If you need the disposal recorded, write to [team@muveya.com](mailto:team@muveya.com).
* Quarantining a lot is marked as a sensitive action. In the current release a second factor is optional and does not block it; see [Account security](/docs/en/account/security).

### What can go wrong

| Message | Cause | What to do |
| - | - | - |
| **This record is not available in the active dental clinic account.** | No box of this lot is in your warehouses anymore. | Find the lot again. |
| **The record changed or already exists. Review it before trying again.** | An earlier attempt of this recall was recorded with another reason. | Find the lot again and repeat. |
| **Could not confirm the operation. Check your connection and review the list before trying again.** | The connection failed. | Check the statuses in the reloaded list and repeat if boxes are still **Active**; nothing is held twice. |
| **Your account does not have permission for this action.** | You do not have `inventory.adjust`. | Ask an administrator. |

## Recall checklist

1. Find the lot and quarantine it.
2. Take the quarantined boxes off the shelf and keep them apart.
3. Trace the exits of the boxes already used.
4. Follow the boxes in transit and quarantine them when they arrive.
5. Find the lot again after any new receipt of that supply.

## Related pages

<CardGroup cols={2}>
  <Card title="Boxes and labels" icon="box-open" href="/docs/en/inventory/boxes">
    Box history and taking a single box out of use.
  </Card>

  <Card title="Record use and move boxes" icon="arrow-right-arrow-left" href="/docs/en/inventory/use-and-moves">
    Usage by room and care references.
  </Card>

  <Card title="Custody history" icon="route" href="/docs/en/deliveries/custody-history">
    Where a dispatched box went.
  </Card>

  <Card title="Receive stock" icon="truck-ramp-box" href="/docs/en/inventory/receive">
    How lot numbers are recorded at reception.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.