Criar Investor Owner

---

Introdução

Este recurso cria um vínculo de propriedade / responsabilidade (investor_owner) entre o investidor da análise e outro investidor já existente no sistema (identificado pelo CNPJ informado). É utilizado principalmente em fluxos de carteira administrada para registrar o gestor de carteira.

Quando usar

• Para fundos de investimento (fund_class), os vínculos com administrador e gestor são criados automaticamente ao enviar a análise para validação, com base nos dados públicos da CVM. Este endpoint deve ser usado para registrar vínculos adicionais (ex.: investidor exclusivo, gestor de carteira), ou para fluxos diferentes do auto-enriquecimento.
• O investidor referenciado pelo document_number precisa estar previamente cadastrado no distribuidor.

Input / Output

Como input envie o CNPJ do investidor que será o "owner" e o tipo do vínculo.

Como output o status 201 Created é retornado.

Request

ENDPOINT

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

MÉTODO

POST

STATUS

201

Request body

Request Body

{
    "investor_owner_type": "wallet_manager",
    "document_number": "07.228.314/0001-95"
}

Body params

Campo	Tipo	Descrição	Caracteres	Obrigatório
investor_owner_type	string	Enumerador de Investor Owner Type	1 - 50	Sim
document_number	string	CNPJ do investidor que será o owner (XX.XXX.XXX/XXXX-XX)	18	Sim
external_investor_owner_key	string	Chave externa pré-definida para este vínculo. Caso omitida, é gerada automaticamente	1 - 36	Não

Investor Owner Type

Enumerador	Descrição
fund_class_administrator	Administrador do fundo
fund_class_manager	Gestor do fundo
wallet_manager	Gestor de carteira

Atualizar status de um Investor Owner

Para inativar ou reativar um vínculo, utilize:

ENDPOINT

/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/investor_owner/{external_investor_owner_key}/status

MÉTODO

PUT

STATUS

202

Request Body

{
    "status": "active"
}