Enviar Cadastro do Investidor para Análise

Introdução

Este recurso submete a análise cadastral preenchida para validação. A partir desse momento, os dados são enviados aos serviços de compliance e os documentos são gerados para assinatura.

Atenção

A análise cadastral ocorre de forma assíncrona. Recomendamos integrar com os webhooks de mudança de status para acompanhar a evolução — veja Ciclo de vida da análise cadastral.

Pré-requisitos

O submit só é aceito quando a análise já reúne todos os dados abaixo. Estes são os erros mais comuns nesta etapa, e a validação é feita em sequência — cada recusa pode estar escondendo a próxima pendência, então vale conferir a lista inteira antes de reenviar.

1. Blocos de dados obrigatórios

Faltando qualquer um, a recusa é IVR000150, cuja mensagem lista exatamente as chaves ausentes.

Investidor	Blocos exigidos
`natural_person`	`natural_person`, `address`, `net_worth`, `suitability`
`legal_person` (`default`, `financial_institution`)	`legal_person`, `address`, `net_worth`
`legal_person` / `fund_class`	Nenhum — ver abaixo

Classes de fundo não têm blocos obrigatórios

Para legal_person / fund_class, os dados cadastrais, o endereço e o patrimônio são preenchidos automaticamente a partir da base pública da CVM no próprio submit. Suitability, grupos de assinantes e documentos do investidor também não são exigidos.

A única exigência condicional é a de partes relacionadas, e apenas quando a classe é exclusiva na CVM — ver o item 3 abaixo. Se o CNPJ não constar na base da CVM, o enriquecimento não acontece e o submit é recusado com IVR000068.

2. Suitability

Pessoa física: sempre obrigatória. Sem ela, IVR000150 acusa a chave suitability faltante
Pessoa jurídica retail: obrigatória — a ausência é recusada com IVR000133
Pessoa jurídica qualified ou professional: opcional
Classe de fundo (fund_class): não se aplica — a etapa é pulada

3. Partes relacionadas e participação societária

Quantidade mínima, exigência de representante legal e percentual somado variam por tipo de investidor. A tabela completa está em Criar Parte Relacionada — Exigências por tipo de investidor.

4. Documentos

A matriz de documentos obrigatórios é validada aqui, e não no upload — ver a seção Documentos Obrigatórios na página Enviar Documento do Investidor. As recusas são IVR000029 (documentos do investidor) e IVR000030 (documentos de parte relacionada), ambas devolvendo na mensagem a matriz de opções aceitas.

Para fund_class não há matriz de documentos do investidor. Só podem ser cobrados documentos de parte relacionada, e apenas em classe exclusiva.

5. Conta bancária e grupo de assinantes

Conta bancária ativa: exigida de todo investidor, inclusive classe de fundo. Sem ela, IVR000178. Veja Enviar Conta Bancária do Investidor.
Grupo de assinantes ativo: exigido de pessoa física e jurídica residentes sem investor owner. Sem ele, IVR000180. Classe de fundo e investidor não residente são dispensados.

6. Investor owners (apenas `fund_class`)

Uma classe de fundo precisa de um administrador e uma gestora ativos. Eles são criados automaticamente a partir dos dados da CVM no submit; o endpoint Criar Investor Owner cobre os vínculos adicionais. A ausência é recusada com IVR000164 (administrador) ou IVR000163 (gestora).

7. Classe em funcionamento (apenas `fund_class`)

Somente classes operacionais na CVM são aceitas. Classes pré-operacionais, encerradas, canceladas ou incorporadas são recusadas na análise.

8. Adesões a fundo

Se o investidor selecionou fundos durante o cadastro (ver Selecionar Fundo), o submit também valida essas adesões:

Situação	Recusa
Alguma adesão está `rejected`	`IVR000233`
Alguma adesão ainda está `selected` (elegibilidade não resolvida)	`IVR000235`

Remova as adesões rejected ou aguarde/force a resolução da elegibilidade antes de reenviar. Análises sem nenhuma adesão a fundo não são afetadas por essa validação.

Input / Output

O corpo é opcional — pode ser enviado vazio (null ou {}). Quando enviado, permite informar o método de assinatura e o grupo de assinantes que deverá ser utilizado para os documentos gerados.

Como output é retornada apenas a investor_analysis_key. Acompanhe o resultado pelos webhooks ou pela consulta da análise.

Disponível em

Perfil	Host
Distribuidor	`distributor-api`

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/submit

MÉTODO

PUT

STATUS

202

Request body

O corpo pode ser enviado vazio ({}) — neste caso a API utiliza o método de assinatura e o grupo de assinantes padrão da análise. Para sobrescrever esses valores, envie os campos opcionais abaixo.

Request Body
{
    "signature_method": "certifiqi",
    "external_signer_group_key": "3f8a5a3e-1f0a-4d9b-8a6e-9b4c0e7d8f12"
}

Body params

Campo	Tipo	Descrição	Obrigatório
`signature_method`	string	Enumerador de Signature Method	Não
`external_signer_group_key`	string	Chave externa do grupo de assinantes a ser utilizado para esta análise	Não

Signature Method

Os únicos valores que uma integração pode informar são:

Enumerador	Descrição
`certifiqi`	Assinatura eletrônica via CertifiQI
`qi_sign.liveness`	Assinatura eletrônica com prova de vida

opt_in não é selecionável pela integração

opt_in é uma configuração do distribuidor, definida pela QI Tech na sua conta, e não um valor a ser enviado neste corpo. Se a sua conta estiver configurada como opt_in, o fluxo de assinatura é resolvido automaticamente e não é necessário informar signature_method.

Response

Response Body
{
    "investor_analysis_key": "UUID"
}

Erros

Status	Código	Quando acontece
400	`IVR000018`	A análise não está mais em `pending_registry_data` (já foi enviada ou encerrada)
400	`IVR000029`	Faltam documentos obrigatórios da análise. A mensagem lista as opções aceitas
400	`IVR000030`	Faltam documentos de uma parte relacionada. A mensagem lista as opções aceitas
400	`IVR000148`	Procurador (`attorney`) sem `power_of_attorney`
400	`IVR000178`	Nenhuma conta bancária ativa
400	`IVR000180`	Nenhum grupo de assinantes ativo
400	`IVR000134` / `IVR000136`	Pessoa jurídica sem parte relacionada ou sem representante legal
400	`IVR000169`	Participação somada das partes relacionadas acima de 100%
400	`QIT000011`	Pela gestora (`manager-api`): o investidor não é uma classe de fundo vinculada a ela

Erros de autenticação, permissão e host: veja Erros da API.

Introdução​

Pré-requisitos​

1. Blocos de dados obrigatórios​

2. Suitability​

3. Partes relacionadas e participação societária​

4. Documentos​

5. Conta bancária e grupo de assinantes​

6. Investor owners (apenas fund_class)​

7. Classe em funcionamento (apenas fund_class)​

8. Adesões a fundo​

Input / Output​

Request​

Request body​

Body params​

Signature Method​

Response​

Erros​