跳到主要内容

提交投资者注册进行分析

简介​

本资源将已填写完成的注册分析提交验证。自此之后，数据会发送至合规服务，并生成待签署的文件。

注意

注册分析以异步方式进行。建议集成状态变更 webhook 以跟踪进展——参见 注册分析生命周期。

前提条件​

只有当分析已具备以下全部数据时，submit 才会被接受。这些是此步骤中最常见的错误，且验证是按顺序进行的——每次拒绝都可能掩盖下一个待处理项，因此建议在重新提交前核对整个列表。

1. 必填数据块​

缺少任何一项时，将以 IVR000150 拒绝，其消息会准确列出缺失的键。

投资者必需的数据块
natural_personnatural_person, address, net_worth, suitability
legal_person (default, financial_institution)legal_person, address, net_worth
legal_person / fund_class无——见下文
基金类别没有必填数据块

对于 legal_person / fund_class，注册数据、地址和净资产会在 submit 时根据 CVM 公开数据库自动填写。适配度、签署人组和投资者文件同样不作要求。

唯一的条件性要求是关联方，且仅当该类别在 CVM 登记为专属类别时适用——见下文第 3 项。如果 CNPJ 不在 CVM 数据库中，则不会进行数据补全，submit 将以 IVR000068 被拒绝。

2. 适配度​

  • 自然人：始终必填。缺失时，IVR000150 会提示缺少 suitability 键
  • 法人 retail：必填——缺失时以 IVR000133 拒绝
  • 法人 qualified 或 professional：可选
  • 基金类别（fund_class）：不适用——跳过此步骤

3. 关联方与股权比例​

最低数量、法定代表人要求和合计比例因投资者类型而异。完整表格见 创建关联方——按投资者类型的要求。

4. 文件​

必要文件矩阵在此处验证，而不是在上传时——参见发送投资者文件页面中的必要文件一节。拒绝代码为 IVR000029（投资者文件）和 IVR000030（关联方文件），两者都会在消息中返回可接受选项的矩阵。

对于 fund_class，没有投资者文件矩阵。只可能要求关联方文件，且仅限专属类别。

5. 银行账户和签署人组​

  • 有效的银行账户：所有投资者都必须提供，基金类别也不例外。缺少时返回 IVR000178。参见发送投资者银行账户。
  • 有效的签署人组：没有 investor owner 的居民自然人和居民法人必须提供。缺少时返回 IVR000180。基金类别和非居民投资者无需提供。

6. Investor owners（仅 fund_class）​

基金类别需要一个有效的管理机构和一个有效的管理人。它们会在 submit 时根据 CVM 数据自动创建；Criar Investor Owner 端点用于处理额外的关联。缺失时以 IVR000164（管理机构）或 IVR000163（管理人）拒绝。

7. 运营中的类别（仅 fund_class）​

仅接受在 CVM 处于运营状态的类别。运营前、已终止、已注销或已被合并的类别将在分析中被拒绝。

8. 基金入会​

如果投资者在注册过程中选择了基金（参见 选择基金），submit 也会验证这些入会：

情形拒绝代码
有入会处于 rejected 状态IVR000233
有入会仍处于 selected 状态（资格尚未确定）IVR000235

重新提交前，请移除 rejected 的入会，或等待/强制完成资格确定。没有任何基金入会的分析不受此验证影响。

Input / Output​

请求体为可选——可以为空（null 或 {}）。发送时，可指定生成文件所使用的签署方式和签署人组。

作为输出，仅返回 investor_analysis_key。请通过 webhook 或查询分析来跟踪结果。

适用范围
角色主机
分销商distributor-api

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

Request​

ENDPOINT
/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/submit
MÉTODO
PUT
STATUS
202

Request body​

请求体可以为空（{}）——此时 API 使用该分析的默认签署方式和默认签署人组。如需覆盖这些值，请发送以下可选字段。

请求体
{
    "signature_method": "certifiqi",
    "external_signer_group_key": "3f8a5a3e-1f0a-4d9b-8a6e-9b4c0e7d8f12"
}

Body params​

字段类型描述必填
signature_methodstringSignature Method 枚举值否
external_signer_group_keystring本次分析所使用签署人组的外部键否

Signature Method​

集成方唯一可以传入的值为：

枚举值描述
certifiqi通过 CertifiQI 进行电子签署
qi_sign.liveness带活体验证的电子签署
集成方无法选择 opt_in

opt_in 是由 QI Tech 在您账户中设定的分销商配置，而不是在此请求体中发送的值。如果您的账户配置为 opt_in，签署流程会自动处理，无需传入 signature_method。

Response​

Response Body
{
    "investor_analysis_key": "UUID"
}

错误​

状态代码发生情形
400IVR000018分析已不处于 pending_registry_data 状态（已提交或已结束）
400IVR000029缺少分析的必要文件。消息中列出可接受的选项
400IVR000030缺少某一关联方的文件。消息会列出可接受的选项
400IVR000148代理人（attorney）缺少 power_of_attorney
400IVR000178没有有效的银行账户
400IVR000180没有有效的签署人组
400IVR000134 / IVR000136法人没有关联方或没有法定代表人
400IVR000169关联方合计持股比例超过 100%
400QIT000011通过管理人（manager-api）调用时：该投资者不是与其关联的基金类别

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