Pular para o conteúdo principal

Enviar dados Cadastrais do Investidor


Request

ENDPOINT
/investor_registry/distributor/DISTRIBUTOR_KEY/investor/INVESTOR_KEY/investor_analysis/INVESTOR_ANALYSIS_KEY
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 | legal_person",
"investor_sub_type": "resident | non_resident | financial_institution | fund_class",
"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

CampoTipoDescriçãoCaracteresObrigatório
invested_valuefloatValor investido-Sim
monthly_incomefloatRenda mensal-Sim
is_politically_exposed_personbooleanSe o investidor é uma Pessoa Exposta Politicamente (PEP) ou não-Sim
person_typestringEnumerador de Person Type-Sim
investor_sub_typestringEnumerador de Investor Sub Type-Sim
investor_categorystringEnumerador de Investor Category-sim
bank_accountsarrayLista de objetos de Bank Account-sim
natural_personJSONObjeto de Natural Person-Não
legal_personJSONObjeto de Legal Person-Não
addressJSONObjeto de Address-Sim

Bank Account

CampoTipoDescriçãoCaracteresObrigatório
financial_institution_codestringCódigo da instituição financeira1 - 4Sim
account_numberstringNúmero da conta1 - 20Sim
account_digitstringDígito verificador da conta1Sim
account_branchstringNúmero da agência1 - 4Sim

Natural Person

CampoTipoDescriçãoCaracteresObrigatório
birthdatestringData de nascimento10Sim
genderstringEnumerador de Gender1 - 6Sim
mother_namestringNome da mãe do investidor1 - 255Sim
nationalitystringNacionalidade1 - 255Não
marital_statusstringEstado civil1 - 255Não
occupationstringProfissão1 - 255Não
CampoTipoDescriçãoCaracteresObrigatório
foundation_datestringData de fundação10Não
activity_codestringClassificação Nacional das Atividades Econômicas (CNAE)10Sim
annual_revenuesfloatReceitas anuais-Não
representativesarrayLista de objetos de Representative-Sim

Representative

CampoTipoDescriçãoCaracteresObrigatório
namestringNome do representante1 - 255Sim
document_numberstringCPF do representante14Sim
emailstringE-mail1 - 255Sim
phonestringObjeto de Phone-Não
addressstringObjeto de Address-Não
representative_typestringEnumerador de Gender-Sim
natural_personstringObjeto de Natural Person-Não

Phone

CampoTipoDescriçãoCaracteresObrigatório
international_dial_codestringCódigo internacional1 - 3Sim
area_codestringCódigo de área2Sim
numberstringNúmero de telefone8 - 9Sim

Address

CampoTipoDescriçãoCaracteresObrigatório
streetstringLogradouro1 - 255Sim
numberstringNúmero1 - 10Sim
neighborhoodstringBairro1 - 255Sim
citystringCidade1 - 255Sim
postal_codestringCEP9Sim
ufstringEstado. Ex.: SP / CE / MG2Sim
countrystringPaís. Ex.: BRA / EUA / ARG3Sim
complementstringComplemento1 - 255Não

Person Type

EnumeradorDescrição
natural_personPessoa física
legal_personPessoa jurídica

Investor Sub Type

EnumeradorDescrição
residentInvestidor residente
non-residentInvestidor não residente
financial_institutionInstituição financeira
fund_classClasse de fundo de investimento

Investor Category

EnumeradorDescrição
retailInvestidor varejo
qualifiedInvestidor qualificado
professionalInstituição profissional

Gender

EnumeradorDescrição
maleMasculino
femaleFeminino

Response

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