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é es | Para qué | |
|---|---|---|
| Ingredientes personalizados | Fichas completas nuevas | Ampliar tu catálogo con insumos que la base global no tiene. |
| Campos personalizados | Columnas/metadatos que defines una vez | Capturar 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étodo | Endpoint | Acción |
|---|---|---|
GET | /api/ingredients/custom | Lista tus ingredientes personalizados activos. |
GET | /api/ingredients/custom/:id | Ficha de uno (incluye los retirados, para recetas históricas). |
POST | /api/ingredients/custom | Crear. |
PATCH | /api/ingredients/custom/:id | Editar (solo el propietario). |
DELETE | /api/ingredients/custom/:id | Eliminar (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 Drizzle0070(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
Catálogo de ingredientes
La base global de más de 10.000 fichas de solo lectura.
Buscar ingredientes
Cómo encontrar (y reconocer con la etiqueta "Mío") tus ingredientes.
Campos personalizados
Define columnas propias para capturar datos extra.
Importar y exportar
Vuelca o carga tu catálogo personalizado en JSON o CSV.
Alérgenos UE-14
Los 14 oficiales y cómo se declaran en la ficha.
Tab de ingredientes de la receta
Cómo se añaden y calculan los ingredientes en una receta.