Envie a URL de qualquer nota fiscal eletrônica brasileira e receba os dados estruturados em segundos. Itens, preços, descontos e CNPJ. Todos os estados.
{ "ok": true, "invoice": { "store_fantasy": "Atacadão", "store_cnpj": "75315333000109", "total_amount": 214.87, "issued_at": "2026-05-19T11:22:00-03:00", "state": "Pernambuco" }, "items": [ { "name": "Arroz Branco", "ean": "7896006716113", "qty": 5, "unit": "kg", "unit_price": 4.98, "total_price": 24.90 }, { "name": "Frango Peito", "qty": 2.346, "unit": "kg", "unit_price": 19.90, "discount": 5.00, "total_price": 41.68 } ] }
Como funciona
Cole o link da nota fiscal que aparece no QR code do cupom — ou qualquer URL do portal SEFAZ estadual.
A API consulta a SEFAZ, faz o parse do XML padronizado e normaliza os dados — nome, EAN, qty, preços e descontos.
Dados prontos para usar no seu app. Estrutura consistente independente do estado ou do supermercado.
Integração
Um endpoint POST. Funciona com cURL, JavaScript, Python ou qualquer HTTP client.
curl -X POST https://nfparse.com.br/api/parse \
-H "Authorization: Bearer nfp_sua_chave" \
-H "Content-Type: application/json" \
-d '{"url":"https://nfce.sefaz.pe.gov.br/nfce/consulta?p=..."}'Detalhes
O XML da NF-e é nacional. Um único parser funciona do Acre ao Rio Grande do Sul, sem adaptadores por estado.
Parse direto do XML da SEFAZ. Sem browser headless, sem cold start lento, sem limite de memória.
Nome normalizado, EAN, qty, unit_price, gross_total, desconto e total líquido. Estrutura consistente sempre.
Retorna vProd, vDesc e total efetivamente pago. Essencial para apps de análise de gastos e reembolso.
Authorization: Bearer nfp_xxx. Sem OAuth, sem SDK obrigatório. Funciona com qualquer linguagem ou plataforma.
O contador zera sozinho a cada 30 dias. Sem precisar renovar token, sem webhook de cobrança inesperado.
Referência
/api/parseFaz o parse de uma NF-e ou NFC-e a partir da URL da SEFAZ.
Headers
AuthorizationrequiredBearer nfp_...Content-Typerequiredapplication/jsonBody JSON
urlrequiredURL da nota no portal SEFAZ estadual200Parse realizado com sucesso400URL inválida ou campo obrigatório ausente401API key inválida ou não informada422URL válida mas nenhum item extraído429Limite mensal de requisições atingido504Timeout na consulta à SEFAZ estadualPreços
Pagamento via PIX. Ativação em até 24h úteis.
Starter
1.000 req / mês
FAQ
Com quais estados funciona?
Todos os 27. O padrão XML da NF-e é nacional (SEFAZ federal). O estado é detectado automaticamente pela chave de acesso.
O que preciso para começar?
Crie sua conta gratuita em nfparse.com.br/signup. Você recebe uma chave no formato nfp_xxx no seu email em segundos.
Como funciona o pagamento?
PIX ou cartão de crédito. Nos planos pagos, você entra em contato por email, efetua o pagamento e a chave é atualizada em até 24h.
Os dados das notas são armazenados?
Não. A API faz o parse em tempo real e retorna o JSON. Nenhum dado da nota fiscal é persistido nos nossos servidores.
Qual o tempo de resposta médio?
Entre 1s e 4s, dependendo da latência da SEFAZ estadual. O timeout é de 20 segundos. A SEFAZ pode ser lenta em horários de pico.
Posso usar no plano gratuito para produção?
Sim. 100 req/mês são suficientes para projetos pequenos ou validação de produto. Sem cartão de crédito necessário.
Crie sua conta gratuita e comece a parsear notas fiscais em minutos.
Criar API key gratuita →100 req/mês · sem cartão · ativação imediata