Skip to main content
POST
Verificar NFe

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

string
default:"application/json"
Tipo de conteúdo da requisição
string
required
Token de autenticação da API

Body Parameters

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

Exemplos de Requisição

Códigos de Resposta

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

Exemplos de Resposta

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.