Troubleshooting della precisione OCR

Quando l'OCR legge male uno scontrino, il primo impulso è assumere che il motore OCR sia rotto. Nella nostra esperienza, il 90% delle letture errate ha una causa correggibile dal lato input — di solito un problema di foto.

Receipt Ripper segna i campi a bassa confidenza con un badge giallo — l'incertezza onesta del parser.

Gli otto pattern comuni

1. Numeri con sostituzioni di caratteri

Specificamente: 8 letto come 3, 0 letto come O o D, 5 letto come S o 6, 1 letto come I o l. Vengono da stampa a basso contrasto. Il fix è a monte: migliora la foto.

2. Nome del fornitore come gibberish

L'intestazione dello scontrino è spesso un logo stilizzato. L'OCR fatica con font non standard. Modifica il campo nella tabella di revisione.

3. Una riga manca interamente

Comune su scontrini termici dove una riga è parzialmente sbiadita. Il validatore lo segnala: somma(totali di riga) ≠ subtotale.

4. La data è sbagliata di un anno o un mese

Le date di scontrini arrivano in dozzine di formati. Quando lo scontrino è ambiguo (05/04/26), il parser disambigua dalla lingua dello scontrino.

5. Subtotale, tassa, totale non quadrano

Il validatore controlla che somma(righe) + tassa + mancia ≈ totale. Quando fallisce, guarda la foto originale e correggi il valore sbagliato.

6. La valuta è sbagliata

Un ristorante francese in Svizzera può stampare CHF, fr., o lasciare implicita. Il parser ricade sulla tua locale.

7. L'OCR è corso ma il parser non ha estratto nulla

Succede con layout molto insoliti. Riempi i campi manualmente.

8. L'elaborazione fallisce del tutto

Cause comuni: il file non è davvero un'immagine o PDF, il file è enorme e il dispositivo è andato fuori memoria, il motore OCR non si è caricato.

Un workflow di diagnosi

• Guarda la foto prima. La maggior parte delle letture errate sono problemi di foto.
• Guarda il suggerimento del validatore. Dice quale valore non quadra.
• Guarda i badge di confidenza. Tre o più gialli → rifare la foto.
• Rifare o ritagliare, non modificare campo per campo.
• Come ultima risorsa, modifica manualmente.

Cosa inviare quando si segnala un bug

• La foto o il PDF dello scontrino.
• Breve descrizione di cosa è andato male.
• Quale dovrebbe essere stato il risultato.
• Opzionale: paese / lingua / commerciante.

Manda a contact@receipt-ripper.com. Ogni scontrino segnalato diventa una fixture di test interna (dati personali oscurati).

Per foto pulite dall'inizio, vedi come fotografare uno scontrino.