AreaCacaoDocs
FormulaciónIngredientes

Ingredientes personalizados

Crea, edita y usa tus propios ingredientes privados con la ficha completa: macros, micronutrientes, alérgenos y coste.

Qué es

El catálogo de ingredientes es una base global y compartida de más de 10.000 fichas verificadas, de solo lectura para todos los usuarios. Los ingredientes personalizados son la otra cara: fichas que creas tú, privadas de tu cuenta, con la misma riqueza de datos que las del catálogo.

Sirven para todo lo que la base global no cubre: una materia prima de un proveedor concreto, una preparación propia, un producto regional o cualquier insumo con tus valores nutricionales y tu coste. Una vez creados, se usan en tus recetas y formuladores igual que cualquier ingrediente del catálogo.

Los ingredientes personalizados son privados: nadie más los ve. El catálogo global sigue siendo común a toda la plataforma y de solo lectura. Esta capacidad recupera una funcionalidad que ya existía en la versión anterior de AreaCacao.

Ruta de acceso

  • URL: https://app.areacacao.com/ingredientes
  • Cómo se llega: menú lateral → sección FORMULACIÓN → Ingredientes.
  • Disponibilidad: cualquier cuenta con sesión iniciada, sin restricción por plan.

La pantalla se titula Catálogo de ingredientes y tiene un conmutador de dos pestañas:

  • Catálogo — la base global de solo lectura.
  • Mis ingredientes — los ingredientes personalizados de tu cuenta.

El botón Nuevo ingrediente está en la cabecera, a la derecha, junto a Campos personalizados e Importar / Exportar.

Crear un ingrediente

Abre el formulario

En Ingredientes, pulsa Nuevo ingrediente. Se abre un formulario con la ficha completa.

Rellena la ficha

Solo el nombre es obligatorio; todo lo demás es opcional. Puedes guardar un ingrediente con solo su nombre e ir completando los datos más tarde. Ver el detalle de cada campo en Campos de la ficha.

Guarda

Pulsa Guardar. El ingrediente queda creado y aparece en la pestaña Mis ingredientes, listo para usarse en tus recetas.

Campos de la ficha

Todos los valores nutricionales son por 100 g. Los campos numéricos aceptan coma decimal (formato español, por ejemplo 2,5).

Identidad

  • Nombre (obligatorio)
  • Código propio — tu SKU o referencia interna.
  • Nombres alternativos — separados por comas.
  • Categoría y Subcategoría
  • Marca y Proveedor

Información nutricional (por 100 g)

Agua, grasas (y grasas saturadas), carbohidratos (y azúcares), proteína, fibra, sal, calorías (kcal), grasa de manteca de cacao y cacao total (%).

Micronutrientes

Sección plegable, cerrada por defecto, con 20 micronutrientes más dos valores adicionales:

  • Vitaminas (11): A, D, E, K, C, B1 (tiamina), B2 (riboflavina), B3 (niacina), B6, B9 (folato) y B12.
  • Minerales (9): calcio, hierro, magnesio, fósforo, potasio, zinc, cobre, manganeso y selenio.
  • Otros (2): colesterol y cafeína.

Alérgenos

Selección por casillas de la lista oficial de la UE (14): gluten, crustáceos, huevos, pescado, cacahuetes, soja, leche, frutos de cáscara, apio, mostaza, sésamo, sulfitos, altramuces y moluscos. Es un modelo simple de "contiene" (de momento no se capturan trazas ni "puede contener"). Ver Alérgenos UE-14.

Propiedades físicas

  • Unidad base — gramos por defecto.
  • Densidad (g/ml) — necesaria para convertir volúmenes (ml, L) a peso.
  • Peso por unidad (g) — necesario para convertir unidades a peso.

Coste

  • Precio por kg — un coste de referencia para la ficha. El histórico de compras y la estrategia de precio por proveedor viven en el módulo de Costos.

Notas

Texto libre para cualquier observación.

No se incluyen aquí los campos técnicos internos del formulador (bicarbonato, lecitina, ácido cítrico, pectina): la ficha de ingrediente es nutricional, no de proceso.

Ver, editar y eliminar

En la pestaña Mis ingredientes verás la lista de tus fichas. Para cada una:

  • Ver — pulsa la fila para abrir su ficha completa.
  • Editar — el botón con icono de lápiz reabre el formulario con los datos cargados.
  • Eliminar — el botón con icono de papelera la retira (con confirmación).

El borrado es suave: eliminar un ingrediente lo quita de Mis ingredientes y del buscador, pero las recetas que ya lo usaban siguen mostrando su ficha y no se rompen. En la práctica: eliminar no afecta a recetas anteriores.

Usarlo en una receta

Al añadir ingredientes en el editor de recetas o en los formuladores, el buscador de ingredientes muestra también tus ingredientes personalizados, marcados con la etiqueta Mío para distinguirlos del catálogo global.

Se añaden y calculan exactamente igual que los del catálogo: aportan sus macros al total de la receta y participan en la conversión de unidades por densidad o peso por unidad. Por eso conviene declarar densidad y peso por unidad si vas a usar el ingrediente en mililitros o unidades.

Ingredientes personalizados vs. campos personalizados

Son dos cosas distintas y complementarias:

Qué esPara qué
Ingredientes personalizadosFichas completas nuevasAmpliar tu catálogo con insumos que la base global no tiene.
Campos personalizadosColumnas/metadatos que defines una vezCapturar datos extra (origen, certificación, lote…) en tus ingredientes.

En resumen: los ingredientes personalizados añaden fichas; los campos personalizados añaden campos a esas fichas.

Referencia técnica

Para integraciones o soporte. La API está autenticada con la sesión del usuario (el userId lo toma el servidor, nunca el cliente):

MétodoEndpointAcción
GET/api/ingredients/customLista tus ingredientes personalizados activos.
GET/api/ingredients/custom/:idFicha de uno (incluye los retirados, para recetas históricas).
POST/api/ingredients/customCrear.
PATCH/api/ingredients/custom/:idEditar (solo el propietario).
DELETE/api/ingredients/custom/:idEliminar (borrado suave: is_active = false).
  • IDs: prefijo ci_ (el catálogo global usa otros identificadores).
  • Persistencia: tabla custom_ingredients; los campos de esta ficha se desplegaron con la migración Drizzle 0070 (en producción). Macros y micros se guardan en JSON; los alérgenos, como lista restringida a la UE-14.
  • Validación: el backend usa un esquema estricto (rechaza campos desconocidos) y limita los alérgenos a la lista oficial.

Siguientes pasos

En esta página