合同补充协议
创建补充协议:原始合同链中的一份新合同,生效时替代当前合同。
补充协议:
- 继承名称、供应商和签署方式;
- 声明与原始合同相同的费用类型;
- 可以设定定期费用并修改到期日;
- 归创建方所有:由顾问创建的,须经过管理人决定;由管理人创建的,则无需经过,即使原合同属于顾问;
- 拥有自己的
contract_key,遵循与新合同相同的流程:文件、提交审核、审核和签署。
在补充协议生效之前,原合同保持原状态(active 或 expired)。补充协议生效时,原合同变为 amended,费用改在补充协议下继续。取消补充协议不会影响原合同。
创建补充协议的条件:
- 原合同必须为
active或expired; - 合同链中不能有其他进行中的合同;
- 合同不能有等待审核的解除申请;
- 合同不能带有定期费用。
创建补充协议
适用范围
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 写入 |
| 顾问 | consultant-api | 创建费用合同 |
各主机的 Base URL:环境(主机)。
ENDPOINT
/expense_contract/fund_class/{fund_class_key}/contract/{contract_key}/amendment方法
POST路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
fund_class_key | string | 基金类别的 key(UUID)。 |
contract_key | string | 补充协议所替代合同的 key(UUID)。 |
Corpo da requisição
{
"expense_types": [
{
"expense_type": "audit_tax"
}
],
"expiration_date": "2028-12-31"
}
请求体字段
| 字段 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
expense_types | array | 是 | 必须与原始合同的费用类型完全一致。 |
recurrences | array | 否 | 按月定期费用,规则与创建时相同。 |
expiration_date | string | 否 | 到期日,YYYY-MM-DD,或 null。 |
响应
STATUS
201返回处于 pending_submission 的新合同,结构见合同字段,包含 amended_contract_key(被替代的合同)和 root_contract_key(合同链中的原始合同)。后续步骤请使用响应中的 contract_key。
错误
| 状态 | code | 发生情形 |
|---|---|---|
| 400 | QIT000001 | 请求体无效:缺少 expense_types、expense_types 中有重复类 型、值格式错误或包含未定义的字段。 |
| 400 | ECT000040 | expiration_date 不是有效日期。 |
| 400 | ECT000012, ECT000010 | 某个费用类型不存在、不使用合同,或在基金设立时签约。 |
| 400 | ECT000060 | 费用类型与原始合同不完全一致。 |
| 400 | ECT000061, ECT000045 | 某条定期费用的 end_date 早于 start_date,或定期费用未为每种费用类型恰好提供一条。 |
| 404 | ECT000005 | 基金类别不存在,或您无权访问该基金类别。 |
| 404 | ECT000009 | 该基金类别中不存在此合同。 |
| 409 | ECT000028 | 合同既不是 active 也不是 expired,或合同链中已有另一份进行中的合同。消息中会给出阻碍补充协议的合同状态。 |
| 409 | ECT000064 | 合同有等待审核的解除申请。 |
| 409 | ECT000058 | 合同带有定期费用。 |
| 409 | ECT000046 | 合同由 QI Tech 在基金设立时创建,不接受此调用。 |
| 409 | ECT000015, ECT000059 | 供应商为 inactive 或登记已到期(expired)。 |
| 409 | ECT000014 | 某个类型已出现在本基金与该供应商之间、合同链之外的另一份合同中。 |
| 409 | ECT000029 | 本基金与该供应商之间的某份合同已被合规部门永久驳回。 |
Exemplo
{
"title": "Amendment expense types mismatch",
"description": "An amendment must declare the same expense types as the original contract 3f2b8c1e-7d4a-4e9b-9a61-0c5d2e8f4b17.",
"translation": "Um aditivo precisa declarar os mesmos tipos de despesa do contrato original 3f2b8c1e-7d4a-4e9b-9a61-0c5d2e8f4b17.",
"code": "ECT000060"
}
认证、权限和主机相关错误:参见 API 错误。
下一步
合同文件:使用补充协议的 contract_key 上传补充协议的 PDF。