跳到主要内容

发送投资者注册数据

简介​

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

请求体必须包含 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 数据库自动填写。

适用范围
角色主机
投资者investor-api

各主机的 Base URL：环境（主机）。

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​

字段类型描述字符数必填
namestring投资者姓名（或公司名称）1 - 255否
emailstring联系电子邮箱1 - 255否
phoneobjectPhone 对象-否
natural_personobjectNatural Person 对象——自然人必填-是*
legal_personobjectLegal Person 对象——法人必填-是*

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

Natural Person​

字段类型描述字符数必填
birthdatestring出生日期（YYYY-MM-DD）10是
mother_namestring母亲全名1 - 255是
nationalitystring国籍——3 位字母 ISO 代码（例如：BRA）3是
place_of_birthobjectPlace of Birth 对象-是
marital_statusstringMarital Status 枚举值-是
professionstring职业1 - 255是
occupationstring职务1 - 255是
genderstringGender 枚举值-否
spouseobjectSpouse 对象-否
occupation_companyobjectOccupation Company 对象-否

Gender​

枚举值描述
male男
female女

Marital Status​

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

Place of Birth​

字段类型描述字符数必填
countrystring国家 ISO 代码（3 位字母，例如：BRA）3否
ufstring州（UF）-否
citystring城市-否

Spouse​

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

Occupation Company​

字段类型描述字符数必填
namestring公司名称1 - 255是
document_numberstring公司 CNPJ（XX.XXX.XXX/XXXX-XX）18是
字段类型描述字符数必填
legal_namestring公司法定名称1 - 255否
constitution_datestring成立日期（YYYY-MM-DD）10否
giin_numberstringGIIN（Global Intermediary Identification Number），适用时提供1 - 20否

Phone​

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

Response​

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

错误​

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

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