Consultar Amortização Extraordinária
Este endpoint retorna uma amortização extraordinária específica pela sua chave (extraordinary_event_conciliation_key). Use-o para acompanhar o status da conciliação do evento — desde pending_conciliation (ainda não pago ou parcialmente pago) até o estado terminal (paid ou canceled) definido pela orquestração interna da QI Tech.
A consulta é agnóstica de data e não dispara nenhuma transição de status: apenas reflete o estado atual do evento e de cada parcela vinculada.
Request
Path Params
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
extraordinary_event_conciliation_key | string (UUID) | Sim | Chave única do evento extraordinário de amortização a consultar. |
Exemplo de chamada:
GET /event_conciliation/extraordinary_event/11111111-1111-4111-8111-111111111111
Response
Response Body
{
"extraordinary_event_conciliation_key": "11111111-1111-4111-8111-111111111111",
"security_key": "971380d4-469e-48f6-a64b-3afb8a88109e",
"investment_key": "44444444-4444-4444-8444-444444444444",
"amortization_type": "early_amortization",
"total_expected_amount": 1500.00,
"total_discount_amount": 0,
"total_paid_amount": 0.0,
"status": "pending_conciliation",
"reference_date": "2026-04-24",
"due_date": "2026-04-24",
"paid_at": null,
"event_conciliation_list": [
{
"event_conciliation_key": "22222222-2222-4222-8222-222222222222",
"installment_key": "33333333-3333-4333-8333-333333333333",
"event_conciliation_status": "pending_conciliation",
"event_conciliation_type": "extraordinary_event"
}
]
}
Response Body Params
| Campo | Tipo | Descrição |
|---|---|---|
extraordinary_event_conciliation_key | string (UUID) | Chave do evento extraordinário de amortização consultado. |
security_key | string (UUID) | Chave do ativo (security) ao qual o evento pertence. |
investment_key | string (UUID) | Chave do investimento alvo do evento. |
amortization_type | string | Tipo de amortização do evento — ecoa o valor usado na criação. |
total_expected_amount | number | Valor total esperado do evento (soma distribuída entre as parcelas) em BRL. |
total_discount_amount | number | Desconto total aplicado. Diferente de zero apenas para present_amount. |
total_paid_amount | number | Valor já conciliado para o evento (em BRL). 0 enquanto nenhum pagamento foi confirmado; > 0 em pagamento parcial. |
status | string | Status atual do evento: pending_conciliation, paid ou canceled. |
reference_date | string (date) | Data de referência informada na criação. |
due_date | string (date) | Data alvo de liquidação informada na criação. |
paid_at | string (date) | Data em que o evento foi liquidado. null enquanto não estiver paid. |
event_conciliation_list | array | Lista de event_conciliation (evento de conciliação de cada parcela) do evento. Objeto event_conciliation_list. |
Objeto event_conciliation_list
| Campo | Tipo | Descrição |
|---|---|---|
event_conciliation_key | string (UUID) | Chave do evento de conciliação da parcela (event_conciliation). |
installment_key | string (UUID) | Chave da parcela afetada por este evento de conciliação. |
event_conciliation_status | string | Status atual do evento de conciliação da parcela (pending_conciliation, paid, canceled). |
event_conciliation_type | string | Tipo do event_conciliation. Sempre extraordinary_event para eventos criados por este fluxo. |
O status (e o event_conciliation_status de cada parcela) reflete o estado atual no momento da consulta. A transição para paid ou canceled é feita pela orquestração interna da QI Tech — o integrador não precisa acionar nenhum endpoint para isso.
Erros
| Código | HTTP | Significado |
|---|---|---|
| EVC100011 | 404 | Nenhuma amortização extraordinária encontrada para a extraordinary_event_conciliation_key informada. |
Consulte o Catálogo de erros para resolução completa.