> ## Documentation Index
> Fetch the complete documentation index at: https://docs.predictus.inf.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Dossiê Financeiro por CNPJ

> Consulte o perfil financeiro consolidado de uma pessoa jurídica: dados cadastrais, score, sócios, administradores, pendências, protestos e dívida ativa.

# 🔎 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

```json theme={null}
{
  "cnpj": "28942188000106"
}
```

***

## 📚 Campos

| Campo  | Obrigatório | Tipo   | Descrição                                                                                                                 |
| ------ | ----------- | ------ | ------------------------------------------------------------------------------------------------------------------------- |
| `cnpj` | Sim         | string | CNPJ a consultar — exatamente 14 caracteres alfanuméricos (12 alfanuméricos + 2 dígitos), validado pelo algoritmo de CNPJ |

***

## 📥 Exemplo de cURL

```bash theme={null}
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.

```json theme={null}
{
  "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](../estrutura-pj).

***

## 🧾 Códigos de resposta

| Código | Significado                                             |
| ------ | ------------------------------------------------------- |
| `200`  | Sucesso — perfil financeiro encontrado                  |
| `204`  | Nenhum dado financeiro encontrado para o CNPJ           |
| `400`  | Erro de validação no payload (CNPJ inválido ou ausente) |
| `401`  | Token inválido ou expirado                              |
| `500`  | Erro 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](../../dossie-rj/overview).