Criar investidor

---

Introdução

Este recurso tem como objetivo nos informar dados básicos para iniciar o cadastro de um investidor.

A criação de um investidor já dispara, em conjunto, a abertura de uma primeira análise cadastral vinculada a ele. Por isso, ao final desta chamada são retornadas duas chaves: investor_key (identifica o investidor) e investor_analysis_key (identifica a análise cadastral em andamento).

Informação

No ambiente de Homologação, temos a seguinte regra para aprovações: CNPJ com início 1: reprovação automática; CNPJ com início 8: pendente de validação manual; o restante é aprovado automaticamente.

Input / Output

Como input envie os dados básicos do investidor.

Como output serão retornadas a investor_key e a investor_analysis_key. A investor_key identifica o investidor; a investor_analysis_key identifica a análise cadastral aberta junto com a criação. Um mesmo investidor pode possuir mais de uma análise cadastral ao longo do tempo (renovações, atualizações).

Request

ENDPOINT

/investor_registry/investor

MÉTODO

POST

STATUS

201

Request body

Caso 03: Pessoa Jurídica — Fundo de Investimento (fund_class)

Request Body

{
    "name": "Fundo XPTO Multimercado",
    "document_number": "12.345.678/0001-90",
    "person_type": "legal_person",
    "investor_sub_type": "fund_class"
}

Investidores fund_class

Para fundos de investimento (investor_sub_type: "fund_class"), parte dos dados cadastrais é preenchida automaticamente a partir da base da CVM no momento do envio para análise — incluindo razão social, data de constituição, patrimônio e vínculos com administrador, gestor e (quando aplicável) investidor exclusivo.

Body params

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome (ou razão social) do investidor	1 - 255	Sim
person_type	string	Enumerador de Person Type	-	Sim
document_number	string	CNPJ (XX.XXX.XXX/XXXX-XX)	18	Sim*
investor_sub_type	string	Enumerador de Investor Sub Type	-	Não

Person Type

Enumerador	Descrição
legal_person	Pessoa jurídica

Investor Sub Type

Enumerador	Descrição
fund_class	Fundo de investimento — dispara enriquecimento automático com dados públicos da CVM

Response

Response Body

{
    "investor_key": "UUID",
    "investor_analysis_key": "UUID"
}