Informe cpf ou cnpj.
A árvore de relacionamentos
relacionamentos é uma lista recursiva: cada item pode conter o seu próprio relacionamentos. O campo nivel é um número inteiro igual à profundidade do item na árvore — 1 é o vínculo direto com o documento consultado. Observamos profundidade de até 8, e mais de 60% das respostas passam do nível 3. Percorra a estrutura recursivamente; não presuma um número fixo de níveis.
Quando não há vínculo registrado, relacionamentos vem como lista vazia.
Tipo e grau do vínculo
tipo assume exatamente dois valores: Sociedade ou Parentesco.
grau diz qual é o vínculo, e o seu significado depende do tipo:
- com
tipo = "Sociedade", traz o papel exercido: Sócio Administrador, Administrador, Sócio, Diretor, Sócio Gerente, Conselheiro de Administração, entre outros. Vem nulo em cerca de 7% dos casos.
- com
tipo = "Parentesco", traz o laço familiar: Mãe, Pai, Irmão, Irmã, Filho, Filha, Conjuge, Tio, Avó, Sobrinho, Primo, Sogra, entre outros.
Os valores de grau e de cargo chegam como estão na origem e não são normalizados: podem vir com prefixo numérico (59-Produtor Rural), espaçamento irregular ou variação de caixa. Compare por conteúdo, não por igualdade exata.
Vigência e histórico
status indica se o vínculo está vigente (true) ou encerrado (false). Em vínculo de parentesco status é sempre true e não carrega informação — ignore-o nesse caso.
historicos detalha os períodos de cada cargo e vem vazio em todo vínculo de parentesco. Dentro de cada registro, status = false significa cargo encerrado e coincide sempre com dataFim preenchida.
As datas são esparsas: dataInicio vem em cerca de 19% dos registros e dataFim em cerca de 16%. A origem não informa o período da maioria dos vínculos — não construa linha do tempo assumindo que as datas existem.
Formato das datas e dos documentos
Todas as datas desta consulta vêm no formato DD/MM/AAAA HH:MM:SS (a hora é sempre 00:00:00). Vale para dataInicio, dataFim, dataNascimento, dataAbertura e dataEncerramento.
Os documentos vêm completos e com máscara: CPF como 000.000.000-00 e CNPJ como 00.000.000/0000-00. Remova a pontuação se precisar apenas dos dígitos.
Detalhes por entidade
detalhesPessoaFisica e detalhesPessoaJuridica são complementos opcionais. Em cerca de dois terços dos vínculos nenhum dos dois vem preenchido — trate ambos como possivelmente nulos.
Em detalhesPessoaFisica (presente em ~24% dos vínculos), pep, obito e dataNascimento vêm em torno de 90% das vezes. Já endereco e situacaoCadastral quase nunca vêm (~2%): não dependa deles.
Em detalhesPessoaJuridica (presente em ~9% dos vínculos), situacaoCadastral, dataAbertura, endereco, matriz e baixada vêm em mais de 99% das vezes. Dois cuidados:
baixada = true significa estritamente situação BAIXADA. Empresa INAPTA ou SUSPENSA vem com baixada = false. Para triar empresa irregular, leia situacaoCadastral, não baixada.recuperacaoJudicial vem false em praticamente toda a base e não deve ser usado como triagem de recuperação judicial.
Consulta por CNPJ entrega menos que por CPF
Por CPF a resposta traz tipicamente 6 vínculos diretos e 23 nós no total. Por CNPJ, tipicamente 1 vínculo direto e 5 nós. Além disso, quase metade dos vínculos retornados numa consulta por CNPJ é de parentesco dos sócios, não de sociedade. Se o objetivo é mapear o entorno de uma empresa, consultar os CPFs dos sócios rende mais.