Relacionamentos do Grupo Econômico

Descrição

Dataset que retorna informações sobre entidades — pessoas e empresas — que integram o mesmo grupo econômico da entidade consultada, considerando exclusivamente vínculos de natureza societária. O retorno inclui relacionamentos diretos e indiretos que compõem a estrutura do grupo econômico, podendo resultar em grandes volumes de dados em função da complexidade societária envolvida.

Quando não há informações na Receita Federal sobre o quadro societário da subsidiária consultada, os relacionamentos são construídos a partir do quadro societário da matriz.

Para mais informações sobre contexto de negócio, aplicações e casos de uso, consulte a documentação de Relacionamentos.

Nome técnico do dataset: economic_group_relationships

Tabela de preços

Consultas Realizadas no MêsValor por consulta
1 - 10.000R$ 0,050
10.001 - 50.000R$ 0,048
50.001 - 100.000R$ 0,046
100.001 - 500.000R$ 0,044
500.001 - 1.000.000R$ 0,042
1.000.001 - 5.000.000R$ 34.000,00 (preço fixo)
5.000.001 e acimaEntre em contato

Chaves complementares relevantes

As chaves abaixo representam algumas das chaves complementares aceitas neste dataset, permitindo refinar a consulta ou alterar o escopo e a profundidade dos relacionamentos retornados.

ChaveDescriçãoValores Possíveis
group_levelDefine até qual nível do grupo econômico os relacionamentos devem ser considerados. O nível 1 corresponde aos relacionamentos diretosNúmero inteiro maior que zero
extendedIndica se o grupo econômico estendido deve ser retornado, incluindo parentes e empresas associadas às pessoas do grupotrue, false
group_search_limitLimita a quantidade máxima de relacionamentos retornados, impactando diretamente a performance da consultaNúmero inteiro maior que zero
useHeadQuartersDataIndica se os relacionamentos devem ser construídos a partir do documento da matriztrue, false

Para conhecer todas as chaves disponíveis e entender como combiná-las, consulte a seção Parâmetros de Consulta.

Filtros

CampoDescrição do filtroTipo do filtroValores Possíveis do Filtro
RelatedEntityTaxIdTypeTipo do documento da entidade relacionadaIgualCPF, CNPJ
RelationshipLevelNível do relacionamento dentro do grupo econômicoIgual1st-LEVEL, 2nd-LEVEL, 3rd-LEVEL, etc.
RelationshipTypeTipo do relacionamento societárioIgualQSA, Ownership, Employee, RepresentanteLegal

Limite

Este dataset permite limitar a quantidade de registros retornados utilizando o modificador .limit(x) no campo Datasets. O valor padrão é 10.000 registros.

Para entender como aplicar filtros, limitar a quantidade de resultados, fazer paginação e personalizar o retorno dos dados, consulte a seção Personalizar Retorno.

Campos com valores predefinidos

Os campos que possuem valores predefinidos neste dataset seguem o mesmo padrão do dataset de Relacionamentos. Para a lista completa de valores possíveis e seus significados, consulte a documentação de referência em Relacionamentos.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Objeto de requisição para consulta ao dataset na API de Empresas. Para mais informações sobre cada parâmetro e sua utilização, consulte a página "Estrutura da Consulta" na seção "Primeiros Passos".

string
required

String que define os parâmetros de entrada da consulta, utilizada para informar os identificadores e filtros aplicáveis ao dataset.

string
required

String contendo os nomes técnicos dos datasets a serem consultados.

number

Número máximo de entidades retornadas na resposta, utilizado em consultas realizadas sem uma chave principal. Valor máximo permitido: 80

Response

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json