Skip to main content
POST
Renegociar un contrato cerrado por terminación del vínculo laboral

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-renegociacao-0001"

Parámetros de ruta

numero_contrato
string
requerido

The NEW (renegotiated) contract number, minted by the CLIENT — the rail mints nothing here.

Required string length: 1 - 15
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 an averbação of the authenticated tenant that the rail acknowledged, 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 §2.3.2 line 748).

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 cannot make locally and 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

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"