跳到主要内容

重新计算信贷操作

根据新的分期付款面值重新计算现有信贷操作的财务条款。适用于受益人的可扣除额度发生变化，需要调整分期付款金额的情况。

优势
  • 保留原始条款 — 利率、期限和操作结构保持不变，仅分期付款金额发生变化
  • 即时响应 — 操作在同一调用中重新计算并返回，无需异步处理
  • 自动验证 — 端点在应用前验证前置条件、利率限制和 INSS 规则

请求​

端点
/v2/credit_operation/CREDIT_OPERATION_KEY/recalculate
方法
POST

路径参数​

credit_operation_keystring (UUID)必填要重新计算的信贷操作的唯一标识。

请求体参数​

installment_face_valuenumber必填新的分期付款面值。必须小于或等于原始值，且高于最低允许值。
{
    "installment_face_value": 180.50
}
注意

新的 installment_face_value 只能从原始值降低。端点会拒绝超过原始值或超出允许变化范围的值。

前置条件​

操作必须满足以下所有条件才能被重新计算：

条件不满足时的错误
操作存在COP000027 (404)
请求方拥有该操作QIT000005 (403)
担保类型为 social_securityCOP000276
状态：waiting_signature、issued 或 canceledCOP000489
担保尚未设立COP000489
操作类型：structured_operationCOP000489
放款截止日期未过期COP000489
原始操作包含 installment_face_valueCOP000489
新值在允许范围内COP000490

响应​

状态
200

返回完整的重新计算后的信贷操作对象 — 与按 credit_operation_key 查询的结构相同。

错误​

HTTP 状态码QI 错误码描述翻译
404COP000027Credit Operation not found未找到信贷操作
403QIT000005Selected agent does not own this item所选代理不拥有此项目
400COP000276Collateral type doesn't allow recalculation担保类型不允许重新计算操作
400COP000335Assignment amount exceeds operation final amount转让金额超过操作最终金额
400COP000339Final disbursement amount cannot be negative最终放款金额不能为负数
400COP000489Operation not allowed to be recalculated信贷操作不允许被重新计算
400COP000490Installment face value variance not allowed分期付款面值变化不在允许范围内
COP000489 错误的详细原因

COP000489 代码用于不同的未满足前置条件。响应中的 reason 字段指示具体原因：

原因描述
状态无效信贷操作状态不允许重新计算
担保已设立信贷操作的担保已经设立
操作类型无效信贷操作类型不允许重新计算
放款日期已过期信贷操作的放款截止日期已过
缺少分期付款值原始操作中未提供分期付款面值