Eliminar un contrato averbado del registro de nómina
Elimina un contrato averbado del registro de Dataprev mediante excluir-consignado-trabalhador (Manual 003 v1.19 §3.3). No existe una reversión, por lo que la operación está marcada como x-money-path: true.
El cuerpo contiene exactamente una clave. codigoSolicitante, cpfTrabalhador, matricula, codigoInscricaoEmpregador y numeroInscricaoEmpregador nunca se aceptan de quien llama: identifican al trabajador y al empleador, y proceden de la instantánea local e inmutable de la reserva; por ello, un cliente no puede solicitar la exclusión de un trabajador que su propia reserva nunca cubrió.
La respuesta distingue los tres resultados que quien llama debe poder diferenciar:
| estado | significado |
|---|---|
| 201 | esta llamada creó el intento y alcanzó un estado terminal: confirmado (el contrato salió de la nómina) o rechazado (el registro se negó y su propio código y mensaje están en el cuerpo) |
| 200 | repetición de un intento que ya es terminal: el resultado del cuerpo corresponde al intento anterior y esta llamada no invocó ninguna operación |
| 202 | la pasarela retiene la solicitud y aún no se conoce el efecto en el registro; la conciliación M005 lo converge. La repetición de un intento que aún no es terminal también devuelve 202; X-Idempotency-Replayed, y no el código de estado, indica si esta llamada invocó una operación |
Un intento rechazado es una respuesta de negocio, no un error de transporte: el registro publicó un rechazo que el cliente debe leer.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Mandatory opaque replay key, 1..128 bytes of valid UTF-8, preserved byte for byte. There is no X-Idempotency-Key alias, no case folding and no normalization: two keys differing in one byte are two keys.
1 - 128"idem-exclusao-0001"
Parámetros de ruta
The rail contract number (Manual 003 §3.3.1 p.15: Texto, 2 to 15 characters of free choice). Exact, control-free UTF-8: no trimming and no case folding.
2 - 15"NC-000001"
Cuerpo
The client's declared reason for removing the contract from the rail, as one of the closed codes Manual 003 §3.3.1 publishes: 1 desistência do empréstimo, 2 falecimento, 3 liquidação antecipada, 7 ação judicial, 8 exclusão por fraude, 9 outros. A string, never a JSON number. Mandatory on every request: the gateway never declares a reason on the client's behalf, and an absent or unpublished code is refused locally before the rail is called.
1, 2, 3, 7, 8, 9 "1"
Respuesta
A replay of an attempt that is already terminal: the outcome in the body is the earlier attempt's, and this call invoked nothing.
The client's declared Manual 003 §3.3.1 reason, echoed from the durable authority.
1, 2, 3, 7, 8, 9 "1"
The contract number the exclusion was addressed to.
"NC-000001"
Durable operation status. confirmed means the contract came off the payroll; rejected means the registry published a refusal; claimed, invoking and outcome_unknown all mean the effect at the registry is NOT known yet and M005 reconciliation has to close it — none of the three is a failure to retry blindly.
claimed, invoking, confirmed, rejected, outcome_unknown "confirmed"
Which proof produced the terminal state: exclude_response, operator_evidence or m005_observation. Empty until one did.
"exclude_response"
The refusal message the REGISTRY published. Present only on a rejected operation.
"motivo nao publicado"
Instant the registry answered, RFC 3339 UTC. ABSENT until it did.
"2026-08-05T12:00:00Z"
The registry's own receipt for the mutation. ABSENT when it minted none, which is the normal case under an m005_observation confirmation — absence is never a verdict.
"HASH-1"
The refusal code the REGISTRY published. Present only on a rejected operation.
"ME"

