Unidades de medida¶
Las unidades de medida definen con qué compras, almacenas y recetas tus insumos: kilogramos, gramos, litros, mililitros, piezas, cajas… Su pieza clave es el factor de conversión, que le dice al sistema cómo pasar de una unidad a otra (comprar en cajas, almacenar en kilos, descontar en gramos). Es configuración inicial del sistema: hazla bien una vez y olvídate.
Ruta: /catalogos/unidades-medida. Quién lo usa: administrador o gerente.
Configúralas ANTES de capturar insumos y recetas
Cada insumo se registra con una unidad de inventario y una de compra, y cada receta descuenta ingredientes en alguna unidad. Si las unidades base y sus factores están mal definidos, todas las conversiones de inventario y el costeo de recetas saldrán mal. Consulta Recetas y costeo para ver el efecto en cadena.
Unidades base y derivadas¶
- Una unidad base es la referencia de su familia y no se convierte a nada (ej. Gramo, Mililitro, Pieza).
- Una unidad derivada se define a partir de una base mediante su factor de conversión: cuántas unidades base equivalen a 1 de la unidad derivada.
Ejemplos:
| Unidad | Unidad base | Factor de conversión | Lectura |
|---|---|---|---|
| Gramo (g) | — (es base) | — | Referencia de peso. |
| Kilogramo (kg) | Gramo | 1000 | 1 kg = 1000 g |
| Mililitro (mL) | — (es base) | — | Referencia de volumen. |
| Litro (L) | Mililitro | 1000 | 1 L = 1000 mL |
| Pieza (pza) | — (es base) | — | Referencia de conteo. |
| Caja 24 pzas | Pieza | 24 | 1 caja = 24 piezas |
Elige bases 'pequeñas'
Conviene que la base sea la unidad más chica en la que recetas (gramo, mililitro, pieza). Así los factores siempre son números enteros o sencillos y las recetas descuentan sin decimales raros.
Listado de unidades¶

Elementos de la pantalla¶
- Botón Nueva Unidad.
- Búsqueda por texto (Enter o lupa).
- Paginación de 20 por página.
Columnas de la tabla¶
| Columna | Qué muestra |
|---|---|
| Nombre | Nombre de la unidad, con la descripción debajo. |
| Abreviatura | Badge gris con la abreviatura (ej. "kg"). |
| Unidad Base | Unidad de la que deriva, o "-" si ella misma es base. |
| Factor Conversión | Número con hasta 6 decimales, o "-" si es unidad base. |
| Estado | Activo / Inactivo. |
| Acciones | Editar (lápiz) y eliminar (basura). |
Acciones¶
- Buscar por texto.
- Crear con el botón Nueva Unidad.
- Editar con el lápiz.
- Eliminar con la basura (pide confirmación).
Eliminar es desactivar, y hay bloqueo por uso
La eliminación es soft delete: la unidad queda Inactiva y puedes reactivarla editándola. Además, el sistema no permite eliminar una unidad que esté en uso en insumos (como unidad de inventario o de compra); mostrará un mensaje de bloqueo.
Formulario de unidad (nueva / editar)¶
Rutas: /catalogos/unidades-medida/nueva y /catalogos/unidades-medida/editar/{id}. Incluye breadcrumb superior para volver al listado.
| Campo | Qué es | Obligatorio |
|---|---|---|
| Nombre | Nombre completo (máx. 100; ej. "Kilogramo"). | Sí |
| Abreviatura | Abreviatura corta (máx. 10; ej. "kg"). | Sí |
| Descripción | Texto libre (máx. 500). | No |
| Unidad Base (para conversión) | Desplegable; opción por defecto "Es unidad base". Si la unidad deriva de otra, elige aquí la base. | No |
| Factor de Conversión | Entre 0.000001 y 999,999,999: cuántas unidades base equivalen a 1 de esta unidad. El propio formulario da el ejemplo: "1000 (1 kg = 1000 g)". | No (sí, si eliges unidad base) |
| Activo | Checkbox (solo al editar): reactivar o desactivar. | No |
Flujo:
- Captura nombre y abreviatura.
- Si es derivada, elige su Unidad Base y captura el Factor de Conversión.
- Haz clic en Crear Unidad o Guardar Cambios; Cancelar vuelve sin guardar.
Al editar no puedes ser tu propia base
En el formulario de edición, la propia unidad se excluye de la lista de unidades base para evitar auto-referencias.
Ejemplo completo: comprar en cajas, descontar en gramos¶
Supón que compras queso en cajas de 5 kg y tus recetas usan gramos:
- Crea la base: Gramo (g) — "Es unidad base".
- Crea Kilogramo (kg) — base: Gramo, factor 1000.
- Crea Caja 5 kg — base: Gramo, factor 5000 (1 caja = 5000 g).
- Registra el insumo "Queso manchego" con inventario en gramos y compra en cajas.
- Al recibir 2 cajas, el inventario suma 10,000 g; una receta que usa 120 g los descuenta directamente.
Practica en el demo
En https://demo.consul.rest (usuario admin, contraseña Demo123!) puedes revisar las unidades ya configuradas y sus factores como referencia para tu propia captura.