Recálculo

Recalcula as condições financeiras de uma operação de crédito existente a partir de um novo valor de parcela. Ideal para quando a margem consignável do beneficiário muda e o valor da parcela precisa ser ajustado.

Request

ENDPOINT

/v2/credit_operation/CREDIT_OPERATION_KEY/recalculate

MÉTODO

POST

Path Params

credit_operation_keystring (UUID)obrigatórioChave única da operação de crédito a ser recalculada.

Body Params

installment_face_valuenumberobrigatórioNovo valor de face da parcela. Deve ser menor ou igual ao valor original e acima do mínimo permitido (20.00).

{
    "installment_face_value": 180.50
}

Atenção

O novo installment_face_value só pode ser reduzido em relação ao valor original. O endpoint rejeita valores superiores ao original ou fora da redução máxima permitida (30%).

Pré-condições

A operação deve atender todas as condições abaixo para ser recalculada:

Condição	Erro se não atendida
Operação existe	COP000027 (404)
Requisitante é dono da operação	QIT000005 (403)
Garantia do tipo social_security	COP000276
Status: waiting_signature, issued ou canceled	COP000489
Garantia ainda não constituída	COP000489
Tipo de operação: structured_operation	COP000489
Data limite de desembolso não expirada	COP000489
Operação original possui installment_face_value	COP000489
Novo valor dentro dos limites permitidos	COP000490

Response

STATUS

200

Retorna o objeto completo da operação de crédito recalculada — mesma estrutura da consulta por credit_operation_key.

Erros

Código HTTP	Código QI	Descrição	Tradução
404	COP000027	Credit Operation not found	Operação não encontrada
403	QIT000005	Selected agent does not own this item	O agente selecionado não é dono do item
400	COP000276	Collateral type doesn't allow recalculation	Garantia do contrato não permite que a operação seja recalculada
400	COP000335	Assignment amount exceeds operation final amount	O valor de cessão é superior ao valor final da operação
400	COP000339	Final disbursement amount cannot be negative	O valor de desembolso final não pode ser negativo
400	COP000489	Operation not allowed to be recalculated	A operação de crédito não está permitida para ser recalculada
400	COP000490	Installment face value variance not allowed	A variação do valor da parcela não está permitida

Motivos detalhados do erro COP000489

O código COP000489 é retornado para diferentes pré-condições não atendidas. O campo reason na resposta indica o motivo específico:

Motivo	Descrição
Status inválido	O status da operação de crédito não permite ser recalculada
Garantia já constituída	A operação de crédito já possui garantia constituída
Tipo de operação inválido	O tipo de operação de crédito não permite ser recalculada
Data de desembolso expirada	A data de término do desembolso da operação de crédito está no passado
Valor de parcela ausente	O valor da parcela não foi informado na operação original