创建投资者/投资者分析

---

简介

本资源旨在向我们提供启动投资者注册分析所需的基本数据。 注册分析有2种类型：自然人和法人。法人又有子类型，用于区分注册过程中所需的信息。

信息

在同质化环境中，我们有如下规则：以1开头的 CPF/CNPJ：自动拒绝；以8开头的 CPF/CNPJ：待人工验证；其余自动批准。

注册流程

法人投资者注册遵循以下步骤：

1. 创建投资者 - 初始创建投资者和注册分析
2. 发送注册数据 - 法人具体数据
3. 发送地址 - 地址信息
4. 发送净资产 - 净资产数据
5. 发送银行账户 - 银行账户信息
6. 发送适配度 - 适配度问卷（零售投资者必须）
7. 发送签署人组 - 定义签署人组
8. 发送投资者文件 - 上传必要文件
9. 创建关联方 - 注册合伙人、董事、管理员等
10. 发送关联方文件 - 上传关联方文件
11. 发送分析 - 提交注册分析
12. 签署文件 - 批准后签署文件

输入/输出：

每种注册分析类型需要不同的输入数据集，以下是启动每种流程的示例。

作为输出，将返回 investor_key 和 investor_analysis_key。investor_analysis_key 用于标识创建的注册分析。 investor_key 用于标识注册分析所属的投资者。

因此，一个 investor_key（投资者）可以关联一个或多个 investor_analysis_key（注册分析）。

investor_key 和 investor_analysis_key 都将用于与投资者或注册分析交互的其他端点。

Request

ENDPOINT

/investor_registry/v2/investor

MÉTODO

POST

STATUS

201

Request body

Request Body

{
    "name": "string",
    "document_number": "xx.xxx.xxx/xxxx-xx",
    "person_type": "legal_person | natural_person",
    "person_sub_type": "regular | fund_class",
    "external_distribution_key": "campo livre",
    "email": "string",
    "phone": {
	    "international_dial_code": "+xx",
	    "area_code": "xx",
	    "number": "xxxxxxxxxx"
    }
}

注意

必填字段根据 person_type 有所不同。

• 如果是 natural_person（自然人）：

  • name、document_number、person_type、email 和 phone 为必填字段

• 如果是 legal_person（法人）：

  • name、document_number、person_type 为必填字段

• 如果是 nominee（PCO）：

  • name、person_type、external_distribution_key 为必填字段

信息

registry_user 是代表将填写投资者注册数据的用户的实体。 对于自然人，投资者本人填写其注册数据。

情况02：注册法人

Request Body

{
  "name": "Fundo XPTO", 
  "document_number": "12.456.789/0001-00", 
  "person_type": "legal_person",
  "person_sub_type": "regular",
  "registry_user": {
    "name": "José da Silva", 
    "document_number": "123.456.789-00",
    "email": "example@example.com",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "1234567890"
    },
  }
}

Body params

字段	类型	描述	字符数	必填
name	string	投资者姓名	1-255	是
document_number	string	CPF 或 CNPJ	13-18	是
person_type	string	Person Type 枚举值	-	是
person_sub_type	string	Person Sub Type 枚举值	-	是
email	string	电子邮件	1-255	否
phone	JSON	Phone 对象	-	否
registry_user	JSON	Registry User 对象	-	否

Phone

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

Registry User

字段	类型	描述	字符数	必填
name	string	注册用户姓名	1-255	是
document_number	string	CPF	13	是
person_type	string	Person Type 枚举值	-	是
email	string	电子邮件	1-255	是
phone	JSON	Phone 对象	-	是

Person Type

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

Person Sub Type

枚举值	描述
regular	-
fund_class	投资基金

Response

Response Body

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