Descrição
O dataset de Informações de KYC e Compliance dos Sócios retorna informações análogas ao dataset de KYC e Compliance tradicional, mas com um foco nos registros específicos dos diferentes sócios da empresa consultada. O objetivo principal deste dataset é simplificar processos de verificação e análise, removendo a necessidade de cada um dos sócios serem consultados individualmente. Dependendo da quantidade de sócios, pode haver também uma vantagem financeira na realização dessa consulta sobre a consulta individual de cada um dos sócios.
Origem da Informação
Todas as informações desse dataset tem sua origem em órgãos e instituições oficiais nacionais e internacionais, como a OFAC, a INTERPOL, o Tribunal de Contas da União, o Conselho Nacional de Justiça e dezenas de outras.
Tabela de preços para esse dataset
| Consultas Realizadas no Mês | Valor por consulta |
|---|---|
| 1 - 10000 | R$ 0,090 |
| 10001 - 50000 | R$ 0,085 |
| 50001 - 100000 | R$ 0,081 |
| 100001 - 500000 | R$ 0,077 |
| 500001 - 1000000 | R$ 0,073 |
| 1000001 - 5000000 | R$ 61.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 | CNPJ | 🛑 Obrigatório |
| minmatch | Esse dataset suporta um parametro opcional chamado minmatch, que permite a definição do percentual de similaridade entre o nome da pessoa consultada e o nome presente no registro de sanção a partir do qual o registro será considerado como uma sanção ativa. Atenção! O parâmetro minmatch altera apenas a regra de cálculo do flag "IsCurrentlySanctioned", e não influencia a quantidade de registros retornados na lista detalhada de sanções nem na lista PEP. | Número entre 0 e 100 | ℹ️ 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": "owners_kyc",
"q": "doc{CNPJ}"
}
Filtros
| Campo | Descrição do filtro | Tipo do filtro | Valores Possíveis do Filtro |
|---|---|---|---|
| pep_level | Nível de Pessoa Politicamente Exposta (PPE) | Igual | Qualquer um dos níveis definidos |
| pep_job | Cargo público que a pessoa ocupa | Igual | O nome do cargo (ex. PRESIDENTE) |
| pep_motive | Motivo pelo qual a pessoa foi classificada como PPE | Igual | A descrição do motivo (ex. RELACIONAMENTO) |
| sanctions_source | Fonte da sanção | Igual | A fonte que originou o registro (ex. FBI) |
| sanctions_type | Tipo da sanção | Igual | O tipo da restrição (ex. Money Laundering) |
Abaixo está um exemplo de como utilizar o parâmetro .filter(nome_do_campo=XXXX)
{
"Datasets": "owners_kyc.filter(pep_level=Qualquer um dos níveis definidos)",
"q": "doc{CNPJ}"
}
Paginação
A paginação do dataset pode ser feita através do parâmetro .next(x), utilizando o ID retornado pela requisição anterior e um parâmetro de consulta q com o mesmo parâmetro inserido na consulta original, conforme o exemplo abaixo:
{
"Datasets": "owners_kyc.next(Id da próxima página)",
"q": "doc{CNPJ}"
}
Não há cobrança sobre as requisições de paginação. Por padrão, se nenhum limite for especificado, cada página retornará no mínimo 50 sócios. O número máximo de sócios por página será de 200, mesmo que na consulta seja solicitado um valor maior.