Criar Parte Relacionada

---

Introdução

Este recurso tem como objetivo identificar os beneficiários finais (pessoas físicas) e controladores relacionados ao investidor pessoa jurídica, como sócios, diretores, administradores, etc.

Atenção

• É obrigatório criar pelo menos uma parte relacionada
• É obrigatório que pelo menos uma parte relacionada tenha legal_representative: true
• Para pessoa jurídica como parte relacionada, o related_party_type deve ser parent_company
• Este endpoint deve ser chamado múltiplas vezes, uma vez para cada parte relacionada

Sobre os Beneficiários Finais

Beneficiário Final é a pessoa natural que, em última instância exerce posição de controle ou influência significativa na empresa, especialmente as que detêm 15% ou mais de participação direta ou indireta, exercem cargo de administração ou representam a empresa para fins legais.

Informar os dados das pessoas físicas que detêm 15% ou mais de participação societária direta ou indireta e administradores. Se nenhum dos sócios/acionistas detém individualmente participação igual ou maior a 15%, solicitamos enviar as informações dos 03 controladores que detêm os maiores percentuais de participação.

Input / Output:

Como input deve ser enviado os dados da parte relacionada.

Como output será entregue uma related_party_key e os detalhes da parte relacionada criada.

Request

ENDPOINT

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

MÉTODO

POST

STATUS

201

Request body

Exemplo: Sócio Pessoa Física

Request Body

{
    "name": "João Silva",
    "document_number": "123.456.789-00",
    "person_type": "natural_person",
    "related_party_type": "partner",
    "resident": true,
    "legal_representative": true,
    "direct_beneficiary": true,
    "address": {
        "postal_code": "01000-000",
        "street": "Rua das Flores",
        "number": "123",
        "neighborhood": "Centro",
        "city": "São Paulo",
        "uf": "SP",
        "country": "BRA",
        "complement": "Apto 101"
    },
    "participation_percentage": 0.5,
    "monthly_income": 50000.00,
    "email": "joao.silva@example.com",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "987654321"
    }
}

Exemplo: Empresa Controladora (Pessoa Jurídica)

Request Body

{
    "name": "Empresa Controladora Ltda",
    "document_number": "98.765.432/0001-11",
    "person_type": "legal_person",
    "related_party_type": "parent_company",
    "resident": true,
    "legal_representative": false,
    "direct_beneficiary": true,
    "address": {
        "postal_code": "02000-000",
        "street": "Avenida Principal",
        "number": "456",
        "neighborhood": "Jardim",
        "city": "São Paulo",
        "uf": "SP",
        "country": "BRA"
    },
    "participation_percentage": 0.8,
    "email": "contato@controladora.com.br",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "123456789"
    }
}

Body params

Campo	Tipo	Descrição	Caracteres	Obrigatório
name	string	Nome da parte relacionada	1 - 255	Sim
document_number	string	CPF ou CNPJ	1 - 18	Sim
person_type	string	Enumerador de Person Type	-	Sim
related_party_type	string	Enumerador de Related Party Type	-	Sim
resident	boolean	Define se é residente no Brasil	-	Sim
legal_representative	boolean	Define se é representante legal	-	Sim
direct_beneficiary	boolean	Define se é beneficiário direto	-	Sim
address	object	Objeto de Address	-	Sim
participation_percentage	number	Percentual de participação (0 a 1)	-	Sim
email	string	E-mail	1 - 100	Não
phone	object	Objeto de Phone	-	Não
monthly_income	number	Renda mensal	-	Não
expiration_date	string	Data de expiração (formato: YYYY-MM-DD)	10	Não

Person Type (Related Party)

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

Related Party Type

Enumerador	Descrição
president	Presidente
partner	Sócio
administrator	Administrador
director	Diretor
manager	Gestor
attorney	Procurador
parent_company	Empresa controladora (apenas para pessoa jurídica)
asset_custodian	Custodiante de ativos

Address

Campo	Tipo	Descrição	Caracteres	Obrigatório
postal_code	string	CEP	9	Sim
street	string	Logradouro	1 - 255	Não
number	string	Número	1 - 10	Não
neighborhood	string	Bairro	1 - 255	Não
city	string	Cidade	1 - 255	Não
uf	string	Estado	2	Não
country	string	País	3	Não
complement	string	Complemento	1 - 255	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

Response

Response Body

{
    "related_party_key": "UUID",
    "external_related_party_key": "UUID",
    "name": "João Silva",
    "document_number": "123.456.789-00",
    "person_type": "natural_person",
    "related_party_type": "partner",
    "status": "active",
    "resident": true,
    "legal_representative": true,
    "direct_beneficiary": true,
    "address": {...},
    "participation_percentage": 0.5,
    "monthly_income": 50000.00,
    "email": "joao.silva@example.com",
    "phone": {...}
}