Reverse a refinancing within its 7 business day window
Proxies reverter-refinanciamento-trabalhador (Manual 008 v1.10 §3.2): the new contract is excluded and every contract it quitou returns to ativo. motivoReversao is a closed set (1 Desistência, 2 Óbito, 3 Fraude). The gateway refuses locally ONLY once the reversal is unambiguously past its 7-business-day window (a caller-supplied dataRefinanciamento enables the check; omitted, the request goes straight to the rail, which remains the final judge). X-Idempotency is required.
Authorizations
JWT bearer token issued by the identity provider.
Headers
Client-chosen idempotency key. REQUIRED: an absent key is 422, never a generated default.
"idem-reversao-0001"
Path Parameters
The NEW contract minted by the refinanciamento this call reverses.
2 - 15"99999999999ARN1"
Body
Reversal reason (Manual 008 v1.10 §3.2.1, regra RG): 1 Desistência, 2 Óbito, 3 Fraude. Closed set — no 4th value exists.
1 <= x <= 31
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.
"2026-08-04T09:00:00Z"
Instalment amounts of every contract this refinancing quitou, decimal strings (BRL). Optional; enables the margemReservada notice on the response.
The new (now-reversed) contract's own instalment amount, decimal string (BRL). Optional; enables the margemReservada notice on the response.
"310.00"
Response
OK
Payroll competência the reversal took effect in, yyyyMM.
"202507"
The rail's own identity for this operation.
"34006311"
Every quitado contract the reversal returned to ativo.
The rail's own message.
"Reversao realizada com sucesso"
The new contract, now excluded by the reversal.
"99999999999ARN1"
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.
"310.00"

