📱 Gestione Ordini dal Cellulare (PWA Agenti)

Cosa fa

NOX Agenti è l'app installabile sul cellulare che permette ai rappresentanti e agenti di commercio di inserire ordini cliente direttamente dal campo: in negozio, in studio, in fiera, anche senza connessione di rete. Quando torna la rete gli ordini vengono inviati automaticamente al gestionale NOX.

Con un cellulare in mano puoi:

• Cercare un cliente tra i tuoi (con telefono ed email cliccabili)
• Sfogliare il catalogo prodotti aggiornato
• Comporre un ordine con righe, sconti, IVA e note
• Vedere lo storico ordini (ultimi 90 giorni) con filtro stato
• Aprire la scheda completa di un articolo (anagrafica, prezzi, vendite, immagini, ecc.)
• Lavorare offline — gli ordini rimangono in coda e si inviano da soli al rientro online

L'app vive a un indirizzo dedicato:

Apri quell'indirizzo dal browser del cellulare (Safari su iPhone, Chrome o Edge su Android), inserisci le tue credenziali NOX e premi Accedi. Verrai reindirizzato automaticamente alla home /m/home.

Su Android (Chrome/Edge)

1. 1 Apri https://www.gnox.it/m e fai login
2. 2 Vai nella tab Profilo (in basso a destra)
3. 3 Tocca "Installa NOX Agenti". In alternativa Chrome ti propone spontaneamente un banner "Aggiungi a Home"
4. 4 Conferma. L'icona NOX comparirà nella tua schermata Home come una vera app

Su iPhone (Safari)

1. 1 Apri https://www.gnox.it/m in Safari (no Chrome)
2. 2 Fai login
3. 3 Tocca l'icona Condividi in basso (quadrato con la freccia ↑)
4. 4 Scorri e tocca "Aggiungi alla schermata Home"
5. 5 Conferma con "Aggiungi". L'app si chiamerà "NOX Agenti"

1. 1 Tocca la tab Clienti
2. 2 Nella barra di ricerca digita parte del nome, codice, partita IVA o località — la lista si filtra mentre scrivi
3. 3 Per chiamare il cliente: tocca il numero di telefono nella card → parte la chiamata
4. 4 Per inviare un'email: tocca l'indirizzo email → si apre l'app mail
5. 5 Per creare un ordine per questo cliente: tocca un punto qualsiasi della card. Verrai portato direttamente a "Nuovo ordine" con il cliente già selezionato

La tab Catalogo elenca tutte le voci attive con codice, descrizione, unità di misura, aliquota IVA e prezzo predefinito. Ricerca live su codice e descrizione.

Tap su un articolo → apre la scheda completa con tutti i dati organizzati in sezioni (caratteri piccoli per leggibilità):

• Prezzi: default, ingrosso, dettaglio, acquisto, margine, ricarico, sconto default e catena
• Identificazione: codice EAN, codice fornitore, categoria, marca, modello, taglia, materiale, origine, codice merceologico, tag
• Caratteristiche fisiche: peso lordo/netto, volume, larghezza, altezza, profondità
• Logistica & riordino: scorta minima/massima, punto riordino, MOQ, lead time, ubicazione magazzino
• Indicazioni (Ricetta naturopatica): posologia, lotto, scadenza
• Vendite: unità vendute anno, anno precedente, n. vendite, prezzo medio, ultimo movimento
• Galleria immagini (fino a 3) e link a scheda tecnica PDF

Dalla home tocca "Nuovo ordine", oppure dalla tab Clienti tocca una card. Il flusso è in 3 step:

Step 1 — Scegli il cliente

1. Cerca per nome, P.IVA, città, codice…
2. Tocca il cliente → si conferma in alto con un riquadro blu
3. Per cambiarlo: tocca l'icona ↔ e ricomincia

Step 2 — Aggiungi articoli

1. Cerca un articolo (codice o descrizione)
2. Tocca la voce → viene aggiunta come riga con Q.tà 1, prezzo default, IVA default
3. Per ogni riga puoi modificare 4 valori in linea: quantità · prezzo · sconto % · IVA %
4. Il subtotale di riga si aggiorna live
5. Per rimuovere una riga: tocca l'icona × rossa

Step 3 — Note + Conferma

1. Aggiungi eventuali note interne
2. Controlla i totali: imponibile · IVA · totale ordine
3. (Facoltativo) Fai firmare il cliente e acquisisci la posizione — vedi sotto
4. Tocca "Invia ordine (BOZZA)"
5. Vedrai la conferma con il numero progressivo, e l'app ti porta allo storico ordini

Firma del cliente e posizione (dalla v1.1)

Subito sotto le note, prima dell'invio, trovi lo spazio per la firma elettronica del cliente e la rilevazione della posizione GPS, come nell'app NOX Trasportatori per i DDT:

1. Passa il cellulare al cliente e fagli tracciare la firma col dito nell'area dedicata
2. Se firma, l'app chiede il nome di chi firma (firmatario): compilalo
3. La posizione del punto in cui stai concludendo l'ordine viene rilevata automaticamente (concedi il permesso quando l'iPhone/Android lo richiede)
4. Per rifare la firma tocca "Cancella" e ricomincia

La tab Ordini mostra gli ultimi 90 giorni dei tuoi ordini. In alto trovi i 4 filtri di stato:

• Tutti — qualsiasi stato
• Bozza — non ancora confermati
• Confermati — accettati ma non ancora emessi
• Emessi — fatturati

Ogni card mostra: numero, badge stato (giallo Bozza · azzurro Confermato · verde Emesso), nome cliente, data, numero righe e totale lordo in basso a destra.

Tap sulla card → si apre il dettaglio completo dell'ordine:

• Anagrafica cliente con tel/email cliccabili
• Lista righe esplose con: codice, descrizione, qta, prezzo, sconti applicati, IVA/Natura, imponibile, IVA riga e totale riga
• Note ordine
• Totali documento (imponibile · IVA · totale)
• Tap su una riga con codice articolo → apre la scheda completa di quell'articolo

L'app funziona anche senza rete. Al primo login (con rete) scarica e salva sul cellulare:

• Tutti i tuoi clienti
• Tutto il catalogo (fino a 5.000 articoli)
• Lo storico ordini ultimi 90 giorni

Quando perdi la rete (modalità aereo, treno in galleria, area sperduta) l'icona del WiFi nella topbar diventa rossa. Continuerai a vedere clienti, catalogo e ordini da cache locale, segnalati con un piccolo banner ambrato "Dati da cache offline".

Creare ordini offline

1. Crea un ordine normalmente (cliente → righe → invio)
2. Il pulsante diventa "Salva offline"
3. L'ordine viene salvato in una coda locale sul cellulare
4. In topbar appare un'icona ☁⬆ con il numero di ordini in coda
5. Nello storico, in cima, vedi una sezione arancione "Da inviare (N)"

Sincronizzazione automatica

1. Quando il cellulare torna online, NOX Agenti invia automaticamente gli ordini in coda, uno per uno
2. L'icona ☁⬆ in topbar si anima (sync in corso)
3. Se un ordine fallisce (es. dato errato) resta in coda con messaggio diagnostico
4. Puoi forzare un sync toccando l'icona ☁⬆ in topbar oppure il pulsante "Invia ora" nella sezione "Da inviare"

Se sei agente per più aziende, nella tab Profilo trovi la sezione "Azienda": mostra l'azienda attiva e l'elenco di quelle a te collegate. Tocca un'altra azienda per passarci — l'app aggiorna automaticamente clienti, catalogo e ordini su quelli della nuova azienda.

Come si collega una nuova azienda

Ogni azienda ti invia il suo link di accesso (magic link). Aprendolo dal telefono, quell'azienda si aggiunge alla tua lista: da quel momento compare nel selettore e puoi passarci quando vuoi. Riscatta i link di tutte le aziende per cui lavori e le avrai tutte a portata di tap.

Nota: il cambio azienda richiede la connessione (l'app riscarica i dati). Gli ordini ancora in coda appartengono all'azienda in cui li hai creati: inviali prima di cambiare azienda.

Vedo "Nessun cliente trovato" anche se so di averne

Verifica che il tuo soggetto agente in NOX abbia il flag "È un agente" attivo e che la email coincida con quella del tuo utente login. È così che NOX associa l'utente al soggetto agente.

L'ordine offline non parte quando torno online

Apri la tab Ordini, vai nella sezione "Da inviare" e premi "Invia ora". Se l'ordine resta in errore, leggi il messaggio diagnostico (es. "cliente non trovato", "voce catalogo non valida"): apri il NOX desktop, correggi e riprova.

L'icona nella schermata Home è sbagliata / vecchia

Tieni premuta l'icona, rimuovi l'app dalla home, poi reinstallala con i passi sopra. Le icone PWA vengono cachate dal sistema operativo e non si aggiornano da sole.

Vedo un banner blu "Nuova versione disponibile"

NOX è stato aggiornato dal team. Tocca "Aggiorna ora" per scaricare le novità. L'aggiornamento richiede pochi secondi e non perde i dati offline.