Remove a previously registered legado loan
Proxies excluir-emprestimo-legado-trabalhador (Manual 007 v1.4 §3.2, PUT — never DELETE), restoring the worker’s eligibility for new contracting on this rail. motivoExclusao is a closed, non-contiguous set (1,2,3,7,8,9 — the manual’s own apêndice §4.1 has no 4, 5 or 6). X-Idempotency is required. A retried request that lands on the rail’s own HY (“empréstimo inexistente”) answers success rather than a refusal.
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-legado-excluir-0001"
Path Parameters
Number of the legado contract to remove.
1 - 20"99999999999AL1"
Body
Worker CPF, exactly 11 digits.
^[0-9]{11}$"99999999999"
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.
1, 2, 3, 7, 8, 9 9
Response
OK
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.
false
The rail's own message.
"Emprestimo legado incluido com sucesso"
The contract number the rail confirmed the operation against.
"99999999999AL1"

