Ingredienti personalizzati

Che cos’è

Il catalogo ingredienti è una base internazionale e condivisa di oltre 10.000 schede verificate, in sola lettura per tutti gli utenti. Gli ingredienti personalizzati sono l’altra faccia: schede che crei tu, private del tuo account, con la stessa ricchezza di dati di quelle del catalogo.

Servono per tutto ciò che la base internazionale non copre: una materia prima di un fornitore specifico, una preparazione tua, un prodotto regionale o qualsiasi materia prima con i tuoi valori nutrizionali e il tuo costo. Una volta creati, si usano nelle tue ricette e nei formulatori come qualsiasi ingrediente del catalogo.

Percorso di accesso

• URL: https://app.areacacao.com/ingredients
• Come arrivarci: menu laterale → sezione FORMULAZIONE → Ingredienti.
• Disponibilità: qualsiasi account con accesso effettuato, senza limiti di piano.

La schermata si intitola Catalogo ingredienti e ha un selettore a due sezioni:

• Catalogo: la base internazionale in sola lettura.
• I miei ingredienti: gli ingredienti personalizzati del tuo account.

Il pulsante Nuovo ingrediente si trova nell’intestazione, a destra, accanto a Campi personalizzati e Importa / Esporta.

Creare un ingrediente

Campi della scheda

Tutti i valori nutrizionali sono per 100 g. I campi numerici accettano la virgola decimale (come si scrive in italiano, ad esempio 2,5).

Identità

• Nome (obbligatorio)
• Codice interno: il tuo SKU o riferimento interno.
• Nomi alternativi: separati da virgole.
• Categoria: campo a testo libero: puoi scrivere qualsiasi valore o scegliere uno dei suggerimenti del menu a tendina, che sono categorie del catalogo (Derivati del cacao, Latte e derivati, Edulcoranti, Grassi e oli, Frutta a guscio e semi, Frutta, Spezie e aromi, Additivi e agenti testurizzanti, Bevande alcoliche). I suggerimenti compaiono nella lingua dell’interfaccia; se ne scegli uno, la scheda viene assegnata a quella categoria del catalogo e il suo nome si traduce quando cambi lingua.
• Sottocategoria
• Marca
• Fornitore: selettore con ricerca collegato al tuo elenco fornitori: scegline uno esistente, Nessun fornitore, oppure scrivi un nome nuovo e fai clic su Crea «…».

Dichiarazione nutrizionale (per 100 g)

Acqua, grassi, acidi grassi saturi, carboidrati, zuccheri, proteine, fibre, sale, alcol (etanolo), calorie (kcal), burro di cacao e cacao totale (%).

• Burro di cacao: solo il grasso che proviene dal cacao (cioccolato, copertura, burro di cacao); per latticini e burro, lascialo vuoto.
• Alcol (etanolo): grammi di etanolo per 100 g, per vini e liquori.
• Acqua non indicata: se non inserisci l’acqua, non viene salvato alcun valore e la validazione la considera sconosciuta, non 0. Se l’ingrediente non contiene acqua, scrivi 0.
• Stima dell’acqua: con grassi, carboidrati e proteine inseriti (anche 0 conta), il modulo propone una «Stima indicativa per differenza» (100 − grassi − carboidrati totali − proteine − sale, sottraendo anche le fibre e l’alcol dichiarati) con un pulsante Usa. Se la usi, il campo diventa Acqua (stimata) e la scheda la salva contrassegnata come stimata. Se ci sono fibre, scegli se nella tua etichetta sono separate dai carboidrati (etichettatura UE: si sottraggono) o incluse in essi (USA o Canada: non si sottraggono di nuovo). Per una bevanda alcolica, la stima compare solo se dichiari l’alcol.
• Energia calcolata: con le calorie vuote e grassi, carboidrati e proteine inseriti, il modulo propone l’energia secondo il Regolamento (UE) 1169/2011, allegato XIV (9 × grassi + 4 × carboidrati + 4 × proteine + 2 × fibre + 7 × alcol), anche qui con un pulsante Usa. Nulla viene compilato automaticamente.
• Tabella vuota: se non inserisci alcun valore nutrizionale, il modulo avvisa che la validazione non potrà considerare questo ingrediente nella composizione delle tue ricette.

Micronutrienti

Sezione comprimibile, chiusa per impostazione predefinita, con 20 micronutrienti più due valori aggiuntivi:

• Vitamine (11): A, D, E, K, C, B1 (tiamina), B2 (riboflavina), B3 (niacina), B6, B9 (folati) e B12.
• Minerali (9): calcio, ferro, magnesio, fosforo, potassio, zinco, rame, manganese e selenio.
• Altro (2): colesterolo e caffeina.

Allergeni

Selezione tramite caselle dall’elenco ufficiale UE (14): cereali contenenti glutine, crostacei, uova, pesce, arachidi, soia, latte, frutta a guscio, sedano, senape, semi di sesamo, anidride solforosa e solfiti, lupini e molluschi. È un modello semplice di «contiene»: nella scheda dell’ingrediente non si registrano le tracce (le tracce si indicano nella ricetta). Vedi Allergeni UE-14.

Le situazioni possibili sono tre:

• Con allergeni selezionati: la scheda contiene quegli allergeni.
• Nessuno selezionato: salvando confermi che non contiene nessuno dei 14 («Nessun allergene selezionato: salvando confermi che questo ingrediente non contiene nessuno dei 14.»).
• Non conosco ancora i suoi allergeni (restano non dichiarati): casella che disattiva l’elenco. La scheda non viene salvata come «senza allergeni»: le ricette che contengono questo ingrediente segnaleranno che la loro dichiarazione degli allergeni è incompleta finché non li dichiari.

Conservanti

Sezione comprimibile Questo ingrediente contiene un conservante?, facoltativa, con quattro risposte: Non lo so (quella iniziale), Non contiene conservanti, È un conservante e Ne contiene uno tra gli ingredienti. Le ultime due chiedono la sostanza e, nell’ultimo caso, la quantità. Vedi Come si usa il semaforo dei conservanti.

Proprietà fisiche

• Unità di base: grammi come valore predefinito.
• Densità (g/ml): necessaria per convertire i volumi (ml, L) in peso.
• Peso per unità (g): necessario per convertire le unità in peso.

Costo

• Prezzo al kg: un costo di riferimento per la scheda, nella valuta del tuo account. La cronologia degli acquisti e la strategia di prezzo per fornitore si trovano nel modulo Costi.

Note

Testo libero per qualsiasi osservazione.

Visualizzare, modificare ed eliminare

Nella sezione I miei ingredienti vedrai l’elenco delle tue schede. Se non ne hai ancora creata nessuna, la sezione mostra uno stato vuoto con il titolo «Non hai ancora ingredienti personali», il testo «Crea schede su misura con i tuoi macro, allergeni e prezzi. Saranno disponibili nelle tue ricette e formulazioni.» e un pulsante Nuovo ingrediente.

Quando ci sono schede, sopra la tabella compare lo stesso promemoria di controllo del modulo. Nella tabella, se una scheda ha un Codice interno, viene mostrato come badge accanto al nome, e la colonna Allergeni indica il numero di allergeni, un trattino (nessuno) o Non dichiarati. Per ogni riga:

• Visualizza: fai clic sulla riga per aprire la scheda completa.
• Modifica: il pulsante con l’icona della matita riapre il modulo con i dati caricati.
• Elimina: il pulsante con l’icona del cestino la rimuove (con conferma).

Usarlo in una ricetta

Quando aggiungi ingredienti nell’editor delle ricette o nei formulatori, la ricerca ingredienti mostra anche i tuoi ingredienti personalizzati, contrassegnati dall’etichetta Mio per distinguerli dal catalogo internazionale.

Si aggiungono e si calcolano esattamente come quelli del catalogo: apportano i loro macronutrienti al totale della ricetta e partecipano alla conversione di unità tramite densità o peso per unità. Per questo conviene dichiarare densità e peso per unità se userai l’ingrediente in millilitri o unità.

Ingredienti personalizzati e campi personalizzati

Sono due cose diverse e complementari:

In sintesi: gli ingredienti personalizzati aggiungono schede; i campi personalizzati aggiungono campi a quelle schede.

Riferimento tecnico

Per integrazioni o assistenza. L’API è autenticata con la sessione dell’utente (lo userId lo ricava il server, mai il client):

• ID: prefisso ci_ (il catalogo internazionale usa altri identificatori).
• Persistenza: tabella custom_ingredients; i campi di questa scheda sono stati rilasciati con la migrazione Drizzle 0070 (in produzione). Macronutrienti e micronutrienti sono salvati in JSON; gli allergeni come elenco limitato agli UE-14, oppure null quando non sono dichiarati.
• Validazione: il backend usa uno schema rigoroso (rifiuta i campi sconosciuti) e limita gli allergeni all’elenco ufficiale.

Passaggi successivi