提交和取消合同
将合同提交给 QI Tech 审核，或取消进行中的合同。
提交会冻结文件，并将合同送去自动读取和 QI Tech 审核。此后数据和文件不能再修改：可以跟踪合同进度、取消合同，并在 pending_signature 状态下更换签署方式。
提交审核
在上传文件之后调用。合同必须处于 pending_submission。
适用范围
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 写入 |
| 顾问 | consultant-api | 创建费用合同 |
各主机的 Base URL：环境（主机）。
ENDPOINT
/expense_contract/fund_class/{fund_class_key}/contract/{contract_key}/submit方法
PUT路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
fund_class_key | string | 基金类别的 key（UUID）。 |
contract_key | string | 合同的 key（UUID）。 |
此调用不带请求体。
响应
STATUS
200返回 status: sent_to_analysis 且 ai_analysis 为 status: sent 的合同，结构见合同字段。
Trecho da resposta
{
"contract_key": "3f2b8c1e-7d4a-4e9b-9a61-0c5d2e8f4b17",
"status": "sent_to_analysis",
"ai_analysis": {
"ai_analysis_key": "7c8d9e0f-1a2b-4c3d-9e4f-5a6b7c8d9e0f",
"status": "sent",
"analysis_result": null
}
}
提交之后：
- 自动读取将文件与合同数据进行比对：基金和供应商的 CNPJ、费用类型、到期日、定期费用和禁止条款。
- 无论读取结果如何，合同都会进入
in_manual_analysis。
如果调用返回错误，合同仍保持 pending_submission。
取消合同
取消进行中的合同，即处于以下任一状态的合同：pending_submission、sent_to_analysis、in_manual_analysis、in_compliance_analysis、pending_manager_approval、pending_vendor_approval 或 pending_signature。在 pending_signature 状态下，签署批次也会被取消。
active 或 expired 的合同不能取消：需由管理人提出解除申请。
适用范围
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 写入 |
| 顾问 | consultant-api | 更新费用合同 |
各主机的 Base URL：环境（主机）。
ENDPOINT
/expense_contract/fund_class/{fund_class_key}/contract/{contract_key}/cancel方法
PUT路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
fund_class_key | string | 基金类别的 key（UUID）。 |
contract_key | string | 合同的 key（UUID）。 |
此调用不带请求体。
响应
STATUS
200返回 status: canceled 的合同。定期费用变为 inactive。
错误
| 状态 | code | 发生情形 |
|---|---|---|
| 400 | ECT000071 | 提交：无法读取文件。请重新上传不带密码的 PDF。 |
| 404 | ECT000005 | 基金类别不存在，或您无权访问该基金类别。 |
| 404 | ECT000009 | 该基金类别中不存在此合同。 |
| 404 | ECT000056 | 提交：QI Tech 尚未配置自动读取。请联系支持团队。 |
| 409 | ECT000017 | 提交：合同不处于 pending_submission。 |
| 409 | ECT000022 | 提交：合同文件尚未上传。 |
| 409 | ECT000015 | 提交：供应商为 inactive。 |
| 409 | ECT000059 | 提交：供应商登记已到期（expired）。 |
| 409 | ECT000016 | 取消：合同不在进行中。active 或 expired 的合同只能通过解除来终止。 |
| 409 | ECT000046 | 合同由 QI Tech 在基金设立时创建，不接受此调用。 |
Exemplo
{
"title": "Document not uploaded",
"description": "The document of the contract 3f2b8c1e-7d4a-4e9b-9a61-0c5d2e8f4b17 was not uploaded.",
"translation": "O documento do contrato 3f2b8c1e-7d4a-4e9b-9a61-0c5d2e8f4b17 nao foi enviado.",
"code": "ECT000022"
}
认证、权限和主机相关错误：参见 API 错误。
下一步
合同查询：跟踪审核和签署进度。