Relacionamentos - Grupo Econômico

Descrição

O dataset de Relacionamentos - Grupo Econômico retorna informações sobre outras entidades, sejam elas pessoas ou empresas, que estão dentro do mesmo grupo econômico da entidade consultada. Os tipos de relacionamentos cobertos são exclusivamente os relacionamentos que compõe o grupo econômico, ou seja, relacionamentos de caráter societário. Dada a natureza dos relacionamentos empresariais e a complexidade da composição de determinadas empresas, o volume de informações retornadas dentro deste dataset pode ser muito grande. Recomendamos, portanto, que as chamadas ao mesmo sejam feitas através da requisições assíncronas ou através de um processo batch.

Origem da Informação

As informações de quadro societário e representação legal são extraídas a partir de dados de empresas disponibilizados publicamente pela Receita Federal do Brasil (ou órgãos equivalentes em outros países). Outros tipos de relacionamento são inferidos a partir de informações contextuais, como a utilização de um e-mail do domínio corporativo da empresa, ou a apresentação de um telefone empresarial como referência.

Tabela de preços para esse dataset

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.

Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:

{  
    "Datasets": "economic_group_relationships",
    "q": "doc{CNPJ}"  
}  

Filtros

Abaixo está um exemplo de como utilizar o parâmetro .filter(nome_do_campo=XXXX)

{  
    "Datasets": "economic_group_relationships.filter(relatedentitytaxidtype=cnpj)",
    "q": "doc{CNPJ}"  
}  

Limite

Para utilizar o campo de limite basta utilizar o parâmetro .limit(x)

{  
    "Datasets": "economic_group_relationships.limit(10)",
    "q": "doc{CNPJ}"  
}  

Alguns dos campos desse dataset tem valores predefinidos, seguindo a tabela abaixo: