Skip to main content
POST
Consultar Canceladas

Consultar NFes Canceladas por Raiz CNPJ

Este endpoint permite consultar NFes canceladas armazenadas no GuardaNFe utilizando raiz CNPJ (8 dígitos) para buscar todas as empresas de um mesmo grupo empresarial.
Funcionalidade AvançadaA consulta por raiz CNPJ permite encontrar NFes canceladas de todas as filiais de um grupo empresarial usando apenas os 8 primeiros dígitos do CNPJ.

Endpoint

Headers

Parâmetros de Entrada

integer
default:"12"
Período em meses para buscar NFes canceladas (máximo: 24)
string
required
CNPJ ou raiz CNPJ para filtrar:
  • 8 dígitos: Raiz CNPJ (busca todas as filiais)
  • 14 dígitos: CNPJ específico

Exemplo de Requisição com Raiz CNPJ

Raiz CNPJ (8 dígitos)Ao informar apenas 8 dígitos (ex: “10989834”), o sistema buscará todas as empresas cujo CNPJ inicie com estes dígitos, incluindo todas as filiais do grupo empresarial.

Resposta

Exemplo de Resposta

Campos de Resposta

Cabeçalho da Resposta

NFes Canceladas

Eventos de Cancelamento

Casos de Uso

Auditoria Empresarial

Análise de Grupo EmpresarialUse a raiz CNPJ para auditar cancelamentos de todas as empresas do mesmo grupo

Análise de Risco

Comportamento FiscalAvalie padrões de cancelamento para análise de risco de crédito

Tipos de Busca

Busca todas as empresas cujo CNPJ inicie com “10989834”:
  • 10989834000123 (Matriz)
  • 10989834000456 (Filial 1)
  • 10989834000789 (Filial 2)

Códigos de Erro

Serviço Sob DemandaO GuardaNFe deve estar ativado em sua conta. Entre em contato com o suporte se não tiver acesso.

Dica de PerformanceUse raiz CNPJ (8 dígitos) para análises amplas de grupos empresariais e CNPJ completo (14 dígitos) para consultas específicas.