Enviar dados Cadastrais do Investidor

---

Introdução

Este recurso tem como objetivo nos informar os dados cadastrais que vão compor a análise cadastral de um 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 será entregue uma investor_key e uma investor_analysis_key. A investor_analysis_key é utilizada para identificar a análise cadastral atualizada. A investor_key é utilizada para identificar o investidor ao qual a análise cadastral pertence.

Request

ENDPOINT

/investor_registry/investor/INVESTOR_KEY/investor_analysis/INVESTOR_ANALYSIS_KEY/registry_data

MÉTODO

PUT

STATUS

202

Caso 01: Pessoa física

Request Body

{
    "invested_value": 0.00,
    "monthly_income": 0.00,
    "is_politically_exposed_person": true,
    "person_type": "natural_person",
    "investor_sub_type": "resident | non_resident",
    "investor_category": "retail | qualified | professional" ,
    "bank_accounts": [
        {
            "financial_institution_code": "000",
            "account_number": "00000000000000000000",
            "account_digit": "0",
            "account_branch": "0000",
        }
    ],
    "natural_person": {
      "birthdate": "1999-01-01", 
      "gender": "male", 
      "mother_name": "Sample Mother Name",
    },
    "address": {
        "postal_code": "00000-000",
        "street": "Sample",
        "number": "123",
        "neighborhood": "Sample",
        "city": "São Paulo",
        "uf": "SP",
        "country": "BRA",
        "complement": "Sample",
    },
}

Caso 02: Pessoa jurídica

Request Body

{
    "invested_value": 0.00,
    "monthly_income": 0.00,
    "is_politically_exposed_person": true,
    "person_type": "legal_person",
    "investor_sub_type": "resident | non-resident | financial_institution | fund_class",
    "investor_category": "retail | qualified | professional" ,
    "email": "sample@gmail.com",
    "bank_accounts": [
        {
            "financial_institution_code": "000",
            "account_number": "00000000000000000000",
            "account_digit": "0",
            "account_branch": "0000",
        }
    ],
    "legal_person": {
        "activity_code": "11.11-1-11",
        "representatives": [
            {
                "name": "Sample Person",
                "document_number": "000.000.000-00",
                "email": "sample@email.com.br",
                "phone": {
                  "international_dial_code": "55",
                  "area_code": "11",
                  "number": "1234567890"
                },
                "representative_type": "president | partner | administrator | director | manager | attorney",
                "person_type": "natural_person",
                "natural_person": {
                    "mother_name": "Sample name",
                    "birthdate": "YYYY-MM-DD",
                },
                "address": {
                    "street": "Sample",
                    "number": "000",
                    "neighborhood": "Sample",
                    "city": "Sample",
                    "postal_code": "00000-000",
                    "uf": "SP",
                    "country": "BRA",
                    "complement": "sample",
                },
            }
        ],
    },
    "address": {
        "street": "Sample",
        "number": "000",
        "neighborhood": "Sample",
        "city": "Sample",
        "postal_code": "00000-000",
        "uf": "SP",
        "country": "BRA",
        "complement": "sample",
    },
}

Body params

Campo	Tipo	Descrição	Caracteres	Obrigatório
invested_value	float	Valor investido	-	Sim
monthly_income	float	Renda mensal	-	Sim
is_politically_exposed_person	boolean	Se o investidor é uma Pessoa Exposta Politicamente (PEP) ou não	-	Sim
person_type	string	Enumerador de Person Type	-	Sim
investor_sub_type	string	Enumerador de Investor Sub Type	-	Sim
investor_category	string	Enumerador de Investor Category	-	sim
bank_accounts	array	Lista de objetos de Bank Account	-	sim
natural_person	JSON	Objeto de Natural Person	-	Não
legal_person	JSON	Objeto de Legal Person	-	Não
address	JSON	Objeto de Address	-	Sim

Bank Account

Campo	Tipo	Descrição	Caracteres	Obrigatório
financial_institution_code	string	Código da instituição financeira	1 - 4	Sim
account_number	string	Número da conta	1 - 20	Sim
account_digit	string	Dígito verificador da conta	1	Sim
account_branch	string	Número da agência	1 - 4	Sim

Natural Person

Campo	Tipo	Descrição	Caracteres	Obrigatório
birthdate	string	Data de nascimento	10	Sim
gender	string	Enumerador de Gender	1 - 6	Sim
mother_name	string	Nome da mãe do investidor	1 - 255	Sim
nationality	string	Nacionalidade	1 - 255	Não
marital_status	string	Estado civil	1 - 255	Não
occupation	string	Profissão	1 - 255	Não

Legal Person

Campo	Tipo	Descrição	Caracteres	Obrigatório
foundation_date	string	Data de fundação	10	Não
activity_code	string	Classificação Nacional das Atividades Econômicas (CNAE)	10	Sim
annual_revenues	float	Receitas anuais	-	Não
representatives	array	Lista de objetos de Representative	-	Sim

Representative

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome do representante	1 - 255	Sim
document_number	string	CPF do representante	14	Sim
email	string	E-mail	1 - 255	Sim
phone	string	Objeto de Phone	-	Não
address	string	Objeto de Address	-	Não
representative_type	string	Enumerador de Gender	-	Sim
natural_person	string	Objeto de Natural Person	-	Não

Phone

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

Address

Campo	Tipo	Descrição	Caracteres	Obrigatório
street	string	Logradouro	1 - 255	Sim
number	string	Número	1 - 10	Sim
neighborhood	string	Bairro	1 - 255	Sim
city	string	Cidade	1 - 255	Sim
postal_code	string	CEP	9	Sim
uf	string	Estado. Ex.: SP / CE / MG	2	Sim
country	string	País. Ex.: BRA / EUA / ARG	3	Sim
complement	string	Complemento	1 - 255	Não

Person Type

Enumerador	Descrição
natural_person	Pessoa física
legal_person	Pessoa jurídica

Investor Sub Type

Enumerador	Descrição
resident	Investidor residente
non-resident	Investidor não residente
financial_institution	Instituição financeira
fund_class	Classe de fundo de investimento

Investor Category

Enumerador	Descrição
retail	Investidor varejo
qualified	Investidor qualificado
professional	Instituição profissional

Gender

Enumerador	Descrição
male	Masculino
female	Feminino

Response

Response Body

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