Documentação Técnica

Beneficiário Final

Descrição

O dataset de Beneficiários Finais retorna informações do percentual agregado que cada beneficiário possui de uma determinada empresa (essa informação deixou de ser publicada pela Receita Federal do Brasil em 2016) e também lista os beneficiários com participação acima de dada porcentagem determinada como parâmetro (por padrão definida em 20%), denominados Beneficiários Finais. Esse conjunto de dados pode ser utilizado com um complemento (ou um substituto) do dataset de Relacionamentos de Empresas. Ainda, caso uma empresa detenha participação, listamos um nível adicional, obtendo as informações de participação percentual de beneficiários nessa empresa e calculando o valor cumulativo de participação desses beneficiários na empresa "mãe" consultada.

Origem da Informação

A origem dessas informações são parceiros que coletam os dados de juntas comerciais e outras fontes, através de acordos particulares.

Tabela de preços para esse dataset

Consultas Realizadas no MêsValor por consulta
1 - 10000R$ 5,000
10001 - 50000R$ 4,752
50001 - 100000R$ 4,512
100001 - 500000R$ 4,286
500001 - 1000000R$ 4,072
1000001 e acimaR$ 3,670

Parâmetros de consulta

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

CampoDescriçãoValores PossíveisTipo de Campo
docDocumento de identificaçãoCNPJ🛑 Obrigatório
minimum_percentageEstabelece um threshold com o valor passado que determina o valor mínimo de porcentagem de participação na empresa que o beneficiário deve ter para ser considerado Beneficiário Final. Por padrão o valor é estabelecido em 20%.Número inteiroℹ️  Opcional

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": "partner_ultimate_beneficial_owners_company",
    "q": "doc{CNPJ}"  
}  
Language
Authorization
Click Try It! to start a request and see the response here!