提交投资人文件

此端点允许提交与已登记投资人关联的文件。

Request

ENDPOINT

/investor_management/investor/INVESTOR-KEY/document

MÉTODO

POST

Path Params

字段	类型	描述	字符数
`INVESTOR-KEY`	string	投资人的唯一键（UUID v4）。	36

Request Body

Request Body

{
  "document_base64": "dGVzdGVfZG9jdW1lbnRfYmFzZTY0",
  "document_type": "proof_of_address"
}

Request Body Params

字段	类型	描述	最大字符数
`document_base64` *	string	Base64 编码的文件内容。	-
`document_type` *	string	提交文件的类型。接受的值取决于投资人的 `person_type`。	document_type 枚举

document_type 枚举

接受的值取决于投资人的 person_type。

法人（PJ）

枚举值	描述
`proof_of_address`	地址证明
`letter_of_attorney`	授权书
`company_statute` *	公司章程或合同
`commercial_board_certificate`	商业委员会证书
`board_election_record`	董事会选举记录
`manager_declaration`	经理声明
`financial_statement`	财务报表
`credit_report`	信用报告
`manager_statement`	管理员声明
`compliance_statement`	合规声明
`cnpj_card`	CNPJ 卡
`additional_document`	附加文件

注意

所有登记均需提供 company_statute（公司章程）。

自然人（PF）

枚举值	描述
`cnh`	驾照（CNH）
`cnh_front`	CNH 正面
`cnh_back`	CNH 背面
`cnh_digital`	电子版 CNH（PDF）
`rg_front`	RG 正面
`rg_back`	RG 背面
`passport`	护照

Response

STATUS

201

Response Body

场景 1：自动验证（OCR 成功）
场景 2：需要人工审核

{
    "document_key": "123e4567-e89b-12d3-a456-426614174000",
    "document_type": "proof_of_address",
    "ocr_key": "6654f284-f690-4324-8c39-dcf0225ec8cf"
}

含义：文件已由 OCR 自动处理和验证。

{
    "document_key": "8bf591a8-c184-47db-afd2-a5196de14cc3",
    "document_type": "cnpj_card",
    "ocr_key": null
}

含义：文件无法通过 OCR 自动验证，已转入人工审核队列。

注意

成功请求（提交成功）的响应有两种不同行为，取决于自动验证（OCR）的结果。

Response Body Params

字段	类型	描述	最大长度
`document_key`	string	提交文件的唯一标识符（UUID v4）。	36
`document_type`	string	提交文件的类型。	document_type 枚举
`ocr_key`	string	与提交文件关联的 OCR 键。	36

Request​

Path Params​

Request Body​

Request Body Params​

document_type 枚举​

Response​

Response Body Params​