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/v2/investor/{investor_key}/investor_analysis/{investor_analysis_key}/registry_data

MÉTODO

PUT

STATUS

202

Caso 01: Pessoa jurídica - Fundo de Investimento

Request Body

{
      "name": "Fundo Sample",
      "foundation_date": "2024-12-31",
      "activity_code": "6470-1-01",
      "phone": {
        "international_dial_code": "+55", 
        "number": "993080985", 
        "area_code": "31"
      },
      "fund_class": {
        "cvm_code": "480274",
        "giin_code": "1ZT8DV.99999.SL.076",
        "administrator": {
            "name": "Sample Administrator",
            "document_number": "07.228.314/0001-95"
        },
        "manager": {
            "name": "Sample Manager",
            "document_number": "77.784.920/0001-72"
        },
        "exclusive_investor": {
            "name": "Sample Investor",
            "document_number": "240.610.880-50",
            "person_type": "natural_person"
        },
        "selic_account": "4298-6",
        "cetip_account": "3T6O05700-3"
      }
  }
  

Body params

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome do Investidor	-	Sim
foundation_date	string	Data de constituição da entidade	-	Sim
activity_code	string	CNAE principal associado ao investidor	xx.xx-x-xx	Sim
phone	object	Número de contato do investidor	-	Sim
fund_class	object	Dados específicos para investidor que é Fundo de Investimento	-	Não

Fund Class

Campo	Tipo	Descrição	Caracteres	Obrigatório
cvm_code	string	Código CVM	1 - 50	Sim
giin_code	string	Código GIIN	1 - 50	Sim
selic_account	string	Conta Selic	1 - 50	Sim
cetip_code	string	Conta CETIP	1 - 50	Sim
administrator	object	Objeto que define o adminstrador do Fundo de Investimento	-	Sim
manager	object	Objeto que define o gestor do Fundo de Investimento	-	Sim
exclusive_investor	object	Objeto que define o investidor exclusivo do Fundo de Investimento, caso exista	-	Não

Administrator

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome da Administradora	1 - 100	Sim
document_number	string	CNPJ da Administradora	18	Sim

Manager

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome da Gestora	1 - 100	Sim
document_number	string	CNPJ da Gestora	18	Sim

Exclusive Investor

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome do Investidor Exclusivo	1 - 100	Sim
document_number	string	CPF ou CNPJ do Investidor Exclusivo	13 - 18	Sim
person_type	string	legal_person ou natural_person	-	Não
related_parties	list	lista de objetos que definem o(s) beneficiário(s) final(is), caso se aplique - apenas para legal_person	-	Sim

Atenção

Os beneficiários finais são definidos como pessoas físicas que componham a estrutura societária (seja fundo de investimento ou companhia) que detenham 20% ou mais da entidade. Caso as empresas possuam related_parties, essas por sua vez, devem abrir a cadeia até chegar aos beneficiários finais, como descrito acima.

Related Parties

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome do Investidor Exclusivo	1 - 100	Sim
document_number	string	CPF ou CNPJ do Investidor Exclusivo	13 - 18	Sim
person_type	string	legal_person ou natural_person	-	Sim
related_parties	list	lista de objetos que definem o(s) beneficiário(s) final(is), caso se aplique - apenas para legal_person	-	Não
ultimate_owner	string	Define se a pessoa é beneficiário final	bool	Não

Response

Response Body

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