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

# Recibir existencias

> Recibe una entrega en una bodega como una caja nueva y etiquetada, con el lote, los números de serie y el vencimiento que exige el insumo

Recibir convierte lo que llegó en existencias. Cada recepción crea **una caja nueva** en una bodega, agrega un movimiento `receive` al registro de movimientos y le da a la caja un código que puedes imprimir como etiqueta. Si una entrega trae varios contenedores que quieres seguir por separado, recibe cada uno como su propia caja.

## Quién puede hacerlo

* El permiso `inventory.receive` (**Recibir entregas**), o `inventory.adjust`, que lo incluye.
* Acceso a la bodega donde recibes. Solo se ofrecen bodegas activas de tu acceso.

Quien no tiene el permiso no ve el enlace **Recibir**. Si abre la pantalla de todas formas, ve **No tienes permiso para recibir entregas. Pide a un administrador el permiso “Recibir entregas”.**

## Dónde

**Inventario** en la navegación principal y luego **Recibir** en la parte superior de la pantalla **Existencias**. La ruta directa es `console.muveya.com/inventory/receive`. La pantalla se titula **Recibir**: "Escanea el código del proveedor o elige el insumo, confirma qué llegó y di cuántas."

## Antes de empezar

* El insumo debe existir y estar activo en el catálogo, con su unidad de medida. Revisa [Insumos del catálogo](/docs/es/catalog/items).
* Para recibir escaneando, el código del proveedor debe estar registrado en una de las presentaciones del insumo. Revisa [Presentaciones y códigos](/docs/es/catalog/presentations-and-codes).
* Revisa qué controla el insumo (lote, números de serie, fecha de vencimiento). La pantalla solo pide lo que el insumo controla, y lo exige completo.

## Paso a paso

Primero, en **Cómo encontrar lo que llegó**, elige **Escanear un código** (seleccionado al abrir la pantalla) o **Elegir el insumo**.

<Tabs>
  <Tab title="Escanear un código">
    <Steps>
      <Step title="Lee el código">
        El campo **Código del proveedor** queda activo al abrir la pantalla, así que un lector de códigos de barras puede escribir directamente en él. Escanea o escribe el código y presiona **Buscar**. Mientras busca verás **Buscando…**.
      </Step>

      <Step title="Revisa lo que encontró el código">
        Si hay una coincidencia, aparece una tarjeta con el nombre de la presentación, el insumo (nombre y SKU) y su contenido, por ejemplo **Contiene 100 × Unidad**. La cantidad que ingreses después es una cantidad de esa presentación.
      </Step>

      <Step title="Si el código corresponde a más de una presentación">
        La pantalla dice **Este código corresponde a más de una presentación. Elige la que llegó.** y muestra cada candidata con la presentación, el insumo, el tipo de código y el código, por ejemplo `Caja de 100 · Guantes de nitrilo M (GTIN 07501234567893)`. Selecciona la que llegó. Una candidata marcada **Retirada: ya no admite nuevas entradas.** no se puede recibir.
      </Step>

      <Step title="Si el código no está registrado">
        La pantalla dice **Ese código todavía no está vinculado a un insumo. Abre el insumo en el catálogo y agrega el código en Presentaciones, o elige el insumo para recibirlo sin código.** Usa **Abrir el catálogo** para registrarlo o cambia a **Elegir el insumo**.
      </Step>
    </Steps>

    Si el dígito verificador del código impreso no coincide, verás **El código impreso no coincide con su dígito verificador. Igual puedes recibirlo.** Los insumos se pueden recibir de todos modos.
  </Tab>

  <Tab title="Elegir el insumo">
    <Steps>
      <Step title="Busca el insumo">
        Escribe en **Buscar insumos** ("Escribe parte del nombre o el código del insumo."). La búsqueda no distingue mayúsculas ni tildes y solo muestra insumos activos. Aparecen hasta 8 resultados en **Insumos encontrados**; si hay más, verás una línea como **Se muestran 8 de 12. Sigue escribiendo para acotar la lista.**
      </Step>

      <Step title="Selecciónalo">
        Selecciona un resultado. Aparece en **Insumo**, con **Cambiar insumo** para elegir otro.
      </Step>

      <Step title="Indica cómo llegó">
        En **Llegó como** (**Elige cómo llegó**), elige una de las presentaciones activas del insumo, que se muestran con su nombre y contenido (por ejemplo `Caja de 100 · 100 × Unidad`), o **Unidades sueltas** seguido de la unidad base cuando cuentas unidades sueltas.
      </Step>
    </Steps>
  </Tab>
</Tabs>

Después completa el formulario de recepción:

<Steps>
  <Step title="Cuántas">
    Ingresa la cantidad en **Cuántas** (para unidades sueltas el campo dice **Cuántas, en** seguido de la unidad). Empieza en 1 y debe ser un número entero mayor que cero.
  </Step>

  <Step title="Código de caja (opcional)">
    Escribe el código anotado en el contenedor, o deja vacío **Código de caja (opcional)**: "Déjalo vacío y se genera un código para la caja."
  </Step>

  <Step title="Bodega">
    Elige la **Bodega**. Si solo tienes una bodega disponible, aparece ya elegida.
  </Step>

  <Step title="Datos de trazabilidad">
    Completa **Número de lote**, **Fecha de vencimiento** y **Números de serie** cuando aparezcan. Revisa las reglas más abajo.
  </Step>

  <Step title="Revisa el total">
    La pantalla repite el resultado en unidades base, por ejemplo **Ingresa como 300 × Unidad**. Revísalo antes de confirmar: esa es la cantidad que entra al registro.
  </Step>

  <Step title="Recibir">
    Presiona **Recibir**. El botón queda desactivado hasta que todo lo obligatorio esté completo.
  </Step>

  <Step title="Etiqueta la caja">
    La pantalla confirma **Recibido en la caja BX-7K3QM9.** con dos enlaces: **Abrir la caja BX-7K3QM9** e **Imprimir la etiqueta de BX-7K3QM9**. El formulario se limpia para el siguiente insumo y, en el modo de escaneo, el campo del código vuelve a quedar activo.
  </Step>
</Steps>

## Cantidades, presentaciones y unidades

* **Presentación**: la cantidad se multiplica por el contenido de la presentación. Tres cajas de 100 unidades entran como 300 unidades. La caja guarda la presentación, su versión y la cantidad, que después se ven como **Recibida como** en la caja.
* **Unidades sueltas**: la cantidad ya está en unidades base.
* El registro siempre guarda unidades base. La unidad del insumo se bloquea cuando se activa en el catálogo; una recepción también la bloquea si aún no lo estaba.
* Solo se pueden recibir presentaciones activas. Una presentación que se retira mientras estás en la pantalla muestra **Esta presentación está retirada y ya no admite nuevas entradas.**
* Si alguien corrige la presentación mientras recibes, no se recibe nada y la pantalla muestra el contenido nuevo, por ejemplo **Esta presentación se corrigió mientras recibías: ahora es Caja de 50, 50 × Unidad (versión 3). No se recibió nada: revisa la cantidad y recibe de nuevo.** Mientras carga el contenido nuevo dice **Esta presentación se corrigió mientras recibías. No se recibió nada: cargando lo que contiene ahora…**
* Si la unidad del insumo cambia mientras recibes, no se recibe nada: **La unidad de este insumo cambió mientras recibías. No se recibió nada: revisa la cantidad y recibe de nuevo.**

## Lote, números de serie y fecha de vencimiento

| Campo | Se pide cuando | Reglas |
| - | - | - |
| **Número de lote** | El insumo controla lotes. | Obligatorio. No puede quedar en blanco. Hasta 120 caracteres. Se quitan los espacios al inicio y al final; el resto se guarda tal como se escribió y es lo que busca [Retiro de lote](/docs/es/inventory/lot-recall). |
| **Fecha de vencimiento** | El insumo controla vencimientos. | Obligatoria. Debe ser hoy o una fecha posterior (UTC). Una fecha pasada se rechaza. |
| **Números de serie** | El insumo controla números de serie. | Exactamente un número de serie por unidad base recibida (la cantidad multiplicada por el contenido). La ayuda los cuenta, por ejemplo **2 de 3 ingresados, separados por comas o saltos de línea**. El campo es de una sola línea y Enter envía el formulario, así que sepáralos con comas. Sin vacíos, sin repetidos, hasta 120 caracteres cada uno. Se rechaza un número de serie que ya se recibió para este insumo, en cualquier caja y en cualquier estado. |

Los campos de datos que el insumo no controla no aparecen y no se guarda nada para ellos. Cuando faltan datos de trazabilidad obligatorios o no son válidos, incluida una fecha de vencimiento pasada, la recepción se rechaza con **Este insumo necesita su lote, números de serie o fecha de vencimiento para recibirse. Revísalos y recibe de nuevo.**

## Códigos de caja

* Si dejas el código vacío, muveya genera uno: `BX-` seguido de seis caracteres entre dígitos y letras mayúsculas, sin I, L, O ni U (por ejemplo `BX-7K3QM9`), para que sea fácil de dictar y de copiar a mano.
* A un código escrito se le quitan los espacios al inicio y al final, puede tener hasta 64 caracteres y debe ser único en tu clínica dental. Un código que ya está en uso muestra **Otra caja ya usa este código. Cámbialo o déjalo vacío.** bajo el campo.
* La etiqueta imprime el código como código de barras Code 128. Usa letras sin tildes, dígitos y símbolos comunes; un código con otros caracteres se imprime solo como texto, sin código de barras.

Para imprimir la etiqueta, sigue **Imprimir la etiqueta de** y luego **Imprimir etiqueta** en la pantalla de la caja. Revisa [Cajas y etiquetas](/docs/es/inventory/boxes).

## Qué registra el sistema

* Una caja nueva en estado **Activa**: su código, insumo, bodega, cantidad en unidades base, hora de recepción (reloj del servidor), unidad de medida y, cuando corresponde, la presentación (con su versión y cantidad), el lote, los números de serie y la fecha de vencimiento.
* Un movimiento `receive` (**Recibido**) que suma la cantidad a lo que hay en mano, contigo como la persona que lo registró.
* Un saldo para la caja: en mano igual a la cantidad, nada reservado.
* Las alertas de existencias del insumo se vuelven a evaluar poco después (revisa [Reposición y alertas](/docs/es/inventory/replenishment-and-alerts)).

## Reintentos: una recepción nunca se registra dos veces

Cada recepción que inicias lleva una clave interna de operación que se conserva aunque haya fallas.

* Si se cae la conexión o el servidor no responde, la pantalla dice **No pudimos confirmar si esta recepción quedó registrada. Recibe de nuevo con los mismos datos: nunca se registrará dos veces.** Presiona **Recibir** otra vez sin cambiar nada. O la recepción se registra ahora, o verás **Ya estaba registrado, en la caja BX-7K3QM9.** con la caja que ya existe.
* Un doble clic o presionar varias veces también crea una sola caja.
* Si cambias los datos y el primer intento sí se había registrado, verás **Un intento anterior ya quedó registrado con otros datos. Revisa las existencias antes de recibir de nuevo.** Revisa la pantalla **Existencias** filtrada por el insumo. Después de este mensaje, tu siguiente **Recibir** cuenta como una recepción nueva.
* Después de una recepción exitosa el formulario se limpia y el siguiente **Recibir** es una caja nueva. Dos entregas idénticas recibidas una tras otra son dos cajas, como corresponde.

## Reglas y límites

| Regla | Límite |
| - | - |
| Cantidad | Número entero de 1 a un millón. |
| Total en unidades base | Hasta mil millones. |
| Código de caja | Opcional, hasta 64 caracteres, único en la clínica dental. |
| Número de lote | Hasta 120 caracteres, no en blanco. |
| Números de serie | Uno por unidad base, únicos, hasta 120 caracteres cada uno. |
| Fecha de vencimiento | Hoy o posterior (UTC). |
| Bodega | Activa y dentro de tu acceso a bodegas. |
| Presentación | Activa y del insumo elegido. |

## Qué puede salir mal

| Mensaje | Causa | Qué hacer |
| - | - | - |
| **No tienes una bodega donde recibir. Pide acceso a un administrador.** | No hay ninguna bodega activa en tu acceso. | Pide a un administrador que te dé una bodega en [Equipo](/docs/es/account/team). |
| **Ningún insumo activo coincide con «gasa».** | La búsqueda no encontró insumos activos. | Prueba otra palabra o el SKU, o crea el insumo en el catálogo. |
| **Esta presentación está retirada y ya no admite nuevas entradas.** | La presentación se retiró. | Elige otra presentación o **Unidades sueltas**. |
| **Otra caja ya usa este código. Cámbialo o déjalo vacío.** | El código de caja escrito ya existe. | Escribe otro código o déjalo vacío. |
| **Este insumo necesita su lote, números de serie o fecha de vencimiento para recibirse. Revísalos y recibe de nuevo.** | Faltan datos de trazabilidad o no son válidos, o la fecha de vencimiento ya pasó. | Revisa el empaque y corrige los campos. |
| Un mensaje que nombra números de serie, como **Estos números de serie ya se recibieron para este insumo: SN-0042. Un número de serie identifica una sola unidad: revisa el empaque o corrige la caja original con un ajuste.** | Un número de serie pertenece a una caja existente del insumo. No se recibió nada. | Compara los números de serie con el empaque. Si la caja anterior está mal, revisa [Correcciones](/docs/es/inventory/corrections). |
| **Esta presentación se corrigió mientras recibías…** | La presentación cambió después de que la abriste. No se recibió nada. | Revisa el contenido nuevo y la cantidad, y recibe de nuevo. |
| **La unidad de este insumo cambió mientras recibías. No se recibió nada: revisa la cantidad y recibe de nuevo.** | Cambió la unidad del insumo. | Revisa la cantidad y recibe de nuevo. |
| **Un intento anterior ya quedó registrado con otros datos. Revisa las existencias antes de recibir de nuevo.** | Un intento anterior se registró con otros datos. | Revisa las existencias antes de recibir de nuevo. |
| **No pudimos confirmar si esta recepción quedó registrada. Recibe de nuevo con los mismos datos: nunca se registrará dos veces.** | El servidor no respondió. | Presiona **Recibir** otra vez con los mismos datos. |
| **Revisa los datos ingresados antes de volver a intentar.** | Un valor está fuera de los límites, por ejemplo un código de caja de más de 64 caracteres. | Corrige el valor. |
| **El registro cambió o ya existe. Revísalo antes de volver a intentar.** | La bodega se desactivó, o la unidad del insumo no está confirmada en el catálogo. | Elige una bodega activa o pide a quien administra el catálogo que confirme la unidad. |
| **Este registro no está disponible en la cuenta de clínica dental activa.** | El insumo o la bodega ya no existe o está fuera de tu acceso. | Recarga y vuelve a elegir. |
| **Tu cuenta no tiene permiso para esta acción.** | Te quitaron el permiso. | Pide ayuda a un administrador. |

## Recibir desde WhatsApp

Los miembros vinculados a WhatsApp también pueden recibir existencias desde su teléfono. Esas recepciones siguen las mismas reglas y quedan en el mismo registro. Revisa [Operaciones por WhatsApp](/docs/es/whatsapp/operations).

## Páginas relacionadas

<CardGroup cols={2}>
  <Card title="Cajas y etiquetas" icon="box-open" href="/docs/es/inventory/boxes">
    Abre la caja nueva e imprime su etiqueta.
  </Card>

  <Card title="Presentaciones y códigos" icon="barcode" href="/docs/es/catalog/presentations-and-codes">
    Registra los códigos del proveedor para poder escanearlos.
  </Card>

  <Card title="Resumen del inventario" icon="boxes-stacked" href="/docs/es/inventory/overview">
    Saldos, estados y registro de movimientos.
  </Card>

  <Card title="Confirmar la entrega, recibir y cerrar" icon="truck" href="/docs/es/deliveries/delivery-and-receipt">
    Recibir cajas que llegan de un pedido es otro flujo.
  </Card>
</CardGroup>


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