Skip to main content
PUT
Eliminar un préstamo legado previamente registrado

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-legado-excluir-0001"

Parámetros de ruta

numero_contrato
string
requerido

Number of the legado contract to remove.

Required string length: 1 - 20
Ejemplo:

"99999999999AL1"

Cuerpo

application/json
cpfTrabalhador
string
requerido

Worker CPF, exactly 11 digits.

Pattern: ^[0-9]{11}$
Ejemplo:

"99999999999"

motivoExclusao
enum<integer>
requerido

Reason for the exclusion: 1 desistência, 2 falecimento, 3 liquidação antecipada, 7 ação judicial, 8 fraude, 9 outros. The set has holes at 4, 5 and 6 — the manual's own apêndice §4.1.

Opciones disponibles:
1,
2,
3,
7,
8,
9
Ejemplo:

9

Respuesta

OK

idempotent
boolean
requerido

True when the rail answered its own HX (incluir)/HY (excluir) idempotency code rather than fresh confirmation. On excluir (HY) this means the contract is confirmed gone, which is sound. On incluir (HX) it means ONLY that this numeroContrato is already registered on the rail — the values THIS request carried (valorEmprestimo, valorParcela, etc.) were NOT compared against what is stored. To correct a legado registered with wrong values, exclude it (motivo 9) and include it again; do not rely on idempotent:true as proof the stored values match.

Ejemplo:

false

mensagem
string
requerido

The rail's own message.

Ejemplo:

"Emprestimo legado incluido com sucesso"

numeroContrato
string
requerido

The contract number the rail confirmed the operation against.

Ejemplo:

"99999999999AL1"