Catálogo de insumos

Qué es

El catálogo de insumos es la pantalla donde das de alta y mantienes todos tus insumos: cada material no comestible con su coste por unidad, su unidad de consumo, su proveedor y, si quieres, sus campos propios. Es un catálogo per-usuario (lo creas tú; no hay base global como en ingredientes) y es la fuente de la que beben las recetas cuando añades insumos.

Vive en una única pantalla: no hay sub-rutas (/supplies/catalog, /supplies/categories…). Todo —búsqueda, filtros, alta, edición, campos personalizados e import/export— se opera desde aquí mediante modales.

Ruta de acceso

• URL: https://app.areacacao.com/supplies
• Cómo se llega: menú lateral → FORMULACIÓN → Insumos.
• Disponibilidad: cualquier usuario con sesión iniciada (sin restricción por plan).
• El antiguo /insumos redirige aquí.

Secciones de la pantalla

Cabecera

Arriba encontrarás el enlace Volver al dashboard y el título Catálogo de Insumos, con un subhead que muestra el recuento real de insumos ("N insumos en tu catálogo") o, si aún no tienes ninguno, "Envases, etiquetas, embalaje y consumibles no comestibles".

A la derecha hay cuatro botones:

• Nuevo insumo — abre el formulario para crear un insumo con su ficha completa. Ver Crear un insumo.
• Gestionar categorías — abre el panel para renombrar, eliminar o añadir categorías de insumo. Ver Categorías de insumos.
• Campos personalizados — abre el gestor para definir campos propios de tus insumos (material, lote, certificación…). Ver Campos personalizados.
• Importar / Exportar — abre el modal para volcar o cargar tu catálogo en CSV. Ver Importar y exportar.

Barra de filtros

Sobre la tabla hay una barra con cuatro controles:

• Buscador con el placeholder "Buscar por nombre, código o proveedor…". Busca por nombre, código interno (SKU), referencia del proveedor y proveedor.
• Selector de categoría con la opción por defecto Todas las categorías (se cargan de tus categorías gestionadas).
• Selector de proveedor con la opción por defecto Todos los proveedores.
• Solo con control de stock — casilla que limita el listado a los insumos con stock activado.

Al cambiar cualquier filtro, el listado vuelve a la página 1.

Tabla de resultados

Cada fila muestra estas columnas:

Pulsa sobre cualquier fila para abrir la ficha de detalle del insumo.

Paginación

El listado muestra 50 insumos por página. Cuando hay más de una página, aparece un pie con el rango visible ("Mostrando X–Y de TOTAL") y las flechas Página anterior / Página siguiente.

Crear un insumo

Pulsa Nuevo insumo para abrir el formulario, con el subtexto "Materiales no comestibles que se reparten por unidad de producto vendible.". Está organizado en secciones:

• Identidad — Nombre (obligatorio), Nombre (inglés) opcional, Categoría (ver Categorías), Descripción, Proveedor, Referencia del proveedor y Código interno (SKU).
• Unidades y compra — el modelo de doble unidad:
  • Unidad de consumo — la unidad que usarás en la receta (ej. unidad, hoja, metro).
  • Unidad de compra — cómo lo compras (ej. caja de 500).
  • Unidades de consumo por unidad de compra — el factor (ej. una caja de 500 capacillos → 500). Sirve para calcular el coste por unidad de consumo.
• Coste — Coste por unidad de consumo y el Subtotal del escandallo (dónde se agrupa este coste: Insumos, Ingredientes o Costes generales; por defecto Insumos).
• Stock (opcional) — Llevar control de stock activa el stock perpetuo en el Almacén, con un Aviso de stock bajo.
• Información adicional — URL de imagen, Notas y los Campos personalizados que hayas definido.

Pulsa Crear insumo para guardarlo (o Guardar cambios al editar).

Campos personalizados

Igual que en ingredientes, puedes extender tus insumos con campos propios de tu cuenta (material, lote, certificación…). Pulsa Campos personalizados en la cabecera para abrir el gestor:

• La lista N campos definidos con cada campo (Etiqueta, Clave, Tipo, Obligatorio) y acciones de editar/eliminar.
• Nuevo campo abre un editor con Etiqueta (obligatoria), Clave interna en snake_case (autogenerada, no editable después), Tipo (Texto, Número, Fecha, Lista o Sí/No), Opciones (solo para Lista), Texto de ayuda y la casilla Campo obligatorio.

Eliminar un campo no borra los valores ya capturados en tus insumos. Los valores de cada campo se rellenan dentro de cada insumo, en la sección Información adicional del formulario.

Importar y exportar

Pulsa Importar / Exportar para abrir el modal (subtítulo "Da de alta insumos en masa o descarga tu catálogo."), con dos pestañas:

Importar

• Descargar plantilla te da plantilla-insumos.csv con las columnas correctas.
• Aporta el contenido arrastrando un CSV, con Seleccionar archivo o pegándolo directamente ("…o pega el contenido directamente").
• El desplegable Cómo preparar el CSV recuerda las reglas clave:
  • name es la única columna obligatoria.
  • purchaseUnit, trackingUnit y purchaseToTrackingFactor definen el modelo de doble unidad (compras en "caja de 500", consumes "unidad").
  • costPerUnit es el coste por unidad de consumo, en euros.
  • costBucket admite insumos, ingredientes u overhead.
• El selector Modo decide cómo se aplica:

Antes de confirmar puedes Previsualizar: te muestra un resumen del tipo "N filas — crear X, actualizar Y, omitir Z, errores W". Pulsa Importar para aplicar.

Exportar

Descarga todo tu catálogo en CSV (insumos.csv), una fila por insumo con todas las columnas. Las columnas de campos personalizados se añaden con el prefijo cf_; el campo allergens no aplica a insumos.

Historial de coste

Cada vez que cambia el coste de un insumo, AreaCacao lo registra. Al abrir la ficha de detalle (clic en una fila) verás, además de sus datos generales y de unidades, una sección Historial de coste con la fecha, el coste Antes, el coste Después y una Nota por cada cambio. Si todavía no hay cambios, indica "Aún no hay cambios de coste registrados.".

Estados de la pantalla

• Cargando: muestra un esqueleto de tabla.
• Catálogo vacío: "Aún no tienes insumos" + "Añade envases, etiquetas, capacillos, cajas o cualquier material no comestible para incluirlos en el coste de tus recetas." con un botón Nuevo insumo.
• Sin resultados con filtros: "No hay insumos con esos filtros.".
• Error de carga: banner rojo con "No se pudieron cargar los insumos".

Disponibilidad por plan

Disponible para todos los planes.

Siguientes pasos