发送投资者注册数据

---

简介

本资源用于发送构成投资者注册分析的人员的特定注册数据。

发送的请求体必须包含 natural_person 或 legal_person 中的一个区块，并与创建投资者时填写的 person_type 一致。

Input / Output

输入为该投资者类型的特定注册数据。

输出将返回分析的 data 对象，其中包含已保存的注册数据块（natural_person 或 legal_person、address、net_worth、suitability、email、phone）以及 resident。响应中不包含投资者和分析的键：请使用您已有的键。

fund_class 投资者

对于投资基金（investor_sub_type: "fund_class"），法人信息（公司名称、成立日期等）会在提交分析进行验证时根据 CVM 数据库自动填写。该子类型无需执行此步骤。

Request

ENDPOINT

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

MÉTODO

PUT

STATUS

202

Request body

示例：自然人

请求体

{
    "name": "João da Silva",
    "email": "joao.silva@example.com",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "987654321"
    },
    "natural_person": {
        "birthdate": "1990-05-15",
        "gender": "male",
        "mother_name": "Maria da Silva",
        "nationality": "BRA",
        "place_of_birth": {
            "country": "BRA",
            "uf": "SP",
            "city": "São Paulo"
        },
        "marital_status": "single",
        "spouse": {
            "name": "Maria Santos",
            "document_number": "969.698.790-03"
        },
        "profession": "Engenheiro",
        "occupation": "Engenheiro de Software",
        "occupation_company": {
            "name": "Empresa XYZ Ltda",
            "document_number": "22.333.444/0001-81"
        }
    }
}

示例：法人

请求体

{
    "name": "Empresa XPTO Ltda",
    "email": "contato@empresaxpto.com.br",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "33334444"
    },
    "legal_person": {
        "legal_name": "Empresa XPTO Limitada",
        "constitution_date": "2020-01-15"
    }
}

示例：法人（fund_class）

请求体

{
    "name": "Empresa XPTO Ltda",
    "email": "contato@empresaxpto.com.br",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "33334444"
    },
    "legal_person": {
        "giin_number": "XXXXXX.XXXXX.XX.XXX"
    }
}

Body params

字段	类型	描述	字符数	必填
name	string	投资者姓名（或公司名称）	1 - 255	否
email	string	联系邮箱	1 - 255	否
phone	object	Phone 对象	-	否
natural_person	object	Natural Person 对象——自然人必填	-	是*
legal_person	object	Legal Person 对象——法人必填	-	是*
nif_number	string	NIF（外国税务识别号）。非居民投资者必填（IVR000224）	1 - 50	条件必填
non_resident_type	string	只能重复创建投资者时发送的值（IVR000225）	-	否

* 必须根据投资者的 person_type，在 natural_person 和 legal_person 中恰好发送一个。

Natural Person

字段	类型	描述	字符数	必填
birthdate	string	出生日期（YYYY-MM-DD）	10	是
mother_name	string	母亲全名	1 - 255	是
father_name	string	父亲全名	1 - 255	否
nationality	string	国籍——3 位字母 ISO 代码（例如 BRA）	3	是
place_of_birth	object	Place of Birth 对象	-	是
marital_status	string	Marital Status 枚举值	-	是
profession	string	职业	1 - 255	是
occupation	string	职位	1 - 255	是
gender	string	Gender 枚举值	-	否
spouse	object	Spouse 对象	-	否
occupation_company	object	Occupation Company 对象	-	否

Gender

枚举值	描述
male	男
female	女

Marital Status

枚举值	描述
single	未婚
married	已婚
civil_union	稳定同居关系
divorced	离异
widowed	丧偶
married_with_partial_community_property	已婚（部分共同财产制）

Place of Birth

字段	类型	描述	字符数	必填
country	string	国家 ISO 代码（3 位字母，例如 BRA）	3	是
uf	string	州（UF）	-	是
city	string	城市	-	是

Spouse

字段	类型	描述	字符数	必填
name	string	配偶全名	1 - 255	是
document_number	string	配偶 CPF（XXX.XXX.XXX-XX）	14	是

Occupation Company

字段	类型	描述	字符数	必填
name	string	公司名称	1 - 255	是
document_number	string	公司 CNPJ（XX.XXX.XXX/XXXX-XX）	18	是

Legal Person

字段	类型	描述	字符数	必填
legal_name	string	公司注册名称	1 - 255	否
constitution_date	string	成立日期（YYYY-MM-DD）	10	否
giin_number	string	GIIN（Global Intermediary Identification Number），如适用	1 - 20	否

Phone

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

Response

响应体返回分析的 data 对象，其中包含已保存的数据块。状态及其他字段请参阅 查询投资者注册分析信息。

---

错误

认证、权限和主机相关错误：参见 API 错误。