Scan Types

Choose the right scan type: Receipt, Invoice, or Other

Panoramica dei tipi di scansione

Yomio offre tre tipi di scansione, ciascuno ottimizzato per un diverso tipo di documento. La scelta del tipo giusto è il fattore più importante per il successo dell'estrazione dei dati.

🧾

Ricevuta

Engine: Azure Document Intelligence

Best for: Scontrini cartacei fotografati con la fotocamera
Examples: Scontrini del supermercato, conti del ristorante, scontrini dei negozi al dettaglio, scontrini della stazione di servizio
Limitations: Funziona solo con foto di ricevute cartacee reali. Screenshot, pagine web e ordini digitali non saranno accettati.
How it works: L'immagine viene inviata al modello predefinito "prebuilt-receipt" di Azure DI, un sistema OCR specializzato addestrato su milioni di foto di scontrini reali.
📄

Fattura

Engine: Azure Document Intelligence

Best for: Fatture formali, bollette e documenti finanziari strutturati
Examples: Fatture di appaltatori, bollette delle utenze, abbonamenti a software, fatture di liberi professionisti
Limitations: Risultati ottimali con documenti digitali puliti. Le fatture scritte a mano o con annotazioni potrebbero presentare una precisione ridotta.
How it works: L'immagine viene inviata al modello di fattura predefinito di Azure DI, che riconosce i campi specifici della fattura.
📋

Altro

Engine: GPT-4o Vision (OpenRouter)

Best for: Screenshot, pagine web, conferme via e-mail e qualsiasi altro elemento non standard
Examples: Screenshot del carrello di un sito web, pagine di conferma dell’ordine, ricevute via e-mail, preventivi, stime
Limitations: Nessun limite specifico: gestisce praticamente qualsiasi immagine contenente testo.
How it works: L'immagine viene inviata a GPT-4o, un'intelligenza artificiale multimodale che analizza visivamente l'immagine ed estrae dati strutturati. Non è prevista alcuna fase separata di OCR. Gli elementi vengono classificati automaticamente.

Guida alle decisioni rapide

Non sai quale scegliere? Segui questo flusso:

1

Si tratta di una ricevuta cartacea rilasciata da un negozio o da un ristorante?

→ Choose: Ricevuta

2

Si tratta di una fattura formale o di una ricevuta (in formato PDF o cartacea)?

→ Choose: Fattura

3

Si tratta di uno screenshot, di una pagina web, di un’e-mail o di un ordine digitale?

→ Choose: Altro

4

La ricevuta o la fattura non sono state generate a causa di un errore?

→ Choose: Altro (riprova con questo tipo)

Scenari di guasto comuni

Ecco gli errori più comuni e come correggerli:

ScenarioYou choseResultShould beWhy
Screenshot del carrello di un sito web (Walmart, Amazon, IKEA, ecc.)Ricevuta❌ ERRORE — OCR_FAILEDAltroIl modello di riconoscimento delle ricevute di Azure DI richiede una foto di una ricevuta cartacea. Uno screenshot di un sito web presenta un layout, caratteri e contrasto diversi che il modello non è in grado di analizzare.
Screenshot di un'e-mail di conferma dell'ordineRicevuta❌ ERRORE — OCR_FAILEDAltroPer lo stesso motivo: il layout delle e-mail non è simile a quello delle ricevute.
Foto dello schermo di un computer su cui è visualizzato un PDF di una ricevutaRicevuta❌ ERRORE — OCR_FAILEDAltroI riflessi sullo schermo, gli effetti moiré e gli artefatti della griglia di pixel impediscono al modello OCR di leggere il testo in modo affidabile.
Foto di uno scontrino cartaceo del supermercatoRicevuta✅ SuccessoRicevutaCaso d'uso standard — funziona come previsto.
Fattura in formato PDF emessa da un appaltatoreFattura✅ SuccessoFatturaCaso d'uso standard — funziona come previsto.

⚠️Importante

Se una scansione non riesce con il tipo di ricevuta o fattura, NON ricaricare la stessa immagine. Invece, riprova utilizzando il tipo Altro: utilizza un motore di intelligenza artificiale completamente diverso (visione GPT-4o) in grado di gestire documenti non standard.

Come funziona

Ogni tipo di scansione indirizza la tua immagine a una pipeline AI diversa:

Fase di elaborazione delle ricevute/fatture (v1)

Route: POST /documents · Engine: Azure Document Intelligence

  1. Convalida dei file e caricamento su S3
  2. Azure DI OCR (prebuilt-receipt o prebuilt-invoice)
  3. Analisi della risposta in dati strutturati
  4. Creazione di spese con voci (classificate tramite una chiamata LLM separata)

Altra pipeline (v2)

Route: POST /v2/documents · Engine: GPT-4o Vision (OpenRouter)

  1. Convalida dei file e caricamento su S3
  2. Ottimizzazione delle immagini (rotazione automatica, ridimensionamento, nitidezza, contrasto)
  3. GPT-4o analizza l'immagine e restituisce un JSON strutturato
  4. Creazione di spese con voci precategorizzate (senza fase LLM separata)

Suggerimenti e best practice

✅ Do

  • Se possibile, scatta una foto della ricevuta cartacea: funziona meglio con il tipo “Ricevuta”
  • Seleziona “Altro” per qualsiasi screenshot, pagina web, e-mail o documento digitale
  • Se la scansione non va a buon fine, riprovare selezionando "Altro" prima di caricare nuovamente il file
  • Per ottenere risultati ottimali, assicurati che l'illuminazione sia adeguata e mantieni il documento ben disteso

❌ Don't

  • Non usare Receipt per gli screenshot dei siti web: non funzioneranno
  • Non caricare la stessa immagine due volte: basta modificare il tipo di scansione
  • Non utilizzare screenshot di schermi (monitor/telefono su cui è visualizzato un documento) con il tipo "Ricevuta"