Análise de Risco Positivo - PJ

Name: FonteData
Author: FonteData

GET https://app.fontedata.com/api/v1/consulta/boa-vista-risco-pj

R$ 14,64 por consulta

Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.

Permite validar dados cadastrais e avaliar o perfil de risco de pessoas jurídicas através de uma consulta estruturada por CNPJ. O endpoint realiza uma análise comportamental da empresa, integrando informações sobre histórico de pagamentos, compromissos comerciais, restrições financeiras, composição societária e indicadores de governança.

A consulta retorna um score de risco com classificação numérica e alfabética (ABC), além de probabilidade de inadimplência, facilitando decisões sobre concessão de crédito, avaliação de fornecedores e monitoramento contínuo da saúde financeira. Os resultados incluem detalhes registrais, fiscais e comportamentais da empresa, fornecendo uma visão integrada para análise de risco de crédito.

Casos de uso:

Onboarding de clientes e fornecedores
Análise de elegibilidade para concessão de crédito
Avaliação de probabilidade de inadimplência
Suporte a decisões comerciais baseadas em score e indicadores positivos
Monitoramento periódico da situação financeira e comportamental

Requisição

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/boa-vista-risco-pj?cnpj=SEU_CNPJ"

Parâmetros

Nome	Tipo	Descrição	Exemplo
cnpj obrigatório	CNPJ	CNPJ (somente números, 14 dígitos)	00.000.000/0000-00

Resposta

A consulta retorna um objeto estruturado contendo:

Dados cadastrais e registrais: CNPJ, razão social, nome fantasia, natureza jurídica, inscrição estadual, NIRE, tipo de sociedade, data de fundação e data de encerramento (se aplicável).

Informações comerciais: Ramo de atividade (primário e secundário), código CNAE, capital social, porte da empresa, faixa de funcionários, quantidade de filiais e cidades onde opera.

Endereço: Logradouro completo, bairro, cidade, UF e CEP.

Contato: Telefone e endereço de e-mail.

Score e indicadores de risco: Pontuação geral, tipo de score, classificação ABC, classificação numérica, descrição do score, probabilidade de inadimplência e nível de risco associado.

Decisões registrais: Código e descrição da situação atual, situação no cadastro de contribuinte (Sintegra) e observações.

Indicadores comportamentais: Histórico de crédito obtido, compromissos assumidos, pagamentos pontuais, pagamentos atrasados, eventos relacionados à pessoa jurídica, período de relacionamento com fornecedores e tendências de pontuação mensal.

Restrições: Pendências financeiras (quantidade, valores, prazos, credores e provedores), protestos, cheques sem fundo (BACEN e varejo), condenações cíveis, contumácia, falências e recuperações judiciais.

Governança: Lista de administradores com cargo e data de entrada, lista de sócios com percentual de participação e tipo de documento.

Alertas: Avisos relevantes sobre a empresa.

Histórico de consultas: Registro das datas e dados retornados em buscas anteriores.

Exemplo — 200 OK

{
  "cnpj": "string",
  "nire": "string",
  "email": null,
  "porte": null,
  "score": {
    "risco": "string",
    "score": "string",
    "texto": "string",
    "layout": "string",
    "execucao": null,
    "tipoScore": "string",
    "descrPlano": "string",
    "descrScore": "string",
    "informante": "string",
    "modeloScore": null,
    "classificacaoABC": "string",
    "classificacaoNumero": "string",
    "probabilidadeInadimplencia": "string"
  },
  "nireUf": "string",
  "alertas": [
    {
      "tipo": "string",
      "titulo": "string",
      "observacao": "string"
    }
  ],
  "decisoes": {
    "layout": "string",
    "descricao": "string",
    "codigoSituacao": "string"
  },
  "situacao": "string",
  "enderecos": [
    {
      "uf": "string",
      "cep": "string",
      "bairro": "string",
      "cidade": "string",
      "numero": "string",
      "logradouro": "string",
      "complemento": null
    }
  ],
  "telefones": [],
  "restricoes": {
    "protestos": {
      "dataMaior": null,
      "dataUltimo": null,
      "quantidade": "string",
      "valorMaior": null,
      "valorTotal": null,
      "ocorrencias": [],
      "valorUltimo": null,
      "dataPrimeiro": null,
      "valorPrimeiro": null,
      "ultimoProtesto": null
    },
    "contumacia": {
      "quantidade": "string",
      "dataUltimaOcorrencia": null,
      "dataPrimeiraOcorrencia": null
    },
    "acoesCiveis": {
      "dataMaior": null,
      "dataMenor": null,
      "dataUltimo": null,
      "quantidade": "string",
      "valorMaior": null,
      "valorMenor": null,
      "valorTotal": null,
      "ocorrencias": null,
      "valorUltimo": null,
      "dataPrimeira": null,
      "valorPrimeiro": null
    },
    "limiteCredito": {
      "texto": null,
      "valor": "string",
      "descricao": null
    },
    "chequesSemFundoBacen": {
      "documento": "string",
      "quantidade": "string",
      "tipoPessoa": "string",
      "correntista": "string"
    },
    "faturamentoPresumido": {
      "faixa": null,
      "dataReferencia": null,
      "valorPresumido": null,
      "faturamentoAnual": null,
      "dadosCadastroPositivo": null
    },
    "chequesSemFundoVarejo": {
      "documento": "string",
      "quantidade": "string",
      "tipoPessoa": "string",
      "correntista": "string"
    },
    "pendenciasFinanceiras": {
      "dataMaior": null,
      "provedores": [
        "string"
      ],
      "quantidade": "string",
      "valorMaior": null,
      "valorTotal": null,
      "ocorrencias": [],
      "dataPrimeiro": null,
      "periodoFinal": null,
      "totalCredores": null,
      "valorPrimeiro": null,
      "periodoInicial": null,
      "ultimoVencimento": null
    },
    "falenciaRecuperacaoJudicial": {
      "quantidade": "string",
      "ocorrencias": null,
      "periodoFinal": null,
      "periodoInicial": null
    }
  },
  "governancas": {
    "socios": [
      {
        "nome": "string",
        "documento": "string",
        "tipoDocumento": "string",
        "situacaoDocumento": "string",
        "percentualParticipacao": "string"
      }
    ],
    "administradores": [
      {
        "nome": "string",
        "cargo": "string",
        "documento": "string",
        "dataEntrada": "string",
        "situacaoDocumento": "string"
      }
    ],
    "quantidadeSocios": "string",
    "quantidadeAdministradores": "string"
  },
  "indicadores": {
    "compromissos": {
      "pontuacao": "string",
      "ocorrencias": [
        {
          "periodo": "string",
          "pontuacao_Mensal": "string"
        }
      ]
    },
    "creditoObtido": {
      "pontuacao": "string",
      "ocorrencias": [
        {
          "periodo": "string",
          "pontuacao_Mensal": "string"
        }
      ]
    },
    "pagamentoPontual": {
      "pontuacao": "string",
      "ocorrencias": [
        {
          "periodo": "string",
          "pontuacao_Mensal": "string"
        }
      ]
    },
    "pagamentoAtrasado": {
      "ocorrencias": [
        {
          "itens": [
            {
              "periodo": "string",
              "pontuacao_Mensal": null
            }
          ],
          "descricao": "string",
          "pontuacao": null
        }
      ]
    },
    "eventosPessoaJuridica": {
      "pontuacao": null,
      "ocorrencias": [
        {
          "periodo": "string",
          "indicador": "string",
          "pontuacao": "string"
        }
      ]
    },
    "periodoRelacionamentoFornecedores": {
      "pontuacao": null,
      "ocorrencias": [
        {
          "valor": "string",
          "periodo": "string"
        }
      ]
    }
  },
  "razaoSocial": "string",
  "cnaePrimario": "string",
  "dataFundacao": "string",
  "dataSituacao": "string",
  "nomeFantasia": "string",
  "capitalSocial": "string",
  "tipoSociedade": null,
  "cidadesFiliais": null,
  "cnaeSecundario": "string",
  "opcaoTributaria": null,
  "dataEncerramento": null,
  "naturezaJuridica": "string",
  "situacaoSintegra": "string",
  "faixaFuncionarios": null,
  "historicoConsulta": {
    "detalhes": [
      {
        "cnpj": null,
        "data": "string",
        "razaoSocial": "string"
      }
    ],
    "dataFinal": "string",
    "dataInicial": "string",
    "quantidadeOcorrencias": "string"
  },
  "inscricaoEstadual": "string",
  "quantidadeFiliais": "string",
  "inscricaoEstadualUf": "string",
  "razaoSocialAnterior": null,
  "dataConsultaSintegra": "string",
  "dataSituacaoSintegra": "string",
  "ramoAtividadePrimario": "string",
  "ramoAtividadeSecundario": "string"
}

O JSON Schema desta consulta é longo demais para caber aqui. A íntegra está na versão em Markdown desta página e na especificação OpenAPI.

Códigos de erro

Código	Mensagem	Quando acontece
400	Requisição Inválida	a requisição está incorreta ou os parâmetros são inválidos.
401	Não Autenticado	o usuário não forneceu as credenciais corretas para acessar o recurso.
403	Não Autorizado	o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível.
404	Não Encontrado	o servidor não encontrou uma representação atual do recurso solicitado.
408	Tempo Esgotado	o servidor não conseguiu retornar a requisição no prazo estabelecido.
500	Falha ao Realizar Consulta	o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte.
503	Consulta em Manutenção	a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte.

Observações

A consulta gera um comprovante em PDF que pode ser obtido através de parâmetro adicional na requisição.
Todos os campos de data seguem o formato dd/MM/yyyy.
Valores monetários são retornados em texto com indicação de moeda.
Ocorrências e listas são retornadas como arrays com múltiplos registros quando aplicável.
Períodos e períodos de relacionamento são expressos em intervalos de tempo.
O acesso requer autenticação via token.

Integrar

OpenAPI (JSON) ↗ — importe a URL no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar pelo chat: conecte via MCP. Esta página em Markdown.