Capitolo 2 — App mobile del venditore

L'app mobile è una versione della gestione dell'attività per smartphone e tablet. È adatta ad attività come la consultazione delle vendite, la gestione dei prodotti, l'inventario fisico con fotocamera/codice a barre e gli acquisti e la ricezione della merce in mobilità. Mostra gli stessi dati della Dashboard.

⚠️ La lingua dell'applicazione è l'inglese. L'interfaccia utente di questa app è solo in inglese (senza tedesco/persiano); solo i dati (nome e prezzo del prodotto) vengono visualizzati nella lingua del negozio. Le etichette tra parentesi in questo capitolo corrispondono al testo inglese presente sullo schermo.

2-1. Accesso

1. Inserisca il dominio del negozio e prema Verifica del dominio (Verify domain). La scheda del negozio verificato mostra il nome, l'indirizzo e il badge del piano (se non è presente alcun piano: «No plan published»); è presente anche il pulsante Verifica di nuovo (Re-verify). (Un dominio non valido non blocca l'accesso, così da evitare di collegarsi al negozio sbagliato.)
2. Inserisca email e password (disattivati fino alla verifica del dominio) e prema Accedi.
3. Se la verifica in due passaggi è attiva, inserisca il codice monouso o uno dei codici di recupero; è presente anche il pulsante «Start over» per ricominciare da capo.
4. Stati di avvio: all'apertura è possibile vedere «Restoring mobile session» e poi «Loading tenant workspace»; se l'inizializzazione non riesce, compare «Workspace bootstrap failed» con il pulsante Riprova / Esci.

💡 Autorizzazioni: la maggior parte delle pagine richiede un'autorizzazione; senza l'autorizzazione necessaria, al posto della pagina viene mostrata la scheda «Permission required» (ad esempio, la ricezione della merce richiede l'autorizzazione alla creazione del prodotto o alla modifica della giacenza).

2-2. Pagina principale e navigazione

• Pagina principale: schede di scelta rapida raggruppate per ruolo — titolare dell'attività, magazzino, acquisti, ricezione, consegna, vendite — verso le attività più utilizzate. In aggiunta, la sezione avvisi.
• Riga delle statistiche generali: ⚠️ questi numeri sono conteggi di dati di riferimento (numero di classi fiscali, categorie, risorse, punti vendita), non cifre di vendita.
• Menu laterale a scomparsa: navigazione a più livelli; tutte le sezioni delle impostazioni e la gestione delle imposte sono raggruppate sotto un unico gruppo «System».
• Profilo nella barra inferiore.

2-3. Sezioni principali

Vendite

• Panoramica delle vendite.
• Attività quotidiane: ordini, carrelli, fatture, resi, transazioni (ciascuno con elenco + dettagli).
• Consegna: spedizioni, richieste di rimborso, firme, valutazione del rischio.
• Programmi: carte regalo, abbonamenti.

Catalogo e prodotti

• Elenco e dettagli/modifica del prodotto, creazione del prodotto, importazione in blocco (Import).
• Ricezione tramite codice a barre (Intake) — un flusso di lavoro completo, non solo una scansione: codice a barre riconosciuto → aggiunta o impostazione della giacenza in un punto vendita con una nota; codice a barre sconosciuto → creazione completa del prodotto (set di attributi, nome, codice, categoria, unità e conversione dell'unità, classe fiscale, prezzo netto/lordo multi-ruolo, galleria, giacenza iniziale). Modalità Ripeti (Repeat) per la scansione continua e il concatenamento con scansione/inventario fisico/ricezione degli acquisti.
• Categorie, marchi, collezioni: ciascuno dispone di creazione/dettagli/modifica completi (non solo l'elenco).

Codice a barre

• Centro codici a barre / scansione: scansione o digitazione → ricerca del prodotto → apertura del prodotto/modifica/dettagli del codice a barre, oppure «creazione da codice a barre» quando non viene trovato alcun prodotto.
• Tre modalità di scanner (viene memorizzata): fotocamera dello smartphone, input hardware (scanner che digitano), fotocamera hardware (dispositivi dedicati).
• Elenco dei codici a barre + modalità di selezione: selezione in blocco, riassegnazione in blocco a un altro prodotto, esportazione CSV degli elementi selezionati o dell'intero elenco e stampa dell'etichetta.
• Dettagli del codice a barre: modifica della quantità / riassegnazione / eliminazione, con una scheda per la stampa dell'etichetta.
• Pagina «collegamento del codice a barre al prodotto» separata (dall'interno del prodotto stesso) per scansionare e collegare.

Giacenza

• Panoramica della giacenza; dettagli della giacenza di ogni articolo.
• L'inventario fisico è un flusso di lavoro: elenco + creazione + pagina dei dettagli dell'inventario fisico (scansione → conteggio → salvataggio di ogni articolo → completamento).
• Storico e modifica della giacenza; sedi e risorse con creazione/dettagli/modifica completi.

Acquisti

• Panoramica; ordini/ricevute/richieste; fornitori e approvvigionamento; scorte in esaurimento; fatture, resi, rimborsi, report e notifiche.
• Ricezione degli acquisti (Receiving): pagina di scansione e abbinamento con la riga dell'ordine che crea una ricevuta.
• Azioni sull'ordine di acquisto: modifica, ricezione, creazione della fattura dall'ordine, creazione del reso, creazione del rimborso; conversione della richiesta in ordine.

Utenti e sistema

• Clienti e ruoli con creazione/dettagli/modifica completi.
• Impostazioni (12 sezioni + pagina principale): generale, catalogo, cliente, imposte, vendite, tema, pagamento, spedizione, stampanti, certificati, integrazione, attributi. ⚠️ Note importanti:
• Le impostazioni degli attributi non funzionano ancora (pagina bloccata/in fase di sviluppo).
• Certificati e integrazione sono in sola lettura.
• Imposte — due posizioni: una pagina delle impostazioni e una sezione separata System ← Tax con elenco completo e CRUD per classi, regole e aliquote fiscali.
• Stampanti — due posizioni: Impostazioni ← Stampanti e un gestore dei dispositivi di stampa (System ← Printers) per definire il tipo (rete/Bluetooth/USB/iMin), il modello (Epson/Star), l'indirizzo/protocollo/porta, la larghezza della carta 58/80 mm e attivo/disattivo.
• Account/profilo: modifica del profilo, sicurezza, aspetto, notifiche, connessioni (queste «connessioni» dell'account sono distinte dall'integrazione di sistema).

2-4. Stampa dell'etichetta dallo smartphone

⚠️ Questa app non stampa ricevute — solo etichette di prodotto.

• Modello e quantità: selezioni il layout dell'etichetta (compatto / standard / esteso) e il numero di copie da 1 a 50.
• Modalità di output dell'etichetta: download PDF, condivisione, invio alla finestra di stampa di sistema dello smartphone oppure stampa diretta su una stampante di rete.
• Stampante di rete: Epson (ePOS) o Star (WebPRNT) sulla rete locale — il metodo più stabile.
• Bluetooth (BLE): è stato programmato ma non è ancora stato verificato con l'hardware e richiede una versione speciale dell'app (non funziona su Expo Go).
• USB e iMin: al momento non sono supportati.

💡 Per un'etichettatura rapida degli scaffali, il metodo attualmente più affidabile è la stampante di rete oppure l'output PDF/condivisione.