Resumen del inventario

muveya cuenta las existencias por caja: un contenedor físico de un solo insumo, con su propio código impreso, su bodega, su estado y, cuando el insumo los controla, su lote, sus números de serie y su fecha de vencimiento. Cada cambio en una caja se escribe en un registro de movimientos al que solo se agregan filas, y las cantidades que ves se calculan a partir de ese registro. Nada del registro se edita ni se borra. Esta página explica la pantalla principal del inventario, cómo funcionan las cantidades y los estados, cada movimiento que el registro puede guardar y qué permiso necesita cada acción.

​

Abrir la pantalla de existencias

Selecciona Inventario en la navegación principal. La pantalla que se abre se titula Existencias (“Cajas disponibles en las bodegas que puedes ver.”). También puedes ir directo a console.muveya.com/inventory. La opción Inventario aparece para todos los miembros, pero la lista solo carga para quienes tienen el permiso inventory.read. Sin él, la pantalla muestra Tu cuenta no tiene permiso para esta acción.

​

Qué muestra la lista

Cada fila es una caja. La lista incluye cajas en cualquier estado, así que una caja agotada puede seguir apareciendo con 0 en mano. El código de la caja no es una columna: abre la caja para verlo.

​

Filtrar la lista

Solo ves cajas de las bodegas a las que tienes acceso. La lista muestra hasta 50 cajas, de la más antigua a la más reciente, y no tiene página siguiente: si esperas más, acótala con los filtros.

​

Estados y mensajes

​

Accesos en la parte superior de la pantalla

​

Saldos: en mano, reservado y disponible

Cada caja tiene dos contadores, ambos calculados a partir del registro:

• En mano (onHand): las unidades que hay en la caja. Recibir las suma; consumir, despachar y las correcciones de baja las restan. Nunca puede quedar bajo cero.
• Reservado (reserved): las unidades de la caja apartadas para pedidos aprobados. Reservar nunca cambia lo que hay en mano.
• Disponible (available): onHand menos reserved. La asignación de pedidos solo reserva unidades disponibles, y separar parte de una caja solo toma unidades disponibles.

Las cantidades siempre están en la unidad base del insumo (la que se define en Insumos del catálogo), mostrada en tu idioma, por ejemplo 24 × Caja. La unidad se bloquea cuando el insumo se activa en el catálogo (una recepción también la bloquea si aún no lo estaba), y cada caja conserva la unidad con la que se recibió. Una caja cuya unidad guardada no se puede confirmar muestra sus números sin unidad y el aviso La unidad de esta caja requiere revisión. Sus cantidades se muestran sin unidad hasta que alguien la revise.

​

Estados de una caja

​

El registro de movimientos

El registro es la única fuente de verdad de las existencias. Cada movimiento guarda su tipo, la caja, el insumo, el cambio con signo en lo que hay en mano (y en lo reservado cuando corresponde), quién lo registró, cuándo ocurrió (según el reloj del servidor), la bodega de la que salió o a la que entró y, si se indicó, un motivo. Un error se corrige con un movimiento nuevo que lo compensa, nunca editando uno anterior. Los movimientos de una caja se ven en la pantalla de la caja; revisa Cajas y etiquetas. Un consumo que usa la última unidad también deja la caja Agotada. Los traslados, los cambios de estado y las tomas para pedido registran un cambio de 0: la caja conserva sus unidades, solo cambia su lugar o su estado.

​

FEFO y FIFO

Cuando se asigna un pedido aprobado, muveya reserva unidades caja por caja en un orden fijo:

• FEFO (lo primero que vence es lo primero que sale) se aplica cuando alguna caja elegible del insumo tiene fecha de vencimiento. Primero van las cajas que vencen antes; las cajas sin vencimiento van al final; los empates se resuelven por fecha de recepción.
• FIFO (lo primero que entra es lo primero que sale) se aplica en los demás casos. Primero va la recepción más antigua.

Solo son elegibles las cajas en estado Activa cuya fecha de vencimiento no ha pasado, en la bodega de origen y con la unidad que espera el pedido, y solo se reservan sus unidades disponibles. El orden lo calcula el servidor y siempre es el mismo. Cuando tú consumes o trasladas una caja, eliges la caja al escanearla; la consola no sugiere ninguna. No hay una acción en la consola para cambiar ese orden en una asignación.

​

Permisos

Los permisos de inventario se otorgan uno por uno en Equipo. Ningún rol los da automáticamente: un propietario o un administrador también los necesita para ver o cambiar existencias. Revisa Roles y permisos. Cada permiso aplica solo dentro del acceso a bodegas del miembro (todas las bodegas o una lista específica). Una caja de una bodega fuera de ese acceso se comporta exactamente como si no existiera: al escanear su código, la pantalla dice que no encontró la caja. Trasladar una caja, sacar una caja de uso y poner un lote en cuarentena son acciones marcadas como sensibles. En la versión actual el segundo factor es opcional y no las bloquea; revisa Seguridad de la cuenta.

​

Mapa de las pantallas de inventario

Reposición y Correcciones de existencias también aparecen en la navegación principal.

​

Leer el inventario por API o MCP

Los mismos saldos y el mismo registro se pueden leer con una clave de API que tenga el scope inventory:read: GET /v1/inventory/balances, GET /v1/inventory/boxes/{boxId}, GET /v1/inventory/boxes/{boxId}/balance y GET /v1/inventory/boxes/{boxId}/movements. Son de solo lectura. Revisa API para desarrolladores. Por MCP, la herramienta inventory.check devuelve lo que hay en mano, reservado y disponible de un insumo; revisa Herramientas MCP.

​

Páginas relacionadas