Skip to main content
POST
Risco CFOP

Consultar NFes por Classificação de Risco

Este endpoint permite consultar NFes classificadas por risco FIDC armazenadas no GuardaNFe utilizando CNPJ específico ou raiz CNPJ para análise de crédito e risco empresarial.
Classificação FIDCAs NFes são classificadas em 3 grupos de risco baseados nos CFOPs:
  • 🟢 Baixo Risco: Venda efetiva, crédito líquido e certo
  • 🟡 Médio Risco: Venda com incentivos, ST, triangulações ou consignação
  • 🔴 Alto Risco: Sem entrega ou crédito condicional

Endpoint

Headers

Parâmetros de Entrada

integer
default:"6"
required
Período em meses para análise de risco (mínimo: 1, 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
integer
default:"1"
Número da página para paginação (inicia em 1)
  • Tamanho fixo: 50 registros por página
  • Mínimo: 1

Exemplo de Requisição com Raiz CNPJ

Exemplo de Requisição com CNPJ Específico

Flexibilidade de Busca
  • Raiz CNPJ (8 dígitos): Analisa todo o grupo empresarial
  • CNPJ Completo (14 dígitos): Analisa empresa específica

📄 Paginação

Sistema de PaginaçãoA API implementa paginação automática com 50 registros por página:
  • Página padrão: Página 1 se não especificado
  • Tamanho fixo: 50 NFes por página para otimização
  • Controle total: Informações completas de navegação
  • Performance: Evita timeouts em consultas grandes

Exemplos de Navegação

Primeira Página
Segunda Página

Resposta

Exemplo de Resposta

Campos de Resposta

Cabeçalho da Resposta

Grupos de Risco

NFes por Risco

Classificação de Risco por CFOP

Venda efetiva, crédito líquido e certoCFOPs: 5101, 5102, 6101, 6102, 5405, 6405, 5151, 6151, 5933, 6933
  • Vendas de mercadorias
  • Vendas de produção própria
  • Transferências de produção própria
  • Operações com baixo risco de inadimplência

Casos de Uso

Análise de Crédito FIDC

Avaliação de Risco de CréditoUse a classificação de risco para avaliar a qualidade do crédito baseado nos CFOPs das operações

Due Diligence Empresarial

Análise de Grupo EmpresarialAvalie o perfil de risco de todo um grupo empresarial usando raiz CNPJ

Monitoramento de Carteira

Gestão de RiscoMonitore mudanças no perfil de risco de clientes ao longo do tempo

Precificação de Produtos

Pricing Baseado em RiscoAjuste taxas e condições baseadas na classificação de risco das operações

Tipos de Busca

Análise de Grupo EmpresarialBusca todas as empresas cujo CNPJ inicie com “10989834”:
  • 10989834000123 (Matriz)
  • 10989834000456 (Filial 1)
  • 10989834000789 (Filial 2)
Ideal para análise consolidada de risco do grupo

Códigos de Erro

Exemplos de Erro

Erro 400 - Parâmetros Inválidos
Erro 404 - Não Encontrado
Serviço Sob DemandaO GuardaNFe deve estar ativado em sua conta. Entre em contato com o suporte se não tiver acesso.

Otimização de Performance
  • Use períodos menores (3-6 meses) para análises frequentes
  • Use CNPJ específico quando possível para consultas mais rápidas
  • A classificação é baseada no primeiro CFOP encontrado na NFe