Scan Types

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

Visão geral dos tipos de digitalização

Yomio oferece três tipos de digitalização, cada um otimizado para um tipo diferente de documento. A escolha do tipo certo é o fator mais importante para o sucesso da extração de dados.

🧾

Recibo

Engine: Azure Document Intelligence

Best for: Physical paper receipts photographed with your camera
Examples: Recibos de supermercado, contas de restaurante, recibos de lojas de retalho, recibos de postos de abastecimento
Limitations: Só funciona com fotografias de recibos em papel reais. Capturas de ecrã, páginas da Internet e encomendas digitais não serão aceites.
How it works: A imagem é enviada para o modelo «prebuilt-receipt» do Azure DI — um OCR especializado, treinado com milhões de fotografias reais de recibos.
📄

Fatura

Engine: Azure Document Intelligence

Best for: Faturas formais, contas e documentos financeiros estruturados
Examples: Contractor invoices, utility bills, software subscriptions, freelancer invoices
Limitations: Funciona melhor com documentos digitais nítidos. As faturas manuscritas ou com anotações podem apresentar uma precisão reduzida.
How it works: A imagem é enviada para o modelo de fatura pré-definido do Azure DI, que reconhece os campos específicos da fatura.
📋

Other

Engine: GPT-4o Vision (OpenRouter)

Best for: Capturas de ecrã, páginas web, confirmações por e-mail e qualquer elemento que não seja padrão
Examples: Capturas de ecrã do cesto de compras de sites, páginas de confirmação de encomendas, recibos por e-mail, orçamentos e estimativas
Limitations: Sem limites específicos — processa praticamente qualquer imagem que contenha texto.
How it works: A imagem é enviada para o GPT-4o — uma IA multimodal que analisa a imagem visualmente e extrai dados estruturados. Não é necessária uma etapa separada de OCR. Os itens são categorizados automaticamente.

Guia de Decisão Rápida

Não sabe qual o tipo escolher? Siga estes passos:

1

Is it a physical paper receipt from a store or restaurant?

→ Choose: Recibo

2

Trata-se de uma fatura formal ou de uma nota de cobrança (em PDF ou impressa)?

→ Choose: Fatura

3

Is it a screenshot, web page, email, or digital order?

→ Choose: Outros

4

A emissão do recibo ou da fatura falhou devido a um erro?

→ Choose: Outro (tente novamente com este tipo)

Cenários comuns de falha

Eis os erros mais comuns e como corrigi-los:

ScenarioYou choseResultShould beWhy
Screenshot of a website shopping cart (Walmart, Amazon, IKEA, etc.)Recibo❌ ERRO — OCR_FAILEDOtherO modelo de recibo do Azure DI espera uma fotografia de um recibo em papel. Uma captura de ecrã de um site apresenta um layout, tipos de letra e contraste diferentes, que o modelo não consegue analisar.
Screenshot of an order confirmation emailRecibo❌ ERRO — OCR_FAILEDOutrosSame reason — email layouts are not receipt-like.
Fotografia de um ecrã de computador a mostrar um recibo em formato PDFRecibo❌ ERROR — OCR_FAILEDOutrosO brilho do ecrã, os padrões de moiré e os artefactos da grelha de píxeis impedem que o modelo de OCR leia o texto de forma fiável.
Photo of a paper grocery receiptRecibo✅ SucessoReceiptCaso de utilização padrão — funciona conforme o esperado.
Fatura em PDF de um prestador de serviçosInvoice✅ SucessoFaturaStandard use case — works as expected.

⚠️Importante

Se uma digitalização falhar com o tipo «Recibo» ou «Fatura», NÃO volte a enviar a mesma imagem. Em vez disso, tente novamente utilizando o tipo «Outro» — este utiliza um motor de IA completamente diferente (GPT-4o vision) que consegue processar documentos não padronizados.

Como funciona

Cada tipo de digitalização encaminha a sua imagem para um fluxo de trabalho de IA diferente:

Fluxo de trabalho de recibos/faturas (v1)

Route: POST /documentos · Engine: Azure Document Intelligence

  1. Validação de ficheiros e carregamento para o S3
  2. Azure DI OCR (recibo pré-definido ou fatura pré-definida)
  3. Response parsing into structured data
  4. Criação de despesas com itens (categorizadas através de uma chamada LLM separada)

Outro pipeline (v2)

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

  1. Validação de ficheiros e carregamento para o S3
  2. Image optimisation (auto-rotate, resize, sharpen, contrast)
  3. O GPT-4o analisa a imagem e devolve dados em formato JSON estruturado
  4. Criação de despesas com itens pré-categorizados (sem etapa LLM separada)

Dicas e melhores práticas

✅ Do

  • Take a photo of the physical receipt when possible — it works best with Receipt type
  • Selecione «Outro» para qualquer captura de ecrã, página web, e-mail ou documento digital
  • If a scan fails, retry with Other before uploading again
  • Para obter os melhores resultados, certifique-se de que a iluminação é adequada e mantenha o documento bem esticado

❌ Don't

  • Don't use Receipt for website screenshots — they will fail
  • Não carregues a mesma imagem duas vezes — basta alterar o tipo de digitalização
  • Não utilize capturas de ecrã de ecrãs (monitor/telemóvel a mostrar um documento) com o tipo «Recibo»