发送投资者注册数据

---

简介

本资源旨在发送构成投资者注册分析的、该人员特有的注册数据。

请求体必须包含 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"），此步骤为必需——发送包含联系信息的 legal_person 数据块，并在适用时发送 giin_number。

公司名称、成立日期和净资产无需发送：在提交分析进行验证时，会根据 CVM 数据库自动填写。

Request

ENDPOINT

/investor_registry/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": "1234567890"
    },
    "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": "1234567890"
    },
    "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 对象——法人必填	-	是*

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

Natural Person

字段	类型	描述	字符数	必填
birthdate	string	出生日期（YYYY-MM-DD）	10	是
mother_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 对象，其中包含已保存的数据块。状态及其他字段请参阅查询投资者注册分析信息。

---

错误

状态	代码	发生情形
400	IVR000018	分析已不处于 pending_registry_data 状态（已提交或已结束）
400	IVR000224	非居民投资者未提供 nif_number
400	IVR000225	non_resident_type 与创建投资者时传入的值不同
422	IVR000245 / IVR000246 / IVR000249	基金类别在 CVM 未找到、已注销或未处于运营状态
400	QIT000011	通过管理人（manager-api）调用时：该投资者不是与其关联的基金类别

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