提交文件
提交转让方注册后，需要提交与其相关的文件。为此使用文件审查结构：无论 是创建还是修改，都会生成一次审查，并需提交相应文件。管理人负责核查将与其所管理基金开展业务的转让方的经营情况；之后在创建主合同环节，管理人需要签署一份声明，证明其已完成《第三方资源管理与行政管理规则和程序手册》所要求的全部审查，该手册将转让方注册的审查和更新职责均赋予管理人。
如为更新，最近一次审批通过的审查中的文件会被自动沿用，也可以用新文件替换。
仅在审查处于 pending_documents 时接受文件。通过管理人和顾问提交时，仅限注册的所有者代理方（即创建者）提交；其他代理方提交时，API 返回 ASR000004。
提交了错误的文件？
在审查仍处于 pending_documents 时，使用相同的 document_type 重新提交正确的文件。该类型此前的文件（valid 或 accepted）会自动变为 canceled，并由新文件替换。没有取消接口。
例外情况是 additional_document：附加文件会累积，不会被替换。如果误提交了附加文件，请在提交审查之前联系集成团队 integracao.dtvm@qitech.com.br。
提交审查之后，审查不再接受文件（ASR000039）。如需更正，请通过注册更新生成新的审查。
转让方文件
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 写入 |
| 顾问 | consultant-api | Register Assignor |
| 转让方 | assignor-api | 写入 |
各主机的 Base URL：环境（主机）。
Request
{
"document_type":"social_contract",
"document_b64": "JVBERi0xLjQK...",
"observation":"CONTRATO SOCIAL ATUALIZADO"
}
文件对象
| 字段 | 类型 | 描述 | 字符数 |
|---|---|---|---|
document_type * | string | 文件类型。 | 见 文件类型。 |
document_b64 * | string | 以 Base64 编码的 PDF 文件。 | - |
observation | string | 用于描述所提交文件的自由文本字段。 | 1 - 255 |
*必填字段。
Response
{
"document_key": "8e515a17-8b4d-49a3-aed6-47c9574e426a",
"document_type": "social_contract",
"status": "valid",
"observation": "CONTRATO SOCIAL ATUALIZADO",
"reference_date": null
}
如为注册更新，仅当转让方特有的信息发生变化时，才需要在审查中提交转让方的特定文件。
错误
| 状态码 | 代码 | 触发条件 |
|---|---|---|
| 404 | ASR000004 | 未找到所提供 assignor_registry_key 对应的转让方（对于管理人和顾问，也可能是该注册不属于您的集成）。请检查 assignor_registry_key 是否正确。 |
| 404 | ASR000033 | 未找到所提供 analysis_key 对应的审查。请检查 analysis_key 是否正确。 |
| 400 | ASR000039 | 审查的当前状态不接受新文件。只有当审查处于 pending_documents 时才能附加文件。如需在审查开始后重新提交——或审查因长期无变动已被取消（canceled）——请通过注册更新生成新的审查。 |
| 400 | ASR000005 | 文件格式无效。document_b64 必须为有效的 base64 字符串。 |
| 400 | ASR000060 | 所提交的文件不是有效的 PDF。document_b64 解码后的内容必须为 PDF。 |
| 400 | ASR000059 | 文件大小超出限制。提交前请减小 PDF 的大小（限制见错误消息）。 |
| 400 | ASR000061 | 该文件类型对该转让方无效。请使用与转让方人员类型相符的 document_type（见转让方/担保人标准文件表）。 |
认证、权限和主机相关错误：参见 API 错误。
关联方文件
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 写入 |
| 顾问 | consultant-api | View Assignors |
| 转让方 | assignor-api | 写入 |
各主机的 Base URL：环境（主机）。
Request
{
"document_type":"cnh",
"document_b64": "JVBERi0xLjQK...",
"observation":"CNH Válida"
}
Response
{
"document_key": "afe8532a-4b0b-4e63-8d16-5084b2681752",
"status": "valid",
"document_type": "cnh",
"observation": "CNH Válida"
}
如为注册更新，仅当转让方的关联方有新增或更新时，才需要在审查中提交关联方文件。
如果文件以错误的类型提交，或质量较差，可能会返回 accepted 状态（表示其质量存疑），甚至 invalid 状态，此时需要正确地重新提交——参见提交了错误的文件？。
错误
| 状态码 | 代码 | 触发条件 |
|---|---|---|
| 404 | ASR000004 | 未找到所提供 assignor_registry_key 对应的转让方（对于管理人和顾问，也可能是该注册不属于您的集成）。请检查 assignor_registry_key 是否正确。 |
| 404 | ASR000033 | 未找到所提供 analysis_key 对应的审查。请检查 analysis_key 是否正确。 |
| 404 | ASR000035 | 未找到所提供 analysis_related_party_key 对应的审查关联方。请检查创建审查时返回的 analysis_related_party_key 是否正确。 |
| 400 | ASR000039 | 审查的当前状态不接受新文件。只有当审查处于 pending_documents 时才能附加文件；此后请通过注册更新生成新的审查。 |
| 400 | ASR000005 | 文件格式无效。document_b64 必须为有效的 base64 字符串。 |
| 400 | ASR000060 | 所提交的文件不是有效的 PDF。document_b64 解码后的内容必须为 PDF。 |
| 400 | ASR000059 | 文件大小超出限制。提交前请减小 PDF 的大小（限制见错误消息）。 |
| 400 | ASR000062 | 该文件类型对该关联方无效。请使用与关联方人员类型相符的 document_type（见关联方/代表标准文件表）。 |
认证、权限和主机相关错误：参见 API 错误。
转让方/担保人标准文件
| 人员类型 | document_type | 描述 | 是否必需 |
|---|---|---|---|
| 自然人 | cnh | CNH（国家驾驶执照） | * |
| 自然人 | cin_digital | 国民身份证（电子版） | * |
| 自然人 | rg_back | RG（身份证）- 背面 | * |
| 自然人 | rg_front | RG（身份证）- 正面 | * |
| 法人 | social_contract | 公司章程 | 始终必需 |
| 法人 | commercial_board_certificate | 商业登记处简式证明 | 可选，但公司章程日期超过 3 年时必需 |
| 法人 | board_election_record | 董事会选举记录（如适用） | 用于证明任职关系时必需 |
*任何自然人只需提供以下其一：RG 正反面、CNH 或国民身份证。
关联方/代表标准文件
| 人员类型 | document_type | 描述 | 是否必需 |
|---|---|---|---|
| 自然人 | cnh | CNH（国家驾驶执照） | * |
| 自然人 | cin_digital | 国民身份证（电子版） | * |
| 自然人 | rg_back | RG（身份证）- 背面 | * |
| 自然人 | rg_front | RG（身份证）- 正面 | * |
| 自然人 | power_of_attorney | 自然人或法人授权书——代表为受托人时必需 | 用于证明任职关系时必需 |
*任何自然人只需提供以下其一：RG 正反面、CNH 或国民身份证。
部分文件类型会经过 OCR 工具进行数据提取和核验。请始终关注文件提交的返回结果，它会同步返回 OCR 的校验结果——valid/accepted/invalid。
文件类型
Document Type
| 枚举值 | 描述 |
|---|---|
| cnh | CNH。 |
| rg_back | RG 背面。 |
| rg_front | RG 正面。 |
| passport | 护照——仅限外国人。 |
| national_migration_registry | 国家移民登记（Registro Nacional de Migração）。 |
| national_registry_of_foreigners | 国家外国人登记（Registro Nacional de Estrangeiros）。 |
| cin_digital | 国民身份证（电子版）。 |
| social_contract | 公司章程/社团章程。 |
| cnpj_card | CNPJ 卡。 |
| commercial_board_certificate | 商业登记处简式证明。 |
| board_election_record | 现任董事会选举记录。 |
| power_of_attorney | 授权书——代表为受托人时必需。 |
| marital_power_of_attorney | 配偶授权书——仅适用于配偶。 |
| compliance_statement | 合规意见。 |
| financial_statement | 财务报表。 |
| credit_report | 信贷会议记录/信贷意见。 |
| manager_statement | 管理人意见/管理人表格。 |
| visit_report | 实地走访报告。 |
| proof_of_residence | 住址证明。 |
| credit_agency_consulation | 征信机构查询结果。 |
| annual_revenues_declaration | 营业收入声明。 |
| financial_institutions_declaration | 银行往来关系声明。 |
| additional_document | 附加文件——自由类型。 |
Document Status
| 枚举值 | 描述 |
|---|---|
| created | 已创建 |
| valid | 有效 |
| invalid | 无效 |
| canceled | 已取消（被同类型的新提交替换） |
| accepted | 已接受，但未校验 |
| inconclusive | 校验结果不确定 |