Converter imagem em JSON

O que o arquivo JSON contém

O arquivo descreve um documento formado por páginas, uma para cada imagem que você adicionou, na ordem em que você as colocou. Toda página traz as mesmas informações básicas, e os detalhes extras dependem do modo em que ela foi lida:

• Todas as páginas: o título (tirado do nome do arquivo), o modo em que foi lida e o texto.
• Páginas de tabela: as linhas da tabela, cada uma como uma lista de células, igual à grade que você vê no editor.
• Páginas de recibo e nota fiscal: uma lista de campos, cada um com uma chave, um rótulo legível e um valor, além de uma lista de itens.
• Páginas de código: o nome da linguagem de programação, como Python ou SQL, quando ela é reconhecida.

A exportação usa o resultado do jeito que você deixou no editor, então as correções que você faz antes de baixar vão para o arquivo.

Um exemplo resumido de um recibo

Veja como fica uma página lida no modo Recibo, reduzida a alguns campos e itens:

{
  "title": "lunch-receipt",
  "createdAt": "2026-10-03T12:30:00.000Z",
  "pages": [
    {
      "title": "lunch-receipt",
      "mode": "receipt",
      "text": "Corner Cafe\n2 Flat white 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" }
        ]
      }
    }
  ]
}

O jeito mais rápido de ver a estrutura completa é ler o recibo de exemplo desta página e baixar o resultado em JSON.

Onde imagem para JSON é útil

• Fluxos de despesas. Leia um lote de recibos, revise, exporte um único arquivo JSON e deixe seu próprio script levar datas e totais para um livro-caixa ou uma planilha. A página de OCR de recibos tem dicas para conseguir fotos de recibos bem limpas.
• Digitação de dados. Quando valores de formulários impressos, listas de preços ou notas fiscais precisam entrar em outro sistema, campos nomeados são mais fáceis de mapear do que um bloco de texto.
• Dados de teste. Desenvolvedores que criam um recurso que lida com recibos, tabelas ou texto digitalizado podem usar a saída real do OCR, com seus erros realistas, como fixtures para parsers e código de validação.
• Arquivamento com estrutura. Guardar o modo e os campos junto com o texto facilita processar digitalizações antigas de novo mais tarde.

Se o que você precisa são linhas e colunas numa planilha, imagem para Excel leva você até lá com menos passos.

Como tratar os valores no seu código

Os valores são mantidos como o texto que foi lido, exatamente como estão impressos, em vez de convertidos em números ou datas. Uma data pode vir como 03/14/2026 ou 14.03.2026, e um valor pode vir como 1,250.00 ou 1.250,00, dependendo de onde o recibo veio. Converta esses valores com os formatos que você espera e marque o que não se encaixar para uma pessoa conferir.

Também não conte com a presença de todos os campos. Um recibo sem linha de gorjeta não tem gorjeta, e um recibo desbotado pode estar sem data. Usar a key em vez da posição na lista mantém seu código funcionando quando faltam campos.

Vale também conferir os totais no código: os valores dos itens devem somar o subtotal, e o subtotal mais o imposto, menos qualquer desconto, deve bater com o total. Uma diferença é um bom sinal de que algo foi lido errado.

Processado no seu navegador, sem API

A leitura acontece no seu navegador, no seu próprio dispositivo, com o motor de código aberto Tesseract. As imagens não são enviadas, e o arquivo JSON também é criado no seu dispositivo.

Isso também significa que não há API para chamar nem endpoint de servidor para onde enviar imagens. O Imagem para JSON é uma etapa manual: você adiciona as imagens, confere os resultados e baixa o arquivo. Ele serve para tarefas em que uma pessoa revisa os dados de qualquer forma, e não é um jeito de processar imagens automaticamente em segundo plano. Se você tem curiosidade sobre o que acontece entre a imagem e o texto, como funciona o OCR explica.