跳到主要内容

发送投资者文件

简介​

本资源旨在上传投资者的必要文件。

输入/输出：​

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

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

注意

此端点需多次调用，每个必要文件调用一次。必要文件根据投资者类型（自然人或法人）以及投资者类别（零售、合格或专业）而有所不同。

Request​

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

Request body​

示例：身份证件 - 自然人 (CNH)
Request Body
{
    "type": "cnh",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf",
    "document_data": {
        "document_type": "CNH",
        "issuer_entity": "DETRAN"
    }
}
示例：身份证件 - 自然人 (RG)
Request Body - Frente
{
    "type": "rg_front",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf",
    "document_data": {
        "document_type": "RG",
        "issuer_entity": "SSP",
        "document_number": "20.932.206-8"
    }
}
Request Body - Verso
{
    "type": "rg_back",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}
示例：CNPJ 卡 - 法人
Request Body
{
    "type": "cnpj_card",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf",
    "document_data": {
        "document_type": "CNPJ",
        "issuer_entity": "RFB"
    }
}
示例：财务报表 - 法人
Request Body
{
    "type": "financial_statements",
    "document_b64": "base64_encoded_document_content",
    "file_extension": "pdf"
}
示例：居住证明
Request Body
{
    "type": "proof_of_residence",
    "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_dataobject包含文件识别信息的对象-否

Document Type​

枚举值描述支持的扩展名
cnhCNHpdf, jpeg
rgRGpdf, jpeg
rg_backRG 背面pdf, jpeg
rg_frontRG 正面pdf, jpeg
proof_of_residence居住证明pdf, jpeg
cnpj_cardCNPJ 卡pdf, jpeg
social_contract章程合同pdf, jpeg
company_statute公司章程pdf, jpeg
board_election_record董事选举记录pdf, jpeg
financial_statements财务报表pdf, jpeg
investor_qualification_proof资质证明pdf, jpeg
power_of_attorney授权书pdf, jpeg
billing_statement账单/对账单pdf, jpeg
fund_prospectus投资基金章程pdf, jpeg

必要文件​

自然人 (Natural Person)​

文件描述必填对象
cnh 或 (rg_front + rg_back) 或 rg投资者身份证件所有自然人投资者
proof_of_residence居住证明所有自然人投资者

法人 - 普通 (Legal Person - Regular)​

文件描述必填对象
financial_statements公司财务报表所有
social_contract公司章程合同适用时
company_statute公司章程适用时
board_of_election_records选举记录适用时
investor_qualification_proof合格投资者资质证明合格投资者

法人 - 投资基金 (Legal Person - Fund Class)​

文件描述必填对象
cnpj_card证明基金存在的文件所有
financial_statements财务报表所有
fund_prospectus投资基金章程所有

Response​

Response Body
{
    "document_key": "UUID"
}