Renegotiate a contract closed by employment-link termination

Proxies renegociar-consignado-trabalhador (Manual 006 v1.14 §2.3): renegotiates a contract closed in situação 15 (“Encerrado por término de vínculo”) into a new one against the worker’s new employment bond. numeroContratoEncerrado must be held by this gateway for the authenticated tenant, and must differ from the new contract number in the path; that is checked here, before the rail is called. Whether the closed contract actually sits in situação 15 and whether the new bond is elegível or inelegível only by motivo 8 are live registry facts this gateway defers to the rail’s own judgment, and so is whether valorParcela stays within the closed contract’s own instalment (regra BL). valorIOF is required, following the manual rather than the mirrored Swagger’s required list. X-Idempotency is required.

POST /v1/consignado/contracts/{numero_contrato}/renegociacao

Renegotiate a contract closed by employment-link termination

cURL

curl --request POST \
  --url https://br-consignado-gw.sandbox.lerian.net/v1/consignado/contracts/{numero_contrato}/renegociacao \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "codigoInscricaoEmpregador": "2",
  "cpfTrabalhador": "27928255022",
  "dataFimContrato": "2026-01-24T00:00:00Z",
  "dataInicioContrato": "2025-01-24T00:00:00Z",
  "dataPrimeiroDesconto": "2025-01-28T00:00:00Z",
  "matricula": "teste4243",
  "nomeTrabalhador": "testeead",
  "numeroContratoEncerrado": "Qwerty123456780",
  "numeroInscricaoEmpregador": "42422253000101",
  "numeroParcelas": 8,
  "valorCETAnual": "0.20",
  "valorCETMensal": "0.10",
  "valorEmprestimo": "3000.00",
  "valorIOF": "0.10",
  "valorLiberado": "2000.00",
  "valorParcela": "400.00",
  "valorTaxaAnual": "0.30",
  "valorTaxaMensal": "0.10",
  "competenciaInicioDesconto": "202501"
}
'

200

{
  "competenciaInicioDesconto": "202501",
  "hashOperacao": "9598435",
  "mensagem": "Inclusão efetuada com sucesso",
  "numeroContrato": "Qwerty123456789"
}

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.

Maximum string length: 255

Ejemplo:

"idem-renegociacao-0001"

Parámetros de ruta

numero_contrato · string · requerido

The NEW (renegotiated) contract number, minted by the CLIENT — the rail mints nothing here: 2 to 15 letters or digits.

Required string length: 2 - 15

Pattern: ^[A-Za-z0-9]+$

Ejemplo:

"Qwerty123456789"

Cuerpo

application/json

codigoInscricaoEmpregador · string · requerido

Employer inscription type: 1 CNPJ, 2 CPF.

Pattern: ^[12]$

Ejemplo:

"2"

cpfTrabalhador · string · requerido

Worker CPF, 11 digits.

Required string length: 11

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

Ejemplo:

"27928255022"

dataFimContrato · string<date-time> · requerido

End date of the new consignado contract, RFC 3339 UTC.

Ejemplo:

"2026-01-24T00:00:00Z"

dataInicioContrato · string<date-time> · requerido

Start date of the new consignado contract, RFC 3339 UTC.

Ejemplo:

"2025-01-24T00:00:00Z"

dataPrimeiroDesconto · string<date-time> · requerido

Date of the first payroll deduction, RFC 3339 UTC.

Ejemplo:

"2025-01-28T00:00:00Z"

matricula · string · requerido

Matrícula assigned to the worker by the employer.

Maximum string length: 20

Ejemplo:

"teste4243"

nomeTrabalhador · string · requerido

Worker's full name.

Maximum string length: 100

Ejemplo:

"testeead"

numeroContratoEncerrado · string · requerido

The PRIOR contract this renegociação replaces. Must be held by this gateway for the authenticated tenant, and must differ from the new contract number in the path.

Required string length: 1 - 15

Ejemplo:

"Qwerty123456780"

numeroInscricaoEmpregador · string · requerido

Employer inscription number, Texto.

Maximum string length: 14

Ejemplo:

"42422253000101"

numeroParcelas · integer<int64> · requerido

Number of instalments of the new contract, capped at the manual's own published range 1 to 99 (Manual 006 v1.14 §2.3.2 line 782).

Rango requerido: 1 <= x <= 99

Ejemplo:

8

valorCETAnual · string · requerido

valorCETAnual — Custo Efetivo Total, annual percent decimal string.

Maximum string length: 13

Pattern: ^[0-9]+(\.[0-9]{1,2})?$

Ejemplo:

"0.20"

valorCETMensal · string · requerido

valorCETMensal — Custo Efetivo Total, monthly percent decimal string.

Maximum string length: 13

Pattern: ^[0-9]+(\.[0-9]{1,2})?$

Ejemplo:

"0.10"

valorEmprestimo · string · requerido

valorEmprestimo — the new contract's principal (decimal string, BRL).

Maximum string length: 13

Pattern: ^[0-9]+(\.[0-9]{1,2})?$

Ejemplo:

"3000.00"

valorIOF · string · requerido

valorIOF — the IOF charged, in reais (decimal string, BRL). Obrigatório on the manual even though the mirrored Swagger's required list omits it.

Maximum string length: 13

Pattern: ^[0-9]+(\.[0-9]{1,2})?$

Ejemplo:

"0.10"

valorLiberado · string · requerido

valorLiberado — amount delivered to the worker (decimal string, BRL).

Maximum string length: 13

Pattern: ^[0-9]+(\.[0-9]{1,2})?$

Ejemplo:

"2000.00"

valorParcela · string · requerido

valorParcela — the new contract's instalment amount (decimal string, BRL). Must not exceed the closed contract's own instalment (regra BL) — a comparison this gateway leaves to the rail.

Maximum string length: 13

Pattern: ^[0-9]+(\.[0-9]{1,2})?$

Ejemplo:

"400.00"

valorTaxaAnual · string · requerido

valorTaxaAnual — annual interest rate, percent decimal string.

Maximum string length: 13

Pattern: ^[0-9]+(\.[0-9]{1,2})?$

Ejemplo:

"0.30"

valorTaxaMensal · string · requerido

valorTaxaMensal — monthly interest rate, percent decimal string.

Maximum string length: 13

Pattern: ^[0-9]+(\.[0-9]{1,2})?$

Ejemplo:

"0.10"

competenciaInicioDesconto · string

Payroll competência of the first deduction, yyyyMM. Optional; the rail assumes the current competência when omitted.

Pattern: ^[0-9]{6}$

Ejemplo:

"202501"

Respuesta

200

application/json

OK

competenciaInicioDesconto · string · requerido

Payroll competência of the first deduction, yyyyMM.

Ejemplo:

"202501"

hashOperacao · string · requerido

The rail's own identity for this operation.

Ejemplo:

"9598435"

mensagem · string · requerido

The rail's own message.

Ejemplo:

"Inclusão efetuada com sucesso"

numeroContrato · string · requerido

The new contract's number, as confirmed by the rail.

Ejemplo:

"Qwerty123456789"