编辑合同
修正仍处于 pending_submission 的合同数据。只有发送的字段会被更改。
编辑合同
适用范围
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 写入 |
| 顾问 | consultant-api | 更新费用合同 |
各主机的 Base URL:环境(主机)。
ENDPOINT
/expense_contract/fund_class/{fund_class_key}/contract/{contract_key}/contract_data方法
PUT路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
fund_class_key | string | 基金类别的 key(UUID)。 |
contract_key | string | 合同的 key(UUID)。 |
Corpo da requisição
{
"expense_types": [
{
"expense_type": "audit_tax"
},
{
"expense_type": "lawyer_fee"
}
],
"recurrences": null,
"expiration_date": "2028-06-30"
}
请求体字段
至少发送一个字段。每个字段都遵循创建时的规则。
| 字段 | 类型 | 说明 |
|---|---|---|
name | string | 新名称,1 至 255 个字符。 |
signature_method | string | certifiqi、qi_sign 或 external。 |
expense_types | array | 替换所有费用类型。如果同一调用中未发送 recurrences,现有定期费用必须仍恰好覆盖新的类型。 |
recurrences | array | 替换所有定期费用。null 删除全部定期费用。 |
expiration_date | string | 新的到期日,YYYY-MM-DD。null 删除到期日。 |
响应
STATUS
200返回更新后的合同,结构见合同字段。被删除的定期费用仍保留在 parametrizations 中,status: canceled。
错误
| 状态 | code | 发生情形 |
|---|---|---|
| 400 | QIT000001 | 请求体为空({})或无效。 |
| 400 | ECT000040 | expiration_date 不是有效日期。 |
| 400 | ECT000012, ECT000010 | 某个费用类型不存在、不使用合同,或在基金设立时签约。 |
| 400 | ECT000061, ECT000045 | 某条定期费用的 end_date 早于 start_date,或定期费用未为每种费用类型恰好提供一条。 |
| 400 | ECT000060 | 在补充协议中,费用类型与原始合同不完全一致。 |
| 404 | ECT000005 | 基金类别不存在,或您无权访问该基金类别。 |
| 404 | ECT000009 | 该基金类别中不存在此合同。 |
| 409 | ECT000017 | 合同不处于 pending_submission。提交审核后,数据不能再修改。 |
| 409 | ECT000046 | 合同由 QI Tech 在基金设立时创建,不接受此调用。 |
| 409 | ECT000014 | 某个新类型已出现在本基金与该供应商之间另一份进行中、active 或 expired 的合同中。 |
Exemplo
{
"title": "Contract not pending submission",
"description": "This action requires a contract in status pending_submission, not sent_to_analysis.",
"translation": "Esta acao exige um contrato com status pending_submission, nao sent_to_analysis.",
"code": "ECT000017"
}
认证、权限和主机相关错误:参见 API 错误。