跳到主要内容

发送关联方文件

简介​

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

注意
  • 此端点需为每个已创建且为自然人的关联方调用
  • 关联方必须处于**"active"**状态才能接收文件
  • 对于自然人：必须发送身份证件（cnh 或 rg）
  • 对于 attorney（代理人）类型：必须发送 power_of_attorney（授权书）

输入/输出：​

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

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

Request​

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

Request body​

示例：身份证件 (CNH)
Request Body
{
    "type": "cnh",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}
示例：RG（正面和背面）
Request Body - Frente
{
    "type": "rg_front",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}
Request Body - Verso
{
    "type": "rg_back",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}
示例：授权书（适用于 attorney 类型）
Request Body
{
    "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是
枚举值描述支持的扩展名必填对象
cnhCNHpdf, jpeg自然人（二选一）
rgRGpdf, jpeg自然人（二选一）
rg_backRG 背面pdf, jpeg自然人（与 rg_front 配合）
rg_frontRG 正面pdf, jpeg自然人（与 rg_back 配合）
power_of_attorney授权书pdf, jpegattorney 类型

必要文件​

文件描述关联方类型
cnh 或 (rg_front + rg_back)身份证件自然人
power_of_attorney授权书attorney 类型

Response​

Response Body
{
    "related_party_document_key": "UUID",
    "status": "valid | invalid | in_manual_analysis"
}
信息

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

  • valid：文件有效
  • invalid：文件无效
  • in_manual_analysis：人工分析中

对于无效文件，可以使用 force=true 参数强制发送。但是，使用此标志时，文件将必然提交进行人工审核。