发送投资者注册数据

---

简介

本资源旨在向我们提供与人员类型相关的注册数据，这些数据将构成投资者的注册分析。

输入/输出：

作为输入，需根据投资者类型（natural_person 或 legal_person）发送相应的注册数据。

作为输出，将返回 investor_key 和 investor_analysis_key。

Request

ENDPOINT

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

MÉTODO

PUT

STATUS

202

Request body

示例：发送自然人注册数据

Request Body

{
    "name": "João da Silva",
    "email": "joao.silva@example.com",
    "phone": {
        "international_dial_code": "55",
        "area_code": "11",
        "number": "1234567890"
    },
    "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": "123.456.789-00"
        },
        "profession": "Engenheiro",
        "occupation": "Engenheiro de Software",
        "occupation_company": {
            "name": "Empresa XYZ Ltda",
            "document_number": "12.345.678/0001-90"
        }
    }
}

示例：发送法人注册数据

Request Body

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

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 时，natural_person 为必填。当 person_type 为 legal_person 时，legal_person 为必填。

Natural Person

字段	类型	描述	字符数	必填
birthdate	string	出生日期（格式：YYYY-MM-DD）	10	是
gender	string	性别。Gender 枚举值	1-6	否
mother_name	string	母亲全名	1-255	是
nationality	string	国籍	1-255	是
place_of_birth	object	Place of Birth 对象	-	是
marital_status	string	婚姻状态	1-255	是
spouse	object	Spouse 对象	-	否
profession	string	职业	1-255	是
occupation	string	职位	1-255	是
occupation_company	object	Occupation Company 对象	-	否

Gender

枚举值	描述
male	男
female	女

Place of Birth

字段	类型	描述	字符数	必填
country	string	国家	-	否
uf	string	州 (UF)	-	否
city	string	城市	-	否

Spouse

字段	类型	描述	字符数	必填
name	string	配偶全名	1-255	是
document_number	string	配偶 CPF 或 CNPJ	14	是

Occupation Company

字段	类型	描述	字符数	必填
name	string	公司名称	1-255	是
document_number	string	公司 CNPJ	18	是

Legal Person

字段	类型	描述	字符数	必填
legal_name	string	公司注册名称	1-255	是
constitution_date	string	公司成立日期（格式：YYYY-MM-DD）	10	是

Phone

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

Response

Response Body

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

---