Skip to main content
El catálogo es la lista cerrada de insumos con los que trabaja tu clínica dental. Cada línea de pedido, caja de existencias y registro de consumo apunta a un insumo de esta lista, así que un insumo debe existir aquí antes de que alguien pueda pedirlo, recibirlo o usarlo. La consola llama insumo a cada elemento del catálogo; la API y el código lo llaman item.

​
Quién puede hacerlo

Los permisos se asignan a cada persona en la pantalla Equipo. Consulta Roles y permisos.

​
Dónde

Abre Catálogo en la navegación principal. El módulo tiene tres pantallas de insumos: La pantalla Catálogo (Organiza los insumos que utiliza tu clínica dental.) muestra:
  • Nuevo insumo, en el encabezado, si tienes catalog.manage.
  • Un buscador, Buscar por SKU o nombre. Encuentra cualquier parte del SKU o del nombre sin distinguir mayúsculas ni tildes, así que anestesico encuentra “Anestésico local”.
  • Enlaces a Categorías y, si tienes catalog.manage, a Importar CSV y Exportar CSV. Consulta Categorías e Importar y exportar.
  • Dos filtros: Categoría (por defecto Todas las categorías) y Estado (por defecto Todos los estados, luego Borrador, Activo e Inactivo). Limpiar filtros reinicia la búsqueda y los dos filtros.
La tabla tiene las columnas SKU, Nombre del insumo, Categoría, Unidad y Estado, y además Costo si tienes catalog.cost.read. Haz clic en el nombre para abrir el insumo. Los insumos aparecen en el orden en que se crearon, del más antiguo al más reciente, 50 por página, con Anterior y Siguiente bajo la tabla y un contador de las filas visibles sobre el total.

​
Crear un insumo

1

Ten lista una categoría

Todo insumo pertenece a una categoría. Si no existe ninguna, el formulario dice Crea una categoría antes de agregar insumos. Puedes crearla en Categorías o con Nueva categoría dentro del formulario, que además la deja seleccionada.
2

Abre el formulario

En Catálogo, haz clic en Nuevo insumo. Se abre la página Nuevo insumo con el texto Define cómo se identifica y controla este insumo.
3

Completa la información del insumo

En Información del insumo, ingresa SKU, Nombre del insumo, Categoría, Unidad, Presentación, Criticidad y Descripción. Las reglas de cada campo están en la tabla de abajo.
4

Elige los requisitos de trazabilidad

En Requisitos de trazabilidad (Estas opciones definen los datos necesarios al registrar existencias.), marca Controlar lotes, Controlar números de serie, Controlar vencimientos e Insumo de alto valor según corresponda. Las cuatro opciones empiezan sin marcar.
5

Guarda

Haz clic en Crear insumo. La consola abre el detalle del nuevo insumo. El insumo nace como Borrador: actívalo cuando esté listo para pedirse.
El formulario de creación no tiene campo de costo. Registra el costo en el detalle del insumo después de crearlo, o inclúyelo en una importación CSV. Consulta Costos.

​
Campos y validaciones

La Unidad es la unidad base en la que se cuenta el insumo en todas partes: existencias, pedidos, consumo y presentaciones. Los valores permitidos son:
El campo de texto libre Presentación del formulario no es lo mismo que la sección Presentaciones del detalle del insumo. Para indicar que una caja trae 100 unidades, de modo que recibir 3 cajas sume 300 unidades, agrega una presentación en esa sección. Consulta Presentaciones y códigos.

​
Qué hacen las opciones de trazabilidad

Un cambio en estas opciones se aplica a las recepciones registradas después del cambio; las cajas ya recibidas conservan lo que se registró. Consulta Recibir existencias, Política de aprobación y Correcciones de existencias. La Criticidad se guarda, se muestra en el insumo y se incluye en las exportaciones. En la versión actual no modifica alertas, reposición ni aprobaciones.

​
Estados

No hay forma de volver a draft, y los insumos no se pueden eliminar. Desactiva los insumos que ya no uses.

​
Por qué solo se pueden pedir insumos activos

Cuando alguien agrega un insumo a un pedido, muveya copia en la línea el SKU, el nombre, la unidad, la categoría, la marca de alto valor y el costo vigente del insumo. Esa copia solo tiene sentido si la unidad es definitiva, por eso la pantalla de pedidos ofrece solo insumos activos y el servidor rechaza cualquier otro con orders.catalog_item_unavailable: Este insumo no está activo en el catálogo. Las líneas que ya se agregaron conservan su copia aunque después el insumo se desactive o se edite. Consulta Crear y seguir pedidos.

​
El detalle del insumo

Abre un insumo desde la lista. El título de la página es el nombre del insumo, con Volver al catálogo arriba.
  • Si tienes catalog.manage, ves el mismo formulario de la creación con los valores actuales. El SKU está bloqueado y dice El SKU identifica este insumo y no se puede cambiar. Haz clic en Guardar cambios; Insumo guardado lo confirma.
  • Si no, ves una lista de solo lectura: SKU, Categoría, Unidad, Presentación, Descripción, Criticidad, las cuatro opciones de trazabilidad como Sí o No, y Costo si tienes catalog.cost.read.
Debajo de los datos, todas las personas ven:
  1. Estado, por ejemplo Estado: Borrador, con Solo los insumos activos se pueden agregar a nuevos pedidos.
  2. Presentaciones: cómo se compra y se recibe el insumo. Consulta Presentaciones y códigos.
  3. Costo del insumo, solo para quienes tienen catalog.manage y catalog.cost.read. Consulta Costos.

​
Activar o desactivar

1

Abre el insumo

Ve a Catálogo y haz clic en el nombre del insumo.
2

Revisa la unidad

Si el insumo no está activo, la sección de estado dice La activación permite solicitar este insumo y fija su unidad: seguido de la unidad. Si cambiaste la unidad y todavía no guardaste el cambio, dice Guarda o descarta el cambio de unidad antes de activar.
3

Haz clic en el botón

El botón dice Activar y fijar unidad cuando la activación también fijará la unidad, Activar insumo cuando la unidad ya está fija, y Desactivar insumo cuando el insumo está activo.

​
La unidad queda fija

Las existencias, los pedidos y las presentaciones se cuentan en la unidad base del insumo, así que cambiarla después de usarla cambiaría el significado de las cantidades registradas. muveya protege la unidad:
  • La unidad queda fija la primera vez que el insumo se activa, o la primera vez que se reciben existencias del insumo, aunque todavía sea un borrador.
  • Una vez fija, sigue fija, también después de desactivar el insumo. El formulario muestra la unidad como texto con Esta unidad está protegida y no puede cambiarse. Puedes editar los demás datos.
  • Todo lo demás, salvo el SKU, se puede seguir editando: nombre, descripción, categoría, presentación (el texto libre), criticidad y las opciones de trazabilidad.
Mientras la unidad no esté fija, puedes cambiarla y guardarla junto con los demás campos. Antes de guardar, el formulario muestra Cambio elegido: con la nueva unidad y un botón Descartar cambio de unidad. Cambiar la unidad tiene consecuencias:
  • Un costo registrado para la unidad anterior pasa a review_required y debe confirmarse de nuevo. Consulta Costos.
  • Una presentación publicada con la unidad anterior no sirve para recibir hasta que la corrijas, lo que la vuelve a publicar con la unidad actual.
Si la unidad no se puede verificar o cambió mientras tanto, el formulario te lo indica:

​
Identificadores

La consola siempre muestra nombres y nunca identificadores, salvo en la pantalla de importación CSV, donde necesitas copiar los identificadores de categoría.

​
Leer el catálogo fuera de la consola

La API pública lee el catálogo con GET /v1/catalog/items y GET /v1/catalog/items/{itemId} (scope catalog:read), y la herramienta MCP catalog.search busca insumos por nombre o SKU (los activos, por defecto). Ambas son de solo lectura: los insumos se crean y editan únicamente en la consola o mediante una importación CSV. Consulta API para desarrolladores y Herramientas MCP.

​
Qué registra el sistema

  • El insumo, con estado draft, al crearlo.
  • Cuando la unidad queda fija: quién la fijó y cuándo.
  • Las ediciones de campos y los cambios de estado actualizan el insumo. En la versión actual no generan registros de auditoría separados; las importaciones CSV, las exportaciones y los retiros de códigos de envase sí.

​
Qué puede salir mal

​
Páginas relacionadas

Categorías

Crea los grupos a los que pertenece cada insumo.

Presentaciones y códigos

Describe cómo se compra un insumo y los códigos impresos en él.

Costos

Registra costos y controla quién puede verlos.

Importar y exportar

Crea muchos insumos de una vez desde un archivo CSV.

Recibir existencias

Ingresa existencias de un insumo a una bodega.

Crear y seguir pedidos

Pide insumos activos para una sede.