> ## 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.

# Retiro de lote

> Encuentra todas las cajas de un lote estén donde estén, rastrea lo que se consumió o despachó y saca el lote completo de uso en un solo paso

Cuando un proveedor retira un lote, necesitas saber dónde está cada unidad y evitar que alguien la use. La pantalla **Retiro de lote** encuentra todas las cajas de un insumo que tienen ese lote, en cualquier estado, y pone en cuarentena todas las cajas que siguen en uso en un solo paso confirmado.

## Quién puede hacerlo

| Tarea | Permiso | Sin el permiso |
| - | - | - |
| Buscar un lote y ver sus cajas | `inventory.read` | La pantalla dice **No tienes permiso para ver existencias. Pide acceso a un administrador.** |
| Poner el lote en cuarentena | `inventory.adjust` | La pantalla dice **Puedes buscar un lote. Para ponerlo en cuarentena necesitas permiso para ajustar existencias.** |

Ambas tareas solo abarcan las cajas de las bodegas a las que tienes acceso. Para un retiro completo, pide que lo haga alguien con acceso a todas las bodegas.

## Dónde

**Inventario** en la navegación principal y luego **Retiro de lote** en la parte superior de la pantalla **Existencias**, o `console.muveya.com/inventory/lots`. La pantalla se titula **Retiro de lote**: "Encuentra todas las cajas de un lote, estén donde estén, y saca el lote de uso en un solo paso."

## Encontrar todas las cajas de un lote

<Steps>
  <Step title="Elige el insumo">
    En **Insumo** (**Elige el insumo**), elige el insumo al que pertenece el lote. Aparecen todos los insumos, activos o no. Si lo dejas vacío, verás **Elige el insumo al que pertenece el lote.**
  </Step>

  <Step title="Escribe el lote">
    Escríbelo en **Número de lote**, "Tal como aparece en el empaque o en el aviso de retiro.", con hasta 120 caracteres. Si lo dejas vacío, verás **Ingresa el número de lote.**
  </Step>

  <Step title="Busca las cajas">
    Presiona **Buscar cajas**. Mientras busca verás **Buscando las cajas de este lote…**.
  </Step>

  <Step title="Lee el resumen">
    Los resultados llevan como título el lote y el insumo, por ejemplo **Lote L2409-A · Guantes de nitrilo M · GLV-NIT-M**, seguidos de un conteo como **Cajas encontradas: 6 · Todavía en uso: 4**.
  </Step>
</Steps>

El lote debe coincidir con lo que se escribió al recibir las cajas; los espacios al inicio y al final no importan. Los contenedores separados de una caja del lote conservan su lote, así que también aparecen. Si nada coincide, la pantalla dice **Ninguna caja de tus bodegas tiene el lote L2409-A de este insumo. Revisa el lote tal como está impreso; los espacios al inicio o al final no importan.**

La lista muestra hasta 200 cajas, agrupadas por bodega y luego por fecha de recepción. Si hay más, agrega **Se muestran las primeras 200 cajas de este lote.**

## Leer los resultados

| Columna | Qué muestra |
| - | - |
| **Caja** | El código de la caja, como enlace a la caja. |
| **Bodega** | Dónde está la caja ahora. **Bodega no disponible** si ya no se puede nombrar. |
| **Estado** | El estado de la caja. |
| **En mano** | Las unidades que tiene ahora, con la unidad. |
| **Último movimiento** | El movimiento más reciente y su fecha, por ejemplo `Consumido · 12 sept 2026, 10:40`. **Todavía no hay movimientos** si no hay ninguno. |

Qué significa cada estado para el retiro:

| Estado | Significado | Qué hace el retiro |
| - | - | - |
| **Activa** | Sigue en uso. | La pone en cuarentena. |
| **En cuarentena**, **Vencida**, **Dada de baja** | Ya está fuera de uso. | La deja como está. |
| **Agotada** | Todas sus unidades ya salieron de la caja. | La deja como está. Rastrea sus salidas (más abajo). |
| **En tránsito** | Despachada para un pedido y aún no recibida. | **No** la retiene. Vuelve a hacer el retiro cuando llegue. |

## Rastrear lo que se consumió o despachó

La pantalla del lote te dice dónde está cada caja y qué le pasó por última vez. Para seguir cada unidad:

* **Abre cada caja.** Sus **Movimientos** muestran cada salida con el box o área, **Qué pasó**, **Propósito**, **Responsable**, **Registrado por** y la fecha. Una caja **Agotada** ya entregó todas sus unidades. Revisa [Cajas y etiquetas](/docs/es/inventory/boxes).
* **Revisa los boxes.** En **Uso por box o área** (consulta [Registrar consumo y trasladar cajas](/docs/es/inventory/use-and-moves)), filtra por box y fechas y compara la fecha y la cantidad con las salidas de la caja. Los miembros con `orders.patient_ref.read` también ven la referencia de atención de cada salida, lo que permite al equipo clínico encontrar las atenciones involucradas. Esa pantalla no filtra por lote.
* **Sigue los pedidos.** Una caja que muestra **Despachado** o **En tránsito** salió para un pedido. Sigue el pedido en [Historial de custodia](/docs/es/deliveries/custody-history).
* **Sigue los contenedores separados.** La caja original los muestra en **Separada en**, y también aparecen en los resultados del lote.

## Sacar el lote de uso

La sección **Sacar el lote de uso** aparece debajo de los resultados: "Cada caja de este lote que sigue en uso pasa a cuarentena: deja de recibir movimientos y nunca se asigna a un pedido. Las cajas que ya están fuera de uso quedan como están."

<Steps>
  <Step title="Revisa las cajas en tránsito">
    Si hay cajas en camino, la pantalla avisa, por ejemplo, **En tránsito, este retiro no las retiene: 1. Cuando lleguen, busca de nuevo este lote y ponlas en cuarentena.**
  </Step>

  <Step title="Elige el motivo">
    En **Por qué**, deja **Retirada por el proveedor** (por defecto) o elige **Dañada**, **Vencida**, **Contaminada** u **Otro**.
  </Step>

  <Step title="Pon el lote en cuarentena">
    Presiona **Poner el lote en cuarentena**.
  </Step>

  <Step title="Confirma">
    Un diálogo pregunta **¿Poner en cuarentena el lote L2409-A?** y dice, por ejemplo, "Cajas en uso que pasan a cuarentena: 4. Dejan de recibir movimientos y nunca se asignan a un pedido. No se puede deshacer desde la Consola." También repite cuántas cajas en tránsito no se retienen. Presiona **Sí, poner en cuarentena**, o **Mantener el lote en uso** para cancelar.
  </Step>

  <Step title="Lee el resultado">
    La pantalla dice, por ejemplo, **Cajas del lote L2409-A en cuarentena: 4.**, y luego **Ya estaban fuera de uso y quedan como estaban: 2.** y **En tránsito y sin retener: 1. Cuando lleguen, busca de nuevo este lote y ponlas en cuarentena.** cuando corresponde.
  </Step>
</Steps>

Si ninguna caja está en uso y ninguna está en tránsito, la sección dice **Todas las cajas de este lote ya están fuera de uso.**

### Qué registra el sistema

* Para cada caja **Activa**: un movimiento `quarantine` (**En cuarentena**) con cambio `0`, el motivo y tu nombre como quien lo registró, y el estado de la caja pasa a **En cuarentena**. Cada caja tiene su propio movimiento.
* Un registro de auditoría, `inventory.lot.quarantined`, con el insumo, el lote, el motivo, las cajas retenidas y las cajas que quedaron como estaban.
* Las cajas en cualquier otro estado se informan con su estado actual y no cambian.

Una caja en cuarentena ya no se puede consumir, trasladar, separar, corregir ni tomar para un pedido. Su historial y su cantidad registrada se conservan.

### Reglas y límites

* El retiro actúa sobre **todas** las cajas del lote en tus bodegas, incluidas las que están más allá de las 200 listadas. La cantidad del diálogo solo cuenta las cajas listadas.
* Las cajas en tránsito no se retienen, porque al recibirlas quedan utilizables en el destino. Cuando lleguen, busca el lote otra vez y vuelve a ponerlo en cuarentena.
* Si se perdió el resultado (por ejemplo, se cayó la conexión), la lista se recarga y muestra qué cajas ya están **En cuarentena**. Si alguna sigue **Activa**, presiona **Poner el lote en cuarentena** otra vez: las cajas ya retenidas no se retienen dos veces. Cuando todo ya estaba registrado, la pantalla responde **Este retiro ya estaba registrado. No cambió nada más.**
* Volver a hacer el retiro más adelante, por ejemplo después de recibir más cajas del lote, retiene las nuevas cajas activas e informa el resto como ya fuera de uso.
* No existe una acción para sacar una caja de la cuarentena.
* Descartar cajas en cuarentena todavía no está disponible en la consola. Quedan en cuarentena, lo que las mantiene fuera de todo movimiento. Si necesitas registrar el descarte, escribe a [team@muveya.com](mailto:team@muveya.com).
* Poner un lote en cuarentena está marcado como acción sensible. En la versión actual el segundo factor es opcional y no la bloquea; revisa [Seguridad de la cuenta](/docs/es/account/security).

### Qué puede salir mal

| Mensaje | Causa | Qué hacer |
| - | - | - |
| **Este registro no está disponible en la cuenta de clínica dental activa.** | Ya no hay cajas de este lote en tus bodegas. | Busca el lote otra vez. |
| **El registro cambió o ya existe. Revísalo antes de volver a intentar.** | Un intento anterior de este retiro se registró con otro motivo. | Busca el lote otra vez y repite. |
| **No pudimos confirmar la operación. Revisa tu conexión y la lista antes de volver a intentar.** | Falló la conexión. | Revisa los estados en la lista recargada y repite si quedan cajas en estado **Activa**; nada se retiene dos veces. |
| **Tu cuenta no tiene permiso para esta acción.** | No tienes `inventory.adjust`. | Pide ayuda a un administrador. |

## Lista de control del retiro

1. Busca el lote y ponlo en cuarentena.
2. Saca las cajas en cuarentena del estante y mantenlas apartadas.
3. Rastrea las salidas de las cajas ya usadas.
4. Sigue las cajas en tránsito y ponlas en cuarentena cuando lleguen.
5. Busca el lote otra vez después de cualquier nueva recepción de ese insumo.

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Cajas y etiquetas" icon="box-open" href="/docs/es/inventory/boxes">
    Historial de una caja y cómo sacar de uso una sola caja.
  </Card>

  <Card title="Registrar consumo y trasladar cajas" icon="arrow-right-arrow-left" href="/docs/es/inventory/use-and-moves">
    Uso por box o área y referencias de atención.
  </Card>

  <Card title="Historial de custodia" icon="route" href="/docs/es/deliveries/custody-history">
    Adónde fue una caja despachada.
  </Card>

  <Card title="Recibir existencias" icon="truck-ramp-box" href="/docs/es/inventory/receive">
    Cómo se registran los números de lote al recibir.
  </Card>
</CardGroup>


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