Skip to main content
POST
Revertir una refinanciación dentro de su ventana de 7 días hábiles

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency
string
requerido

Client-chosen idempotency key. REQUIRED: an absent key is 422, never a generated default.

Ejemplo:

"idem-reversao-0001"

Parámetros de ruta

numero_contrato
string
requerido

The NEW contract minted by the refinanciamento this call reverses.

Required string length: 2 - 15
Ejemplo:

"99999999999ARN1"

Cuerpo

application/json
motivoReversao
integer<int64>
requerido

Reversal reason (Manual 008 v1.10 §3.2.1, regra RG): 1 Desistência, 2 Óbito, 3 Fraude. Closed set — no 4th value exists.

Rango requerido: 1 <= x <= 3
Ejemplo:

1

dataRefinanciamento
string<date-time>

The refinancing's own booking date, RFC 3339 UTC. Optional: enables the gateway's local 7-business-day window pre-check. Omitted, the request is submitted straight to the rail.

Ejemplo:

"2026-08-04T09:00:00Z"

parcelasContratosQuitados
string[] | null

Instalment amounts of every contract this refinancing quitou, decimal strings (BRL). Optional; enables the margemReservada notice on the response.

Ejemplo:
valorParcelaNovoContrato
string

The new (now-reversed) contract's own instalment amount, decimal string (BRL). Optional; enables the margemReservada notice on the response.

Ejemplo:

"310.00"

Respuesta

OK

competenciaReversao
string
requerido

Payroll competência the reversal took effect in, yyyyMM.

Ejemplo:

"202507"

hashOperacao
string
requerido

The rail's own identity for this operation.

Ejemplo:

"34006311"

listaContratosTrabalhadorReativados
object[] | null
requerido

Every quitado contract the reversal returned to ativo.

Ejemplo:
mensagem
string
requerido

The rail's own message.

Ejemplo:

"Reversao realizada com sucesso"

numeroContratoExcluido
string
requerido

The new contract, now excluded by the reversal.

Ejemplo:

"99999999999ARN1"

margemReservada
string

The margin that was held reserved during the reversal window (Manual 008 v1.10 §3.2): the greater of the quitados' summed instalments and the new contract's own. Present only when the caller supplied enough context to compute it — a courtesy figure, not a rail field.

Ejemplo:

"310.00"