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. 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).

6. 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.

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 será retornada a representação atualizada da análise cadastral.

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

A análise cadastral atualizada é retornada no corpo da resposta.