1. Cos'è la Migrazione menu e quando usarla
La Migrazione menu è la sezione dell'area admin (voce 🔄 Migrazione menu nella sidebar di sinistra) pensata per chi ha già un menu e vuole trasferirlo digitalmente senza digitare tutto a mano. È utile in tre casi tipici:
- Hai un menu cartaceo — fotografi ogni pagina con il telefono e l'AI legge e riconosce il testo.
- Hai un file CSV o Excel — lo importi direttamente senza passare dall'analisi AI.
- Sei in configurazione guidata (onboarding) — anche lì puoi scegliere CSV o foto fin dal passo «Menu / Listino».
Il risultato è sempre lo stesso: un elenco strutturato di categorie, sottocategorie e piatti, modificabile prima di essere importato nel tuo listino. Vediamo i due percorsi uno per uno.
2. Metodo 1 — Da foto o menu cartaceo (analisi AI)
È il percorso più comune: hai il menu stampato sul tavolo, fai qualche foto e carichi tutto. Segui questi passaggi dall'interno di Migrazione menu:
Passo 1 — Carica le immagini
Trascina le immagini nella zona di caricamento oppure clicca per selezionarle dal dispositivo. Sono accettati i formati PNG, JPEG e WebP. Il limite è di 15 pagine per analisi: se il tuo menu ha più sezioni, carica tutte le pagine insieme in un'unica sessione — l'AI le legge come un documento unico. Se l'ordine non è corretto, usa le frecce ↑ ↓ per riordinare le pagine prima di avviare l'analisi.
Ogni pagina analizzata consuma 250 crediti AI dal tuo piano. L'indicazione del costo totale compare sotto il pulsante «Analizza menu con AI» prima di confermare, così sai esattamente quanti crediti userai.
Passo 2 — Analisi AI in corso
Clicca «Analizza menu con AI»: il sistema invia le immagini all'AI, che le legge in sequenza e produce un documento CSV unificato con categorie, sottocategorie, piatti, descrizioni, ingredienti, allergeni e prezzi estratti dalle foto. L'operazione richiede da pochi secondi fino a qualche minuto a seconda del numero di pagine. Il documento CSV viene automaticamente salvato anche nella sezione Documenti CSV del tuo account.
Passo 3 — Anteprima e correzione della tabella
L'AI mostra una tabella con tutte le righe rilevate: ogni riga è una categoria, una sottocategoria o un piatto. Puoi modificare qualsiasi cella — nomi, prezzi, categorie — cliccando direttamente sulla cella, oppure cancellare le righe che non ti servono con il pulsante ×. Poi scegli cosa importare selezionando i checkbox: Categorie, Sottocategorie e/o Piatti, anche solo una parte alla volta.
Passo 4 — Importazione nel menu
Clicca «Importa nel menu»: le categorie vengono create se non esistono già, le sottocategorie vengono associate alle rispettive categorie padre e i piatti vengono aggiunti al listino. Al termine vedi il riepilogo con il numero esatto di categorie, sottocategorie e piatti creati.
3. Metodo 2 — Da file CSV (Excel o foglio di calcolo)
Se hai già i dati del menu in un foglio di calcolo — Excel, LibreOffice Calc, Google Sheets — puoi esportarlo in formato .csv UTF-8 e importarlo direttamente. Il file deve rispettare queste colonne nell'ordine indicato:
tipo, categoria, sottocategoria, nome, descrizione, ingredienti, allergeni, prezzo
La colonna tipo indica la struttura del menu: i valori ammessi sono categoria, sottocategoria o piatto. Le colonne descrizione, ingredienti, allergeni e prezzo possono essere vuote — le completi con l'AI dopo l'importazione (vedi sezione 5).
Hai due modi per caricare il CSV:
- Durante la configurazione guidata (onboarding) — al passo «Menu / Listino», scegli «Importa da CSV», carica il file e si apre la stessa schermata di anteprima della migrazione da foto: puoi correggere e scegliere cosa importare prima di confermare.
- Tramite Documenti CSV — carica il file in Documenti CSV, salvalo in libreria e poi chiedi all'assistente AI di importarlo o di lavorarci su.
Se il CSV è prodotto automaticamente dalla migrazione AI (foto → analisi → CSV), il formato è già corretto e il file viene salvato in Documenti CSV con un nome assegnato dall'AI.
4. La tabella di anteprima: come correggere prima di importare
Prima di ogni importazione — sia da foto che da CSV — compare la tabella di anteprima. Serve per correggere errori di lettura AI o imperfezioni del CSV senza ricominciare dall'inizio. Cosa puoi fare:
- Modifica le celle — clicca su qualsiasi campo (nome, categoria, prezzo, allergeni…) e scrivi il valore corretto. La modifica è immediata e viene salvata nel CSV prima dell'importazione.
- Elimina righe — clicca × a destra della riga per rimuoverla. Utile per voci duplicate, pagine speciali (eventi, promozioni) o righe vuote che non vuoi importare.
- Seleziona cosa importare — usa i tre checkbox per scegliere se importare le Categorie, le Sottocategorie e/o i Piatti. Puoi importare solo i piatti se le categorie esistono già nel tuo listino.
- Riepilogo in tempo reale — in cima vedi sempre il conteggio aggiornato di categorie, sottocategorie e piatti che verranno importati dopo le tue modifiche.
Se vuoi ricominciare da zero — ad esempio hai caricato le foto nell'ordine sbagliato — usa il pulsante Ricomincia per tornare al caricamento immagini. Il documento CSV già prodotto rimane salvato in Documenti CSV e non viene eliminato.
5. Arricchimento AI: descrizioni, ingredienti, allergeni e prezzi mancanti
Quando l'importazione è completata, la schermata di completamento mostra il riepilogo dei piatti creati. Se alcuni piatti hanno dati mancanti compare la sezione Arricchimento AI: con un singolo clic puoi chiedere all'AI di compilare automaticamente quel campo per tutti i piatti che ne hanno bisogno.
- 📝 Descrizioni — breve testo appetitoso per ogni piatto.
- 🥗 Ingredienti — stima degli ingredienti tipici. Verifica sempre prima di pubblicare.
- ⚠️ Allergeni — stima degli allergeni CE. Da verificare obbligatoriamente con il cuoco o il fornitore: la responsabilità legale dell'indicazione degli allergeni è del titolare del locale.
- 💶 Prezzi — stima basata su un ristorante italiano tipico. Correggi sempre prima di pubblicare.
Puoi avviare l'arricchimento per ciascun campo separatamente: decidi caso per caso cosa affidare all'AI e cosa preferisci compilare a mano. I dati arricchiti finiscono direttamente nel listino e sono subito modificabili dalla sezione Piatti.
6. Documenti CSV: la libreria dove vengono salvati i tuoi file
Ogni volta che esegui una migrazione da foto, il CSV prodotto dall'AI viene salvato automaticamente nella sezione 📄 Documenti CSV della sidebar. Trovi tutti i tuoi documenti in una libreria e puoi:
- Visualizzare il CSV in tabella — l'anteprima tabellare rende leggibili anche file con molte colonne, con scorrimento orizzontale.
- Modificare il sorgente CSV — passa alla vista «Modifica sorgente CSV» per correggere direttamente il testo grezzo riga per riga.
- Scaricare il file .csv — utile per conservare una copia o lavorarci in Excel prima di reimportarlo.
- Caricare un CSV da file — trascina o seleziona un file .csv per aggiungerlo in libreria senza passare dalla migrazione.
- Chiedere all'assistente AI di leggerlo o aggiornarlo — l'assistente AI ha accesso ai documenti salvati: puoi chiedergli di estrarre dati, aggiornare prezzi in blocco o generare tabelle partendo dal documento.
I Documenti CSV sono disponibili nei piani con accesso all'assistente AI. Sul piano FREE l'accesso è limitato.
Domande frequenti sulla Migrazione menu
La migrazione menu è disponibile su tutti i piani?
No. La funzione «Migrazione menu» nell'area admin richiede un piano a pagamento attivo o un periodo di prova in corso. Sul piano FREE l'accesso è bloccato e il sistema reindirizza alla pagina Abbonamento. L'import da CSV durante la configurazione guidata (onboarding) è invece disponibile per tutti.
Quante foto posso caricare in una singola analisi?
Fino a 15 immagini per analisi (PNG, JPEG, WebP). Ogni pagina analizzata consuma 250 crediti AI dal tuo piano. Se il menu ha più pagine, caricale tutte insieme: l'AI le legge in sequenza e produce un unico CSV unificato e ordinato.
In che formato deve essere il CSV per l'importazione?
Il CSV deve avere le colonne: tipo, categoria, sottocategoria, nome, descrizione, ingredienti, allergeni, prezzo — separate da virgola, encoding UTF-8. I valori ammessi per la colonna «tipo» sono: categoria, sottocategoria, piatto. Se il CSV è prodotto dall'AI il formato è già corretto; se lo prepari a mano usa Excel o LibreOffice Calc e salvalo come .csv UTF-8.
Posso correggere il CSV prima di importarlo nel menu?
Sì. Nella schermata di anteprima ogni cella è modificabile direttamente: puoi correggere nomi, prezzi, categorie oppure eliminare righe che non ti servono. Le modifiche vengono salvate automaticamente nel CSV prima dell'importazione finale.
Cosa succede se un piatto non ha il prezzo nella foto?
Viene importato senza prezzo. Dopo l'importazione puoi avviare l'arricchimento AI «Prezzi»: l'AI stima un prezzo tipico per un ristorante italiano e lo compila in automatico per tutti i piatti che ne sono privi. Verifica sempre i prezzi stimati prima di pubblicare il menu.