Skip to main content
POST
Refinanciar uno o más contratos activos en uno nuevo

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

Parámetros de ruta

​
numero_contrato
string
requerido

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

Required string length: 2 - 15
Ejemplo:

"99999999999ARN1"

Cuerpo

application/json
​
codigoInscricaoEmpregador
string
requerido

Employer inscription type: 1 CNPJ, 2 CPF.

Pattern: ^[12]$
Ejemplo:

"1"

​
cpfTrabalhador
string
requerido

Worker CPF, 11 digits.

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

"99999999999"

​
dataFimContrato
string<date-time>
requerido

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

Ejemplo:

"2027-07-10T00:00:00Z"

​
dataInicioContrato
string<date-time>
requerido

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

Ejemplo:

"2025-06-11T00:00:00Z"

​
dataPrimeiroDesconto
string<date-time>
requerido

Date of the first payroll deduction, RFC 3339 UTC.

Ejemplo:

"2025-07-10T00:00:00Z"

​
listaContratosQuitadosTrabalhador
object[] | null
requerido

Every contract this refinanciamento quits. Each must be an active averbação of the authenticated tenant — 'active' is the government registry's own judgment, which this gateway does not locally track.

Minimum array length: 1
Ejemplo:
​
matricula
string
requerido

Matrícula assigned to the worker by the employer.

Maximum string length: 30
Ejemplo:

"99999999999-A"

​
nomeTrabalhador
string
requerido

Worker's full name.

Maximum string length: 90
Ejemplo:

"Trabalhador 99999999999"

​
numeroInscricaoEmpregador
string
requerido

Employer inscription number, Texto since Manual 008 v1.7 (the mirrored Swagger still types this int64).

Maximum string length: 14
Ejemplo:

"99999999999881"

​
numeroParcelas
integer<int64>
requerido

Number of instalments of the new contract, capped at the manual's own 3-digit field width (Manual 008 §3.1.1 p.10).

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

24

​
temGarantias
boolean
requerido

Whether FGTS collateral secures the new contract. When true, exactly one contract may be named in lista_contratos_quitados_trabalhador (regra FR) and at least one of the three garantia values below must be informed (regra FI).

Ejemplo:

true

​
valorCETAnual
string
requerido

valorCETAnual — Custo Efetivo Total, annual percent decimal string.

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

"7.26"

​
valorCETMensal
string
requerido

valorCETMensal — Custo Efetivo Total, monthly percent decimal string.

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

"0.59"

​
valorEmprestimo
string
requerido

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

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

"9018.54"

​
valorIOF
string
requerido

valorIOF — the IOF charged, in reais (decimal string, BRL).

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

"94.95"

​
valorPago
string
requerido

valorPago — settlement amount paid to quit the original contracts (decimal string, BRL).

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

"6114.50"

​
valorParcela
string
requerido

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

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:

"6.17"

​
valorTaxaMensal
string
requerido

valorTaxaMensal — monthly interest rate, percent decimal string.

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

"0.5"

​
valorTroco
string
requerido

valorTroco — amount delivered to the client after settling the quitados contracts (decimal string, BRL).

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

"2809.09"

​
cnpjOperador
string

CNPJ of the operator (correspondent, cooperado or similar) responsible for the operation. Optional, Texto since v1.7.

Maximum string length: 14
Ejemplo:

"12345678000199"

​
competenciaInicioDesconto
string

Payroll competência of the first deduction, yyyyMM. Optional.

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

"202507"

​
percVerbaRescisoriaGarantia
string

Percentage of severance pay pledged as collateral, 0 to 35%.

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

"15"

​
valorMultaRescisoriaGarantiaFgts
string

FGTS termination-fine collateral, up to 100% of the 40% fine (decimal string, BRL). Optional individually.

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

"300.00"

​
valorSaldoDisponivelGarantiaFgts
string

FGTS balance pledged as collateral (decimal string, BRL). Optional individually; at least one of the three garantia values is required when temGarantias is true.

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

"600.00"

Respuesta

OK

​
competenciaInicioDesconto
string
requerido

Payroll competência of the first deduction, yyyyMM.

Ejemplo:

"202507"

​
hashOperacao
string
requerido

The rail's own identity for this operation.

Ejemplo:

"34006311"

​
listaContratosQuitadosTrabalhador
object[] | null
requerido

Every contract the rail confirmed as quitado by this refinanciamento.

Ejemplo:
​
mensagem
string
requerido

The rail's own message.

Ejemplo:

"Refinanciamento realizado com sucesso"

​
numeroContrato
string
requerido

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

Ejemplo:

"99999999999ARN1"