Validar Aditamento
Este endpoint recebe o mesmo corpo da criação e devolve o que aconteceria, sem criar nada. Use-o como último passo antes de disparar o rito: ele confere a elegibilidade do título, resolve cada alteração contra o estado atual e informa em qual status o aditamento nasceria.
Diferente da simulação, a validação aceita o conjunto completo de alterações, de qualquer tipo.
Request
Request Body
Idêntico ao da criação.
{
"security_key": "2d35b5a7-4cd1-4960-b1d7-4a53668e85b5",
"financial_base_date": "2026-09-20",
"signature_method": "certifiqi",
"changes": [
{
"type": "financial_flow",
"operation": "modification",
"new_value": {
"installments": [
{ "installment_number": 3, "due_date": "2026-10-20" },
{ "installment_number": 4, "due_date": "2026-11-20" }
]
}
},
{
"type": "collateral",
"operation": "removal",
"target_key": "a1b2c3d4-0000-4000-8000-000000000001"
}
]
}
Response
Response Body
{
"valid": true,
"financial_base_date": "2026-09-20",
"outstanding_balance": 152340.55,
"closing": {
"present_value": 152340.55,
"difference": 0.00,
"tolerance": 0.01,
"passed": true
},
"resolved_changes": [
{
"type": "financial_flow",
"operation": "modification",
"target_key": null,
"previous_value": {
"interest_rate": {
"monthly_rate": 0.0180,
"interest_base": "workdays"
}
},
"preserved_installments": [
{
"installment_number": 1,
"due_date": "2026-07-20",
"principal_amortization_amount": 48000.00,
"interest_amount": 2100.00,
"installment_status": "paid"
}
]
},
{
"type": "collateral",
"operation": "removal",
"target_key": "a1b2c3d4-0000-4000-8000-000000000001",
"previous_value": {
"collateral_type": "fiduciary_alienation_vehicle",
"description": "Veículo dado em alienação fiduciária"
}
}
],
"term_generation": "qi_generated",
"next_status": "pending_term_generation"
}
Response Body Params
| Campo | Tipo | Descrição |
|---|---|---|
valid | boolean | true quando o aditamento pode ser criado como enviado. |
financial_base_date | string (date) | Data base ecoada da requisição. |
outstanding_balance | number | Saldo devedor apurado na data base. |
closing | object | Resultado do fechamento. Presente quando há alteração de financial_flow. |
resolved_changes | array | Cada alteração resolvida contra o estado atual do título. |
term_generation | string | Origem do termo. qi_generated quando a QI Tech gera; tenant_supplied quando você enviou o termo pronto. |
next_status | string | O status em que o aditamento nasceria se fosse criado agora. |
resolved_changes[]
| Campo | Tipo | Descrição |
|---|---|---|
type | string | Tipo da alteração. |
operation | string | Operação da alteração. |
target_key | string (UUID) | Registro endereçado, quando houver. |
previous_value | object | Estado atual do que será alterado. Ausente quando não há valor anterior (por exemplo, em addition). |
preserved_installments | array | Apenas em financial_flow: parcelas mantidas fora da repactuação. |
O campo next_status é o principal motivo para validar antes de criar. Quando ele vem pending_manual_approval, o aditamento vai aguardar conferência da QI Tech sobre o termo que você enviou — e o prazo total muda. Veja Regras de Negócio.
Erros
A validação recusa pelos mesmos motivos da criação. Os mais comuns:
| Status | Código | Descrição |
|---|---|---|
| 404 | AMD000001 | Título não encontrado para este tenant. |
| 422 | AMD000002 | Título não está ativo. |
| 422 | AMD000003 | Operação de origem não está finalizada. |
| 422 | AMD000004 | Título já liquidado. |
| 422 | AMD000005 | Data base retroativa. |
| 422 | AMD000006 | Combinação de tipo e operação inexistente. |
| 422 | AMD000007 | target_key obrigatório e ausente. |
| 422 | AMD000008 | Garantia não suportada para este tipo de operação. |
| 422 | AMD000014 | Parte relacionada de papel imutável. |
| 409 | AMD000031 | O título já tem um aditamento em andamento. |
O catálogo completo está em Catálogo de erros.