Skip to main content
POST
/
GuardaNFe
/
Checar
Verificar NFe
curl --request POST \
  --url https://api.validanfe.com/GuardaNFe/Checar \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <x-api-key>' \
  --data '
{
  "chavesNFe": [
    {}
  ]
}
'
{
  "200": {},
  "400": {},
  "401": {},
  "500": {}
}

​
Objetivo

Este endpoint permite validar se chaves de acesso estão disponíveis nos servidores do GuardaNFe, indicando que as respectivas NF-e foram previamente armazenadas com sucesso.
Segurança GarantidaA verificação é restrita às NF-e associadas à sua conta, garantindo confidencialidade dos documentos.

​
Endpoint

​
Headers

​
Content-Type
string
default:"application/json"
Tipo de conteúdo da requisição
​
X-API-KEY
string
required
Token de autenticação da API

​
Body Parameters

​
chavesNFe
array
required
Lista de chaves de acesso das NF-e para verificação (44 caracteres cada)Exemplo: ["11220108333830000304550010000000881000001108"]

​
Exemplos de Requisição

curl -X POST "https://api.validanfe.com/GuardaNFe/Checar" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "X-API-KEY: SEU_TOKEN_AQUI" \
  -d '{
    "chavesNFe": [
      "11220108333830000304550010000000881000001108",
      "43210312345678000123450010000000201234567890"
    ]
  }'

​
Códigos de Resposta

​
200
Success
Verificação realizada com sucesso
​
400
Bad Request
Lista de chaves NF-e está vazia
​
401
Unauthorized
Token de autenticação ausente ou inválido
​
500
Internal Server Error
Erro ao verificar a existência dos arquivos

​
Exemplos de Resposta

{
  "11220108333830000304550010000000881000001108": { "exists": true },
  "43210312345678000123450010000000201234567890": { "exists": false }
}

​
Interpretando os Resultados

exists: true

NFe EncontradaO arquivo XML está presente no GuardaNFe e pode ser acessado

exists: false

NFe Não EncontradaO arquivo não foi encontrado ou não pertence à sua conta

​
Casos de Uso

Ideal para verificar o status de armazenamento de múltiplas NFe de uma só vez, otimizando o número de requisições.
Utilize para auditar quais NFe estão efetivamente armazenadas no GuardaNFe antes de gerar relatórios.
Integre com seus sistemas internos para verificar disponibilidade antes de solicitar downloads.
Limitações
  • Máximo de 100 chaves por requisição
  • Apenas NFe associadas à sua conta são verificadas
PerformancePara melhor performance, agrupe múltiplas chaves em uma única requisição ao invés de fazer múltiplas chamadas individuais.