Modulo Agenti & Provvigioni

Gestione agenti, maturazione provvigioni, liquidazioni con calcolo Enasarco e FIRR

v 2.5 Manuale Utente

Riferimenti normativi

1Pagina Agenti

La pagina Agenti e il punto di accesso centralizzato per la gestione della rete commerciale. Si compone di una griglia di card, una per agente, con la ricerca e i filtri in alto.

Card grid

Ogni card agente mostra: nome, codice, stato, tipo di contratto, provvigione base, zone di competenza, quante fatture ha gestito, email e cellulare. In alto il conto degli agenti e di quelli attivi.

Filtri

In alto: la casella Cerca agente e i pulsanti Attivi, Inattivi, Tutti. Gli agenti nel cestino non compaiono.

Dettaglio agente — 5 Tab

Il clic su una card apre la scheda di dettaglio, organizzata in cinque tab:

TabContenuto
AnagraficaRecapiti, partita IVA, codice fiscale e indirizzo (con Modifica anagrafica che porta alla scheda Soggetto), e la configurazione del contratto (vedi capitolo 2). Il riepilogo del contratto in alto si aggiorna appena salvi.
ProvvigioniI totali (da liquidare, sospese in attesa d'incasso, in liquidazione, pagate, annullate), l'elenco delle provvigioni con il filtro per stato, e le liquidazioni dell'agente (visibili appena si apre la scheda) con IVA, Enasarco agente, ritenuta, netto a pagare e FIRR a carico dell'azienda, i PDF Estratto conto e Nota, e le azioni Conferma, Paga, Annulla.
ObiettiviTarget di fatturato e/o volume assegnati per periodo. Barra di avanzamento, percentuale raggiungimento, premi legati al superamento soglia. Il Raggiunto è il fatturato vero dell'agente nel periodo dell'obiettivo, calcolato come nelle Statistiche: le note di credito tolgono, i premi e le provvigioni annullate non contano.
StatistichePer l'anno scelto (frecce per cambiare anno): fatturato e raggiungimento dell'obiettivo, provvigioni maturate, sospese, in liquidazione e liquidate, clienti gestiti, fatture elaborate, margine generato, DSO medio, premio maturato, top clienti, top articoli e andamento mese per mese.
Storico contrattoLe modifiche alla configurazione del contratto: campo, valore prima e dopo, chi e quando (vedi in fondo).
ⓘ Una nuova liquidazione si crea dalla scheda dell'agente (tab Provvigioni) o da Provvigioni Agenti (pulsante Nuova Liquidazione). La classifica degli agenti per venduto, con le provvigioni accanto, è in Reportistica → Top-N Parametrico (scheda Top Agenti, solo per l'amministratore).
2Configurazione Agente nel soggetto

Quando un soggetto ha il ruolo Agente attivo, nella sua scheda anagrafica appare la sezione di configurazione agente. Qui si definiscono tutti i parametri contrattuali e provvigionali.

  1. Aprire la scheda del soggetto e verificare che il ruolo Agente sia attivo.
  2. Compilare il Tipo contratto: monomandatario, plurimandatario, occasionale/procacciatore o dipendente (decide massimale Enasarco e scaglioni FIRR; occasionali e dipendenti non versano Enasarco).
  3. Inserire i dati del Mandato: data inizio, data fine (se a termine), zona esclusiva, rinnovo automatico.
  4. Definire la Provvigione base: percentuale predefinita applicata sul fatturato netto.
  5. Configurare le Provvigioni differenziate per categoria del catalogo (nella scheda agente) o per singolo cliente (la «Provvigione %» nei dati commerciali del cliente), se necessario.
  6. Impostare la Maturazione: alla fatturazione, all'incasso o alla consegna merce.
  7. Indicare le due quote Enasarco: quella dell'agente (si trattiene) e quella dell'azienda (si versa). Per mono e plurimandatari il programma propone le quote di legge e applica da solo il massimale dell'anno.
  8. Decidere se accantonare il FIRR: gli scaglioni dell'anno li applica il programma.
  9. Verificare la Ritenuta d'acconto (accesa per gli agenti nuovi) e l'IVA sulla provvigione (22%, o nessuna per forfettari e occasionali).
  10. Salvare la configurazione.
CampoDescrizioneNote
Tipo contrattoMonomandatario / Plurimandatario / Occasionale / DipendenteDetermina massimale Enasarco e scaglioni FIRR
Data inizio mandatoDecorrenza del rapporto di agenziaObbligatorio
Zona esclusivaZone commerciali assegnateArt. 1743 C.C.
% Provvigione basePercentuale predefinitaSovrascrivibile per riga
MaturazioneFatturazione / Incasso / ConsegnaArt. 1748 C.C.
Enasarco % agente / aziendaLe due quote del contributo (di legge 8,5% + 8,5%)Massimale dell'anno applicato dal programma
FIRRAccantonamento indennita, a carico dell'aziendaA scaglioni annui (AEC)
IVA sulla provvigione22% regime ordinario, nessuna per forfettari e occasionaliEntra nel netto a pagare
Ritenuta d'acconto23% sul 50% (20% con dipendenti o terzi)Art. 25-bis DPR 600/73
⚠ La modifica del tipo contratto (da monomandatario a plurimandatario o viceversa) cambia massimale Enasarco e scaglioni FIRR per le liquidazioni successive; quelle gia fatte restano come sono.

Parametri fiscali e di maturazione

Nella scheda di configurazione, la sezione «Fisco e maturazione» raccoglie i parametri che governano il calcolo:

  • Enasarco a carico agente — distinto dalla quota a carico del mandante: in liquidazione viene trattenuta all'agente la sola quota di sua competenza, applicando il massimale annuo sulla base.
  • Ritenuta d'acconto — attivabile per gli agenti persone fisiche: si applica l'aliquota (es. 23%) su una base ridotta (50% standard, 20% se l'agente si avvale in via continuativa di dipendenti/terzi). La ritenuta viene sottratta nel netto della liquidazione.
  • Regola di maturazione — alla fatturazione (subito), alla consegna (data del documento) o all'incasso: in quest'ultimo caso la provvigione resta sospesa e matura automaticamente quando il cliente salda il documento.
  • Base di calcolo — la provvigione (e gli scaglioni) possono essere calcolati sul fatturato (imponibile) oppure sul margine (imponibile meno costo).
  • Provvigioni per categoria — percentuali dedicate per categoria del catalogo (scelta da una tendina), che prevalgono sulla base quando l'articolo appartiene a quella categoria. L'ordine: % scritta sulla riga, poi categoria, poi % del cliente, poi scaglione (sull'imponibile dell'agente nel documento), poi base.
  • Premi al raggiungimento obiettivo — soglie di raggiungimento (%) con premio in euro, riconosciute quando l'agente supera l'obiettivo di fatturato (visibili nella scheda Statistiche).
3Provvigioni nei documenti

In ogni documento di vendita (ordine, DDT, fattura) e presente una tab Agente che consente di associare uno o piu agenti e gestire le provvigioni a livello di riga. Le provvigioni maturano solo con le fatture (o con il DDT per gli agenti «alla consegna»): sull'ordine la provvigione e solo indicata, e passa alla fattura che ne nasce.

  1. Aprire il documento di vendita e selezionare la tab Agente.
  2. L'agente viene proposto automaticamente in base al cliente (portafoglio agente). E possibile modificarlo manualmente.
  3. Per ogni riga il programma propone la percentuale con la regola dell'agente (categoria, cliente, scaglioni, base) e calcola l'importo: l'importo lo fa sempre il server, non si scrive a mano.
  4. Se necessario, scrivere una percentuale provvigione per riga: vale quella (zero esclude la riga); lasciata vuota torna quella della regola.
  5. E possibile assegnare agenti diversi a righe diverse dello stesso documento (es. vendita multi-zona).
  6. Alla conferma del documento, le righe provvigione vengono salvate con stato coerente alla regola di maturazione configurata per l'agente.
Campo ProvvigioneRigaDescrizione
AgenteSoggetto agente associato alla riga
% ProvvigionePercentuale applicata (da configurazione o override manuale)
Imponibile rigaBase di calcolo: importo netto della riga, meno la sua parte dello sconto di testata. Spese accessorie, bollo, anticipazioni e omaggi non portano provvigione.
Importo provvigioneCalcolato: imponibile x % provvigione
StatoMATURATA, IN_LIQUIDAZIONE o LIQUIDATA
Documento origineRiferimento al documento di vendita
ⓘ La generazione delle ProvvigioneRiga e automatica: il sistema applica le regole configurate nella scheda agente. L'utente interviene solo in caso di eccezioni o override manuali.
4Provvigioni Agenti

La sezione Provvigioni Agenti offre una vista consolidata di tutte le provvigioni generate dal sistema. E accessibile dal menu principale ed e il punto di controllo per la gestione del ciclo provvigionale.

Lista e filtri

La lista mostra tutte le righe provvigione con: fattura, data, agente, cliente, imponibile, percentuale, importo, stato e liquidazione. I filtri disponibili sono: agente, stato, numero del documento e periodo (dal/al, di partenza dal primo del mese).

KPI

In testa alla pagina, una barra di indicatori mostra: provvigioni da liquidare, sospese (attendono l'incasso), in liquidazione, pagate e il totale dell'anno sul fatturato; sotto la tabella, i totali delle righe mostrate.

Ciclo di vita della provvigione

StatoDescrizioneTransizione
SOSPESAAgente con maturazione all'incasso: la fattura non è ancora incassata tutta. Non entra in nessuna liquidazione.Matura da sola all'incasso; torna sospesa se l'incasso si annulla
MATURATALa provvigione e maturata secondo la regola configurata (fatturazione, incasso o consegna). E pronta per essere inclusa in una liquidazione.Automatica al verificarsi dell'evento di maturazione
IN_LIQUIDAZIONELa provvigione e stata inclusa in un documento di liquidazione in stato Bozza o Confermata.Inclusione nella liquidazione
LIQUIDATALa provvigione e stata pagata all'agente. La liquidazione corrispondente e in stato PAGATA.Pagamento della liquidazione
ANNULLATANon entra in nessuna liquidazione: documento annullato, oppure annullata a mano dall'elenco.Annullamento del documento o azione Annulla; Rimetti da liquidare la riporta indietro
⚠ Le provvigioni in stato LIQUIDATA non possono essere modificate. In caso di errore e necessario emettere una nota di credito sul documento di origine, che genera automaticamente uno storno provvigionale.
5Liquidazioni

La Liquidazione e il documento che raggruppa le provvigioni maturate di un agente in un determinato periodo e ne calcola il netto da corrispondere: provvigioni piu IVA, meno Enasarco a carico dell'agente e ritenuta d'acconto. FIRR e quota Enasarco dell'azienda si calcolano a parte e non riducono il netto.

Creazione di una liquidazione

  1. Dalla scheda dell'agente (tab Provvigioni, + Nuova Liquidazione) o da Provvigioni Agenti: scegliere l'agente e il periodo di riferimento (da/a).
  2. Il sistema prende le provvigioni maturate e libere del periodo: non quelle sospese in attesa d'incasso, nel cestino o gia in un'altra liquidazione. Per escluderne qualcuna: da Provvigioni Agenti si scelgono le righe e si usa «Crea liquidazione da selezionate», oppure si annullano le righe da non pagare.
  3. Il sistema calcola: totale provvigioni, IVA, contributo Enasarco (quota agente e quota azienda, entro il massimale dell'anno), accantonamento FIRR (a scaglioni sulle provvigioni dell'anno), ritenuta d'acconto e netto a pagare.
  4. La liquidazione nasce in stato BOZZA e le provvigioni incluse passano subito a IN_LIQUIDAZIONE.
  5. Premere Conferma per passare allo stato CONFERMATA (le provvigioni restano IN_LIQUIDAZIONE).
  6. Dopo il pagamento effettivo, registrare il pagamento per portare la liquidazione allo stato PAGATA. Solo ora le provvigioni passano a LIQUIDATA, da qualunque pagina si paghi.

Stati della liquidazione

StatoDescrizioneAzioni consentite
BOZZALiquidazione in preparazioneConferma, annullamento, cestino (le provvigioni tornano da liquidare)
CONFERMATALiquidazione validata, pronta per il pagamentoEstratto conto e Nota provvigionale in PDF, registrazione pagamento, annullamento (le provvigioni tornano da liquidare)
PAGATAPagamento effettuato e registratoConsultazione ed Estratto conto / Nota provvigionale in PDF; l'annullamento chiede di confermare che il pagamento e stato revocato

Calcolo Enasarco, FIRR e netto

VoceCalcoloRiferimento
Totale provvigioni lordoSomma importi provvigione incluse—
IVALordo x 22% (nessuna per forfettari e occasionali)Art. 21 DPR 633/72
Contributo Enasarco agenteLordo x aliquota agente, entro il massimale dell'anno (contando tutte le liquidazioni dell'anno, in qualunque ordine)Regolamento Enasarco
Contributo Enasarco preponenteLordo x aliquota azienda, entro lo stesso massimaleRegolamento Enasarco
Accantonamento FIRRCalcolato per scaglioni sulle provvigioni annueAEC
Ritenuta d'acconto23% sul 50% del lordo provvigionale (20% con dipendenti o terzi)Art. 25-bis DPR 600/73
Netto a pagareLordo + IVA − Enasarco agente − Ritenuta d'acconto—
ⓘ Il contributo Enasarco del preponente non viene detratto dal netto agente ma e un costo aziendale aggiuntivo. Il FIRR viene accantonato e versato annualmente alla Fondazione Enasarco. Una liquidazione senza provvigioni, nel cestino o con il totale negativo (piu storni che provvigioni) non si conferma e non si paga: gli storni si compensano con le provvigioni successive. Il pagamento non scrive ancora la prima nota ne il debito per ritenuta ed Enasarco: gli importi si leggono nel dettaglio della liquidazione (e nei suoi PDF) e si registrano a mano.
6Footer operativo

Il footer della pagina Agenti fornisce accesso rapido alle due viste operative principali:

Voce footerDescrizione
Tutte le ProvvigioniApre la vista consolidata di tutte le righe provvigione di tutti gli agenti, con filtri per agente, stato, numero del documento e periodo. Consente selezione multipla per creare liquidazioni, annullare, rimettere da liquidare o cestinare le righe scelte.
LiquidazioniApre l'elenco di tutte le liquidazioni emesse, con filtri per agente, stato (Bozza / Confermata / Pagata / Annullata) e anno. Da qui, scelte una o più liquidazioni, si confermano, si pagano o si annullano; il dettaglio di ognuna mostra il conto e i PDF. Le liquidazioni nuove si creano da Tutte le Provvigioni o dalla scheda dell'agente.
ⓘ Tutte e due le viste hanno il pulsante Esporta CSV (solo per l'amministratore): scarica le righe dell'elenco con i filtri applicati — tutte, non solo quelle della pagina che si vede — con gli stessi importi e le date come sullo schermo. I PDF (Estratto conto e Nota provvigionale) si scaricano dal dettaglio della singola liquidazione.
7Margine per agente

Quando il campo costo unitario è compilato nelle righe dei documenti, il sistema calcola il margine per ogni riga e per l'intero documento. Questo dato, incrociato con la provvigione dell'agente, permette di valutare la redditività netta delle vendite:

IndicatoreFormula
Margine lordoImponibile − (Costo × Quantità)
ProvvigioneImponibile × % Provvigione
Margine nettoMargine lordo − Provvigione
ⓘ Utilizzare questa analisi per identificare agenti con vendite ad alto volume ma basso margine netto, e calibrare le percentuali provvigionali di conseguenza.
8Integrazione con documenti

L'agente viene collegato ai documenti in tre modi:

  1. Automatico dal soggetto: se il cliente ha un agente di riferimento nella sua scheda anagrafica, viene assegnato automaticamente al documento.
  2. Manuale dal documento: nel tab Agente del documento, è possibile selezionare o cambiare l'agente e la percentuale provvigionale.
  3. Per riga: ogni riga del documento può avere un agente e una percentuale diversa (utile per vendite multi-agente).

Le provvigioni calcolate nei documenti alimentano la pagina Provvigioni Agenti dove si gestisce la maturazione, la liquidazione e l'ENASARCO.

✨Novità della v2.1 — Audit Contratto

Aggiornamento del modulo Agenti: tracciamento cronologico delle modifiche alla configurazione contrattuale (AgenteConfig).

Audit log della configurazione

Nella scheda dell'agente e stato aggiunto un nuovo tab 🕔 Storico contratto che elenca tutte le modifiche effettuate ai campi chiave della configurazione:

  • tipoContratto (MONOMANDATARIO / PLURIMANDATARIO / OCCASIONALE / DIPENDENTE)
  • provvigioneBase (% applicata di default)
  • provvigioneScaglioni e provvigioniCategorie (override per fascia fatturato e per categoria voce)
  • zone di competenza
  • numeroMandato, dataInizioMandato, dataFineMandato
  • aliquotaEnasarco, massimaleEnasarco, aliquotaFirr
  • noteContratto

Per ogni modifica il sistema registra valore precedente, valore nuovo, utente che ha salvato e data/ora. Si registrano solo le modifiche vere: salvare la scheda senza cambiare niente non aggiunge righe allo storico. Lo storico risponde alla domanda: “quando e perche abbiamo alzato la provvigione base di Rossi dal 5 al 7%?”

Endpoint API: GET /api/agenti/:id/config-audit-log. La tabella DB di riferimento e log_modifiche_agente_config.

Nota sul soft-delete

Gli Agenti sono rappresentati come Soggetti con isAgente=true, quindi beneficiano gia del soft-delete (cancellatoIl/cancellatoDa) e del cestino del modulo Soggetti. Non e stato introdotto un cestino separato sul modulo Agenti per non duplicare l'anagrafica.

?Domande frequenti (FAQ)
Quando matura effettivamente la provvigione?
Dipende dalla configurazione nella scheda agente. Se impostata su "Fatturazione", la provvigione matura alla conferma della fattura. Se "Incasso", matura solo quando il pagamento del cliente viene registrato. Se "Consegna", matura all'emissione del DDT, e la fattura differita che lo raggruppa non la matura una seconda volta. Ordini e preventivi non maturano mai. L'art. 1748 C.C. prevede che la provvigione spetti quando l'operazione e stata conclusa per effetto dell'intervento dell'agente.
Come gestisco un agente con provvigioni diverse per categoria articolo?
Nella scheda agente, sezione Configurazione, e possibile definire una tabella provvigionale per categoria articolo. La percentuale specifica per categoria prevale sulla provvigione base e su quella del cliente. In fase di inserimento documento, il sistema propone automaticamente la percentuale corretta in base all'articolo; una percentuale scritta a mano sulla riga prevale su tutte.
Cosa succede se emetto una nota di credito su una fattura con provvigioni gia liquidate?
Il sistema genera automaticamente righe di storno provvigionale con importo negativo. Queste righe verranno incluse nella liquidazione successiva, riducendo il totale lordo. Le provvigioni originali restano in stato LIQUIDATA per tracciabilita.
Come viene calcolato il massimale Enasarco?
Il massimale Enasarco e annuo e differenziato tra agenti monomandatari e plurimandatari. Il sistema tiene traccia del progressivo annuo di ogni agente (tutte le liquidazioni vive dell'anno di competenza delle provvigioni, in qualunque ordine siano state fatte) e smette di calcolare il contributo una volta raggiunto il massimale. I valori di ogni anno sono nel programma (2026: 30.478 € plurimandatario, 45.717 € monomandatario) e la scheda agente li mostra; se manca l'anno, la liquidazione usa l'ultimo noto e lo dice.
Posso annullare una liquidazione gia confermata?
Si: una liquidazione BOZZA o CONFERMATA si annulla con "Annulla", e le provvigioni incluse tornano allo stato MATURATA, da liquidare. Una liquidazione PAGATA si annulla solo confermando che il pagamento e stato revocato: le sue provvigioni tornerebbero liquidabili e si potrebbero pagare due volte.
Come gestisco il FIRR a fine anno?
Il sistema calcola l'accantonamento FIRR su ogni liquidazione con gli scaglioni dell'anno, tenendo conto di quanto gia liquidato nello stesso anno: la somma delle liquidazioni dell'anno e il FIRR da versare entro il 31 marzo dell'anno dopo. Un prospetto «Riepilogo FIRR» dedicato non c'e ancora: il FIRR di ogni liquidazione è nella colonna FIRR (azienda) della tabella Liquidazioni, nella scheda dell'agente: sommando quelle dell'anno si ha il totale da versare.
✓Certificazione v 2.2 — Presidi di compliance
🔑 Visibilità — Questo modulo è accessibile solo se:
• il pacchetto VENDITE_B2B è compreso nella licenza dell’azienda
• il modulo è acceso nella Aziende & Licenze, per l’azienda e per l’utente
Spento vuol dire bloccato, non solo nascosto. Dettagli in Licenza e Aziende & Licenze.

A partire dalla versione 2.2, il modulo Agenti adotta lo standard di certificazione NOX con i seguenti presidi:

Cestino e soft-delete

Gli elementi cancellati non vengono rimossi fisicamente ma spostati in un cestino interno (campi cancellatoIl / cancellatoDa). Dalla toolbar il pulsante Cestino alterna tra vista attivi e vista cestino. Dal cestino è possibile:

  • Ripristinare l'elemento (riportarlo nella lista attiva) — operazione riservata ad amministratori.
  • Eliminare definitivamente con motivazione obbligatoria — azione irreversibile, riservata ad amministratori, tracciata nell'audit log.

Azioni massive (bulk)

È possibile selezionare più elementi con le checkbox della prima colonna. Appare una barra inferiore con le azioni disponibili: Audit configurazione agente + obiettivi. La risposta indica N operazioni riuscite / M fallite; i dettagli delle fallite compaiono nella console browser (F12).

Storico modifiche (audit log)

L'icona history nelle azioni di riga apre un modal con la storia completa delle modifiche: data, campo, valore precedente, valore nuovo, operatore, eventuale motivazione. I record di audit non sono modificabili né eliminabili via UI. Conservazione: indefinita (art. 2220 c.c. — 10 anni minimo).

Mascheramento dati sensibili (GDPR art. 32)

Se i campi modificati contengono dati sensibili (IBAN, Codice Fiscale, Partita IVA, password/token), l'audit log salva il valore mascherato anziché in chiaro:

CampoEsempio originaleNel log
IBANIT60X0542811101000000123456IT60****3456
Codice Fiscale (PF)RSSMRA80A01H501ZRSSMRA****501Z
Partita IVA12345678901123****901
Password / token(qualsiasi)***REDACTED***

Timeline aggregata

Per ciascun elemento è disponibile una vista Timeline che aggrega in ordine cronologico audit, eventi del ciclo di vita ed eventuali entità collegate (es. documenti, movimenti, storni).

RBAC uniforme

Tutte le azioni distruttive o massive (soft-delete, ripristino, eliminazione definitiva, bulk, storno) richiedono il ruolo ADMIN o superiore. Gli operatori possono continuare a creare / modificare / consultare secondo le proprie abilitazioni.

ⓘIl DOCX di certificazione formale per questo modulo è disponibile: certificazione-agenti.docx (cartella manuali).
§Formato monetario nelle statistiche Agente — 1.234,00

Le statistiche del dettaglio Agente (Fatturato anno, Provvigioni maturate/liquidate, tabella mensile, obiettivi) e la lista agenti ora mostrano gli importi nel formato italiano corretto 1.234,00 con separatore migliaia di punto e virgola decimale.

Tutte le tab del dettaglio agente sono allineate:

  • Provvigioni: KPI da liquidare / sospese / in liquidazione / pagate / annullate, tabella imponibile-provvigione, tabella liquidazioni (visibile all'apertura della tab) con IVA, Enasarco agente, ritenuta, netto e FIRR a carico dell'azienda, e i PDF Estratto conto e Nota.
  • Obiettivi: Fatturato obiettivo, Fatturato raggiunto, Provvigione obiettivo.
  • Statistiche: KPI Fatturato anno, Provvigioni maturate/liquidate, andamento mensile.
  • Lista Agenti: provvigione base nelle card.

📱 PWA Agenti commercio — modulo /m

Nuovo modulo mobile-first per gli agenti di commercio: applicazione web installabile sul cellulare (PWA) per inserire ordini cliente direttamente dal campo, anche senza connessione di rete. Sincronizzazione automatica al ritorno online.

Come accedere

  • URL: https://www.gnox.it/m
  • Login con le stesse credenziali NOX (utente abilitato come Agente, oppure Admin / Superadmin).
  • L'utente Agente vede solo i propri clienti: il match avviene per email tra User.email e Soggetto.email (campo Soggetto con flag "È un agente").

Installazione sul cellulare

  • Android / Chrome / Edge: vai in Profilo → pulsante "Installa NOX Agenti", oppure usa il banner "Aggiungi a Home" che il browser propone spontaneamente.
  • iPhone / Safari: tocca l'icona Condividi (⮨) → "Aggiungi alla schermata Home". L'app si chiamerà "NOX Agenti" e partirà direttamente dalla home della PWA.

Funzionalità (5 tab)

  • Home: quick-action Nuovo ordine + lista degli ultimi 5 ordini con stato e totale.
  • Clienti: lista dei propri clienti con ricerca live (cognome/ragione sociale/codice/P.IVA/località), telefono ed email cliccabili. Tap sulla card pre-seleziona il cliente per il nuovo ordine.
  • Catalogo: voci attive con codice, descrizione, unità di misura, IVA e prezzo predefinito.
  • Nuovo ordine: wizard a 3 step (cliente → aggiungi articoli con quantità/prezzo/sconto/IVA modificabili → note + invio). Totali calcolati live. L'ordine viene creato in stato BOZZA; il numero progressivo definitivo viene assegnato dall'amministrazione al passaggio a CONFERMATO o EMESSO dal NOX desktop.
  • Regole dell'ordine: l'agente e la sua provvigione vanno sulle righe, così la fattura che nasce dall'ordine la matura. L'IVA si sceglie fra le aliquote attive dell'azienda. Un prezzo abbassato rispetto al catalogo conta come sconto nel limite di sconto dell'utente. Non si prendono ordini per un cliente bloccato o sospeso, né da un agente cessato o col mandato finito (che non vede più i clienti). Il prezzo d'acquisto e il margine di un articolo si vedono solo con il permesso «Vedere costi e margini».
  • Ordini: storico ultimi 90 giorni con filtri (Tutti / Bozza / Confermati / Emessi) e sezione "Da inviare" per ordini creati offline ancora in coda.
  • Profilo: identità agente, last-sync per ogni tabella, pulsanti Sincronizza ora / Svuota cache offline / Apri NOX desktop / Esci.

Modalità offline

L'app continua a funzionare anche senza rete: clienti, catalogo e storico vengono memorizzati in cache locale sul dispositivo (IndexedDB). Quando crei un ordine offline:

  • L'ordine viene salvato in coda locale; il pulsante diventa "Salva offline" per chiarezza.
  • Sul topbar appare un'icona ☁↑ con il numero di ordini in attesa; tap per forzare l'invio.
  • Al ritorno online la sincronizzazione è automatica: gli ordini in coda vengono inviati uno per uno, e in caso di errore restano in coda con messaggio diagnostico (potrai riprovare o correggerli manualmente dal NOX desktop).
  • Le pagine Clienti / Catalogo / Storico mostrano un banner ambrato "Dati da cache offline" quando i dati visualizzati non sono aggiornati alla rete.

Limiti attuali (Fase 1)

Per scelta progettuale la prima release non include: scanner barcode con fotocamera, allegati foto, invio diretto a SDI dal mobile. Queste feature sono valutabili in una Fase 2 evolutiva insieme alla decisione se mantenere PWA o passare a un binario nativo distribuito da App Store / Google Play (via wrapper Capacitor).

✨ Novità PWA Agenti — versione 1.1

La versione 1.1 dell'app Agenti introduce la firma elettronica del cliente e la rilevazione della posizione GPS direttamente sul nuovo ordine, oltre a una topbar più compatta. Il numero di versione è ora visibile nell'app.

Firma e posizione sul nuovo ordine

Nel wizard Nuovo ordine, dopo lo step «3. Note e Conferma» è stato aggiunto uno spazio per la firma del cliente col dito (firma su area touch) e per la rilevazione GPS della posizione, esattamente come nell'app Trasportatori per la firma dei DDT.

  • La firma è opzionale: se presente, l'app richiede anche il nome del firmatario.
  • La posizione GPS viene rilevata automaticamente al momento dell'invio (se il dispositivo concede il permesso di geolocalizzazione).
  • Firma e posizione vengono salvate anche in modalità offline insieme all'ordine in coda, e inviate al ritorno online.
  • Vengono memorizzate sul documento dell'ordine e restano consultabili dal NOX desktop.

Topbar più compatta

La barra superiore dell'app è stata ridotta in altezza (simile a quella del logo) per lasciare più spazio ai dati a schermo, utile soprattutto durante la composizione di un ordine.

Numero di versione visibile

La versione 1.1 è ora mostrata in app: come etichetta nella topbar e come riga «Versione 1.1» nella tab Profilo.

© NOX Enterprise Suite — Manuale Utente Modulo Agenti & Provvigioni v 2.5 by DPM Software - Francavilla al Mare (Chieti) ABRUZZO
Documento generato automaticamente. Tutti i diritti riservati.