Skip to main content
PUT
Remover um empréstimo legado previamente registrado

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency
string
obrigatório

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

Exemplo:

"idem-legado-excluir-0001"

Parâmetros de caminho

numero_contrato
string
obrigatório

Number of the legado contract to remove.

Required string length: 1 - 20
Exemplo:

"99999999999AL1"

Corpo

application/json
cpfTrabalhador
string
obrigatório

Worker CPF, exactly 11 digits.

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

"99999999999"

motivoExclusao
enum<integer>
obrigatório

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.

Opções disponíveis:
1,
2,
3,
7,
8,
9
Exemplo:

9

Resposta

OK

idempotent
boolean
obrigatório

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.

Exemplo:

false

mensagem
string
obrigatório

The rail's own message.

Exemplo:

"Emprestimo legado incluido com sucesso"

numeroContrato
string
obrigatório

The contract number the rail confirmed the operation against.

Exemplo:

"99999999999AL1"