Cosa contiene il file JSON
Il file descrive un documento fatto di pagine, una per ogni immagine che hai aggiunto, nell’ordine in cui le hai messe. Ogni pagina ha gli stessi dati di base, e i dettagli in più dipendono dalla modalità con cui è stata letta:
- Ogni pagina: il titolo (preso dal nome del file), la modalità di lettura e il testo.
- Pagine con tabelle: le righe della tabella, ognuna come elenco di celle, uguali alla griglia che vedi nell’editor.
- Pagine di scontrini e fatture: un elenco di campi, ognuno con una chiave, un’etichetta leggibile e un valore, più un elenco di righe.
- Pagine di codice: l’etichetta del linguaggio di programmazione, come Python o SQL, quando viene riconosciuto.
L’esportazione usa il risultato così come l’hai lasciato nell’editor, quindi le correzioni fatte prima del download finiscono nel file.
Un esempio ridotto da uno scontrino
Ecco come appare una pagina letta in modalità Scontrino o fattura, accorciata a pochi campi e righe:
{
"title": "lunch-receipt",
"createdAt": "2026-10-03T12:30:00.000Z",
"pages": [
{
"title": "lunch-receipt",
"mode": "receipt",
"text": "Corner Cafe\nFlat white 2 3.50 7.00\n...",
"receipt": {
"kind": "receipt",
"currency": "USD",
"fields": [
{ "key": "merchant", "label": "Business", "value": "Corner Cafe" },
{ "key": "date", "label": "Date", "value": "03/14/2026" },
{ "key": "tax", "label": "Tax", "value": "1.12" },
{ "key": "total", "label": "Total", "value": "15.12" }
],
"items": [
{ "description": "Flat white", "qty": "2", "unitPrice": "3.50", "amount": "7.00" },
{ "description": "Chicken wrap", "qty": "1", "unitPrice": "7.00", "amount": "7.00" }
]
}
}
]
}
Il modo più rapido per vedere la struttura completa è leggere lo scontrino di esempio di questa pagina e scaricarlo in JSON.
Quando serve convertire un’immagine in JSON
- Gestione delle spese. Leggi un gruppo di scontrini, controllali, esporta un unico file JSON e lascia che un tuo script sposti date e totali in un registro o in un foglio di calcolo. La pagina OCR scontrini ha consigli per fotografare bene gli scontrini.
- Data entry. Quando i valori di moduli stampati, listini prezzi o fatture devono finire in un altro sistema, i campi con un nome si mappano più facilmente di un blocco di testo.
- Dati di test. Chi sviluppa una funzione che gestisce scontrini, tabelle o testo scansionato può usare un vero output OCR, con i suoi errori realistici, come fixture per parser e codice di validazione.
- Archivi strutturati. Conservare modalità e campi insieme al testo rende più facile rielaborare in futuro le vecchie scansioni.
Se ti servono righe e colonne in un foglio di calcolo, immagine in Excel ci arriva con meno passaggi.
Gestire i valori nel codice
I valori restano il testo letto, esattamente come stampato, senza conversioni in numeri o date. Una data può essere 03/14/2026 o 14.03.2026 e un importo 1,250.00 o 1.250,00, a seconda della provenienza dello scontrino. Analizzali con i formati che ti aspetti e segnala tutto ciò che non corrisponde, così che lo controlli una persona.
Non dare nemmeno per scontato che ogni campo sia presente. Uno scontrino senza la riga della mancia non ha la mancia, e uno sbiadito può non avere la data. Usare la key invece della posizione nell’elenco mantiene il codice funzionante quando mancano dei campi. La key e la label dei campi riconosciuti sono in inglese, come nell’esempio, anche se usi il sito in italiano; i campi che aggiungi tu hanno l’etichetta che scrivi.
Vale anche la pena verificare i totali nel codice: la somma delle righe deve dare il subtotale, e subtotale più imposte, meno eventuali sconti, deve coincidere con il totale. Sugli scontrini italiani i prezzi sono di solito IVA inclusa, quindi l’IVA indicata è già compresa nel totale e non va sommata. Una differenza è un buon indizio che qualcosa è stato letto male.
Elaborato nel tuo browser, senza API
La lettura avviene nel tuo browser, sul tuo dispositivo, con il motore open source Tesseract. Le immagini non vengono caricate, e anche il file JSON viene creato sul tuo dispositivo.
Questo significa anche che non c’è un’API da chiamare né un endpoint a cui inviare le immagini. Immagine in JSON è un passaggio manuale: aggiungi le immagini, controlli i risultati e scarichi il file. È adatto ai lavori in cui comunque una persona rivede i dati, non a elaborare immagini in automatico in background. Se ti chiedi cosa significa OCR e cosa succede tra l’immagine e il testo, come funziona l’OCR lo spiega.