Enviar Resposta Suitability

---

Introdução

Este recurso tem como objetivo enviar as respostas fornecidas para o formulário suitability respondido pelo investidor.

Input / Output:

Os dados cadastrais mudam de acordo com os dados passados na etapa de Criar investidor. Segue abaixo exemplos de quais dados devem ser enviados para cada variação.

Como output é retornado o objeto data da análise, com os blocos cadastrais já gravados. As chaves do investidor e da análise não vêm na resposta: use as que você já tem. A investor_key é utilizada para identificar o investidor ao qual a análise cadastral pertence.

Atenção

O envio do suitability é opcional para investidores que sejam Pessoa Jurídica enquadradas como qualificadas ou profissionais.

Classe de fundo (fund_class) — etapa pulada

Classes de fundo não respondem suitability. O bloco não é exigido no submit para esse subtipo. Pule esta etapa.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita
Consultoria	consultant-api	Liberada pelo time de integração

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

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

MÉTODO

PUT

STATUS

202

Exemplo - Pessoa Jurídica

Request Body

{
    "01": "A",
    "02": "A",
    "03": "A",
    "04": "A",
    "05": "A",
    "06": "A",
    "07": "A",
    "08": "A",
    "09": "A"
}

Body params

Campo	Tipo	Descrição	Caracteres	Obrigatório
01..NN	string	Resposta para cada questão do formulário. Valor é a letra da alternativa (A–D)	1	Sim*

* As chaves numéricas (01, 02, ...) representam o número da questão; o valor deve ser uma única letra maiúscula correspondente à alternativa escolhida.

Response

O corpo traz o objeto data da análise com os blocos já gravados. Para status e demais campos, consulte Busca informações de uma análise cadastral do investidor.

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	IVR000271	Investidor não residente sem profile: not_applicable
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.