# Schema di estrazione documentale

Definisci esattamente cosa significa ciascun campo prima di estrarlo. Un output con la struttura corretta può comunque contenere dati sbagliati o privi di supporto nel documento.

Revisione: 2026-09-24

## Quando usarlo

Quando si vuole estrarre dati da richieste, conferme, fatture o altri documenti e trasferirli a un sistema operativo.

## Risultato atteso

Uno schema per famiglia documentale con significato dei campi, regole di validazione, evidenze e gestione dell’assenza di dati.

## 1. Definisci documento e destinazione

Separa famiglie che usano gli stessi nomi con significati diversi. Descrivi il risultato necessario al processo, evitando di raccogliere ogni dato disponibile.

### Famiglia, formati e varianti

Indica documenti inclusi, lingue, scansioni, allegati e versioni da escludere o trattare separatamente.

________________

### Destinazione e uso dei campi

Spiega quale sistema riceve i dati e quali decisioni o azioni dipendono da essi.

________________

### Identità del documento e delle righe

Definisci riferimento stabile, versione e modo di distinguere righe, pagine e documenti duplicati.

________________

> Esempio illustrativo, da sostituire: Esempio ipotetico: estrarre una conferma d’ordine fornitore per confrontarla con l’ordine originale. Non trattare un preventivo come conferma solo perché presenta codici e prezzi.

## 2. Specifica i campi

Compila una riga per campo. Distingui ciò che è presente nel documento da ciò che può essere calcolato tramite una regola esplicita e verificabile.

### Nome, significato e obbligatorietà

Descrivi campo, tipo e condizioni in cui serve; chiarisci termini ambigui come data o totale.

________________

### Formato, unità e normalizzazione

Indica formato data, valuta, separatori, unità e trasformazioni ammesse senza perdere il valore originale.

________________

### Evidenza e valore mancante

Richiedi riferimento a pagina o testo; definisci cosa restituire quando il campo è assente o ambiguo.

________________

> Esempio illustrativo, da sostituire: Esempio ipotetico: “data_consegna” indica una data esplicitamente attribuita alla consegna, non all’emissione. Se il documento dice soltanto “da concordare”, il campo resta vuoto con motivo.

## 3. Controlla prima dell’uso

Combina controlli deterministici e revisione delle ambiguità. Non correggere silenziosamente importi o codici per far passare una validazione.

### Controlli di campo e tra campi

Elenca formati, coerenza di totali, corrispondenza con anagrafiche e regole con tolleranze esplicite.

________________

### Condizioni di revisione

Definisci quali campi critici, conflitti o documenti illeggibili devono fermare la scrittura.

________________

### Casi di prova e riferimento corretto

Prepara esempi ordinari, mancanti e discordanti con risultati verificati da chi conosce il documento.

________________

> Esempio illustrativo, da sostituire: Esempio ipotetico: quantità per prezzo non coincide con il totale riga. Conservare entrambi i valori e richiedere revisione, senza inventare uno sconto per spiegare la differenza.

## Errori da evitare

- Usare il nome di un campo senza definirne il significato operativo.

- Riempire dati mancanti con ipotesi che sembrano plausibili.

- Accettare un JSON valido come prova che i dati siano corretti.

Stolen Orbit — https://stolenorbit.com/it/modelli/schema-estrazione-documenti/