AreaCacaoDocs
FormulazioneMateriali di consumo

Catalogo materiali di consumo

La schermata /supplies: ricerca, filtri per categoria e fornitore, creazione dei materiali di consumo, campi personalizzati, importazione/esportazione CSV e cronologia dei costi.

Che cos’è

Il catalogo materiali di consumo è la schermata in cui crei e gestisci tutti i tuoi materiali di consumo: ogni materiale non alimentare con il suo costo per unità, la sua unità di consumo, il suo fornitore e, se vuoi, i tuoi campi personalizzati. È un catalogo personale (lo crei tu; non esiste una base internazionale come per gli ingredienti) ed è la fonte da cui attingono le ricette quando aggiungi materiali di consumo.

Si trova in un’unica schermata: non ci sono sottopercorsi (/supplies/catalog, /supplies/categories…). Tutto (ricerca, filtri, creazione, modifica, campi personalizzati e importazione/esportazione) si gestisce da qui tramite finestre modali.

Percorso di accesso

  • URL: https://app.areacacao.com/supplies
  • Come arrivarci: menu laterale → FORMULAZIONE → Materiali di consumo.
  • Disponibilità: qualsiasi utente che abbia effettuato l’accesso (nessuna limitazione per piano).
  • Il vecchio indirizzo /insumos reindirizza qui.

Sezioni della schermata

Intestazione

In alto trovi il link Torna al pannello e il titolo Catalogo materiali di consumo, con un sottotitolo che mostra il numero effettivo di materiali di consumo («N materiali di consumo nel tuo catalogo») oppure, se non ne hai ancora, «Contenitori, etichette, imballaggi e materiali di consumo non alimentari».

A destra ci sono quattro pulsanti:

  • Nuovo materiale: apre il modulo per creare un materiale di consumo con la sua scheda completa. Vedi Creare un materiale di consumo.
  • Gestisci categorie: apre il pannello per rinominare, eliminare o aggiungere categorie di materiali di consumo. Vedi Categorie dei materiali di consumo.
  • Campi personalizzati: apre il gestore per definire campi personalizzati per i tuoi materiali di consumo (materiale, lotto, certificazione…). Vedi Campi personalizzati.
  • Importa / Esporta: apre la finestra modale per esportare o caricare il tuo catalogo in CSV. Vedi Importare ed esportare.

Barra dei filtri

Sopra la tabella c’è una barra con quattro controlli:

  • Campo di ricerca con il testo segnaposto «Cerca per nome, codice o fornitore…». Cerca per nome (anche il nome inglese), codice interno (SKU), codice del fornitore, fornitore, descrizione e note.
  • Selezione della categoria con l’opzione predefinita Tutte le categorie (vengono caricate dalle tue categorie gestite).
  • Selezione del fornitore con l’opzione predefinita Tutti i fornitori.
  • Solo con gestione giacenze: casella che limita l’elenco ai materiali di consumo con gestione delle giacenze attivata.

Quando modifichi un filtro, l’elenco torna alla pagina 1.

Tabella dei risultati

Ogni riga mostra queste colonne:

ColonnaContenuto
NomeNome del materiale di consumo, con il suo codice interno (SKU) in un’etichetta, se presente.
CategoriaCategoria del materiale di consumo.
Unità di consumoL’unità con cui lo consumi nella ricetta (unità, foglio, metro…). Viene nascosta sugli schermi medi.
Costo / unitàCosto per unità di consumo, in euro.
FornitoreFornitore (viene nascosto sugli schermi stretti).
GiacenzeSì / No a seconda che sia attiva la gestione delle giacenze (viene nascosta sugli schermi stretti).
AzioniIcone Modifica (matita) ed Elimina (cestino).

Fai clic su una riga qualsiasi per aprire la scheda di dettaglio del materiale di consumo.

Paginazione

L’elenco mostra 50 materiali di consumo per pagina. Quando le pagine sono più di una, compare un piè di pagina con l’intervallo visualizzato («X–Y di TOTALE») e le frecce Pagina precedente / Pagina successiva.

Creare un materiale di consumo

Fai clic su Nuovo materiale per aprire il modulo, con il sottotitolo «Materiali non alimentari ripartiti per unità di prodotto vendibile.». È organizzato in sezioni:

  • Identità: Nome (obbligatorio), Nome (inglese) facoltativo, Categoria (vedi Categorie), Descrizione, Fornitore, Codice del fornitore e Codice interno (SKU).
  • Unità e acquisto: il modello a doppia unità:
    • Unità di consumo: l’unità che userai nella ricetta (es. unità, foglio, metro).
    • Unità d’acquisto: come lo acquisti (es. scatola da 500).
    • Unità di consumo per unità d’acquisto: il fattore di conversione (es. una scatola da 500 pirottini → 500). Serve a calcolare il costo per unità di consumo.
  • Costo: Costo per unità di consumo e la Voce della scheda di costo (dove viene raggruppato questo costo: Materiali di consumo, Ingredienti o Spese generali; predefinito: Materiali di consumo).
  • Giacenze (facoltativo): Gestisci le giacenze di questo materiale attiva l’inventario permanente in Magazzino, con un Avviso di scorta bassa.
  • Informazioni aggiuntive: URL dell’immagine, Note e i Campi personalizzati che hai definito.

Fai clic su Crea materiale per salvarlo (oppure su Salva modifiche in fase di modifica).

Campi personalizzati

Come per gli ingredienti, puoi arricchire i tuoi materiali di consumo con campi specifici del tuo account (materiale, lotto, certificazione…). Fai clic su Campi personalizzati nell’intestazione per aprire il gestore:

  • L’elenco N campi definiti con ogni campo (Etichetta, Chiave, Tipo, Obbligatorio) e le azioni di modifica ed eliminazione.
  • Nuovo campo apre un editor con Etichetta (obbligatoria), Chiave interna in snake_case (generata automaticamente, non modificabile in seguito), Tipo (Testo, Numero, Data, Elenco o Sì/No), Opzioni (solo per Elenco), Testo di aiuto e la casella Campo obbligatorio.

Eliminare un campo non cancella i valori già inseriti nei tuoi materiali di consumo. I valori di ciascun campo si compilano all’interno di ogni materiale di consumo, nella sezione Informazioni aggiuntive del modulo.

Importare ed esportare

Fai clic su Importa / Esporta per aprire la finestra modale (sottotitolo «Crea materiali di consumo in blocco o scarica il tuo catalogo.»), con due sezioni:

Importa

  • Scarica modello ti fornisce modello-materiali-consumo.csv con le colonne corrette e due righe di esempio (un pirottino e una scatola di praline) nella lingua dell’applicazione.
  • Fornisci il contenuto trascinando un CSV, con Seleziona file oppure incollandolo direttamente («…oppure incolla direttamente il contenuto»).
  • Il menu a discesa Come preparare il CSV riepiloga le regole principali:
    • name è l’unica colonna obbligatoria.
    • purchaseUnit, trackingUnit e purchaseToTrackingFactor definiscono il modello a doppia unità (acquisti in «scatola da 500», consumi in «unità»).
    • costPerUnit è il costo per unità di consumo, nella valuta del tuo account.
    • costBucket accetta insumos, ingredientes oppure overhead.
    • Le nuove categorie vengono create automaticamente come categorie gestite.
  • La selezione Modalità stabilisce come viene applicata l’importazione:
ModalitàCosa fa
Crea solo nuovi (predefinita)Crea i materiali di consumo il cui nome non esiste ancora e salta i duplicati per nome.
Crea e aggiornaCrea i nuovi e aggiorna quelli esistenti (abbinati per nome).

Prima di confermare puoi usare Anteprima: mostra un riepilogo del tipo «N righe — da creare X, da aggiornare Y, da saltare Z, errori W». Fai clic su Importa per applicare.

Esporta

Scarica tutto il tuo catalogo in CSV (materiali-consumo.csv), una riga per materiale di consumo con tutte le colonne. Le colonne dei campi personalizzati vengono aggiunte con il prefisso cf_; il campo allergens non si applica ai materiali di consumo.

Cronologia dei costi

Ogni volta che il costo di un materiale di consumo cambia, AreaCacao lo registra. Aprendo la scheda di dettaglio (clic su una riga), oltre ai dati generali e alle unità, vedrai una sezione Cronologia dei costi con la data, il costo Prima, il costo Dopo e una Nota per ogni variazione. Se non ci sono ancora variazioni, compare «Nessuna variazione di costo registrata finora.».

Stati della schermata

  • Caricamento: mostra la struttura vuota della tabella.
  • Catalogo vuoto: «Non hai ancora materiali di consumo» + «Aggiungi contenitori, etichette, pirottini, scatole o qualsiasi materiale non alimentare per includerli nel costo delle tue ricette.» con un pulsante Nuovo materiale.
  • Nessun risultato con i filtri: «Nessun materiale di consumo con questi filtri.».
  • Errore di caricamento: banner rosso con «Impossibile caricare i materiali di consumo».

L’eliminazione di un materiale di consumo è una cancellazione logica: l’avviso lo ricorda («Resterà disponibile nelle ricette che già lo usano.»). Scompare dal catalogo attivo, ma le ricette che lo usavano conservano il loro costo.

Disponibilità per piano

Disponibile per tutti i piani.

Passaggi successivi

In questa pagina