Skip to main content
POST
Registrar la averbação de una portabilidad tras la exclusión de origen

Autorizaciones

​
Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

​
X-Idempotency
string
requerido

Required transport replay key, scoped by authenticated tenant.

Required string length: 1 - 128
Ejemplo:

"idem-portabilidade-averbacao-2026-01-21-0001"

Parámetros de ruta

​
numero_unico
string
requerido

The portability's NSU (Manual 008 v1.10 publishes 21 algarismos, which overflows int64/float64 — carried and validated as a digit string only).

Required string length: 1 - 21
Pattern: ^[0-9]{1,21}$
Ejemplo:

"100000000000000000001"

Cuerpo

application/json
​
codigoInscricaoEmpregador
string
requerido

1 CNPJ, 2 CPF.

Pattern: ^[12]$
Ejemplo:

"1"

​
cpfTrabalhador
string
requerido

Worker CPF, 11 digits.

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

"99999999999"

​
dataFimContrato
string<date-time>
requerido

Contract end date.

Ejemplo:

"2031-01-01T00:00:00Z"

​
dataInicioContrato
string<date-time>
requerido

Contract start date.

Ejemplo:

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

​
dataPrimeiroDesconto
string<date-time>
requerido

First payroll discount date.

Ejemplo:

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

​
matricula
string
requerido

Worker registration number at the employer.

Required string length: 1 - 30
Ejemplo:

"99999999999-A"

​
nomeTrabalhador
string
requerido

Worker's full name. Manual 008 §5.3.1 publishes 90 characters; the mirrored Swagger publishes maxLength 100 for the same field — the wider bound is accepted here for the same reason as numeroContrato above.

Required string length: 1 - 100
Ejemplo:

"Trabalhador 99999999999"

​
numeroContrato
string
requerido

Contract number being averbado. Manual 008 §5.3.1 publishes 2-15 characters; the mirrored Swagger publishes maxLength 20 for the same field — the wider bound is accepted here so a value the rail itself would honour is never rejected first.

Required string length: 2 - 20
Ejemplo:

"199971600000"

​
numeroInscricaoEmpregador
string
requerido

Employer inscription number.

Required string length: 1 - 15
Ejemplo:

"99999999999881"

​
numeroParcelas
integer<int64>
requerido

Number of instalments.

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

48

​
temGarantias
boolean
requerido

Whether this averbação pledges FGTS collateral.

Ejemplo:

false

​
valorCETAnual
string
requerido

Annual total effective cost in percent.

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

"11.00"

​
valorCETMensal
string
requerido

Monthly total effective cost in percent.

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

"0.90"

​
valorEmprestimo
string
requerido

Principal plus financed costs as an exact decimal string.

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

"2160.00"

​
valorPago
string
requerido

Settlement amount for the ORIGINAL contract(s) being ported — a field unique to this averbação.

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

"2000.00"

​
valorParcela
string
requerido

Instalment amount as an exact decimal string.

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

"180.00"

​
valorTaxaAnual
string
requerido

Annual interest rate in percent.

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

"10.00"

​
valorTaxaMensal
string
requerido

Monthly interest rate in percent.

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

"0.80"

​
cnpjOperador
string

OPTIONAL correspondent/cooperado CNPJ.

Maximum string length: 14
Ejemplo:

"12345678000199"

​
competenciaInicioDesconto
string

OPTIONAL. yyyyMM.

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

"202602"

​
dataExclusaoOrigem
string<date-time>

OPTIONAL. Origin exclusion date the client tracks, NEVER sent to Dataprev. When present, the gateway's own 20-calendar-day pre-rail refusal is judged against it. When absent, this averbação is submitted as occurring BEFORE the origin exclusion (Manual 008 §4 permits either order).

Ejemplo:

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

​
numeroProposta
string

OPTIONAL. Manual-only field of undocumented referent — see the operation description.

Maximum string length: 20
Ejemplo:

"7K9M2P4R6T8V3W5X2Y4Z"

​
percVerbaRescisoriaGarantia
string

OPTIONAL severance-pay percentage pledged as collateral.

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

"15.00"

​
valorMultaRescisoriaGarantiaFgts
string

OPTIONAL rescission-penalty amount pledged as collateral.

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

"300.00"

​
valorSaldoDisponivelGarantiaFgts
string

OPTIONAL consignable FGTS balance pledged as collateral.

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

"600.00"

Respuesta

OK

​
codigoSucesso
string
requerido

Bounded rail outcome code, relayed verbatim. Free-form provider text is never returned.

Maximum string length: 32
Pattern: ^[A-Za-z0-9_-]*$
Ejemplo:

"BD"

​
competenciaInicioDesconto
integer<int64>
requerido

First payroll-discount competência (yyyyMM) echoed by Dataprev.

Ejemplo:

202602

​
numeroContrato
string
requerido

Contract number echoed by Dataprev.

Ejemplo:

"199971600000"

​
numeroUnico
string
requerido

The portability identity addressed by this averbação.

Ejemplo:

"100000000000000000001"

​
submittedAt
string<date-time>
requerido

UTC instant the gateway submitted this averbação.

Ejemplo:

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

​
mensagem
string

Rail message, relayed verbatim.

Ejemplo:

"Averbacao realizada com sucesso"