Skip to main content

​
Visão Geral

A API de Consulta NF-e permite a consulta de Notas Fiscais Eletrônicas (NF-e) utilizando a chave de acesso. Para acessar os endpoints da API, é necessário um token de autenticação que pode ser gerado no painel administrativo.

​
Autenticação na API

​
Obtendo o Token de Acesso

Para consumir a API, você precisa gerar um API Token:
1

Acesse o Dashboard

Vá para admin.validanfe.com
2

Faça Login

Entre com seu usuário e senha
3

Navegue até Configurações

Acesse Configurações > API Token
4

Gere o Token

Crie um novo API Token e copie-o

​
Utilizando o Token

Todas as requisições para a API devem conter o token no cabeçalho X-API-KEY: 
curl -X GET "https://api.validanfe.com/NFe/ConsultarNFe/35170608530528000184550000000154301000771561" \
  -H "Accept: application/json" \
  -H "X-API-KEY: SEU_API_TOKEN_AQUI"

​
Rate Limiting

Limite de RequisiçõesPara garantir a estabilidade da API, aplicamos um limite de 5 chamadas por minuto. Caso excedido, você receberá o status 429 Too Many Requests.
Chaves de Teste GratuitasAs chaves de teste podem ser usadas em produção sem custos ou consumo do seu pacote.

​
Chaves de Teste

Use estas chaves para testar a API sem custos:
Chave NF-eObservação
87878774456468954646464654654546545446579312NF-e contendo todos os arrays
35220241522703000167550010000001211000225472NF-e contendo evento de cancelamento
22210841816302000110550000000000012824578529NF-e autorizada fora do prazo (cstat 150)
41220211436073000147550010013215511002385213NF-e com uso denegado (cstat 302)

​
Base URL

A URL base para todos os endpoints da API NFe é: 
https://api.validanfe.com

​
Próximos Passos

NFe Resumida

Consulte informações básicas da NFe

NFe Completa

Consulte dados completos da NFe

Webhook Subscriptions

Configure notificações automáticas

Webhook Deliveries

Monitore entregas de webhooks
Precisa de Ajuda?Entre em contato: [email protected]