Impostazioni Generali

Tutto quello che puoi configurare in SiltaFlow in un'unica guida: lingua, scala dello schermo, scanner barcode, comandi vocali, backup, abbonamento, impostazioni magazzino e pannello amministratore.

Panoramica

La schermata Impostazioni di SiltaFlow raccoglie tutti i parametri di configurazione dell'app in gruppi logici. Puoi arrivarci in qualsiasi momento toccando l'icona ingranaggio in basso a destra nella schermata principale. Le modifiche vengono applicate immediatamente, salvo dove indicato diversamente (alcune impostazioni visive richiedono il riavvio dell'app).

Le impostazioni sono organizzate in sette sezioni principali: Connessioni, Configurazione AI, Magazzino, Generali, Backup e Ripristino, Modalità Admin e Info app.

Connessioni — connessioni Odoo, stampanti etichette e autenticazione biometrica se disponibile
Configurazione AI — provider LLM, chiavi, modelli e template prompt
Magazzino — impostazioni magazzino, produzione, note ricezione/consegna e resi
Generali — lingua, scala UI, foto/immagini, scanner hardware, eventi e riconoscimento vocale
Backup e Ripristino — salva e ripristina tutta la configurazione dell'app
Modalità Admin — visibilità moduli e accessi operatore
Info app — versione, informazioni app e licenze open source

La maggior parte delle impostazioni è attiva immediatamente dopo la modifica, senza riavviare l'app. Le eccezioni sono indicate nella sezione corrispondente.

Lingua e Scala UI

Queste due impostazioni controllano come SiltaFlow appare sullo schermo. Funzionano in modo completamente indipendente dalle impostazioni di sistema del telefono: puoi usare SiltaFlow in inglese anche se il tuo Android è in italiano, e viceversa.

Lingua dell'app

SiltaFlow supporta sei opzioni di lingua:

Opzione	Descrizione
Lingua di Sistema	Segue la lingua impostata in Android. Se la lingua del telefono non è supportata, l'app usa l'inglese automaticamente. Valore predefinito.
Italiano	Forza l'italiano in tutta l'app, indipendentemente dalla lingua del telefono.
English	Forza l'inglese in tutta l'app.
Deutsch	Forza il tedesco in tutta l'app.
Français	Forza il francese in tutta l'app.
Español	Forza lo spagnolo in tutta l'app.

Dopo aver cambiato la lingua, l'app si riavvia automaticamente per applicare le nuove stringhe. I dati in corso non vengono persi.

Scala UI

La scala UI modifica la dimensione di testo, icone e pulsanti in tutta l'app. Utile per chi lavora con guanti, in condizioni di scarsa visibilità, o su schermi molto grandi o molto piccoli.

Livello	Quando usarlo
90% — Compatto	Mostra più righe e contenuto a schermo. Ideale su tablet o per utenti con buona vista che preferiscono alta densità di informazioni.
95%	Leggermente più compatto del predefinito.
100% — Predefinito	Bilanciamento ottimale per smartphone da 5" a 6,5". Valore consigliato per la maggior parte degli utilizzi.
110%	Elementi più grandi e facili da toccare. Consigliato se si lavora con guanti.
120% — Grande	Massima leggibilità. Si vede meno contenuto per schermata ma ogni elemento è molto chiaro.

Dopo aver scelto una nuova scala, l'app mostra un avviso e richiede il riavvio per applicare le modifiche.

Scanner Hardware

Percorso: Impostazioni > Generali > Scanner Hardware. Qui puoi abilitare scanner USB/Bluetooth/integrati nelle schermate native, impostare auto-conferma quantità 1, timeout scansione 50-300 ms, prefisso/suffisso da rimuovere, beep, vibrazione e visibilità del tasto scanner fotocamera.

Tipi di scanner supportati

SiltaFlow supporta tre modalità di acquisizione barcode:

Scanner USB / Bluetooth (Keyboard Wedge) — il pistolino si comporta come una tastiera. Funziona su qualsiasi dispositivo Android senza configurazione aggiuntiva: basta collegarlo e attivare l'opzione "Scanner Hardware" nelle impostazioni.
Scanner Zebra (DataWedge) — per i dispositivi Zebra con scanner laser integrato (TC52, TC57, TC72, MC93 e simili). Offre latenza minima, rilevamento automatico della simbologia e feedback LED/beep/vibrazione controllabili dall'app.
Fotocamera — disponibile come opzione di riserva su qualsiasi smartphone. Appare come pulsante flottante nelle schermate operative. Meno veloce di uno scanner dedicato, ma sempre disponibile.

La modalità Intent DataWedge vale per le schermate native di SiltaFlow. In Odoo Web/WebView gli Intent DataWedge non vengono inoltrati al campo web: usa il tasto fotocamera oppure un profilo keystroke separato.

Parametri di configurazione

Impostazione	Predefinito	Descrizione
Scanner Hardware Attivo	ON	Interruttore principale. Deve essere attivo per ricevere input da pistolini USB o Bluetooth.
Auto-Conferma Qty=1	OFF	Conferma automaticamente la quantità 1 dopo ogni scansione. Ideale per operazioni di ricezione in serie dove ogni scansione corrisponde a un'unità.
Timeout Scansione	100 ms	Tempo di attesa per raccogliere tutti i caratteri di un barcode. Se il tuo scanner produce errori di lettura, prova ad aumentare il valore a 150–200 ms. Range: 50–300 ms.
Strip Prefisso	Vuoto	Caratteri da rimuovere automaticamente dall'inizio del codice letto. Alcuni scanner aziendali aggiungono caratteri identificativi che potrebbero interferire con la ricerca.
Strip Suffisso	Vuoto	Caratteri da rimuovere automaticamente dalla fine del codice letto (es. il carattere di ritorno a capo aggiunto da molti scanner).
Feedback Suono	ON	Emette un beep dopo ogni scansione riconosciuta. Separato dal beep hardware dello scanner.
Feedback Vibrazione	ON	Vibrazione breve dopo ogni scansione valida. Utile in ambienti rumorosi dove il beep non è percepibile.
Mostra pulsante fotocamera	ON	Mostra il pulsante fotocamera nelle schermate operative. Puoi disattivarlo se usi solo scanner hardware.

Configurazione Zebra DataWedge

Se hai un dispositivo Zebra, attiva il toggle "Zebra DataWedge" e poi tocca "Configura Profilo DataWedge". L'app crea automaticamente un profilo chiamato "SiltaFlow" in DataWedge senza che tu debba aprire l'app DataWedge manualmente. Il profilo viene configurato per inviare i dati di scansione direttamente a SiltaFlow, con feedback LED, beep e vibrazione secondo le tue preferenze.

Su dispositivi Zebra, usa sempre la modalità DataWedge invece del Keyboard Wedge: offre latenza inferiore a 50 ms, rilevamento della simbologia e nessun rischio di conflitto con altri campi di testo aperti sullo schermo.

Riconoscimento Vocale

Il riconoscimento vocale ti permette di dichiarare le quantità e dare comandi operativi usando solo la voce, senza toccare lo schermo. Funziona in combinazione con la scansione barcode: scansiona il prodotto, poi parla per inserire la quantità.

Il sistema usa il motore di riconoscimento vocale nativo di Android: non vengono inviati dati audio a server SiltaFlow. La privacy dei dati vocali segue le politiche di Google o del produttore del dispositivo.

Come attivare il vocale

Il riconoscimento vocale ha due interruttori indipendenti:

Vocale in Ricezione Merci — attiva l'ascolto automatico dopo ogni scansione nelle schermate di ricezione.
Vocale in Picking e Consegna — attiva l'ascolto automatico durante le operazioni di prelievo e spedizione.

Quando il vocale è attivo, il microfono si avvia automaticamente subito dopo ogni scansione barcode riuscita. Non devi toccare nessun pulsante: scansioni il prodotto e dichiari la quantità.

Comandi vocali disponibili

Puoi usare tre tipi di comandi:

Numeri — pronuncia qualsiasi numero intero o decimale, in cifre o parole: "cinque", "dodici", "tre virgola cinque". Funziona nelle lingue: italiano, inglese, spagnolo, francese, tedesco.
Comandi di azione — "aggiungi", "togli", "metti", "tutto" (imposta la quantità massima disponibile), "conferma", "ok". Puoi combinarli con un numero: "aggiungi cinque".
Comandi di navigazione — "annulla", "stop", "ripeti" per interagire con i dialoghi di conferma.

Impostazioni di configurazione vocale

Impostazione	Predefinito	Descrizione
Soglia di Confidenza	70%	Percentuale minima di certezza richiesta per accettare un risultato vocale. Range: 50–95%. Valori alti (90%+) accettano solo riconoscimenti chiarissimi; valori bassi (50–60%) sono più reattivi ma con più margine di errore.
Conferma Opzionale	OFF	Quando attivo, mostra un banner con la quantità interpretata prima di applicarla. L'operatore può confermare, riprovare o annullare. Utile in ambienti rumorosi o per operazioni critiche.
Feedback Silenzioso	OFF	Disattiva i suoni di conferma del riconoscimento vocale. Attiva se lavori in un ambiente dove i suoni dell'app sono indesiderati.

Usa il pulsante "Testa Voce" nelle impostazioni per verificare che il microfono funzioni correttamente prima di iniziare a lavorare. Il test mostra il testo trascritto e il livello di confidenza in tempo reale.

Impostazioni Magazzino

Questa sezione controlla il comportamento operativo di SiltaFlow durante le attività di magazzino: come vengono caricati i dati dei prodotti, come si gestiscono i barcode con peso, come funzionano i conteggi inventariali e molto altro.

Conferma Prodotto

Controlla quali dati aggiuntivi vengono recuperati da Odoo quando scansi o selezioni un prodotto.

Carica Packaging (Unità Imballo) — recupera da Odoo le configurazioni di imballo del prodotto (confezione singola, cartone, pallet). Permette di selezionare l'unità di scansione corretta. Aggiunge 50–150 ms per prodotto.
Carica Lotti / Numeri di Serie — recupera i lotti disponibili in magazzino e popola automaticamente il selettore, evitando l'inserimento manuale. Aggiunge 100–300 ms per prodotto tracciato.
Escludi Lotti Scaduti — se il caricamento lotti è attivo, filtra i lotti con data di scadenza passata. Predefinito: ON. Richiede che le date di scadenza siano configurate su Odoo.

Barcode Pesati GS1

I barcode pesati sono codici GS1-128 che incorporano il peso del prodotto direttamente nel codice a barre — comuni nella grande distribuzione e nella logistica alimentare. Quando questa funzione è attiva, SiltaFlow legge automaticamente il peso dal barcode e lo pre-compila nel campo quantità.

Il pulsante "Sincronizza Nomenclatura Barcode da Odoo" scarica le regole barcode personalizzate dall'installazione Odoo, così SiltaFlow rispetta le configurazioni specifiche della tua azienda invece di usare solo lo standard GS1 generico.

Conteggio Inventario

Configura il comportamento dei conteggi inventariali: se vuoi che il peso venga registrato durante il conteggio, quale campo Odoo usare per il peso, e se aggiornare automaticamente il peso del prodotto su Odoo dopo ogni conteggio.

Controllo Peso Consegna

Abilita la verifica del peso durante le consegne. Puoi scegliere tra tre livelli di controllo:

Disabilitato — nessun controllo peso.
Opzionale — l'operatore può inserire il peso ma non è obbligatorio.
Obbligatorio — la consegna non può essere completata senza la verifica del peso.

Puoi configurare una tolleranza percentuale (es. ±5%) entro cui il peso viene accettato automaticamente senza segnalazione di anomalia.

Cluster Picking

Il cluster picking permette di gestire più ordini contemporaneamente usando un carrello multi-bin colorato. Quando attivo, ogni ordine viene associato a un colore diverso (fino a 10 colori) così l'operatore sa sempre in quale scomparto riporre ogni articolo scansionato.

La sezione include due impostazioni aggiuntive visibili quando il cluster picking è attivo:

Modalità di Setup — Scegli tra Touch (assegnazione contenitori dalla lista) e Scansione (scansiona bolla + contenitore per un setup completamente hands-free).
Conferma Deposito con Scansione — Se attivo, dopo ogni prelievo l'operatore deve scansionare il contenitore di destinazione per confermare il posizionamento corretto. Feedback visivo e sonoro immediato (verde = corretto, rosso = sbagliato).

Firma Elettronica

Abilita la raccolta della firma del destinatario al termine di una consegna. La firma viene catturata direttamente sullo schermo del dispositivo e salvata su Odoo. Puoi aggiungere una clausola legale personalizzata che appare sotto il campo firma.

Conversione Unità di Misura

Configura le conversioni di unità di misura per i prodotti che hanno UdM diverse tra Odoo e le tue operazioni fisiche. Specifica il campo Odoo da usare per ogni tipo di conversione (peso, volume, lunghezza).

Produzione / Manufacturing

Le impostazioni Manufacturing si trovano nell'area Magazzino e controllano flusso produzione, operatore o workcenter, sezioni attive, qualità, scarti, anomalie e stampa. Tutte le sezioni principali sono abilitate di default: ordini di produzione, prelievo componenti, postazione di lavoro e prodotti finiti.

Le impostazioni Manufacturing rientrano nel backup delle impostazioni generali, ma la selezione corrente di operatore o centro di lavoro resta locale al dispositivo. Per i dettagli consulta la guida Impostazioni Produzione.

Backup e Ripristino

Il backup ti permette di salvare tutta la configurazione di SiltaFlow in un file JSON e di ripristinarla su qualsiasi dispositivo. Utile per cambiare smartphone, distribuire la stessa configurazione su più dispositivi del team, o semplicemente avere una copia di sicurezza prima di aggiornamenti importanti.

Per sicurezza, password Odoo, chiavi API e PIN amministratore non vengono mai inclusi nel file di backup. Il file può essere condiviso tra colleghi senza rischi di esporre credenziali.

Cosa viene salvato

Il backup può includere fino a 10 categorie di dati, selezionabili singolarmente o tutte insieme:

Categoria	Contenuto	Condivisibile con il team
Impostazioni Generali	Lingua, tema, comportamenti UI	Si
Template Prompt AI	Modelli personalizzati per descrizioni prodotto, analisi e assistente vocale	Si
Profili Scanner Documenti	Configurazioni OCR, soglie di confidenza, campi Odoo target	Si
Profili Import Excel	Mappature colonne per l'importazione da file Excel	Si
Impostazioni AI (LLM)	Provider, modello, temperatura (API key esclusa)	Si
Connessioni Odoo	URL server, database, username (password esclusa)	Con cautela
Preset Etichette	Template ZPL/PDF con layout e dimensioni configurate	Si
Impostazioni Resi	Motivazioni, destinazioni, workflow di approvazione	Si
Impostazioni Admin	Moduli disabilitati per gli operatori (PIN escluso)	Con cautela
Impostazioni Eventi	Configurazione check-in eventi e biglietteria	Si

Come fare un backup

Vai in Impostazioni e tocca "Backup e Ripristino".
Scegli "Backup Completo" per salvare tutto, oppure seleziona solo le categorie che ti interessano.
Tocca "Esporta" — l'app genera un file JSON e apre il foglio di condivisione Android. Puoi salvarlo localmente, inviarlo via email o condividerlo su Drive.

Come ripristinare un backup

Vai in Impostazioni e tocca "Backup e Ripristino".
Tocca "Importa" e seleziona il file JSON dal tuo dispositivo.
L'app mostra un'anteprima con quanti record verranno creati, aggiornati o ignorati per ogni categoria. Controlla prima di procedere.
Scegli se sovrascrivere i dati esistenti o integrare solo quelli mancanti, poi tocca "Importa".

Abbonamento e Crediti

Questa sezione mostra lo stato della tua licenza SiltaFlow: il piano attivo, i crediti disponibili e la data di rinnovo. Qui puoi anche registrare una nuova API key o effettuare l'upgrade del piano.

Piani disponibili

SiltaFlow offre due livelli di abbonamento:

Trial Gratuito (14 giorni) — accesso a tutte le funzioni base di magazzino senza limitazioni. Le funzioni AI avanzate sono disponibili in modo limitato (5 usi al mese). Nessun pagamento richiesto.
Piano Pro (49 €/mese per dispositivo) — 250 crediti mensili, accesso completo a tutte le funzioni AI, fino a 3 dispositivi registrabili, rollover crediti non utilizzati (max 20% del mensile), supporto email prioritario.

Le operazioni base di magazzino (picking, ricezione, inventario, scanner barcode) sono sempre gratuite e non consumano crediti. I crediti vengono usati solo dalle funzioni AI: analisi documenti, segmentazione immagini, riconoscimento vocale avanzato e ottimizzazione percorso picking.

Registrare l'API Key

Per attivare il piano Pro:

Vai sul portale SiltaFlow (odoo-enhancer-prod.web.app) e accedi con le credenziali del tuo account.
Copia la tua API key dalla sezione "Dispositivi" del portale.
In SiltaFlow, vai in Impostazioni › Abbonamento, incolla la chiave nel campo e tocca "Registra".
Se il piano lo richiede, approva la richiesta sul portale. La licenza diventa attiva entro pochi minuti.

Ogni installazione di SiltaFlow genera un codice dispositivo univoco che puoi vedere in questa schermata. Usalo per registrare il dispositivo sul portale o per comunicare con il supporto. Puoi copiarlo o condividerlo direttamente dall'app.

Avvisi crediti bassi

L'app mostra automaticamente un avviso giallo quando i crediti scendono a 49 o meno, e un avviso rosso quando si esauriscono completamente. I crediti si rinnovano automaticamente ogni mese alla data di abbonamento.

Pannello Amministratore

Il Pannello Admin è un'area protetta da password dedicata a chi gestisce SiltaFlow per un team di operatori. Da qui puoi decidere quali funzioni sono visibili agli operatori: quelle che nascondi scompaiono completamente dall'interfaccia, senza nessun pulsante grigio o avviso.

Se dimentichi la password amministratore, non esiste una procedura di recupero: l'unico modo per reimpostare la password è disinstallare e reinstallare l'app, con conseguente perdita di tutti i dati locali. Conserva la password in un posto sicuro.

Accesso al pannello Admin

La prima volta che accedi al pannello Admin, ti viene chiesto di impostare una password. Questa password viene cifrata con AES-256-GCM e conservata nell'Android Keystore del dispositivo: nessuna app di terze parti può leggerla o estrarla.

Scegli una password sicura: almeno 10 caratteri con lettere maiuscole, minuscole e numeri. Evita PIN numerici corti, vulnerabili agli attacchi a dizionario.

Gestire la visibilità dei moduli

Il pannello Admin offre 26 interruttori indipendenti per controllare la visibilità di ogni funzione:

8 interruttori per i moduli della schermata principale (Gestione Articoli, Magazzino, Scanner Documenti, Resi, Label Creator, ecc.)
18 interruttori per le funzioni del modulo Magazzino (Picking, Ricezione, Inventario, Cluster Picking, ecc.)

Le modifiche sono immediate: non serve riavviare l'app. Un operatore che perde l'accesso a una funzione la vedrà scomparire al prossimo accesso alla schermata.

Distribuire la configurazione su più dispositivi

La configurazione del pannello Admin può essere esportata in JSON e importata su altri dispositivi tramite la funzione Backup. Questo permette di configurare un "dispositivo master" e distribuire la stessa configurazione su tutta la flotta aziendale in pochi minuti, senza dover ripetere l'impostazione manualmente su ogni device.

Crea profili di configurazione diversi per ogni ruolo: un file JSON per i magazzinieri (con cluster picking e inventario), uno per i picker (con solo picking e ricezione), uno per i responsabili (con tutto attivo). Distribuisci il file corretto a seconda del ruolo.

Suggerimenti

Fai un backup completo prima di aggiornare SiltaFlow a una nuova versione principale. Anche se i dati vengono generalmente mantenuti, un backup ti dà la certezza di poter ripristinare la configurazione in caso di problemi.

Se il tuo pistolino barcode produce letture incomplete o doppie, la prima cosa da regolare è il timeout di scansione. Aumenta di 20 ms alla volta finché le letture diventano stabili.

In ambienti rumorosi (es. magazzini con muletti o linee di produzione), abbassa la soglia di confidenza vocale a 55–65% e attiva la "Conferma Opzionale". Avrai più falsi negativi ma meno errori silenziosi.

Se gli operatori lavorano con guanti spessi, imposta la Scala UI a 110% o 120%. I pulsanti più grandi riducono i tocchi accidentali e aumentano la velocità operativa.

Controlla i crediti rimanenti almeno una volta a settimana durante il primo mese di utilizzo, finché non hai un'idea chiara del consumo mensile. Il pulsante di aggiornamento nella dashboard crediti recupera il saldo aggiornato dal server.