Skip to main content

🧾 Estrutura de Dados — Pessoa Jurídica

Abaixo estão todos os campos retornados pelo endpoint Dossiê Financeiro por CNPJ, com suas descrições e origens.
A resposta omite campos sem valor (serialização NON_NULL). Trate todos os campos como opcionais no consumo, exceto cnpj, que sempre vem preenchido.

📑 Tabela de Campos

CampoDescrição
cnpjCNPJ consultado (14 caracteres alfanuméricos)
razaoSocialRazão social da empresa
nomeFantasiaNome fantasia
dataAberturaData de abertura da empresa (yyyy-MM-dd)
naturezaJuridicaNatureza jurídica (ex: LTDA, S/A, EIRELI)
atividadePrincipalCNAE da atividade principal
atividadesSecundariasLista de CNAEs secundárias
situacaoCadastralSituação cadastral na Receita (ex: ATIVA, BAIXADA, SUSPENSA, INAPTA, NULA)
motivoSituacaoMotivo da situação cadastral atual
dataSituacaoData da situação cadastral atual
situacaoEspecialSituação especial (ex: RECUPERACAO JUDICIAL, FALENCIA)
dataSituacaoEspecialData da situação especial
scoreScore de crédito da empresa
score.valorPontuação numérica
score.mensagemMensagem indicativa do bureau (ex: BAIXO RISCO DE INADIMPLENCIA, CREDITO NEGADO, DESCONHECIDO)
contatoTelefones e e-mails encontrados
contato.telefonesLista de telefones no formato DDD-numero
contato.emailsLista de e-mails
enderecoEndereço cadastral
endereco.logradouroLogradouro
endereco.numeroNúmero
endereco.complementoComplemento
endereco.bairroBairro
endereco.cidadeCidade
endereco.ufUF
endereco.cepCEP
endereco.dataAtualizacaoData/hora da última atualização
sociosQuadro societário
socios[].cpfCnpjCPF (11 dígitos) ou CNPJ (14 caracteres) do sócio
socios[].nomeNome ou razão social do sócio
socios[].entradaData de entrada na sociedade — frequentemente ausente
socios[].saidaData de saída — frequentemente ausente
administradoresLista de administradores formalmente registrados
administradores[].nomeOuRazaoSocialNome ou razão social do administrador
administradores[].qualificacaoQualificação do administrador (ex: 16-PRESIDENTE, 10-DIRETOR)
administradores[].representanteLegalNomeNome do representante legal (quando o administrador é PJ)
administradores[].representanteLegalQualificacaoQualificação do representante legal
administradores[].paisDeOrigemPaís de origem (quando estrangeiro)
capitalSocialCapital social registrado (BRL)
faturamentoPresumidoFaturamento anual presumido (BRL)
pendenciasLista de pendências financeiras (apontamentos)
pendencias[].origemCredor/origem da pendência
pendencias[].cidadeCidade da origem
pendencias[].ufUF da origem
pendencias[].contratoIdentificação do contrato/dívida
pendencias[].valorValor em aberto (string com formato BR)
pendencias[].dataVencimentoData de vencimento original
pendencias[].dataPendenciaData em que a pendência foi registrada
protestosLista de protestos em cartório
protestos[].dataData do protesto
protestos[].cidadeCidade do cartório
protestos[].ufUF do cartório
protestos[].cartorioIdentificação do cartório (pode vir como nome ou apenas o número, ex: "0002")
protestos[].valorValor protestado
ccfLista de ocorrências de cheques sem fundo
ccf[].bancoNome do banco
ccf[].agenciaNúmero da agência
ccf[].quantidadeQuantidade de ocorrências
ccf[].motivoMotivo da devolução
ccf[].ultimaOcorrenciaData da última ocorrência
consultasLista de consultas recentes feitas ao CNPJ (ordenadas da mais recente)
consultas[].dataData da consulta
consultas[].lojaQuem consultou
consultas[].cidadeCidade (pode vir como string vazia)
consultas[].estadoUF (pode vir como string vazia)
mensagensAvisos/mensagens do bureau
mensagens[].codigoCódigo da mensagem (numérico ou slug, ex: "001", "msg-txt-nclass")
mensagens[].descricaoTexto da mensagem
resumoPendenciasResumo agregado das últimas 90 ocorrências
resumoPendencias.quantidadeUltimas90Quantidade de pendências nos últimos 90 dias
resumoPendencias.valorAcumuladoUltimas90Valor acumulado (BRL)
dividasAtivasLista de dívidas ativas com órgãos públicos
dividasAtivas[].descricaoDescrição completa da dívida (texto livre)
dividasAtivas[].valorValor extraído da descrição (BRL)