合同解除
申请终止 active 或 expired 的合同。只有管理人可以提出申请,由 QI Tech 作出决定。
| 申请状态 | 说明 |
|---|---|
pending_analysis | 等待 QI Tech 审核。每份合同只能有一个处于此状态的申请。 |
approved | 已批准。合同变为 reproved,reproval_reason: termination_agreement,定期费用随之终止。 |
reproved | 已拒绝,原因见 reproval_details。合同保持原状,可以重新提出申请。 |
没有撤回审核中申请的调用。可在合同查询的 terminations 中跟踪申请。
申请解除
适用范围
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 写入 |
各主机的 Base URL:环境(主机)。
ENDPOINT
/expense_contract/fund_class/{fund_class_key}/contract/{contract_key}/termination方法
POST路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
fund_class_key | string | 基金类别的 key(UUID)。 |
contract_key | string | 合同的 key(UUID)。 |
Corpo da requisição
{
"termination_details": "Distrato amigável a partir de 31/12/2026."
}
请求体字段
JSON 请求体是必需的,即使为空:没有详情时请发送 {}。
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
termination_details | string | 否 | 解除的原因和条件,1 至 1000 个字符。 |
响应
STATUS
201返回的是合同,而不是申请,结构见合同字段。申请位于 terminations 中。
Trecho da resposta
{
"contract_key": "3f2b8c1e-7d4a-4e9b-9a61-0c5d2e8f4b17",
"status": "active",
"terminations": [
{
"termination_key": "e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b",
"status": "pending_analysis",
"termination_details": "Distrato amigável a partir de 31/12/2026.",
"reproval_details": null,
"created_at": "2026-11-09T15:01:44.230118"
}
]
}
错误
| 状态 | code | 发生情形 |
|---|---|---|
| 400 | QIT000001 | 请求没有 JSON 请求体、termination_details 不在 1 至 1000 个字符之间,或包含未定义的字段。 |
| 404 | ECT000005 | 基金类别不存在,或您无权访问该基金类别。 |
| 404 | ECT000009 | 该基金类别中不存在此合同。 |
| 409 | ECT000063 | 合同既不是 active 也不是 expired。 |
| 409 | ECT000064 | 已存在等待审核的解除申请。 |
| 409 | ECT000062 | 该合同有进行中的补充协议。请先取消补充协议,再申请解除。 |
| 409 | ECT000046 | 合同由 QI Tech 在基金设立时创建,不接受此调用。 |
Exemplo
{
"title": "Contract not terminable",
"description": "A contract in status pending_signature cannot be terminated.",
"translation": "Um contrato com status pending_signature nao pode ser encerrado.",
"code": "ECT000063"
}
认证、权限和主机相关错误:参见 API 错误。