Introdução
🔹 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
1️⃣ Obtendo o Token de Acesso
Para consumir a API, você precisa gerar um API Token. Siga os passos abaixo:
- Acesse o painel administrativo em admin.validanfe.com.
- Faça login com seu usuário e senha.
- Navegue até Configurações > API Token.
- Gere um novo API Token e copie-o para utilizá-lo nas requisições.
2️⃣ Utilizando o Token na Requisição
Todas as requisições para a API devem conter o token no cabeçalho X-API-KEY.
📌 Exemplo de requisição via cURL:
curl -X GET "https://api.validanfe.com/NFe/ConsultarNFe/35170608530528000184550000000154301000771561" \
-H "Accept: application/json" \
-H "X-API-KEY: SEU_API_TOKEN_AQUI"
📌 Exemplo de cabeçalhos na requisição:
GET /NFe/ConsultarNFe/{chave}
Host: api.validanfe.com
X-API-KEY: SEU_API_TOKEN_AQUI
Accept: application/json
📌 Controle de Acesso e Rate Limit
- Para garantir a estabilidade da API, aplicamos um limite de requisições.
- As chamadas para estas chaves podem ser feitas em produção e não serão cobradas ou descontadas do seu pacote.
- O limite de requisições para essas chaves também segue a regra de 5 chamadas por minuto.
- Caso o limite seja excedido, a API retornará o status 429 Too Many Requests.
✅ Chaves de Teste - Consluta Completa
As chaves abaixo podem ser usadas para testes em produção sem custos ou consumo do seu pacote de requisições:
| Chave NF-e | Observação |
|---|---|
87878774456468954646464654654546545446579312 | NF-e contedo todos os array |
35220241522703000167550010000001211000225472 | NF-e contendo evento de cancelamento |
22210841816302000110550000000000012824578529 | NF-e autorizada fora do prazo (cstat 150) |
41220211436073000147550010013215511002385213 | NF-e com uso denegado (cstat 302) |
📞 Suporte e Contato
Caso tenha dúvidas ou precise de suporte, entre em contato com nossa equipe pelo e-mail suporte@validanfe.com