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.
Para mais informações sobre contexto de negócio, aplicações e casos de uso, consulte a documentação de Relacionamentos.
Tabela de preços
| Consultas Realizadas no Mês | Valor por consulta |
|---|---|
| 1 - 10.000 | R$ 0,050 |
| 10.001 - 50.000 | R$ 0,048 |
| 50.001 - 100.000 | R$ 0,046 |
| 100.001 - 500.000 | R$ 0,044 |
| 500.001 - 1.000.000 | R$ 0,042 |
| 1.000.001 - 5.000.000 | R$ 34.000,00 (preço fixo) |
| 5.000.001 e acima | Entre em contato |
Chaves opcionais relevantes
As chaves abaixo representam algumas das chaves opcionais aceitas neste dataset, permitindo refinar a consulta ou alterar o escopo e a profundidade dos relacionamentos retornados.
| Chave | Descrição | Valores Possíveis |
|---|---|---|
| group_level | Define até qual nível do grupo econômico os relacionamentos devem ser considerados. O nível 1 corresponde aos relacionamentos diretos | Número inteiro maior que zero |
| extended | Indica se o grupo econômico estendido deve ser retornado, incluindo parentes e empresas associadas às pessoas do grupo | true, false |
| group_search_limit | Limita a quantidade máxima de relacionamentos retornados, impactando diretamente a performance da consulta | Número inteiro maior que zero |
| useHeadQuartersData | Indica se os relacionamentos devem ser construídos a partir do documento da matriz | true, false |
Para conhecer todas as chaves disponíveis e entender como combiná-las, consulte a seção Parâmetros de Consulta.
Filtros
| Campo | Descrição do filtro | Tipo do filtro | Valores Possíveis do Filtro |
|---|---|---|---|
| RelatedEntityTaxIdType | Tipo do documento da entidade relacionada | Igual | CPF, CNPJ |
| RelationshipLevel | Nível do relacionamento dentro do grupo econômico | Igual | 1st-LEVEL, 2nd-LEVEL, 3rd-LEVEL, etc. |
| RelationshipType | Tipo do relacionamento societário | Igual | QSA, Ownership, Employee, RepresentanteLegal |
Para entender como aplicar filtros, ordenações 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.