AreaCacaoDocs
FormulaciónIngredientes

Catálogo de ingredientes

Base global de más de 10.000 ingredientes con macros, alérgenos y densidad verificados.

Qué es

El catálogo de ingredientes es la base común sobre la que se apoya toda la formulación de AreaCacao. Reúne más de 10.000 fichas técnicas (macronutrientes, alérgenos UE-14, densidad y peso por unidad) que alimentan el editor de recetas, los formuladores y el cálculo automático de macros.

La base global es de solo lectura: puedes buscar, filtrar y consultar la ficha completa de cualquier ingrediente, pero no se editan sus datos desde esta pantalla. Lo que sí es tuyo: puedes crear tus propios ingredientes personalizados (fichas privadas que se usan en tus recetas igual que las del catálogo), definir campos personalizados para tu cuenta e importar o exportar tu propio catálogo personalizado.

El catálogo de ingredientes es solo para materiales comestibles. El packaging, los capacillos, las etiquetas, las cajas y otros consumibles no comestibles viven en su propio módulo: Insumos.

Ruta de acceso

  • URL: https://app.areacacao.com/ingredients
  • Cómo se llega: menú lateral → sección FORMULACIÓN → Ingredientes.
  • Disponibilidad: accesible para cualquier usuario con sesión iniciada (sin restricción por plan).

Secciones de la pantalla

Cabecera

En la parte superior encontrarás el enlace Volver al dashboard y el título Catálogo de ingredientes. Bajo el título se muestra un subtítulo dinámico con el número de fichas del listado, del tipo "Base global de N ingredientes con macros y alérgenos verificados." El número es el total de resultados del listado actual: cambia al buscar o filtrar. Mientras no hay resultados (al cargar o si los filtros no devuelven nada) verás el texto de reserva "Base global de 10.000+ ingredientes con macros y alérgenos verificados.".

La pantalla tiene dos pestañas: Catálogo (la base global) y Mis ingredientes (los ingredientes personalizados de tu cuenta). Una vez abierta la pestaña Mis ingredientes, si tienes fichas propias, muestra junto a su nombre una insignia con el número de ingredientes personalizados activos.

A la derecha de la cabecera hay tres botones:

  • Nuevo ingrediente — abre el formulario para crear un ingrediente personalizado con su ficha completa (macros, micronutrientes, alérgenos y coste).
  • Campos personalizados — abre el gestor para definir campos propios de tu cuenta (origen, certificación, lote, etc.). Ver Campos personalizados.
  • Importar / Exportar — abre el modal para volcar o cargar tu catálogo personalizado en JSON o CSV. Ver Importar y exportar.

Barra de filtros

Sobre la tabla hay una barra horizontal de filtros con tres controles:

  • Buscador con el placeholder "Buscar por nombre, marca...".
  • Selector de categoría con la opción por defecto Todas las categorías. Las categorías se cargan en función del catálogo, no son una lista fija.
  • Con alérgenos — casilla que limita el listado a los ingredientes que declaran algún alérgeno UE-14.

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

Filtrar por etiquetas

Bajo la barra de filtros hay una sección Etiquetas que permite acotar el catálogo por características transversales. Es un filtro de selección múltiple: pulsa los chips que te interesen y el listado se reduce. Dentro de un mismo eje basta con que el ingrediente tenga una de las etiquetas marcadas; entre ejes distintos tiene que cumplir todos (por ejemplo, Orgánico / Bio + Tostado muestra los ingredientes orgánicos que además son tostados). Cuando hay etiquetas activas, aparece un botón Limpiar (N) que las quita todas de una vez. Cualquier cambio devuelve el listado a la página 1.

Los chips están agrupados por ejes:

EjeEtiquetas
OrigenDe origen único, Orgánico / Bio
DietaVegetal / Vegano, Sin azúcar, Integral
ProcesadoCrudo, Tostado, Alcalinizado
UsoDecoración, Granola, Cocina, Snacks, Repostería, Ensaladas, Mermeladas, Smoothies, Compotas, Postres, Preparado / mezcla
Familia químicaPoliol, Goma, Polisacárido
FuenteLeche de cabra

Tabla de resultados

Cada fila del listado muestra estas columnas:

ColumnaContenido
NombreNombre del ingrediente, con la etiqueta base cuando es un ingrediente base.
CategoríaCategoría principal.
MarcaMarca u origen (se oculta en pantallas pequeñas).
AlérgenosNúmero de alérgenos UE-14 declarados; un guion si la ficha declara que no tiene ninguno; Sin declarar si la ficha no confirma sus alérgenos (se oculta en pantallas estrechas).
DetalleEnlace Ver que abre la ficha completa.

Pulsa sobre cualquier fila para abrir la ficha de ingrediente.

Paginación

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

Acciones disponibles

AcciónCómo
BuscarEscribe en el buscador; el listado se filtra solo tras una breve pausa.
Filtrar por categoríaElige una categoría en el selector.
Filtrar por alérgenosMarca la casilla Con alérgenos.
Filtrar por etiquetasPulsa los chips de la sección Etiquetas (selección múltiple); usa Limpiar (N) para quitarlas.
Consultar una fichaPulsa sobre la fila o su enlace Ver.
Crear un ingrediente propioPulsa Nuevo ingrediente. Ver Ingredientes personalizados.
Definir campos propiosPulsa Campos personalizados.
Importar o exportarPulsa Importar / Exportar.

Estados de la pantalla

  • Cargando: filas de esqueleto mientras llega el listado.
  • Sin resultados: "No hay ingredientes con esos filtros.".
  • Error de carga: banner rojo con el mensaje del sistema o el aviso "Error cargando ingredientes".
  • Límite diario de consultas: cada cuenta puede pedir hasta 2.000 páginas del catálogo al día (listado y buscador). Si lo superas, el banner rojo dice "Has consultado el catálogo más de 2.000 veces hoy. Mañana vuelve a estar disponible; si necesitas el catálogo completo, escríbenos a soporte.".

El catálogo global es común a toda la plataforma y no se edita desde la interfaz. Si necesitas datos propios de proveedor, usa Campos personalizados para extender la información o Importar / Exportar para mantener tu catálogo personalizado.

Siguientes pasos

En esta página