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

# Registrar consumo y trasladar cajas

> Registra lo que sale de una caja y adónde fue, traslada cajas entre bodegas, revisa el uso por box o área y atribuye salidas después sin descontar dos veces

Las existencias salen de una caja de dos formas habituales: alguien las usa, o se entregan a un box o área. Esta página explica cómo registrar esas salidas, cómo trasladar una caja completa a otra bodega, cómo leer la pantalla **Uso por box o área** y cómo atribuir una salida después.

## Boxes, áreas y cómo cuentan

Las salidas apuntan a los **boxes y áreas** de una sede (por ejemplo un box de atención o un área de esterilización). Se configuran por sede; revisa [Boxes y áreas](/docs/es/locations/destinations). Cada uno tiene un **Control de stock**:

| Control de stock | Significado | Salidas que acepta |
| - | - | - |
| **Sin conteo** | "Las entregas salen del inventario; lo que queda en el box no se cuenta." | **Entrega al box o área** y **Uso directo**. |
| **Stock contado** | "El box tiene existencias propias que se cuentan." Sus existencias están en una bodega express, su **Punto de stock**. | Solo **Uso directo**, y solo desde una caja que ya está en su punto de stock. |

Lo que pasó con las existencias tiene dos valores posibles:

* **Entrega al box o área** (`issue`): "Sale del inventario una sola vez; quién lo usó se puede atribuir después sin descontar de nuevo."
* **Uso directo** (`use`): "Se usó en el momento."

Los boxes que se ofrecen dependen de dónde está la caja. Una caja en una bodega **Central** puede ir a los boxes activos de cualquier sede. Una caja en una bodega **Express** solo puede ir a los boxes activos de la sede de esa bodega.

## Registrar un consumo o una salida de una caja

**Quién puede hacerlo:** `inventory.consume` (**Registrar consumo**) o `inventory.adjust`, con acceso a la bodega de la caja. Para abrir la caja también se necesita `inventory.read`.

**Dónde:** la pantalla de la caja. Escanea la caja con **Escanear un código** en la pantalla **Existencias**, o ábrela desde la lista. El formulario de salida es la primera acción de una caja **Activa**.

<Steps>
  <Step title="Abre la caja">
    Escanea o escribe su código. Revisa [Cajas y etiquetas](/docs/es/inventory/boxes).
  </Step>

  <Step title="Cantidad">
    Escribe cuántas unidades salieron en **Cantidad**. Empieza en 1.
  </Step>

  <Step title="Box o área">
    Elígelo en **Box o área** (**Elige un box o área**). Si solo hay uno posible, aparece ya elegido. Con varias sedes, cada box muestra también su sede, por ejemplo `Box 1 · Clínica Norte`.
  </Step>

  <Step title="Qué pasó">
    Para un box sin conteo, elige **Entrega al box o área** (seleccionado por defecto) o **Uso directo** en **Qué pasó**. Para un box con **Stock contado**, cuando la caja ya está en su punto de stock, la pantalla dice **Se usa desde las existencias contadas de este box.** y registra un uso directo.
  </Step>

  <Step title="Propósito">
    Elige el **Propósito**: **Sin especificar** (por defecto), **Procedimiento**, **Limpieza**, **Administrativo** u **Otro**.
  </Step>

  <Step title="Responsable">
    **Responsable** empieza con tu propio nombre. Si eliges a otra persona, la ayuda lo confirma, por ejemplo **Registrado por ti, responsable: Ana Rojas.**
  </Step>

  <Step title="Referencia de atención (opcional)">
    En **Referencia de atención (opcional)**, escribe el código del sistema clínico: "El código del sistema clínico, nunca el nombre del paciente."
  </Step>

  <Step title="Consumir">
    Presiona **Consumir**. La pantalla confirma **Consumo registrado.** El campo de referencia de atención se limpia para la siguiente salida.
  </Step>
</Steps>

### Cuando el box cuenta sus propias existencias

Si eliges un box con **Stock contado** y la caja está en otro lugar, el formulario no deja consumir. Dice, por ejemplo, **Box 2 cuenta sus propias existencias. Primero lleva la caja completa allí; sacar solo una parte de una caja llegará más adelante.**

* Con `inventory.transfer`, presiona **Llevar esta caja a Box 2**. La caja pasa al punto de stock del box y la pantalla confirma **La caja ya está en Box 2.** Después puedes registrar el uso.
* Sin ese permiso, el formulario dice **Pide a alguien que pueda trasladar cajas que lleve esta caja a Box 2.**

<Tip>
  Para llevar a un box con **Stock contado** solo una parte de una caja, primero separa esas unidades en un contenedor nuevo (consulta [Cajas y etiquetas](/docs/es/inventory/boxes)) y luego traslada ese contenedor al punto de stock del box.
</Tip>

### Cuando la sede no tiene boxes ni áreas

El formulario dice **Esta sede todavía no tiene boxes ni áreas, así que este consumo no dirá adónde fue.** De todos modos puedes registrar la salida; se guarda sin box. Quienes pueden administrar sedes también ven **Configurar boxes y áreas**. Esas salidas no aparecen en **Uso por box o área**.

### Reglas

| Regla | Detalle |
| - | - |
| Cantidad | Número entero de 1 a un millón, y no más de lo que la caja tiene en mano. |
| Unidades reservadas | El límite es lo que hay en mano, no lo disponible: la consola no impide usar unidades reservadas para un pedido. Revisa primero **Reservado** en la lista **Existencias**. |
| Caja | **Activa** y sin haber pasado su fecha de vencimiento. |
| Box o área | Activo; de la sede de la caja, salvo que la caja esté en una bodega central. Un box con **Stock contado** solo acepta uso directo desde su punto de stock. Si la sede tiene boxes, elegir uno es obligatorio. |
| Responsable | Un miembro activo del equipo. |
| Referencia de atención | Opcional. De 1 a 64 caracteres: letras, números y `. _ : / -`, empezando por una letra o un número, sin espacios. |

La referencia de atención se guarda sellada. Nunca aparece en el historial de la caja; en **Uso por box o área** solo la ven los miembros con el permiso `orders.patient_ref.read`. Nunca escribas ahí el nombre ni el documento de un paciente.

### Qué registra el sistema

Un movimiento `consume` que resta la cantidad de lo que hay en mano, con la bodega de la caja como origen, el box o área, qué pasó, el propósito, el responsable, la referencia de atención sellada y tu nombre como quien lo registró. Cuando lo que hay en mano llega a cero, la caja pasa a **Agotada**. En el historial de la caja el movimiento dice **Consumido**, o **Entregado** si fue una entrega a un box o área. Estas salidas alimentan el [Reporte de consumo](/docs/es/reports/consumption).

Presionar de nuevo o reintentar después de perder la respuesta registra la salida una sola vez y responde **Ya estaba registrado.**

### Qué puede salir mal

| Mensaje | Causa | Qué hacer |
| - | - | - |
| **Usa letras, números y . \_ : / - sin espacios.** | La referencia de atención tiene un espacio u otro carácter. | Escribe solo el código. **Consumir** queda desactivado hasta que sea válida. |
| **Este box cuenta sus propias existencias. Primero lleva la caja allí.** | Se envió una entrega a un box con **Stock contado**. | Traslada la caja al punto de stock del box y registra un uso directo. |
| **Esta caja pertenece a otra sede que el box o área elegido. Revisa dónde está la caja.** | El box es de otra sede, o la caja se trasladó mientras tanto. | Elige un box de la sede de la caja o recarga la caja. |
| **Ese box o área ya no está activo. Elige otro.** | El box se desactivó. | Elige otro box. |
| **La persona responsable ya no está en el equipo. Elige a otra persona.** | El responsable salió del equipo. | Elige a otra persona. |
| **Usa el código del sistema clínico, sin espacios.** | El servidor rechazó la referencia de atención. | Corrige el código. |
| **El registro cambió o ya existe. Revísalo antes de volver a intentar.** | La caja ya no está activa, pasó su fecha de vencimiento o tiene menos que la cantidad. | Recarga la caja y revisa lo que tiene en mano. |
| **Revisa los datos ingresados antes de volver a intentar.** | Un valor está fuera de rango. | Corrige la cantidad. |
| **Este registro no está disponible en la cuenta de clínica dental activa.** | La caja está fuera de tus bodegas o ya no existe. | Revisa el código. |
| **Tu cuenta no tiene permiso para esta acción.** | No tienes `inventory.consume`. | Pide ayuda a un administrador. |

## Trasladar una caja a otra bodega

**Quién puede hacerlo:** `inventory.transfer` (**Trasladar cajas entre bodegas**) o `inventory.adjust`, con acceso a ambas bodegas.

**Dónde:** la pantalla de la caja, **Bodega de destino** y **Trasladar**.

<Steps>
  <Step title="Elige el destino">
    En **Bodega de destino**, elige una de las bodegas activas a las que tienes acceso. La bodega actual de la caja no se ofrece.
  </Step>

  <Step title="Traslada">
    Presiona **Trasladar**. No hay un diálogo de confirmación.
  </Step>

  <Step title="Revisa el resultado">
    La pantalla confirma, por ejemplo, **Trasladada a Express Norte.** Una solicitud repetida responde **Ya estaba registrado.**
  </Step>
</Steps>

Si no hay otra bodega disponible, la pantalla dice **No hay otra bodega a la que puedas trasladar esta caja.**

### Reglas

* Un traslado mueve la **caja completa**. Para mover solo una parte, separa esas unidades primero y traslada el contenedor nuevo.
* La caja debe estar **Activa** y sin haber pasado su fecha de vencimiento. El destino debe estar activo y ser distinto de la bodega actual.
* La caja conserva su código, lote, fecha de vencimiento y cantidades. Las unidades reservadas para un pedido siguen reservadas, y la caja se puede seguir tomando para ese pedido desde su nueva bodega.
* Trasladar una caja 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é registra el sistema

Dos movimientos con cambio `0` y una misma identidad de traslado: `transfer_out` (**Salida por traslado**) desde el origen y `transfer_in` (**Entrada por traslado**) hacia el destino. La bodega de la caja cambia en el mismo paso, así que la lista **Existencias** la muestra en su nuevo lugar.

### Qué puede salir mal

| Mensaje | Causa | Qué hacer |
| - | - | - |
| **Revisa los datos ingresados antes de volver a intentar.** | La caja ya está en esa bodega. | Recarga la caja. |
| **El registro cambió o ya existe. Revísalo antes de volver a intentar.** | El destino se desactivó, o la caja ya no está activa o pasó su fecha de vencimiento. | Elige otra bodega o saca la caja de uso. |
| **Este registro no está disponible en la cuenta de clínica dental activa.** | La caja o el destino están fuera de tu acceso. | Pide acceso a la bodega a un administrador. |
| **Tu cuenta no tiene permiso para esta acción.** | No tienes `inventory.transfer`. | Pide ayuda a un administrador. |

## Revisar el uso por box o área

**Quién puede hacerlo:** `inventory.read` para leerlo; `inventory.consume` o `inventory.adjust` para atribuir salidas.

**Dónde:** **Uso por box o área** en la parte superior de la pantalla **Existencias**, o `console.muveya.com/inventory/usage`. La pantalla dice: "Lo que salió de las existencias hacia cada box o área, y cuánto ya está atribuido."

### Filtros

| Filtro | Detalle |
| - | - |
| **Box o área** | **Todos los boxes y áreas**, o un box (activo o no). |
| **Desde** y **Hasta** | Días de calendario, ambos incluidos. Empiezan en los últimos siete días, contando hoy. El inicio debe ser igual o anterior al término y el rango puede abarcar hasta 92 días; si no, la pantalla dice **Elige una fecha de inicio igual o anterior a la de término, con 92 días de diferencia como máximo.** |

Solo aparecen las salidas registradas **con** un box o área, de cajas de tus bodegas: "Aquí solo aparecen los consumos registrados con un box o área." Si no hay ninguna, la pantalla dice **No hay salidas con box o área en estas fechas.**

### Totales

Una fila por box, insumo y unidad. Nunca se suman cantidades de insumos o unidades distintas.

| Columna | Significado |
| - | - |
| **Box o área** | El box. **Box no disponible** si ya no se puede nombrar. |
| **Insumo** | Nombre y SKU. **Insumo no disponible** si ya no se puede nombrar. |
| **Unidad** | La unidad de las cantidades. |
| **Entregado** | Unidades entregadas al box. |
| **Uso directo** | Unidades usadas directamente. |
| **Atribuido** | Cuánto de esas salidas explicó una atribución posterior. |

### Salidas

| Columna | Significado |
| - | - |
| **Cuándo** | Fecha y hora de la salida. |
| **Insumo**, **Cantidad**, **Unidad** | Lo que salió. |
| **Box o área** | Adónde fue. |
| **Qué pasó** | **Entrega al box o área** o **Uso directo**. |
| **Propósito**, **Responsable** | Lo que se registró con la salida. |
| **Registrado por** | Quién la registró. |
| **Pendiente** | Unidades de la salida que ninguna atribución posterior ha explicado todavía. El responsable elegido al registrar la salida no lo reduce. |
| **Referencia de atención** | Solo para miembros con `orders.patient_ref.read`, y solo cuando alguna salida tiene una. |
| **Acciones** | **Atribuciones** con su cantidad, para desplegarlas, y **Atribuir** mientras quede algo pendiente. |

La pantalla lee hasta 2.000 salidas. Si hay más, dice **Esta es una vista parcial. Acota las fechas para ver todas las salidas.** y los totales cuentan solo lo leído. Si la carga falla, presiona **Reintentar**.

## Atribuir una salida después

Una entrega a un box sale del inventario una sola vez. Después puedes indicar quién usó cuánto y para qué, sin volver a descontar existencias.

<Steps>
  <Step title="Encuentra la salida">
    En **Uso por box o área**, busca la fila y presiona **Atribuir**. Solo aparece mientras **Pendiente** es mayor que cero.
  </Step>

  <Step title="Completa la atribución">
    **Cantidad a atribuir** empieza con todo lo pendiente. Elige el **Responsable** (tú, por defecto) y el **Propósito** y, si quieres, escribe una **Referencia de atención (opcional)**.
  </Step>

  <Step title="Guarda">
    Presiona **Guardar atribución**. La pantalla confirma **Atribución registrada.** y el campo de cantidad muestra lo que sigue pendiente. Presiona **Cerrar** cuando termines.
  </Step>

  <Step title="Lee las atribuciones">
    Presiona **Atribuciones** con su cantidad, por ejemplo **Atribuciones (2)**, para ver cada una con **Cuándo**, **Cantidad**, **Responsable**, **Propósito**, **Registrado por** y, para miembros con `orders.patient_ref.read`, **Referencia de atención**.
  </Step>
</Steps>

### Reglas

* Solo se pueden atribuir salidas registradas con un box o área, sean entregas o usos directos.
* El total atribuido nunca puede superar la cantidad de la salida. Para repartir una salida entre varias personas, guarda varias atribuciones.
* Una atribución no mueve existencias y no se puede editar ni borrar.
* El responsable debe ser un miembro activo del equipo. La referencia de atención sigue el mismo formato que en una salida.
* Guardar de nuevo la misma atribución responde **Ya estaba registrado.** y no agrega nada.

### Qué puede salir mal

| Mensaje | Causa | Qué hacer |
| - | - | - |
| **Eso supera lo que queda pendiente de esta salida.** | La cantidad es mayor que lo pendiente. | Baja la cantidad. |
| **El registro cambió o ya existe. Revísalo antes de volver a intentar.** | La salida ya está atribuida por completo. | Recarga la pantalla. |
| **Revisa los datos ingresados antes de volver a intentar.** | El responsable ya no está en el equipo, o un valor no es válido. | Elige a otra persona o corrige el valor. |
| **Este registro no está disponible en la cuenta de clínica dental activa.** | La salida vino de una bodega fuera de tu acceso. | Pide ayuda a alguien con acceso a esa bodega. |

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Boxes y áreas" icon="door-open" href="/docs/es/locations/destinations">
    Configura dónde se usan los insumos y cómo cuentan los boxes.
  </Card>

  <Card title="Cajas y etiquetas" icon="box-open" href="/docs/es/inventory/boxes">
    Escanea una caja, separa parte de ella y revisa su historial.
  </Card>

  <Card title="Reporte de consumo" icon="chart-line" href="/docs/es/reports/consumption">
    El consumo a lo largo del tiempo.
  </Card>

  <Card title="Bodegas" icon="warehouse" href="/docs/es/locations/warehouses">
    Bodegas centrales y express.
  </Card>
</CardGroup>


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