Skip to main content
POST
Renegociar uno o más préstamos de legado en un nuevo contrato.

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-legado-renegociar-0001"

Cuerpo

application/json
​
codigoInscricaoEmpregador
enum<string>
requerido

Employer inscription type: 1 CNPJ, 2 CPF.

Opciones disponibles:
1,
2
Ejemplo:

"1"

​
codigoTipoRenegociacao
enum<integer>
requerido

1 = Padrão; 2 = Portabilidade. Portabilidade requires at least one contratoLegado carrying numeroUnico; Padrão forbids numeroUnico on every item.

Opciones disponibles:
1,
2
Ejemplo:

1

​
contratosLegados
object[] | null
requerido

Every legado contract folded into this renegociação (§3.3.1, Obrigatório=Sim).

Minimum array length: 1
Ejemplo:
​
cpfTrabalhador
string
requerido

Worker CPF, exactly 11 digits.

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

"99999999999"

​
dataFimContrato
string<date-time>
requerido

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

Ejemplo:

"2026-06-23T00:00:00Z"

​
dataInicioContrato
string<date-time>
requerido

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

Ejemplo:

"2025-04-03T00:00:00Z"

​
dataPrimeiroDesconto
string<date-time>
requerido

Date of the first payroll deduction of the NEW contract, RFC 3339 UTC.

Ejemplo:

"2025-04-23T00:00:00Z"

​
matricula
string
requerido

Matrícula assigned to the worker by the employer. Cannot be blank or whitespace-only.

Maximum string length: 30
Pattern: ^\S(.*\S)?$
Ejemplo:

"99999999999-A"

​
nomeTrabalhador
string
requerido

Worker's full name (Manual 007 §3.3.1 publishes 90 characters — the mirrored Swagger's 100 is not the bound this gateway enforces). Cannot be blank or whitespace-only.

Maximum string length: 90
Pattern: ^\S(.*\S)?$
Ejemplo:

"Trabalhador 99999999999"

​
numeroContrato
string
requerido

The NEW contract's number, minted by the CLIENT. 1 to 15 alphanumeric characters, no diacritics (§3.3.1 + its footnote 3).

Required string length: 1 - 15
Pattern: ^[A-Za-z0-9]+$
Ejemplo:

"99999999999AN1"

​
numeroInscricaoEmpregador
string
requerido

Employer inscription number: 14 digits for CNPJ, 11 for CPF (matching codigoInscricaoEmpregador; §3.3.1's own '15 algarismos' is a stale maximum, see ports.ValidateNumeroInscricaoEmpregador).

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

"42422253000101"

​
numeroParcelas
integer<int64>
requerido

Total number of instalments of the NEW contract.

Rango requerido: 1 <= x <= 999
Ejemplo:

15

​
valorCETAnual
string
requerido

valorCETAnual — Custo Efetivo Total, annual percent decimal string.

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

"4.91"

​
valorCETMensal
string
requerido

valorCETMensal — Custo Efetivo Total, monthly percent decimal string.

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

"0.4"

​
valorEmprestimo
string
requerido

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

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

"12000.00"

​
valorIOF
string
requerido

valorIOF — the IOF charged, in reais (decimal string, BRL). Required by the manual despite the mirrored Swagger's required list omitting it.

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

"0.00"

​
valorLiberado
string
requerido

valorLiberado — amount delivered to the worker (decimal string, BRL). Required by the manual despite the mirrored Swagger's required list omitting it.

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

"12000.00"

​
valorParcela
string
requerido

valorParcela — the new contract's instalment amount (decimal string, BRL).

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

"825.10"

​
valorTaxaAnual
string
requerido

valorTaxaAnual — annual interest rate, percent decimal string. Must stay below the original legado contract's own rate — a comparison this gateway holds no local record of and leaves to the rail.

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

"4.91"

​
valorTaxaMensal
string
requerido

valorTaxaMensal — monthly interest rate, percent decimal string.

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

"0.4"

​
cnpjOperador
string

CNPJ of the operator (correspondente, cooperado or similar) responsible for the operation, exactly 14 digits, unpunctuated. Optional (§3.3.1) — omitted entirely rather than sent malformed; competenciaInicioDesconto below is the other optional field on this body. Dataprev performs no documental validation of legado data (§2.2.1.3), so this shape guard is the only one the CNPJ gets before the rail is spent.

Pattern: ^[0-9]{14}$
Ejemplo:

"99999999999962"

​
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:

"202504"

Respuesta

OK

​
codigo
string
requerido

The rail's own outcome code — a closed enum of roughly 290 values including SUCESSO. NOT redundant with the 200 status: read this field.

Ejemplo:

"SUCESSO"

​
competenciaInicioDesconto
string
requerido

Payroll competência of the first deduction, yyyyMM.

Ejemplo:

"202504"

​
mensagem
string
requerido

The rail's own message.

Ejemplo:

"Renegociacao efetuada com sucesso"

​
numeroContrato
string
requerido

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

Ejemplo:

"99999999999AN1"

​
erros
object[] | null

Top-level errors, if any.

​
errosContratosPortados
object[] | null

Per-legado-contract failures, if any. A non-empty list here does NOT mean the new contract failed to averbate.