Ingredientes personalizados

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.

Ruta de acceso

• URL: https://app.areacacao.com/ingredients
• 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

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 — campo de texto libre: puedes escribir cualquier valor o elegir una de las sugerencias del desplegable, que son categorías del catálogo (Derivados del cacao, Lácteos, Edulcorantes, Grasas y aceites, Frutos secos y semillas, Frutas, Condimentos, Aditivos y agentes de textura, Bebidas alcohólicas). Las sugerencias se muestran en el idioma de la interfaz; si eliges una, la ficha queda en esa categoría del catálogo y su nombre se traduce al cambiar de idioma.
• Subcategoría
• Marca
• Proveedor — selector con buscador enlazado a tu lista de proveedores: elige uno existente, Sin proveedor, o escribe un nombre nuevo y pulsa Crear «…».

Información nutricional (por 100 g)

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

• Manteca de cacao: solo la grasa que viene del cacao (chocolate, cobertura, manteca de cacao); en lácteos y mantequilla, déjala vacía.
• Alcohol (etanol): gramos de etanol por 100 g, para vinos y licores.
• Agua sin informar: si no escribes el agua, no se guarda ningún valor y la validación la trata como desconocida, no como 0. Si el ingrediente no lleva agua, escribe 0.
• Estimación del agua: con grasas, carbohidratos y proteína escritos (un 0 cuenta), el formulario ofrece una "Estimación orientativa por diferencia" (100 − grasas − hidratos totales − proteína − sal, restando también la fibra y el alcohol declarados) con un botón Usar. Si la usas, el campo pasa a llamarse Agua (estimada) y la ficha la guarda marcada como estimada. Cuando hay fibra, eliges si en tu etiqueta va aparte de los hidratos (etiquetado UE: se resta) o incluida en ellos (EE. UU. o Canadá: no se resta otra vez). En una bebida alcohólica, la estimación solo aparece si declaras el alcohol.
• Energía calculada: con las calorías vacías y grasas, carbohidratos y proteína escritos, el formulario propone la energía según el Reglamento (UE) 1169/2011, anexo XIV (9 × grasas + 4 × hidratos + 4 × proteína + 2 × fibra + 7 × alcohol), también con un botón Usar. Nada se rellena solo.
• Tabla vacía: si no escribes ningún valor nutricional, el formulario avisa de que la validación no podrá contar este ingrediente en la composición de tus recetas.

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": en la ficha del ingrediente no se capturan trazas (las trazas se marcan en la receta). Ver Alérgenos UE-14.

Hay tres situaciones posibles:

• Con alérgenos marcados: la ficha contiene esos alérgenos.
• Sin ninguno marcado: al guardar confirmas que no contiene ninguno de los 14 ("Sin alérgenos marcados: al guardar confirmas que este ingrediente no contiene ninguno de los 14.").
• Todavía no conozco sus alérgenos (quedan sin declarar): casilla que desactiva la lista. La ficha no se guarda como «sin alérgenos»: las recetas que lleven este ingrediente avisarán de que su declaración de alérgenos está incompleta hasta que los declares.

Conservantes

Sección plegable ¿Este ingrediente lleva conservante?, opcional, con cuatro respuestas: No lo sé (la de partida), No lleva conservante, Es un conservante y Lleva uno entre sus ingredientes. Las dos últimas piden la sustancia y, en el último caso, cuánto lleva. Ver Cómo se usa el semáforo de conservantes.

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, en la moneda de tu cuenta. El histórico de compras y la estrategia de precio por proveedor viven en el módulo de Costes.

Notas

Texto libre para cualquier observación.

Ver, editar y eliminar

En la pestaña Mis ingredientes verás la lista de tus fichas. Si todavía no has creado ninguna, la pestaña muestra un estado vacío con el título "Aún no tienes ingredientes propios", el texto "Crea fichas a medida con tus macros, alérgenos y precios. Estarán disponibles en tus recetas y formulaciones." y un botón Nuevo ingrediente.

Cuando hay fichas, encima de la tabla aparece el mismo recordatorio de revisión que en el formulario. En la tabla, cuando una ficha tiene Código propio, se muestra como una insignia junto a su nombre, y la columna Alérgenos indica el número de alérgenos, un guion (ninguno) o Sin declarar. Para cada fila:

• 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).

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:

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):

• 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, o null cuando están sin declarar.
• Validación: el backend usa un esquema estricto (rechaza campos desconocidos) y limita los alérgenos a la lista oficial.

Siguientes pasos