🧾 OCR de DANFE e Nota Fiscal: extraia os dados por foto ou PDF

Tem só a DANFE ou uma foto da nota fiscal? Este Actor extrai os dados com IA e devolve tudo estruturado em JSON: chave de acesso, emitente, destinatário, valores e os itens em formato tabular - pronto para o seu sistema, planilha ou ERP.

🎯 Feito para a nota fiscal brasileira. Como a DANFE tem campos conhecidos (NF-e modelo 55 e NFC-e modelo 65), a extração é direcionada a eles - mais assertiva que um OCR genérico.

ℹ️ Este Actor lê a imagem/PDF que você envia (não consulta a SEFAZ). Se você tem a chave de acesso e quer o XML oficial, use o Consulta NFe por Chave.

---

O que você recebe (por documento)

Campo	Descrição
chaveAcesso	Chave de acesso de 44 dígitos
numero, serie, modelo	Identificação da nota (55 = NF-e, 65 = NFC-e)
dataEmissao, naturezaOperacao	Emissão e natureza da operação
emitenteRazaoSocial, emitenteCnpj, emitenteInscricaoEstadual...	Dados do emitente
destinatarioNome, destinatarioCnpjCpf...	Dados do destinatário
valorTotalProdutos, valorIcms, valorTotalNota...	Valores e impostos
itens[]	Produtos da nota em tabela (código, descrição, NCM, CFOP, qtd, valor unitário, total)

---

Como usar

Faça upload da DANFE/foto no campo de input, ou informe URLs para lote:

{
  "documentos": [
    "https://upload.wikimedia.org/wikipedia/commons/9/97/Nfe.png"
  ]
}

Aceita PDF, PNG, JPG e WebP. Até 50 documentos por execução. PDFs são lidos nativamente (multipágina); imagens são otimizadas antes da análise.

---

Precificação

Cobrado por nota extraída com sucesso (evento danfe-extraida). Documentos que falham no download ou não são notas fiscais não geram cobrança.

---

Exemplo de saída

[
  {
    "documentoUrl": "https://upload.wikimedia.org/wikipedia/commons/9/97/Nfe.png",
    "sucesso": true,
    "chaveAcesso": "43090890627936000130550010000001750008965360",
    "numero": "000175", "serie": "1", "modelo": "55",
    "dataEmissao": "2009-08-26",
    "naturezaOperacao": "Venda de mercadoria",
    "emitenteRazaoSocial": "Empresa Teste LTDA.",
    "emitenteCnpj": "90627936000130",
    "destinatarioNome": "Cliente Exemplo",
    "destinatarioCnpjCpf": "00000000000",
    "valorTotalProdutos": 230.0, "valorIcms": 41.4, "valorTotalNota": 230.0,
    "itens": [
      { "codigo": "001", "descricao": "Produto A", "ncm": "00000000", "cfop": "5102", "unidade": "UN", "quantidade": 1, "valorUnitario": 100.0, "valorTotal": 100.0 },
      { "codigo": "002", "descricao": "Produto B", "ncm": "00000000", "cfop": "5102", "unidade": "UN", "quantidade": 1, "valorUnitario": 130.0, "valorTotal": 130.0 }
    ],
    "metadadosArquivo": { "tipo": "png", "tamanhoBytes": 84210, "paginas": null },
    "motivoFalha": null,
    "processadoEm": "2026-01-01T12:00:00.000Z",
    "erro": null
  }
]

---

Perguntas frequentes

Que documentos funcionam melhor? DANFEs em PDF e fotos/scans nítidos. Imagens muito escuras, tortas ou de baixa resolução podem não ser lidas - o motivo vem em motivoFalha.

Funciona com NFC-e (cupom) e DANFE de NF-e? Sim, ambos (modelo 55 e 65). Os itens vêm em formato tabular nos dois casos.

Posso enviar vários de uma vez? Sim, até 50 por execução, via upload múltiplo ou lista de URLs.

Posso chamar em tempo real? Sim. O endpoint Standby POST /extrair responde de forma síncrona. Veja abaixo.

---

🔌 Integração via API

Execução em lote:

curl -X POST "https://api.apify.com/v2/acts/brasildados~danfe-nota-fiscal-ocr/run-sync-get-dataset-items?token=SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"documentos":["https://upload.wikimedia.org/wikipedia/commons/9/97/Nfe.png"]}'

Standby (POST /extrair):

curl -X POST "https://brasildados--danfe-nota-fiscal-ocr.apify.actor/extrair" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  --compressed \
  -d '{"documentos":["https://upload.wikimedia.org/wikipedia/commons/9/97/Nfe.png"]}'

O token vai no header Authorization: Bearer, nunca na URL.

---

Actors relacionados

Actor	Descrição
Consulta NFe por Chave	Já tem a chave? Busque o XML e o DANFE oficiais
Baixar NF-e em Lote	XML + DANFE de várias chaves num ZIP
Enriquecimento por CNPJ	Dados cadastrais completos por CNPJ

---

Legal

Este Actor analisa os documentos que você envia. Você é responsável por ter o direito de processá-los e os dados pessoais/fiscais que contiverem.