Impostazioni¶
Dove si trova: indirizzo /config/impostazioni — voce di menu Configurazione → Impostazioni.
A cosa serve¶
Raccoglie le opzioni generali dell'ambiente di lavoro: comportamenti automatici sulle anagrafiche, le funzioni del ciclo attivo (riconoscimento prodotti, listino), la lettura delle fatture elettroniche, la riconciliazione e la verifica degli itinerari. Da qui puoi anche esportare/importare in blocco le regole di mappatura e — con cautela — azzerare prodotti e attributi. Le opzioni valgono per tutto l'ambiente e hanno effetto immediato dopo il salvataggio.
Cosa vedi¶

Un'unica scheda con più sezioni, il pulsante Salva in fondo, e due riquadri aggiuntivi: Configurazione mapping (import/export) e la zona rossa Prodotti e attributi.
Cosa puoi fare¶
Anagrafiche¶
- Crea automaticamente fornitori/clienti mancanti al salvataggio: se al salvataggio di un documento un fornitore o cliente non è in anagrafica, viene chiesto all'operatore se crearlo al volo.
Location matching / itinerari¶
- Verifica itinerario (route) sui documenti con tappe: per i documenti con un modello di itinerario (es. mandati di trasporto), al termine dell'analisi le tappe vengono verificate per coerenza (carico → tappe intermedie → scarico), completando partenza e arrivo dai terminal indicati in testata. L'abbinamento indirizzo→destinazione a regole funziona comunque, anche a interruttore spento.
Ciclo attivo¶
- Product matching sui documenti ordine: per gli ordini, al termine dell'analisi ogni riga viene arricchita con gli attributi standardizzati del prodotto (categoria, materiale, misure, ...) tramite intelligenza artificiale. Attivandolo compaiono le opzioni collegate:
- Soglia confidenza (%) sotto cui usare l'AI: se il riconoscimento a regole sul codice ha una confidenza pari o superiore alla soglia, la riga è considerata risolta; sotto la soglia interviene l'IA sugli attributi (predefinito 70).
- Chiamate AI in parallelo (max): quante richieste di riconoscimento vengono eseguite contemporaneamente durante l'elaborazione (predefinito 15).
- Usa canale a coda: invece di elaborare le richieste una per una in linea, le invia in blocco su un canale di lavoro dedicato e il documento viene completato quando arrivano le risposte. Richiede che il servizio ricevente sia attivo.
- Ranking prodotti da attributi (pesi): regola come vengono ordinati i prodotti candidati. Il punteggio combina tre criteri — Match (quanti attributi combaciano), Copertura (quanti attributi del prodotto sono coperti) e Ordinamento (l'attributo di ordinamento: più basso è meglio) — ciascuno con il proprio peso (i pesi vengono riportati automaticamente a somma 1). Candidati (max) limita quanti prodotti candidati vengono proposti.
- Risoluzione codici via cross-reference: se il codice sull'ordine non è un codice prodotto interno, viene risolto tramite le corrispondenze codici della controparte (codice esterno → prodotto interno). Attivo di default.
- Estrai codici dalla descrizione: per le righe non risolte, cerca nella descrizione eventuali codici prodotto o corrispondenze e li verifica a catalogo (risolve solo se il codice è univoco). È una funzione euristica, disattiva di default. Attivandola compare:
- Lunghezza minima del codice: una parola della descrizione è considerata un possibile codice solo se la sua parte alfanumerica ha almeno questa lunghezza (predefinito 4).
- Listino avanzato: calcola il prezzo netto delle righe con sconti a cascata, scaglioni per quantità, sconto campagna, valori di riserva per classe/listino di default, maggiorazione per confezione e provvigioni; emette avvisi sulle righe. Disattivo di default. Attivandolo compare:
- Soglia basso stock (qtà): una riga è "in basso stock" se la giacenza disponibile è minore o uguale a questa quantità (e maggiore di zero); "esaurito" se pari o inferiore a zero.
Riconciliazione¶
- Verifiche avanzate con formule: abilita le regole di riconciliazione basate su formule (es. imponibile + IVA = totale, somma delle consegne = ordinato) su campi generici delle righe e dei documenti collegati, oltre al confronto base con tolleranze. Disattivo di default.
Fatture¶
- Lettura deterministica dell'XML fattura elettronica (SDI): se il file caricato è l'XML della fattura elettronica, testata e righe vengono lette direttamente dal file, con risultato identico ogni volta. Se mancano campi chiave (es. il riferimento all'ordine d'acquisto) il sistema ricade automaticamente sull'IA. Attivo di default.
- Lettura strutturata delle fatture elettroniche (stampa FatturaPA): se il PDF della fattura è la stampa standard dell'XML SDI, testata e righe vengono estratte da un algoritmo dedicato (solo le righe con codice articolo, unite ai riferimenti di ordine e DDT) invece che dall'IA.
Al termine clicca Salva: la notifica "Impostazioni salvate" conferma l'operazione.
Esportare/importare la configurazione di mapping¶
Il riquadro Configurazione mapping (import/export) gestisce in un unico file tutte le regole di mappatura dell'ambiente: regole di matching (codice, posizionale, dominio email), mapping dei soggetti, regole di listino e canali. È utile per replicare la configurazione da un ambiente di prova a quello di produzione.
- Esporta JSON scarica il file con la configurazione corrente.
- Importa JSON carica un file esportato in precedenza. Prima dell'import scegli con l'interruttore Sostituisci le regole esistenti all'import:
- attivo: le regole attuali vengono cancellate e sostituite da quelle del file;
- spento: le regole del file vengono aggiunte o aggiornate, senza cancellare le altre.
- La notifica riepiloga quante regole sono state importate per ciascun tipo.
Resettare prodotti e attributi¶
Nel riquadro rosso Prodotti e attributi, il pulsante Resetta attributi cancella tutti i prodotti caricati, gli import, gli attributi con i loro valori, le categorie, e rimuove i campi attributo aggiunti all'entità Prodotto. Viene chiesta conferma esplicita; al termine la notifica riepiloga quanti elementi sono stati eliminati.
Buono a sapersi¶
Il reset è irreversibile
Resetta attributi non è annullabile: usalo solo per ripartire da zero con il catalogo prodotti (es. dopo un import di prova). Tutti i dati elencati nella conferma vengono eliminati definitivamente.
Le soglie di automazione stanno altrove
Le soglie che decidono quando un documento salta la validazione manuale non sono in questa pagina: si configurano in Soglia automazione.