Descrição
Os datasets de Grupos Empresariais retornam informações agregadas e agrupadas de conjuntos de empresas que estão relacionadas com a entidade consultada através de uma característica específica. Esses grupos estão quebrados de acordo com essa característica que reúne as empresas. Através desses datasets, é possível recuperar informações consolidadas sobre diversas empresas sem a necessidade de consultar individualmente cada uma delas, viabilizando a aplicação deste tipo de informação em processos de modelagem estatística ou machine learning.
O grupo empresarial de Sociedade reúne todas as empresas das quais a pessoa é ou já foi sócia. Esse grupo empresarial pode ser utilizado para apoiar o processo de estimativa patrimonial e de inferência de renda, para a análise de risco de crédito, ou mesmo em processos de KYC simplificados.
Origem da Informação
Todas as informações dos grupos empresariais são calculadas como inferências sobre os agrupamentos a partir do tipo de relacionamento estabelecido entre as empresas e a entidade consultada. Os relacionamentos tem diferentes origens, de acordo com os seus tipos, que podem ser visualizadas nos seus datasets específicos.
Tabela de preços para esse dataset
| Consultas Realizadas no Mês | Valor por consulta |
|---|---|
| 1 - 10000 | R$ 0,050 |
| 10001 - 50000 | R$ 0,048 |
| 50001 - 100000 | R$ 0,046 |
| 100001 - 500000 | R$ 0,044 |
| 500001 - 1000000 | R$ 0,042 |
| 1000001 - 5000000 | R$ 34.000,00 (preço fixo) |
| 5000001 e acima | Entre em contato |
Parâmetros de consulta
A tabela abaixo detalha os campos aceitos na consulta a este dataset.
| Campo | Descrição | Valores Possíveis | Tipo de Campo |
|---|---|---|---|
| doc | Documento de identificação | CPF | 🛑 Obrigatório |
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": "company_group_ownership",
"q": "doc{CPF}"
}
Filtros
| Campo | Descrição do filtro | Tipo do filtro | Valores Possíveis do Filtro |
|---|---|---|---|
| company_status | Status da empresa | Igual | Qualquer um dos Status definidos |
| head_subsidiary | Indicador se a empresa é Matriz (H) ou Filial (S) | Igual | A flag do indicador (ex. H) |
| tax_regime | Natureza jurídica da empresa | Igual | A descrição da natureza (ex: S.A.) |
| main_economic_activity | Código da atividade econômica da empresa | Igual | O código da atividade econômica principal da empresa (ex. 6422100) |
| company_size | Porte da empresa | Igual | O porte da empresa (ex. DEMAIS) |
Abaixo está um exemplo de como utilizar o parâmetro .filter(nome_do_campo=XXXX)
{
"Datasets": "company_group_ownership.filter(company_status=Qualquer um dos Status definidos)",
"q": "doc{CPF}"
}
Notas
- O retorno de todos os datasets de grupos empresariais está contido em um único campo, "CompanyGroup", do objeto principal de retorno do serviço