Skip to main content
POST
Import a contract already averbado outside this gateway

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency
string
requerido

Required idempotency key. Absent is 422, never a generated default.

Ejemplo:

"idem-import-1"

Parámetros de ruta

numero_contrato
string
requerido

The contract number as the RAIL holds it (Manual 005 v1.13 §3.2.1 p.13, 2..15 alphanumerics). It is the only identifier the import takes: everything else about the contract is read back from Dataprev.

Required string length: 2 - 15
Ejemplo:

"199971600000"

Cuerpo

application/json
parcelas_pagas
integer<int64>
predeterminado:0

How many monthly competências of this contract have ALREADY amortized under whoever averbou it. It must lie between 0 and the contract's own total de parcelas as the rail reports it; anything outside that is refused 422. Leave it at 0 only for a contract that has genuinely not been discounted yet — a higher value than reality makes the first saldo devedor report understate the debt, and a lower one overstates it.

Rango requerido: x >= 0
Ejemplo:

7

Respuesta

Created

competencia_inicio_desconto
string
requerido

The first payroll competência the discount runs in, as the rail's verbatim AAAAMM literal.

Ejemplo:

"202601"

numero_contrato
string
requerido

The contract that was imported.

Ejemplo:

"199971600000"

numero_parcelas
integer<int64>
requerido

The contract's total de parcelas, as the rail reports it. Read back, never supplied.

Ejemplo:

24

origem
enum<string>
requerido

Always "importado" on this route — the provenance stamped on the obligation, distinguishing it forever from one this gateway averbou.

Opciones disponibles:
importado
Ejemplo:

"importado"

parcelas_pagas
integer<int64>
requerido

The amortized count recorded on the obligation — the value sent with the request.

Ejemplo:

7

saldo_devedor_dispatch_scheduled
boolean
requerido

Always true on a 201: the contract's first M015 saldo devedor report was scheduled durably alongside the obligation. It does NOT mean the report has been delivered to Dataprev — the outbox does that afterwards.

Ejemplo:

true

situacao_emprestimo
integer<int64>
requerido

The rail's own situação código for the contract at the moment it was imported (Manual 005 §3.2.2 p.17). Only 0, 7, 8 and 17 are importable.

Ejemplo:

0

valor_parcela
string
requerido

The instalment, as the rail reports it, verbatim (BRL decimal string).

Ejemplo:

"1116.31"