Skip to main content

​
Comece em 3 passos simples

Faça sua primeira consulta à API ValidaNFe e integre com seus sistemas.

​
Passo 1: Obtenha suas credenciais

  1. Acesse admin.validanfe.com
  2. Cadastre-se ou faça login em sua conta
  3. Complete o processo de verificação
Contas novas recebem créditos gratuitos para testes!
  1. No painel administrativo, vá para Configurações > API Token
  2. Clique em “Gerar Novo Token”
  3. Copie e guarde seu token com segurança
  4. Configure variáveis de ambiente em sua aplicação
Mantenha seu token seguro e nunca o compartilhe publicamente.

​
Passo 2: Faça sua primeira consulta

Faça uma consulta de teste usando uma chave NFe de exemplo:
curl -X GET "https://api.validanfe.com/NFe/ConsultarNFe/35170608530528000184550000000154301000771561" \
  -H "Accept: application/json" \
  -H "X-API-KEY: SEU_TOKEN_AQUI"
Use uma das chaves de teste gratuitas para experimentar sem custos.
const consultarNFe = async (chave) => {
  const response = await fetch(`https://api.validanfe.com/NFe/ConsultarNFe/${chave}`, {
    headers: {
      'Accept': 'application/json',
      'X-API-KEY': process.env.VALIDANFE_API_KEY
    }
  });
  
  return await response.json();
};

// Uso
const nfe = await consultarNFe('35170608530528000184550000000154301000771561');
console.log(nfe);

​
Passo 3: Integre com sua aplicação

  1. Configure autenticação segura com variáveis de ambiente
  2. Implemente tratamento de erros e rate limiting
  3. Configure webhooks para notificações automáticas
  4. Teste com dados reais em ambiente de homologação
  5. Deploy para produção

​
Próximos Passos

Agora que você fez sua primeira consulta, explore estes recursos:

Consulta Completa

Obtenha todos os detalhes da NFe incluindo produtos e impostos

API GuardaNFe

Armazene suas NFe com segurança na nuvem

Webhooks

Receba notificações automáticas sobre suas consultas

Bibliotecas

Use nossas SDKs para principais linguagens

​
Chaves de Teste Gratuitas

Use estas chaves para testar a API sem custos:
Chave NFeDescrição
87878774456468954646464654654546545446579312NFe com todos os arrays preenchidos
35220241522703000167550010000001211000225472NFe com evento de cancelamento
22210841816302000110550000000000012824578529NFe autorizada fora do prazo
Precisa de ajuda?Entre em contato: [email protected] ou acesse nossa documentação completa.