Skip to main content

🔎 Dossiê Financeiro por CNPJ

Este endpoint retorna o perfil financeiro consolidado de uma pessoa jurídica a partir de um CNPJ, agregando dados de bureaus de crédito (SPC/Serasa) com identificação cadastral, quadro societário, administradores, capital social, faturamento presumido, score, pendências, protestos, CCF, consultas recentes e dívida ativa. A resposta é um objeto único (não uma lista) — o CNPJ identifica unicamente a empresa.

🔗 Endpoint

POST https://api.predictus.com.br/predictus-api/pessoas/juridicas/pendenciasFinanceiras

🧾 Corpo da requisição

{
  "cnpj": "28942188000106"
}

📚 Campos

CampoObrigatórioTipoDescrição
cnpjSimstringCNPJ a consultar — exatamente 14 caracteres alfanuméricos (12 alfanuméricos + 2 dígitos), validado pelo algoritmo de CNPJ

📥 Exemplo de cURL

curl --location 'https://api.predictus.com.br/predictus-api/pessoas/juridicas/pendenciasFinanceiras' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {accessToken}' \
--data '{
  "cnpj": "28942188000106"
}'

✅ Resposta esperada (200)

Campos sem valor são omitidos do JSON. O exemplo abaixo mostra todas as seções possíveis.
{
  "cnpj": "28942188000106",
  "razaoSocial": "EMPRESA EXEMPLO LTDA",
  "nomeFantasia": "EXEMPLO",
  "dataAbertura": "2017-08-14",
  "naturezaJuridica": "SOCIEDADE EMPRESARIA LIMITADA",
  "atividadePrincipal": "62.01-5-01 - DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
  "atividadesSecundarias": [
    "62.02-3-00 - DESENVOLVIMENTO E LICENCIAMENTO DE PROGRAMAS DE COMPUTADOR CUSTOMIZAVEIS",
    "63.11-9-00 - TRATAMENTO DE DADOS, PROVEDORES DE SERVICOS DE APLICACAO"
  ],
  "situacaoCadastral": "ATIVA",
  "dataSituacao": "2017-08-14",
  "score": {
    "valor": 645,
    "mensagem": "RISCO MEDIO DE INADIMPLENCIA"
  },
  "contato": {
    "telefones": ["11-30001234"],
    "emails": ["contato@exemplo.com.br"]
  },
  "endereco": {
    "logradouro": "AVENIDA PAULISTA",
    "numero": "1000",
    "complemento": "ANDAR 12",
    "bairro": "BELA VISTA",
    "cidade": "SAO PAULO",
    "uf": "SP",
    "cep": "01310100",
    "dataAtualizacao": "2025-12-01"
  },
  "socios": [
    {
      "cpfCnpj": "12345678901",
      "nome": "FULANO DE TAL",
      "entrada": "2017-08-14"
    },
    {
      "cpfCnpj": "98765432109",
      "nome": "BELTRANO DE TAL",
      "entrada": "2017-08-14"
    }
  ],
  "administradores": [
    {
      "nomeOuRazaoSocial": "FULANO DE TAL",
      "qualificacao": "16-PRESIDENTE"
    }
  ],
  "capitalSocial": 100000.00,
  "faturamentoPresumido": 2500000.00,
  "pendencias": [
    {
      "origem": "BANCO XYZ S/A",
      "cidade": "SAO PAULO",
      "uf": "SP",
      "contrato": "9988776655",
      "valor": "12.500,00",
      "dataVencimento": "2025-09-10",
      "dataPendencia": "2025-10-15"
    }
  ],
  "protestos": [
    {
      "data": "2025-02-18",
      "cidade": "SAO PAULO",
      "uf": "SP",
      "cartorio": "3 TABELIONATO DE PROTESTO",
      "valor": "8.000,00"
    }
  ],
  "ccf": [],
  "consultas": [
    {
      "data": "2026-04-22",
      "loja": "FORNECEDOR ABC",
      "cidade": "RIO DE JANEIRO",
      "estado": "RJ"
    }
  ],
  "mensagens": [
    {
      "codigo": "001",
      "descricao": "CONSULTA REALIZADA COM SUCESSO"
    }
  ],
  "resumoPendencias": {
    "quantidadeUltimas90": 1,
    "valorAcumuladoUltimas90": 12500.00
  },
  "dividasAtivas": [
    {
      "descricao": "DIVIDA ATIVA DA UNIAO - PROCESSO 456 - VALOR R$ 3.200,00",
      "valor": 3200.00
    }
  ]
}
Para o significado de cada campo, veja 📂 Estrutura de Dados — Pessoa Jurídica.

🧾 Códigos de resposta

CódigoSignificado
200Sucesso — perfil financeiro encontrado
204Nenhum dado financeiro encontrado para o CNPJ
400Erro de validação no payload (CNPJ inválido ou ausente)
401Token inválido ou expirado
500Erro interno do servidor

🛡️ Validações

  • cnpj:
    • Não nulo
    • Exatamente 14 caracteres no formato [0-9A-Za-z]{12}[0-9]{2}
    • Validação de CNPJ formal (algoritmo de dígitos verificadores)

💡 Dica

Combine situacaoCadastral (status na Receita) com situacaoEspecial (recuperação judicial, falência) para identificar empresas em estresse antes mesmo de avaliar pendencias. Empresas com situacaoEspecial preenchida geralmente exigem análise jurídica complementar — veja Dossiê de Recuperação Judicial.