Skip to main content

🧾 Estrutura de Dados — Pessoa Física

Abaixo estão todos os campos retornados pelo endpoint Dossiê Financeiro por CPF, 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 cpf, que sempre vem preenchido.

📑 Tabela de Campos

CampoDescrição
cpfCPF consultado (11 dígitos numéricos)
nomeNome completo da pessoa
nomeMaeNome da mãe
dataNascimentoData de nascimento (yyyy-MM-dd)
idadeIdade em anos
sexoSexo informado pelo bureau
grauInstrucaoGrau de instrução (pode vir vazio se o bureau não retornar)
ocupacaoOcupação registrada (CBO)
ocupacao.codigoCódigo CBO
ocupacao.tituloTítulo da ocupação
classeSocialClasse social estimada
classeSocial.codigoCódigo numérico da classe social (ex: "5")
classeSocial.classeLetra da classe (ex: A, B, C, D, E)
classeSocial.descricaoFaixa salarial associada (ex: "de 03 a 05 salarios minimos")
rendaPresumidaRenda mensal presumida (BRL)
statusCpfStatus do CPF na Receita
statusCpf.situacaoSituação cadastral (REGULAR, SUSPENSA, CANCELADA, NULA, PENDENTE DE REGULARIZACAO, TITULAR FALECIDO)
statusCpf.dataConsultaData da consulta na Receita (yyyy-MM-dd)
statusCpf.autenticacaoCódigo de autenticação fornecido pela Receita
scoreScore de crédito
score.valorPontuação numérica (geralmente 0 a 1000)
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
enderecoÚltimo endereço conhecido
endereco.logradouroLogradouro
endereco.numeroNúmero
endereco.complementoComplemento
endereco.bairroBairro
endereco.cidadeCidade
endereco.ufUF (sigla de 2 letras)
endereco.cepCEP
endereco.dataAtualizacaoData da última atualização do endereço
pendenciasLista de pendências financeiras (apontamentos)
pendencias[].origemCredor/origem da pendência (ex: banco, varejista)
pendencias[].cidadeCidade da origem
pendencias[].ufUF da origem
pendencias[].contratoIdentificação do contrato/dívida
pendencias[].valorValor em aberto (string com formato BR — ex: 1.234,56)
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 CPF (ordenadas da mais recente)
consultas[].dataData da consulta
consultas[].lojaQuem consultou (loja/cliente)
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
sociedadesEmpresas em que o CPF aparece como sócio
sociedades[].cnpjCNPJ da empresa
sociedades[].razaoSocialRazão social
sociedades[].entradaData de entrada na sociedade — frequentemente ausente
sociedades[].saidaData de saída — frequentemente ausente
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)