Jev AI per estrarre dati da email e fatture: prima trovare, poi scegliere

Jev AI può selezionare il valore di un campo tra candidati già trovati nel testo. Nel flusso proposto, preparazione, normalizzazione e controlli hanno passaggi distinti, con una verifica prima dell'importazione.

La differenza tra trovare un importo e capire cosa rappresenta

In un'email può comparire più di un numero: prezzo, quantità, riferimento d'ordine e telefono. In una fattura possono esserci importi di riga, imponibile, imposta e totale. Il lavoro non consiste soltanto nel riconoscere le cifre; bisogna stabilire quale valore rappresenti il campo richiesto e a quale documento appartenga.

Il cookbook ufficiale sull'estrazione da valori preparati separa la raccolta dei candidati dalla loro selezione semantica. Il codice può poi recuperare il testo associato alla scelta. Se il parser non trova il valore giusto, la selezione non può recuperarlo da un elenco incompleto.

Questo metodo è diverso dalla produzione libera di un oggetto con campi compilati. La scelta ha un perimetro esplicito: valori disponibili, campo richiesto e opzione per l'assenza. La panoramica su Jev AI spiega il ruolo del componente; qui ci interessa progettare la catena che rende utilizzabile il risultato nel gestionale.

Definisci quindi il campo prima di costruire la chiamata. Totale del documento, importo da pagare e saldo residuo possono essere valori diversi. Se l'addetto amministrativo li distingue nel lavoro, il progetto deve mantenere la distinzione. Un'etichetta generica come importo rende difficile valutare se il risultato sia corretto.

Il file passa da una preparazione controllata

Jev riceve testo; PDF e immagini richiedono preparazione separata. Nel flusso qui proposto, XML e formati strutturati usano i loro parser; i documenti visivi richiedono una preparazione adeguata. Il risultato viene collegato al file originale e agli eventuali segnali di errore.

Quando il formato offre già un campo strutturato affidabile, verifica prima se sia sufficiente una lettura deterministica. Non serve introdurre una decisione AI per copiare un valore che il software sa già identificare. La parte semantica può essere utile nei messaggi liberi, nei riepiloghi o quando più valori plausibili devono essere associati a un ruolo.

Per i PDF con tabelle, conserva indicazioni di pagina e posizione quando disponibili. Un importo estratto senza l'intestazione della colonna può perdere il proprio significato. Per le email, distingui il nuovo messaggio dalla conversazione citata: una scadenza presente in un vecchio inoltro può non riguardare la richiesta attuale.

La guida su come importare ordini PDF nel gestionale affronta il processo complessivo. Qui l'output del passaggio di preparazione è una raccolta controllabile: ogni candidato ha un identificativo, un valore originale e una provenienza. Se la preparazione fallisce, il flusso non deve presentare i campi come verificati.

Candidati riconoscibili, non soltanto una lista di numeri

Un identificativo del candidato permette al software di recuperare l'occorrenza corretta anche quando lo stesso valore compare due volte. Considera 122,00 presente sia nel totale corrente sia in un riepilogo storico. Le due stringhe sono uguali, ma i riferimenti sono diversi. La selezione deve riguardare il candidato con il suo contesto.

La tabella mostra un esempio ipotetico molto semplice. Non è un payload API né un output osservato; gli identificativi servono a illustrare il legame tra valore e provenienza.

L'opzione dato assente è parte del processo. Può essere scelta quando nessun candidato soddisfa il campo; il software deve distinguerla da un errore tecnico e da una verifica fallita. L'operatore può allora cercare nel file, chiedere una precisazione o lasciare il campo non confermato secondo la procedura aziendale.

Per evitare confusione, mostra anche quali parti del documento sono state considerate. Un numero trovato in una firma o in una nota non deve sembrare equivalente a un importo nel riepilogo. Questo contesto rende più semplice sia la selezione sia la revisione, senza dover produrre una spiegazione libera.

Normalizzare soltanto dopo aver scelto l'occorrenza

Il valore originale serve a controllare la fonte; il valore normalizzato serve al software. Per un importo, definisci separatori, valuta e rappresentazione interna. Per un codice, verifica se gli zeri iniziali sono significativi. Per un telefono, stabilisci quali trasformazioni siano consentite senza perdere un'estensione o un riferimento utile.

Non cambiare il valore originale quando correggi la rappresentazione. Mantieni una coppia riconoscibile, così l'operatore può capire perché 1.234,50 diventa una quantità numerica e perché un codice che sembra un numero resta testo. La validazione del formato è separata dalla correttezza del ruolo: una cifra ben formata può ancora essere il subtotale sbagliato.

Nel caso aritmetico semplice della tabella, il software verifica 100 + 22 = 122. È un calcolo dell'esempio, non una regola sufficiente per tutte le fatture. Sconti, ritenute, acconti, arrotondamenti o più riepiloghi richiedono controlli coerenti con il documento e con il gestionale. Le regole devono essere approvate da chi possiede il processo amministrativo.

La classificazione documentale con Jev AI può precedere questi controlli, perché il tipo di documento determina quali campi cercare. Una nota di credito, un preventivo e una fattura non devono avanzare nello stesso percorso soltanto perché contengono un totale.

Date: distinguere l'espressione dal calendario

Un'email può chiedere una consegna venerdì, entro fine mese o due giorni dopo l'approvazione. In questi casi bisogna conservare l'espressione e decidere quali dati la rendono risolvibile. Il cookbook sulla date extraction propone scelte limitate e validazioni applicative. Data di riferimento, fuso e regole del calendario restano necessari nel codice.

Immagina un messaggio inoltrato lunedì che contiene una richiesta scritta il venerdì precedente. L'espressione domani può riferirsi al messaggio originario, non alla ricezione dell'inoltro. Il flusso deve usare il riferimento pertinente o segnalare l'ambiguità. Fare un calcolo corretto su una data iniziale sbagliata produce comunque un campo inutilizzabile.

Un'espressione condizionata, come dopo l'approvazione, richiede inoltre un evento che può non essere ancora avvenuto. Puoi conservarla come condizione e attendere il dato applicativo. Se una regola aziendale genera poi una scadenza, rendila riconoscibile come calcolo: non è una data letta nel documento.

La guida a confidence e revisione umana è utile per i segnali di incertezza. Nel progetto, una data che cambia consegna o pagamento può richiedere un controllo anche quando la selezione appare netta. L'effetto del campo sul processo determina quanto approfondire la verifica.

Prima di importare un campo, segui questi quattro controlli

1. La fonte contiene davvero l'occorrenza selezionata?
2. Il candidato rappresenta il ruolo richiesto, nel documento corretto?
3. La normalizzazione conserva il significato del valore originale?
4. Le regole applicative consentono l'importazione o chiedono una revisione?

Un campo può superare i primi tre controlli e richiedere comunque una conferma prima dell'azione aziendale.

Scenario ipotetico: amministrazione di una PMI a Milano

Una PMI italiana ipotetica riceve una fattura e un riepilogo allegato. Il testo preparato contiene gli importi 100,00, 22,00 e 122,00 del documento corrente, oltre a un importo identico relativo a una pratica precedente. L'addetto deve compilare il totale per una proposta di registrazione.

Il parser assegna identificativi distinti alle occorrenze. Jev viene utilizzato per selezionare il candidato pertinente, mentre il software recupera il valore originale e applica normalizzazione e controllo aritmetico del caso semplice. Se il candidato è quello storico, la presenza di una somma coerente altrove non basta a correggere la scelta: serve un controllo sulla fonte.

La schermata mostra quindi il campo insieme al riepilogo da cui proviene. L'addetto conferma o corregge prima dell'importazione. Le eventuali autorizzazioni per registrare il documento restano nel gestionale. Se manca un dato necessario, il documento resta in una coda di completamento senza valori inventati.

La prova valuta separatamente candidati mancanti, scelte errate e verifiche applicative fallite. Un numero complessivo di campi compilati nasconderebbe problemi diversi. Lo scenario è illustrativo: non dimostra una prestazione di Jev o un risparmio amministrativo di Giallo.

Scenario ipotetico: ricambi industriali a Modena

Una seconda PMI italiana ipotetica riceve ordini via email. Il cliente elenca due codici, menziona il prezzo del precedente acquisto e chiede la consegna nella settimana successiva. La firma contiene telefono e riferimenti che sembrano codici numerici. Il flusso deve preparare una scheda da controllare, non confermare la vendita.

La preparazione distingue prodotti richiesti, testo storico e firma. I candidati per i codici mantengono il contesto e passano da una verifica sul catalogo. Il prezzo menzionato non viene assunto come prezzo corrente: il gestionale applica le condizioni aggiornate. La richiesta di consegna resta un dato da confrontare con disponibilità e calendario.

Se il codice non è trovato, il sistema segnala il campo anziché scegliere quello più simile senza una regola. Se la data relativa è ambigua, la scheda conserva l'espressione originale e chiede verifica. L'operatore può completare i campi e approvare il passaggio all'attività successiva.

Questo esempio mostra perché estrazione e decisione commerciale non coincidono. Trovare il codice indicato dal cliente non certifica che il ricambio sia adatto; recuperare la richiesta di consegna non promette che l'azienda possa rispettarla. I controlli del processo vengono dopo i campi.

Progettare una revisione per campo, non una rilettura indistinta

Per il pilota, costruisci una scheda di riferimento con il valore atteso e l'occorrenza che lo giustifica. Il confronto deve poter riconoscere quattro situazioni: il candidato corretto non è stato trovato; il candidato esiste ma la scelta è sbagliata; la scelta è giusta ma la trasformazione altera il dato; il campo è coerente ma non supera una regola del processo. Ogni situazione richiede un intervento diverso e un responsabile riconoscibile.

Includi documenti in cui il campo sia assente. Sono utili per verificare che la coda non presenti una compilazione plausibile come un dato confermato. Inserisci inoltre casi con due occorrenze uguali, numeri in un riferimento storico e formati diversi tra fornitori. La raccolta deve riprodurre il lavoro degli addetti, non soltanto il percorso più semplice.

Quando il referente corregge un campo, conserva il motivo e la fase che ha richiesto l'intervento. Se la stessa cifra viene selezionata dalla pagina sbagliata, la correzione deve restare collegata alla fonte; salvare soltanto il valore finale farebbe apparire il risultato corretto senza mostrare l'errore. Questo registro permette di migliorare la preparazione, i criteri o la schermata, scegliendo il punto del processo che ha prodotto il problema.

Il cookbook SDE cascade esplora un percorso con un estrattore, verifiche per campo e un modello più capace per i casi segnalati. È un pattern da valutare; i risultati del suo esempio non sono una garanzia sul proprio processo. Nel progetto, conviene scegliere prima quali errori debbano provocare un approfondimento.

Una revisione utile mostra soltanto i campi da controllare con la loro fonte, lasciando disponibili gli altri. Il referente vede se manca un candidato, se ci sono più occorrenze plausibili o se un controllo è fallito. Così può correggere la causa e non soltanto sovrascrivere il dato finale.

Il confronto dei modelli per l'estrazione documentale serve a valutare il componente di preparazione e i casi complessi. Mantieni la prova sul documento intero e sui singoli campi: una buona selezione non compensa un candidato assente, e una fonte corretta non compensa una validazione saltata.

Per collegare questi passaggi al gestionale, usa un'integrazione controllata come descritta nella guida alle API di Jev AI. Stima separatamente preparazione, chiamate, storage e tempo di revisione con l'articolo sui costi dell'automazione con Jev. Giallo può costruire l'automazione del processo a partire da campi, fonti e controlli realmente disponibili.

Progetta con Giallo un'estrazione dati che conserva fonti, candidati e verifiche prima del gestionale.