创建关联方

---

简介

本资源旨在识别与法人投资者相关的最终受益人（自然人）和控制人，如合伙人、董事、管理员等。

注意

• 必须创建至少一个关联方
• 至少一个关联方必须具有 legal_representative: true
• 对于法人关联方，related_party_type 必须为 parent_company
• 此端点需多次调用，每个关联方调用一次

关于最终受益人

最终受益人是最终行使公司控制权或重大影响力的自然人，特别是直接或间接持有15%或以上股份、担任管理职位或代表公司履行法律目的的人。

请提供直接或间接持有15%或以上股权的自然人及管理员的数据。如果没有合伙人/股东单独持有等于或超过15%的股份，则请发送持有最大百分比股份的3位控制人的信息。

输入/输出：

作为输入，需发送关联方数据。

作为输出，将返回 related_party_key 和所创建关联方的详情。

Request

ENDPOINT

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

MÉTODO

POST

STATUS

201

Request body

示例：自然人合伙人

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"
    }
}

示例：母公司（法人）

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

字段	类型	描述	字符数	必填
name	string	关联方姓名	1 - 255	是
document_number	string	CPF 或 CNPJ	1 - 18	是
person_type	string	Person Type 枚举值	-	是
related_party_type	string	Related Party Type 枚举值	-	是
resident	boolean	定义是否为巴西居民	-	是
legal_representative	boolean	定义是否为法定代表人	-	是
direct_beneficiary	boolean	定义是否为直接受益人	-	是
address	object	Address 对象	-	是
participation_percentage	number	持股比例（0 到 1）	-	是
email	string	电子邮件	1 - 100	否
phone	object	Phone 对象	-	否
monthly_income	number	月收入	-	否
expiration_date	string	过期日期（格式：YYYY-MM-DD）	10	否

Person Type (Related Party)

枚举值	描述
natural_person	自然人
legal_person	法人

Related Party Type

枚举值	描述
president	董事长
partner	合伙人
administrator	管理员
director	董事
manager	经理
attorney	代理人
parent_company	母公司（仅限法人）
asset_custodian	资产托管人

Address

字段	类型	描述	字符数	必填
postal_code	string	邮政编码	9	是
street	string	街道	1 - 255	否
number	string	门牌号	1 - 10	否
neighborhood	string	社区	1 - 255	否
city	string	城市	1 - 255	否
uf	string	州	2	否
country	string	国家	3	否
complement	string	补充信息	1 - 255	否

Phone

字段	类型	描述	字符数	必填
international_dial_code	string	国际区号	1 - 3	是
area_code	string	地区区号	2	是
number	string	电话号码	8 - 9	是

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": {...}
}