Importare da CSV o Excel

Che cos’è

Importare da CSV o Excel trasforma un foglio di calcolo in ricette di AreaCacao. Prepari tu il file, decidi tu che cosa significa ogni colonna, e l’importatore crea (o aggiorna) le ricette. Nessuna IA interviene nella lettura del file e non si consumano crediti.

• Percorso: https://app.areacacao.com/import-recipe, sezione Nuovo caricamento.
• Come arrivarci: barra laterale → FORMULAZIONE → Importa ricette → sezione Nuovo caricamento. Il riquadro si trova sotto l’area di caricamento di foto/PDF.
• Disponibilità: attiva per impostazione predefinita in tutti i piani. L’unica eccezione è l’account gratuito limitato (quello che può restare quando la prova di 14 giorni termina senza sottoscrivere un piano): facendo clic su Importa CSV/Excel vedrai l’avviso «L’importazione da Excel o CSV è inclusa nei piani Starter e Pro.» con il pulsante Visualizza i piani.

In cosa si differenzia dall’importare una foto o un PDF

L’unica parte in cui può intervenire l’IA è facoltativa e la scegli tu: completare automaticamente gli ingredienti che non esistono nel tuo catalogo (vedi la sezione Ingredienti che non corrispondono al catalogo, più sotto).

Il riquadro e i suoi due pulsanti

Il riquadro si intitola «CSV o Excel (senza crediti)» e il suo testo è: «Importa le tue ricette da un foglio di calcolo. Non consuma crediti e non ha limiti di utilizzo. Importa una o più ricette alla volta.»

Ha due pulsanti e una sezione espandibile:

• Importa CSV/Excel — apre la procedura guidata.
• Scarica modello — scarica il file direttamente, senza passare dal server.
• Guida rapida: come preparare il file — una sezione espandibile con le regole di compilazione, l’elenco dei valori validi di filling_type e i valori di recipe_type.

Il modello

Il pulsante Scarica modello genera areacacao-modello-ricette.csv sul tuo computer. È un CSV con BOM UTF-8 (perché Excel rispetti gli accenti) e contiene l’intestazione canonica più tre ricette di esempio, scelte per mostrare i tre schemi che l’importatore riconosce:

1. Ganache al frutto della passione — ripieno semplice: cinque righe condividono recipe_name e l’ultima contiene i passaggi. Quattro ingredienti sono collegati tramite ingredient_code e uno (la polpa di frutto della passione) solo per nome.
2. Tartufo di cioccolato classico — ripieno a strati: la colonna part separa «Interno» da «Rivestimento».
3. Tavoletta fondente 70% — ricetta di cioccolato: usa chocolate_type e cocoa_percent e lascia vuoto filling_type.

Il modello viene generato nella lingua dell’interfaccia: con l’app in italiano, il file si chiama areacacao-modello-ricette.csv e i nomi di ricette, ingredienti, sezioni e passaggi sono in italiano; le intestazioni e gli identificatori (ganache_bombon, negro…) restano sempre gli stessi. I costi di esempio sono al kg (cost_unit = kg) e in euro (EUR).

Non sei obbligato a usare il modello: puoi importare il tuo foglio con le tue intestazioni e indicare nel passaggio di mappatura che cos’è ogni colonna.

Colonne

Il modello contiene 17 colonne, in quest’ordine:

recipe_name, recipe_type, chocolate_type, filling_type, cocoa_percent, part, ingredient_code, ingredient_name, quantity, unit, weight_g, cost_per_unit, cost_unit, cost_currency, is_supply, supply_code, steps

Nella procedura guidata puoi mappare 18 campi: i 17 del modello più recipe_id (ID della ricetta), che esiste come destinazione di mappatura anche se non è nel modello.

Come vengono raggruppate le righe

Le righe vengono raggruppate per recipe_name normalizzato: minuscole, senza accenti e con gli spazi interni ridotti a uno. In altre parole, «Ganache al Frutto della Passione» e «ganache al frutto della passione» finiscono nella stessa ricetta.

Regole di compilazione applicate dall’importatore

• Un ingrediente per riga. Non scrivere l’elenco completo degli ingredienti in un’unica cella: l’importatore non è in grado di separarlo.
• Passaggi con |. Basta compilare steps in una qualsiasi riga della ricetta.
• Strati con part. Stesso recipe_name in tutte le righe e il nome dello strato in part. Se la ricetta ha un solo strato, lascia vuota part.
• filling_type con l’identificatore esatto, in minuscolo e con trattini bassi. ganache da solo non è un valore valido; la ganache classica per praline è ganache_bombon. L’elenco completo è nella sezione espandibile Guida rapida della schermata stessa.

La procedura guidata, passo per passo

La procedura guidata si intitola «Importa ricette da CSV» e ha cinque schermate.

Ingredienti che non corrispondono al catalogo

L’importatore risolve ogni riga così: se c’è ingredient_code, cerca quella scheda esatta; altrimenti cerca per nome nel tuo catalogo. Se il nome corrisponde a più schede, la riga resta in sospeso con un breve elenco di candidate tra cui scegliere nella ricetta; se la scheda è stata dedotta togliendo una marca o una percentuale dal nome, la riga viene contrassegnata perché tu la verifichi. Quando non trova nulla, applica l’opzione che hai scelto nel passaggio Opzioni:

• Crea gli ingredienti mancanti come in sospeso (senza costo) — «Gli ingredienti che non troviamo vengono aggiunti come in sospeso, senza dati nutrizionali né di costo. Potrai completarli in seguito. Non consuma crediti.» È l’opzione predefinita.
• Completa gli ingredienti mancanti con l’IA — 5 crediti per ingrediente — «Per ogni ingrediente che non troviamo, l’IA stima macronutrienti, allergeni e dati di costo. Vengono addebitati 5 crediti per ogni nuovo ingrediente.»

Materiali di consumo

Le righe contrassegnate con is_supply o con supply_code vengono trattate come materiali di consumo. Vengono collegate solo tramite codice al tuo catalogo dei materiali di consumo. Se il codice non esiste, la riga viene comunque importata ma resta contrassegnata da rivedere, e il conteggio Materiali di consumo non trovati dell’anteprima ti avvisa in anticipo. L’importazione non crea mai nuovi materiali di consumo — nemmeno in modalità IA, che si applica solo agli ingredienti.

Creare o aggiornare

• Senza recipe_id → viene sempre creata una nuova ricetta.
• Con recipe_id → se quell’id esiste ed è tuo, la ricetta viene aggiornata. Se non esiste o non è tuo, viene creata una nuova ricetta.
• Quando viene creata una ricetta con un nome già presente nel tuo catalogo, AreaCacao differenzia automaticamente il nome invece di duplicarlo alla cieca. Questo vale solo in creazione, mai in aggiornamento.
• Una ricetta che non va a buon fine non interrompe l’importazione: viene contrassegnata con il suo errore e l’importatore passa alla successiva.

Limiti

Se provi ad avviare un’importazione mentre un’altra è ancora in coda o in elaborazione, il server la rifiuta: devi aspettare che la precedente termini.

Che cosa NON fa

• Non legge il tuo file con l’IA. La mappatura delle colonne è tua e l’analisi del file è deterministica.
• Non compare nella sezione Cronologia. Quella sezione elenca le importazioni da foto e PDF. Anche se la procedura guidata dice «Puoi chiudere questa finestra: l’importazione continua e la troverai nella Cronologia.», al momento le importazioni da foglio di calcolo non sono elencate in nessuna schermata: il loro stato è visibile solo nella finestra della procedura guidata finché resta aperta. Se la chiudi, l’importazione prosegue, ma per verificarne il risultato dovrai controllare in Le mie ricette.
• Non si può annullare. Dopo aver fatto clic su Importa non c’è un pulsante per annullare; la procedura guidata permette solo di chiudere la finestra.
• Non crea nuovi materiali di consumo.
• Non legge più di un foglio di una cartella di lavoro Excel.
• Non importa da un link a Google Sheets né da un URL: devi caricare il file. Per importare da una pagina web esiste un’altra via, vedi Importare una ricetta da URL.
• Non convalida al posto tuo il filling_type. Se scrivi un identificatore inesistente, la ricetta viene importata senza validazione tecnica del ripieno.

Passaggi successivi