ForHosting KIT · Ler texto de imagem (OCR)

Como extrair dados de nota fiscal

Serviço que serve para extrair dados de nota fiscal a partir do documento visual — o DANFE em PDF, a nota fotografada no balcão, a nota de serviço em papel. Devolve emitente, destinatário, CNPJ, itens, valores e impostos em campos estruturados. Para contadores, financeiros e MEIs que recebem nota em todo formato, menos no que precisam.

● Estávelpor páginaUS$ 0,009

Executar — US$ 0,009 + US$ 0,0571/página Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Rode online

Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.

Quando você tem o DANFE, mas não o XML

Vamos ao ponto que economiza seu dinheiro: se você tem o XML da NF-e, não precisa de OCR — o XML já é dado estruturado, é só ler. O problema real é outro: o fornecedor que só manda o DANFE em PDF, a nota antiga que sobrou impressa, a NFC-e fotografada no balcão, a nota de serviço da prefeitura que veio em papel. É para esses casos que esta ferramenta existe: quando o documento visual é tudo o que você tem, ela reconstrói os dados que o XML teria te dado.

O que sai de cada nota

Os campos que o financeiro e o contador realmente usam: razão social e CNPJ do emitente e do destinatário, número e série da nota, data de emissão, chave de acesso de 44 dígitos, relação de itens com quantidades e valores unitários, totais e impostos destacados. Tudo em formato estruturado, pronto para alimentar o ERP, a planilha de entrada de mercadorias ou o sistema do escritório contábil. Valores no padrão brasileiro — R$ 12.345,67 — são lidos exatamente como impressos, sem trocar vírgula por ponto no meio do caminho.

Foto de nota tirada no balcão também vale

Nem toda nota chega em PDF comportado. A leitura aceita foto de celular do documento impresso — a NFC-e do mercado, o DANFE que veio junto da mercadoria, a nota térmica que já começou a apagar. As regras de sempre ajudam: luz decente, documento inteiro no quadro, foco nas letras miúdas. Campos ilegíveis voltam vazios em vez de adivinhados, o que importa muito em documento fiscal: errar um dígito de CNPJ em silêncio seria bem pior que sinalizar que ele não foi lido.

O preço mais baixo da categoria de leitura visual

US$ 0,009 por chamada mais US$ 0,0571 por página — abaixo do preço das outras leituras visuais do catálogo, porque nota fiscal é o documento de maior volume no Brasil e o custo precisa acompanhar. Cem notas de uma página saem por cerca de US$ 5,05. A cobrança é por uso, em dólares americanos, sem mensalidade: quem processa 30 notas em julho e 300 em dezembro paga exatamente isso. O limite técnico é o mesmo das demais: 25 MB e até 10 páginas por chamada.

Da extração à planilha do contador

O destino natural dos dados extraídos é a rotina contábil: a planilha de notas do mês, o lançamento de entrada no estoque, o arquivo que o escritório pede todo dia 5. Com os campos estruturados, montar esses formatos deixa de ser trabalho manual — inclusive para lotes grandes, disparando uma chamada por nota em paralelo. Uma conferência por amostragem fecha o fluxo: escolha algumas notas, compare com o original e confirme que os totais batem antes de subir o lote inteiro para o sistema.

Casos de uso

O contador que recebe DANFE em vez de XML

Um escritório contábil em Curitiba cansou de pedir XML e receber PDF. Agora processa os DANFEs recebidos dos clientes e monta a planilha de escrituração com os campos extraídos, cobrando o XML só quando indispensável.

Entrada de mercadorias na distribuidora

A Distribuidora Horizonte Verde S.A. fotografa o DANFE que acompanha cada carga na doca e lança itens e quantidades no estoque em minutos, antes mesmo de a mercadoria sair da conferência.

MEI organizando as compras do ano

Thiago Barbosa Lima, MEI, guarda notas de compra numa pasta do celular. No fim do mês, extrai os dados de todas e mantém o controle de despesas em ordem para a declaração anual — sem contador fixo e sem digitação.

Notas fotografadas chegando pelo WhatsApp

Os vendedores externos de uma empresa mandam foto das notas de despesa pelo WhatsApp. O financeiro roda a extração no lote da semana e concilia com os adiantamentos de viagem automaticamente.

Perguntas frequentes

Funciona com NF-e, NFC-e e NFS-e?

Funciona com a representação visual de qualquer uma delas: DANFE de NF-e, cupom de NFC-e e nota de serviço municipal, em PDF ou foto. O que estiver impresso no documento é o que a extração devolve — cada prefeitura tem seu leiaute de NFS-e, e a leitura visual lida com essa variedade justamente por não depender de modelo fixo.

Se eu tenho o XML da nota, ainda preciso disto?

Não — e preferimos te dizer isso a cobrar por página. O XML já contém todos os dados estruturados. Esta ferramenta é para quando o XML não existe ou não chegou: só o PDF, só o papel, só a foto.

A chave de acesso de 44 dígitos sai completa?

Sim, ela é um dos campos extraídos. Vale a conferência de praxe em documento fotografado com qualidade ruim: dígitos ilegíveis voltam sinalizados em vez de inventados, exatamente para você não levar uma chave errada para o sistema.

Vocês consultam a Sefaz para validar a nota?

Não. A ferramenta extrai os dados do documento; ela não verifica autenticidade nem situação da nota junto ao fisco. Com a chave de acesso em mãos, a consulta no portal oficial fica a um passo — mas esse passo é seu.

Como é a cobrança para um volume mensal variável?

Proporcional ao uso: US$ 0,009 por chamada mais US$ 0,0571 por página, em dólares americanos, sem franquia nem mensalidade. Mês fraco custa pouco, mês forte custa proporcional — e o preço publicado não muda no meio do caminho.

Vocês emitem nota fiscal do valor que eu pagar pelo serviço?

Resposta honesta: não emitimos NF-e brasileira — o serviço é internacional e o pagamento acontece via PayPal, que gera recibo da transação. Esse comprovante documenta a despesa em moeda estrangeira; consulte seu contador sobre o lançamento adequado.

Notas fiscais têm CNPJ, endereço e dados de negócio. Qual o tratamento?

Os documentos enviados são usados unicamente para gerar a extração devolvida a você. Sua empresa permanece controladora dos dados nos termos da LGPD; o processamento ocorre por instrução sua e para seu uso exclusivo.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/ocr/invoice

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/ocr/invoice \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"image":"https://ejemplo.com/factura.jpg"}'

const res = await fetch("https://api.kit.forhosting.com/ocr/invoice", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "image": "https://ejemplo.com/factura.jpg"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/ocr/invoice",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "image": "https://ejemplo.com/factura.jpg"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/ocr/invoice", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"image":"https://ejemplo.com/factura.jpg"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"image":"https://ejemplo.com/factura.jpg"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ocr/invoice", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "image": "https://ejemplo.com/factura.jpg"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "ocr.invoice",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,009

por páginaUS$ 0,0571

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`max_mb`	25
`max_pages`	10

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.
`413`	`input_too_large`	A entrada passou do tamanho máximo desta tarefa. Confira os limites publicados.
`422`	`task_failed`	A tarefa falhou do nosso lado. Você não paga nada por ela.

Ver a documentação completa do KIT →