Enviar Patrimônio do Investidor

---

Introdução

Este recurso registra as informações de patrimônio e enquadramento do investidor (varejo, qualificado ou profissional).

Classe de fundo (fund_class) — etapa pulada

Classes de fundo não enviam patrimônio. Ele é calculado automaticamente a partir dos dados públicos da CVM ao enviar a análise para validação, e o submit não exige o bloco net_worth para esse subtipo. Pule esta etapa.

Input / Output

Como input envie os valores patrimoniais e a categoria autodeclarada do investidor.

Como output é retornado o objeto data da análise, com os blocos cadastrais já gravados.

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}/net_worth

MÉTODO

PUT

STATUS

202

Exemplo

Request Body

{
    "investor_category": "retail",
    "total_net_worth": 250000,
    "total_financial_applications": 80000,
    "monthly_income": 15000,
    "other_incomes": 0,
    "real_estate": 150000,
    "movable_assets": 20000,
    "resource_origin": "Renda do trabalho"
}

Body params

Campo	Tipo	Descrição	Obrigatório
total_net_worth	number	Patrimônio total (>= 0)	Sim
total_financial_applications	number	Total em aplicações financeiras (>= 0)	Sim
monthly_income	number	Renda ou faturamento mensal (>= 0)	Sim
other_incomes	number	Outras rendas mensais (>= 0)	Sim
real_estate	number	Patrimônio em imóveis (>= 0)	Sim
movable_assets	number	Patrimônio em bens móveis (>= 0)	Sim
investor_category	string	Enumerador de Investor Category	Sim
resource_origin	string	Origem dos recursos (até 255 caracteres)	Não

Investor Category

Enumerador	Descrição
retail	Varejo
qualified	Qualificado
professional	Profissional

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	IVR000091	other_incomes maior que zero sem resource_origin
400	IVR000270	Investidor não residente com investor_category diferente de professional
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.