Cadastro de Representantes do Investidor

Este endpoint permite o cadastro de representantes associados a um investidor previamente cadastrado.

---

Request

ENDPOINT

/investor_management/investor/INVESTOR-KEY/investor_representative

MÉTODO

POST

Path Params

Campo	Tipo	Descrição	Caracteres
INVESTOR-KEY	string	Chave única do investidor (UUID v4).	36

Request Body

Request Body

{
  "name": "João da Silva",
  "document_number": "123.456.789-01",
  "birthdate": "1990-01-01",
  "nationality": "Brasileiro",
  "mother_name": "Maria da Silva",
  "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
  }
}

Request Body Params

Campo	Tipo	Descrição	Máximo de Caracteres
name *	string	Nome completo do representante do investidor.	255
document_number *	string	Número do documento (CPF). Deve conter exatamente 11 dígitos.	11
birthdate	string	Data de nascimento do representante no formato ISO 8601 (YYYY-MM-DD).	-
document_identification_number	string	Número do documento de identificação.	255
marital_status	string	Estado civil do representante.	Enumeradores marital_status
property_system	string	Regime de bens.	Enumeradores property_system
nationality	string	Nacionalidade do representante do investidor.	255
mother_name	string	Nome completo da mãe do representante.	1023
father_name	string	Nome completo do pai do representante.	1023
occupation	string	Ocupação ou profissão do representante.	255
is_pep	boolean	Indica se o representante é uma Pessoa Politicamente Exposta (PEP).	-
address *	string	Objeto referenciando o endereço	Objeto address

Objeto Address

Campo	Tipo	Descrição	Caracteres Máx.
street *	string	Nome da rua do endereço da empresa.	500
neighborhood	string	Nome do bairro do endereço da empresa.	100
number *	string	Número do endereço.	10
postal_code *	string	CEP do endereço (somente números).	8
city *	string	Nome da cidade do endereço.	255
state *	string	Sigla do estado (2 caracteres).	2
complement	string	Complemento do endereço, se aplicável.	100

Enumeradores marital_status

Enum	Description
single	Solteiro(a)
married	Casado(a)
widower	Viúvo(a)
separated	Separado(a)
stable_union	em União Estável
divorced	Divorciado(a)

Enumeradores property_system

Enum	Description
total_communion_of_goods	Comunhão Total de Bens
partial_communion_of_goods	Comunhão Parcial de Bens
total_separation_of_goods	Separação Total de Bens
final_participation_of_acquisitions	Participação Final nos Aquestos
compulsory_separation_of_goods	Separação Compulsória de Bens

Response

STATUS

201

Response Body

{
  "investor_representative_key": "123e4567-e89b-12d3-a456-426614174000",
  "name": "João da Silva",
  "document_number": "123.456.789-01",
  "document_identification_number": "987654321",
  "marital_status": "single",
  "property_system": "partial_communion_of_goods",
  "birthdate": "1990-01-01",
  "nationality": "Brasileiro",
  "mother_name": "Maria da Silva",
  "father_name": "José da Silva",
  "occupation": "Advogado",
  "is_pep": false,
  "address": {
      "street": "Rua das Empresas",
      "neighborhood": "Centro",
      "number": "123",
      "postal_code": "01001-000",
      "city": "São Paulo",
      "state": "SP",
      "complement": "Sala 101"
  },
  "investor_representative_document_list": []
}

Response Body Params

Campo	Tipo	Descrição	Máximo de Caracteres
investor_representative_key	string	Identificador único do representante do investidor (UUID v4).	36
name	string	Nome completo do representante do investidor.	255
document_number	string	Número do documento do representante (formato CPF).	11
document_identification_number	string	Número do documento de identificação.	255
marital_status	string	Estado civil do representante.	Enumeradores marital_status
property_system	string	Regime de bens.	Enumeradores property_system
birthdate	string	Data de nascimento do representante.	-
nationality	string	Nacionalidade do representante do investidor.	255
mother_name	string	Nome completo da mãe do representante.	1023
father_name	string	Nome completo do pai do representante.	1023
occupation	string	Ocupação ou profissão do representante.	255
is_pep	boolean	Indica se o representante é uma Pessoa Politicamente Exposta (PEP).	-
address *	string	Objeto referenciando o endereço	Objeto address
investor_representative_document_list	array	Lista de documentos associados ao representante.	-