跳到主要内容

发送关联方文件

简介​

本资源旨在上传每个已创建关联方的必要文件。

注意
  • 对于每个已创建的自然人关联方，都必须调用此端点
  • 关联方必须处于 active 状态才能接收文件
  • 自然人：必须发送一份身份证明文件——cnh 或 rg_front + rg_back 组合
  • 法人（parent_company）：无需任何文件
  • 同一 type 只接受一次成功的发送：参见重发与重复

Input / Output:​

作为输入，需发送 base64 编码的文件、文件类型和文件扩展名。

作为输出，将返回用于标识已发送文件的 related_party_document_key。

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

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

Request​

ENDPOINT
/investor_registry/investor/{investor_key}/investor_analysis/{investor_analysis_key}/related_party/{external_related_party_key}/document
MÉTODO
POST
STATUS
201

Request body​

示例：身份证明文件（CNH）
请求体
{
    "type": "cnh",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}
示例：RG（正面和背面）
请求体 - 正面
{
    "type": "rg_front",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}
请求体 - 背面
{
    "type": "rg_back",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}
示例：授权委托书（适用于 attorney 类型）
请求体
{
    "type": "power_of_attorney",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}

Body params​

字段类型描述字符数必填
typestring文件类型1 - 50是
document_b64string文件的 Base 64 编码-是
file_extensionstring文件扩展名（pdf、png、jpeg）1 - 10是

Document Type（Related Party）​

枚举值描述支持的扩展名用途
cnhCNH（驾驶证）pdf, jpeg身份证明（选项 1）
rg_frontRG 正面pdf, jpeg身份证明（选项 2，与 rg_back 一起）
rg_backRG 背面pdf, jpeg身份证明（选项 2，与 rg_front 一起）
passport护照pdf, jpeg外国关联方身份证明
foreign_id外国身份证件pdf, jpeg外国关联方身份证明
power_of_attorney授权委托书pdf, jpeg补充文件，适用于 attorney

必要文件​

该要求在提交分析（submit）时评估，不满足时以 IVR000030 拒绝。满足其中一个选项即可。

居民自然人关联方​

选项文件
1cnh
2rg_front + rg_back

非居民自然人关联方​

选项文件
1passport
2foreign_id

法人关联方（parent_company）​

无需任何文件。

授权委托书

对于 attorney 类型的关联方，power_of_attorney 是必需的补充文件：它是在身份证明之外额外要求的，不能替代身份证明。该关联方仍需提供 cnh 或 rg_front + rg_back 组合。缺少授权委托书时以 IVR000148 拒绝。

重发与重复​

只要该关联方已有一份该类型、状态为 valid 或 in_manual_analysis 的文件，该类型即视为已满足。此后同类型的新发送将被拒绝：

HTTP 409
{
  "title": "Already exists valid document for related party.",
  "code": "IVR000141"
}

只要某类型的所有文件均为 invalid，新的发送仍会被接受。

Response​

响应体
{
    "related_party_document_key": "UUID",
    "status": "in_manual_analysis"
}
自动验证

文件上传后会自动验证。状态可能为：

  • valid：自动验证通过
  • invalid：自动验证未通过
  • in_manual_analysis：已转交人工核查

对于未通过的文件，可以使用 force=true 参数强制发送。使用该标志时，文件必定会提交人工评估——并因此满足该类型的要求。

错误​

状态代码发生情形
400IVR000024文件不是有效的 base64
400IVR000026分析已不处于 pending_registry_data 状态
400IVR000145关联方未处于有效状态
404IVR000183未找到关联方
404IVR000144未知的文件类型
409IVR000141已存在同类型的有效（或分析中）文件
400QIT000011通过管理人（manager-api）调用时：该投资者不是与其关联的基金类别

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