Enviar Dados Cadastrais do Investidor

---

Introdução

Este recurso tem como objetivo enviar os dados cadastrais específicos da pessoa que compõe a análise cadastral de um investidor.

O corpo enviado deve conter um dos blocos natural_person ou legal_person, coerente com o person_type informado na criação do investidor.

Input / Output

Como input envie os dados cadastrais específicos do tipo de investidor.

Como output será retornada a representação atualizada da análise cadastral. As chaves investor_key e investor_analysis_key identificam o investidor e a análise atualizada.

Investidor fund_class

Para fundos de investimento (investor_sub_type: "fund_class"), as informações da pessoa jurídica (razão social, data de constituição, etc.) são preenchidas automaticamente a partir da base da CVM ao enviar a análise para validação. Esta etapa não é necessária para esse subtipo.

Request

ENDPOINT

/investor_registry/v2/investor/{investor_key}/investor_analysis/{investor_analysis_key}/registry_data

MÉTODO

PUT

STATUS

202

Request body

Exemplo: Pessoa Física

Request Body

{
    "name": "João da Silva",
    "email": "joao.silva@example.com",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "987654321"
    },
    "natural_person": {
        "birthdate": "1990-05-15",
        "gender": "male",
        "mother_name": "Maria da Silva",
        "nationality": "BRA",
        "place_of_birth": {
            "country": "BRA",
            "uf": "SP",
            "city": "São Paulo"
        },
        "marital_status": "single",
        "spouse": {
            "name": "Maria Santos",
            "document_number": "123.456.789-00"
        },
        "profession": "Engenheiro",
        "occupation": "Engenheiro de Software",
        "occupation_company": {
            "name": "Empresa XYZ Ltda",
            "document_number": "12.345.678/0001-90"
        }
    }
}

Exemplo: Pessoa Jurídica

Request Body

{
    "name": "Empresa XPTO Ltda",
    "email": "contato@empresaxpto.com.br",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "1234567890"
    },
    "legal_person": {
        "legal_name": "Empresa XPTO Limitada",
        "constitution_date": "2020-01-15"
    }
}

Exemplo: Pessoa Jurídica (fund_class)

Request Body

{
    "name": "Empresa XPTO Ltda",
    "email": "contato@empresaxpto.com.br",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "1234567890"
    },
    "legal_person": {
        "giin_number": "XXXXXX.XXXXX.XX.XXX",
    }
}

Body params

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome (ou razão social) do investidor	1 - 255	Não
email	string	E-mail de contato	1 - 255	Não
phone	object	Objeto de Phone	-	Não
natural_person	object	Objeto de Natural Person — obrigatório para pessoa física	-	Sim*
legal_person	object	Objeto de Legal Person — obrigatório para pessoa jurídica	-	Sim*

* É obrigatório enviar exatamente um entre natural_person ou legal_person, de acordo com o person_type do investidor.

Natural Person

Campo	Tipo	Descrição	Caracteres	Obrigatório
birthdate	string	Data de nascimento (YYYY-MM-DD)	10	Sim
mother_name	string	Nome completo da mãe	1 - 255	Sim
nationality	string	Nacionalidade — código ISO de 3 letras (ex.: BRA)	3	Sim
place_of_birth	object	Objeto de Place of Birth	-	Sim
marital_status	string	Enumerador de Marital Status	-	Sim
profession	string	Profissão	1 - 255	Sim
occupation	string	Ocupação	1 - 255	Sim
gender	string	Enumerador de Gender	-	Não
spouse	object	Objeto de Spouse	-	Não
occupation_company	object	Objeto de Occupation Company	-	Não

Gender

Enumerador	Descrição
male	Masculino
female	Feminino

Marital Status

Enumerador	Descrição
single	Solteiro(a)
married	Casado(a)
civil_union	União estável
divorced	Divorciado(a)
widowed	Viúvo(a)
married_with_partial_community_property	Casado(a) em comunhão parcial de bens

Place of Birth

Campo	Tipo	Descrição	Caracteres	Obrigatório
country	string	Código ISO do país (3 letras, ex.: BRA)	3	Não
uf	string	Estado (UF)	-	Não
city	string	Cidade	-	Não

Spouse

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome completo do cônjuge	1 - 255	Sim
document_number	string	CPF do cônjuge (XXX.XXX.XXX-XX)	14	Sim

Occupation Company

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome da empresa	1 - 255	Sim
document_number	string	CNPJ da empresa (XX.XXX.XXX/XXXX-XX)	18	Sim

Legal Person

Campo	Tipo	Descrição	Caracteres	Obrigatório
legal_name	string	Razão social da empresa	1 - 255	Não
constitution_date	string	Data de constituição (YYYY-MM-DD)	10	Não
giin_number	string	GIIN (Global Intermediary Identification Number), quando aplicável	1 - 20	Não

Phone

Campo	Tipo	Descrição	Caracteres	Obrigatório
international_dial_code	string	Código internacional	1 - 3	Sim
area_code	string	DDD	2	Sim
number	string	Número de telefone	8 - 9	Sim

Response

A análise cadastral atualizada é retornada no corpo da resposta. Para o formato completo, consulte Busca informações de uma análise cadastral do investidor.

---