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

# Cajas y etiquetas

> Encuentra una caja por su código, revisa sus datos e historial, imprime su etiqueta, separa parte de ella y sácala de uso

La caja es la unidad que muveya sigue: un contenedor de un solo insumo, con un código impreso. Esta página explica cómo encontrar una caja, todo lo que muestra su pantalla, cómo imprimir y reimprimir su etiqueta, cómo separar parte de ella en un contenedor nuevo y cómo sacarla de uso.

## Encontrar una caja

### Escanear o escribir su código

**Quién puede hacerlo:** los miembros con `inventory.read` y acceso a la bodega de la caja.

**Dónde:** **Inventario** y luego **Escanear un código** en la parte superior de la pantalla **Existencias**, o `console.muveya.com/inventory/scan`. La pantalla se titula **Escanear**: "Lee una etiqueta o escribe el código."

<Steps>
  <Step title="Lee la etiqueta">
    El campo **Código de caja** queda activo al abrir la pantalla, así que un lector de códigos de barras escribe directamente en él. También puedes escribir el código a mano.
  </Step>

  <Step title="Busca">
    Presiona **Buscar** (un lector que envía Enter lo hace por ti). Mientras busca verás **Buscando…**.
  </Step>

  <Step title="Abre">
    Si el código existe en tus bodegas, se abre la pantalla de la caja.
  </Step>
</Steps>

El código debe coincidir exactamente con la etiqueta; los espacios al inicio y al final no importan. Si no encuentra nada, la pantalla dice **No encontramos esa caja.** El mismo mensaje aparece cuando la caja está en una bodega fuera de tu acceso o cuando no tienes `inventory.read`: muveya nunca revela si un código existe en una bodega que no puedes ver.

### Otras formas de abrir una caja

* Desde la lista **Existencias**, selecciona el nombre del insumo en una fila.
* Desde [Retiro de lote](/docs/es/inventory/lot-recall), selecciona el código de una caja.
* Desde la confirmación después de recibir (consulta [Recibir existencias](/docs/es/inventory/receive)) o de separar, selecciona **Abrir la caja** o **Abrir**.
* Desde los enlaces **Separada de** y **Separada en** de otra caja.

## La pantalla de la caja

La ruta es `/inventory/boxes/:boxId`. El título es el código de la caja y la línea de abajo es su estado (por ejemplo **Activa** o **Agotada**). **Volver a existencias** regresa a la lista. Mientras carga verás **Cargando caja…**.

### Datos

| Campo | Qué muestra |
| - | - |
| **Insumo** | Nombre y SKU. |
| **Bodega** | Dónde está la caja ahora. |
| **En mano** | Las unidades de la caja, con la unidad, por ejemplo `80 × Unidad`. |
| **Recibida como** | Solo en cajas recibidas como presentación: la cantidad, el nombre de la presentación y la versión que se recibió, por ejemplo `3 × Caja de 100 (versión 2)`. Si esa presentación ya no se puede leer: `3 × presentación no disponible (versión 2)`. |

Si la unidad guardada de la caja no se puede confirmar, la pantalla agrega **La unidad de esta caja requiere revisión. Sus cantidades se muestran sin unidad hasta que alguien la revise.**

<Note>
  La pantalla de la caja no muestra el lote, la fecha de vencimiento ni los números de serie. El lote y la fecha de vencimiento se ven en la vista previa de la etiqueta (más abajo). Los números de serie no se muestran en ninguna parte de la consola; los devuelve `GET /v1/inventory/boxes/{boxId}` en la API pública (consulta [API para desarrolladores](/docs/es/api-reference/introduction)).
</Note>

### Contenedores separados

Cuando una caja se separó de otra, o se separaron otros contenedores de ella, la pantalla muestra:

| Etiqueta | Qué muestra |
| - | - |
| **Separada de** | El código de la caja original, como enlace. |
| **Separada en** | Cada contenedor separado de esta caja: su código (un enlace), la cantidad con la que empezó y su estado actual (por ejemplo `20 · Activa`), e **Imprimir la etiqueta de** seguido de su código. Se muestran hasta 50 contenedores, del más antiguo al más reciente. |

Una caja relacionada que está en una bodega fuera de tu acceso no se nombra.

### Movimientos

La tabla **Movimientos** muestra todo el registro de la caja, del más antiguo al más reciente. Si no hay movimientos, dice **Todavía no hay movimientos.**

| Columna | Qué muestra |
| - | - |
| **Tipo** | El movimiento, por ejemplo **Recibido**, **Consumido**, **Entrada por traslado** o **Separación (salida)**. Una salida entregada a un box o área muestra **Entregado**. Revisa todos los tipos en [Resumen del inventario](/docs/es/inventory/overview). |
| **Cambio** | El cambio con signo en lo que hay en mano, con la unidad, por ejemplo `+300 × Unidad` o `−5 × Unidad`. Los traslados, las reservas, las tomas para pedido y los cambios de estado muestran `0`. |
| **Dónde** | El box o área de una salida; en los demás casos, la bodega a la que entró o de la que salió la caja. |
| **Propósito** | En las salidas: **Procedimiento**, **Limpieza**, **Administrativo** u **Otro**. |
| **Responsable** | En las salidas: el profesional indicado como responsable. |
| **Registrado por** | Quién registró el movimiento. Alguien que ya no está en el equipo, o un paso automático como la asignación de un pedido, aparece como **Fuera del equipo**. |
| **Cuándo** | Fecha y hora en que ocurrió el movimiento. |

Una columna sin valor para ese movimiento muestra un guion. Las referencias de atención nunca aparecen en esta tabla; revisa [Registrar consumo y trasladar cajas](/docs/es/inventory/use-and-moves).

## Imprimir o reimprimir una etiqueta

La sección **Etiqueta** está en todas las pantallas de caja: "Imprímela y pégala en el contenedor para que un escáner encuentre esta caja."

<Steps>
  <Step title="Muestra la etiqueta">
    Selecciona **Ver la etiqueta de BX-7K3QM9**. Los enlaces **Imprimir la etiqueta de** que aparecen después de una recepción o una separación abren la caja con la etiqueta ya visible.
  </Step>

  <Step title="Revisa la vista previa">
    La etiqueta muestra el código como código de barras Code 128, el código en texto debajo, el nombre y SKU del insumo, cómo se recibió la caja (por ejemplo `3 × Caja de 100`) y, cuando la caja los tiene, **Lote** y **Vence** con la fecha.
  </Step>

  <Step title="Imprime">
    Presiona **Imprimir etiqueta**. Se abre el diálogo de impresión del navegador y la página imprime solo la etiqueta, en negro sobre blanco, de 62 mm de ancho, en la esquina superior izquierda de la hoja.
  </Step>
</Steps>

Puedes reimprimir una etiqueta todas las veces que necesites; imprimir no registra nada. Un código con caracteres distintos de letras simples, dígitos y símbolos comunes se imprime solo como texto, sin código de barras.

## Acciones sobre una caja activa

Los formularios siguientes aparecen solo mientras la caja está **Activa**, y cada uno solo para quienes tienen su permiso. Cuando la caja está en cualquier otro estado, la pantalla dice **Esta caja está cerrada y no admite más movimientos.**

| Sección | Permiso | Guía |
| - | - | - |
| Cantidad, box o área y **Consumir** | `inventory.consume` | [Registrar consumo y trasladar cajas](/docs/es/inventory/use-and-moves) |
| **Bodega de destino** y **Trasladar** | `inventory.transfer` | [Registrar consumo y trasladar cajas](/docs/es/inventory/use-and-moves) |
| **Separar parte de esta caja** | `inventory.transfer` | Más abajo |
| **Corregir esta caja** y **Contar este insumo aquí** | `inventory.adjust` | [Correcciones](/docs/es/inventory/corrections), [Conteos](/docs/es/inventory/counts) |
| **Sacar la caja de uso** | `inventory.adjust` | Más abajo |

`inventory.adjust` incluye `inventory.consume` e `inventory.transfer`.

## Separar parte de una caja

Separar saca algunas unidades de una caja a un contenedor nuevo y etiquetado en la misma bodega, por ejemplo para llevar 20 guantes a un box mientras el resto de la caja sigue en el estante.

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

**Dónde:** la pantalla de la caja, sección **Separar parte de esta caja**: "Saca algunas unidades a un contenedor nuevo. Conserva el lote y el vencimiento de esta caja."

<Steps>
  <Step title="Cantidad">
    Escribe las unidades en **Cantidad a separar**. La ayuda indica el máximo, por ejemplo **Hasta 12 unidades libres.**
  </Step>

  <Step title="Etiqueta (opcional)">
    Escribe el código que anotarás en el contenedor nuevo en **Etiqueta del contenedor nuevo (opcional)**, o déjalo vacío: "Si la dejas vacía, se sugiere una."
  </Step>

  <Step title="Separa">
    Presiona **Separar**.
  </Step>

  <Step title="Etiqueta el contenedor">
    La pantalla confirma, por ejemplo, **Se separaron 20 en BX-7K3QM9-F1. Escribe este código en el contenedor nuevo.**, muestra el código en su propia línea y ofrece **Abrir BX-7K3QM9-F1** e **Imprimir la etiqueta de BX-7K3QM9-F1**.
  </Step>
</Steps>

### Reglas

* La cantidad es un número entero desde 1 hasta el menor valor entre las unidades disponibles de la caja y lo que tiene en mano menos uno. Siempre queda al menos una unidad en la caja: para llevarse todo, traslada la caja completa.
* Solo se pueden separar unidades libres, nunca unidades reservadas para pedidos. Si no hay nada libre, la sección dice **Esta caja no tiene unidades libres para separar.**
* La caja debe estar **Activa**, sin haber pasado su fecha de vencimiento, sin control de números de serie y con una unidad confirmada.
* Una etiqueta escrita tiene hasta 64 caracteres, sin los espacios al inicio y al final, y debe ser única en tu clínica dental. Si no escribes una, muveya usa el código original seguido de `-F` y un número: `BX-7K3QM9-F1`, luego `BX-7K3QM9-F2`, y salta los códigos que ya están en uso.
* El contenedor nuevo queda en estado **Activa**, en la misma bodega, con el mismo insumo, lote, fecha de vencimiento, fecha de recepción y unidad. No queda asociado a una presentación: su cantidad está en unidades base. No lleva ninguna reserva.

### Qué registra el sistema

* Un movimiento `split_out` (**Separación (salida)**) en la caja original, que resta la cantidad.
* Una caja nueva vinculada a la original.
* Un movimiento `split_in` (**Separación (entrada)**) en la caja nueva, que suma la misma cantidad.

Ambos movimientos comparten una misma identidad de separación, y el total en mano del insumo no cambia. Presionar de nuevo o reintentar después de perder la respuesta nunca separa dos veces: responde **Ya estaba registrado.**

Durante la preparación de un pedido (consulta [Preparar y despachar un pedido](/docs/es/deliveries/picking)), muveya puede separar una caja por su cuenta para que un pedido salga exactamente con las unidades reservadas para él. Esas separaciones aparecen en el mismo historial.

### Qué puede salir mal

| Mensaje | Qué hacer |
| - | - |
| **Ingresa un número entero de 1 a 12.** | Escribe un número entero dentro del rango indicado. |
| **Usa como máximo 64 caracteres.** | Acorta la etiqueta. |
| **Esa etiqueta ya está en otra caja. Escribe una distinta.** | Escribe otra etiqueta o déjala vacía. |
| **No puedes separar todo lo que tiene la caja. Para moverla completa, trasládala.** | Separa menos o traslada la caja. |
| **Solo se pueden separar unidades libres: el resto está reservado para pedidos.** | Separa menos unidades. |
| **Esta caja registra números de serie y todavía no se puede separar.** | Las cajas con números de serie todavía no se pueden separar. |
| **La unidad de esta caja no está verificada, así que no se puede separar. Revisa primero la unidad del insumo.** | Pide a quien administra el catálogo que confirme la unidad del insumo. Consulta [Insumos del catálogo](/docs/es/catalog/items). |
| **Esta caja está vencida y no se puede separar.** | Ya pasó su fecha de vencimiento. Saca la caja de uso. |
| **Esta caja ya no se puede separar en su estado actual.** | La caja ya no está activa. Recarga la página. |

## Sacar una caja de uso

**Quién puede hacerlo:** `inventory.adjust` (**Ajustar y contar stock**), con acceso a la bodega de la caja.

**Dónde:** la última sección de la pantalla de la caja, **Sacar la caja de uso**: "La cuarentena la aparta para revisarla; las cajas vencidas y descartadas salen de las existencias utilizables. Su historial se conserva." Solo aparece mientras la caja está **Activa**.

<Steps>
  <Step title="Elige qué pasa con ella">
    En **Qué pasa con ella** (**Elegir…**), elige **Cuarentena**, **Marcar como vencida** o **Descartar**. Si presionas **Continuar** sin elegir, verás **Elige qué pasa con la caja.**
  </Step>

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

  <Step title="Continúa">
    Presiona **Continuar**.
  </Step>

  <Step title="Confirma">
    Un diálogo pregunta, por ejemplo, **Cuarentena: ¿caja BX-7K3QM9?** con el texto "La caja deja de recibir movimientos. No se puede deshacer desde la Consola." Presiona **Sí, hacerlo**, o **Mantener la caja activa** para cancelar.
  </Step>

  <Step title="Lee el resultado">
    La pantalla dice **La caja BX-7K3QM9 ahora está: En cuarentena.** Una solicitud repetida dice **Esto ya estaba registrado.**
  </Step>
</Steps>

| Opción | Nuevo estado | Movimiento |
| - | - | - |
| **Cuarentena** | **En cuarentena** | `quarantine` |
| **Marcar como vencida** | **Vencida** | `expire` |
| **Descartar** | **Dada de baja** | `dispose` |

### Qué registra el sistema

Un movimiento del tipo elegido, con un cambio de `0`, el motivo que elegiste y tu nombre como quien lo registró, junto con el nuevo estado de la caja, en un solo paso. El historial y lo que hay en mano quedan como estaban, pero la caja sale de las existencias utilizables: ya no se puede consumir, trasladar, separar, corregir ni reservar para pedidos.

### Reglas y límites

* La consola ofrece esto solo para cajas en estado **Activa**. muveya también acepta descartar una caja que ya está en cuarentena o vencida, pero todavía no hay un botón para eso; escribe a [team@muveya.com](mailto:team@muveya.com) si necesitas registrarlo.
* No existe una acción para devolver una caja a **Activa**.
* Para sacar de uso todas las cajas de un lote a la vez, usa [Retiro de lote](/docs/es/inventory/lot-recall).
* Es una acción marcada como 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 |
| - | - | - |
| **El registro cambió o ya existe. Revísalo antes de volver a intentar.** | La caja dejó de estar activa mientras tanto. | Recarga la caja. |
| **Este registro no está disponible en la cuenta de clínica dental activa.** | La caja ya no está en una bodega a la que tengas acceso. | Revisa su ubicación con alguien que pueda verla. |
| **Tu cuenta no tiene permiso para esta acción.** | No tienes `inventory.adjust`. | Pide ayuda a un administrador. |

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Registrar consumo y trasladar cajas" icon="arrow-right-arrow-left" href="/docs/es/inventory/use-and-moves">
    Consume desde una caja o trasládala.
  </Card>

  <Card title="Correcciones" icon="scale-balanced" href="/docs/es/inventory/corrections">
    Corrige la cantidad registrada de una caja.
  </Card>

  <Card title="Retiro de lote" icon="triangle-exclamation" href="/docs/es/inventory/lot-recall">
    Retén todas las cajas de un lote.
  </Card>

  <Card title="Preparar y despachar un pedido" icon="dolly" href="/docs/es/deliveries/picking">
    Cómo se toman y separan las cajas para los pedidos.
  </Card>
</CardGroup>


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