Registrar a averbação de uma portabilidade após a exclusão de origem

curl --request POST \
  --url https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "codigoInscricaoEmpregador": "1",
  "cpfTrabalhador": "99999999999",
  "dataFimContrato": "2031-01-01T00:00:00Z",
  "dataInicioContrato": "2026-01-01T00:00:00Z",
  "dataPrimeiroDesconto": "2026-02-01T00:00:00Z",
  "matricula": "99999999999-A",
  "nomeTrabalhador": "Trabalhador 99999999999",
  "numeroContrato": "199971600000",
  "numeroInscricaoEmpregador": "99999999999881",
  "numeroParcelas": 48,
  "temGarantias": false,
  "valorCETAnual": "11.00",
  "valorCETMensal": "0.90",
  "valorEmprestimo": "2160.00",
  "valorPago": "2000.00",
  "valorParcela": "180.00",
  "valorTaxaAnual": "10.00",
  "valorTaxaMensal": "0.80",
  "cnpjOperador": "12345678000199",
  "competenciaInicioDesconto": "202602",
  "dataExclusaoOrigem": "2026-01-01T00:00:00Z",
  "numeroProposta": "7K9M2P4R6T8V3W5X2Y4Z",
  "percVerbaRescisoriaGarantia": "15.00",
  "valorMultaRescisoriaGarantiaFgts": "300.00",
  "valorSaldoDisponivelGarantiaFgts": "600.00"
}
'

import requests

url = "https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao"

payload = {
    "codigoInscricaoEmpregador": "1",
    "cpfTrabalhador": "99999999999",
    "dataFimContrato": "2031-01-01T00:00:00Z",
    "dataInicioContrato": "2026-01-01T00:00:00Z",
    "dataPrimeiroDesconto": "2026-02-01T00:00:00Z",
    "matricula": "99999999999-A",
    "nomeTrabalhador": "Trabalhador 99999999999",
    "numeroContrato": "199971600000",
    "numeroInscricaoEmpregador": "99999999999881",
    "numeroParcelas": 48,
    "temGarantias": False,
    "valorCETAnual": "11.00",
    "valorCETMensal": "0.90",
    "valorEmprestimo": "2160.00",
    "valorPago": "2000.00",
    "valorParcela": "180.00",
    "valorTaxaAnual": "10.00",
    "valorTaxaMensal": "0.80",
    "cnpjOperador": "12345678000199",
    "competenciaInicioDesconto": "202602",
    "dataExclusaoOrigem": "2026-01-01T00:00:00Z",
    "numeroProposta": "7K9M2P4R6T8V3W5X2Y4Z",
    "percVerbaRescisoriaGarantia": "15.00",
    "valorMultaRescisoriaGarantiaFgts": "300.00",
    "valorSaldoDisponivelGarantiaFgts": "600.00"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    codigoInscricaoEmpregador: '1',
    cpfTrabalhador: '99999999999',
    dataFimContrato: '2031-01-01T00:00:00Z',
    dataInicioContrato: '2026-01-01T00:00:00Z',
    dataPrimeiroDesconto: '2026-02-01T00:00:00Z',
    matricula: '99999999999-A',
    nomeTrabalhador: 'Trabalhador 99999999999',
    numeroContrato: '199971600000',
    numeroInscricaoEmpregador: '99999999999881',
    numeroParcelas: 48,
    temGarantias: false,
    valorCETAnual: '11.00',
    valorCETMensal: '0.90',
    valorEmprestimo: '2160.00',
    valorPago: '2000.00',
    valorParcela: '180.00',
    valorTaxaAnual: '10.00',
    valorTaxaMensal: '0.80',
    cnpjOperador: '12345678000199',
    competenciaInicioDesconto: '202602',
    dataExclusaoOrigem: '2026-01-01T00:00:00Z',
    numeroProposta: '7K9M2P4R6T8V3W5X2Y4Z',
    percVerbaRescisoriaGarantia: '15.00',
    valorMultaRescisoriaGarantiaFgts: '300.00',
    valorSaldoDisponivelGarantiaFgts: '600.00'
  })
};

fetch('https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'codigoInscricaoEmpregador' => '1',
    'cpfTrabalhador' => '99999999999',
    'dataFimContrato' => '2031-01-01T00:00:00Z',
    'dataInicioContrato' => '2026-01-01T00:00:00Z',
    'dataPrimeiroDesconto' => '2026-02-01T00:00:00Z',
    'matricula' => '99999999999-A',
    'nomeTrabalhador' => 'Trabalhador 99999999999',
    'numeroContrato' => '199971600000',
    'numeroInscricaoEmpregador' => '99999999999881',
    'numeroParcelas' => 48,
    'temGarantias' => false,
    'valorCETAnual' => '11.00',
    'valorCETMensal' => '0.90',
    'valorEmprestimo' => '2160.00',
    'valorPago' => '2000.00',
    'valorParcela' => '180.00',
    'valorTaxaAnual' => '10.00',
    'valorTaxaMensal' => '0.80',
    'cnpjOperador' => '12345678000199',
    'competenciaInicioDesconto' => '202602',
    'dataExclusaoOrigem' => '2026-01-01T00:00:00Z',
    'numeroProposta' => '7K9M2P4R6T8V3W5X2Y4Z',
    'percVerbaRescisoriaGarantia' => '15.00',
    'valorMultaRescisoriaGarantiaFgts' => '300.00',
    'valorSaldoDisponivelGarantiaFgts' => '600.00'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Idempotency: <x-idempotency>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao"

	payload := strings.NewReader("{\n  \"codigoInscricaoEmpregador\": \"1\",\n  \"cpfTrabalhador\": \"99999999999\",\n  \"dataFimContrato\": \"2031-01-01T00:00:00Z\",\n  \"dataInicioContrato\": \"2026-01-01T00:00:00Z\",\n  \"dataPrimeiroDesconto\": \"2026-02-01T00:00:00Z\",\n  \"matricula\": \"99999999999-A\",\n  \"nomeTrabalhador\": \"Trabalhador 99999999999\",\n  \"numeroContrato\": \"199971600000\",\n  \"numeroInscricaoEmpregador\": \"99999999999881\",\n  \"numeroParcelas\": 48,\n  \"temGarantias\": false,\n  \"valorCETAnual\": \"11.00\",\n  \"valorCETMensal\": \"0.90\",\n  \"valorEmprestimo\": \"2160.00\",\n  \"valorPago\": \"2000.00\",\n  \"valorParcela\": \"180.00\",\n  \"valorTaxaAnual\": \"10.00\",\n  \"valorTaxaMensal\": \"0.80\",\n  \"cnpjOperador\": \"12345678000199\",\n  \"competenciaInicioDesconto\": \"202602\",\n  \"dataExclusaoOrigem\": \"2026-01-01T00:00:00Z\",\n  \"numeroProposta\": \"7K9M2P4R6T8V3W5X2Y4Z\",\n  \"percVerbaRescisoriaGarantia\": \"15.00\",\n  \"valorMultaRescisoriaGarantiaFgts\": \"300.00\",\n  \"valorSaldoDisponivelGarantiaFgts\": \"600.00\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao")
  .header("X-Idempotency", "<x-idempotency>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"codigoInscricaoEmpregador\": \"1\",\n  \"cpfTrabalhador\": \"99999999999\",\n  \"dataFimContrato\": \"2031-01-01T00:00:00Z\",\n  \"dataInicioContrato\": \"2026-01-01T00:00:00Z\",\n  \"dataPrimeiroDesconto\": \"2026-02-01T00:00:00Z\",\n  \"matricula\": \"99999999999-A\",\n  \"nomeTrabalhador\": \"Trabalhador 99999999999\",\n  \"numeroContrato\": \"199971600000\",\n  \"numeroInscricaoEmpregador\": \"99999999999881\",\n  \"numeroParcelas\": 48,\n  \"temGarantias\": false,\n  \"valorCETAnual\": \"11.00\",\n  \"valorCETMensal\": \"0.90\",\n  \"valorEmprestimo\": \"2160.00\",\n  \"valorPago\": \"2000.00\",\n  \"valorParcela\": \"180.00\",\n  \"valorTaxaAnual\": \"10.00\",\n  \"valorTaxaMensal\": \"0.80\",\n  \"cnpjOperador\": \"12345678000199\",\n  \"competenciaInicioDesconto\": \"202602\",\n  \"dataExclusaoOrigem\": \"2026-01-01T00:00:00Z\",\n  \"numeroProposta\": \"7K9M2P4R6T8V3W5X2Y4Z\",\n  \"percVerbaRescisoriaGarantia\": \"15.00\",\n  \"valorMultaRescisoriaGarantiaFgts\": \"300.00\",\n  \"valorSaldoDisponivelGarantiaFgts\": \"600.00\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Idempotency"] = '<x-idempotency>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"codigoInscricaoEmpregador\": \"1\",\n  \"cpfTrabalhador\": \"99999999999\",\n  \"dataFimContrato\": \"2031-01-01T00:00:00Z\",\n  \"dataInicioContrato\": \"2026-01-01T00:00:00Z\",\n  \"dataPrimeiroDesconto\": \"2026-02-01T00:00:00Z\",\n  \"matricula\": \"99999999999-A\",\n  \"nomeTrabalhador\": \"Trabalhador 99999999999\",\n  \"numeroContrato\": \"199971600000\",\n  \"numeroInscricaoEmpregador\": \"99999999999881\",\n  \"numeroParcelas\": 48,\n  \"temGarantias\": false,\n  \"valorCETAnual\": \"11.00\",\n  \"valorCETMensal\": \"0.90\",\n  \"valorEmprestimo\": \"2160.00\",\n  \"valorPago\": \"2000.00\",\n  \"valorParcela\": \"180.00\",\n  \"valorTaxaAnual\": \"10.00\",\n  \"valorTaxaMensal\": \"0.80\",\n  \"cnpjOperador\": \"12345678000199\",\n  \"competenciaInicioDesconto\": \"202602\",\n  \"dataExclusaoOrigem\": \"2026-01-01T00:00:00Z\",\n  \"numeroProposta\": \"7K9M2P4R6T8V3W5X2Y4Z\",\n  \"percVerbaRescisoriaGarantia\": \"15.00\",\n  \"valorMultaRescisoriaGarantiaFgts\": \"300.00\",\n  \"valorSaldoDisponivelGarantiaFgts\": \"600.00\"\n}"

response = http.request(request)
puts response.read_body

{
  "codigoSucesso": "BD",
  "competenciaInicioDesconto": 202602,
  "numeroContrato": "199971600000",
  "numeroUnico": "100000000000000000001",
  "submittedAt": "2026-01-15T00:00:00Z",
  "mensagem": "Averbacao realizada com sucesso"
}

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Registrar a averbação de uma portabilidade após a exclusão de origem

Executa averbar-portabilidade-trabalhador (Manual 008 v1.10 §5.3): a averbação de uma portabilidade pela instituição proponente. A exclusão do lado de origem é um comando separado que este gateway ainda não integra. De acordo com o Manual 008 §4, ela pode ocorrer antes ou depois desta averbação; o manual define explicitamente o caso anterior à exclusão e trata o valor reservado como zero.

dataExclusaoOrigem é opcional e não é enviada à Dataprev. Quando informada, representa a data de exclusão de origem registrada pelo cliente. O gateway a repete para poder rejeitar, antes de chamar o trilho, uma averbação cujo prazo de 20 dias corridos (Manual 008 §4) já tenha terminado. Nenhum calendário comercial é consultado porque o prazo usa dias corridos. Se o campo estiver ausente, o gateway envia a averbação como anterior à exclusão de origem. Não há um fato iniciador alternativo, portanto o cliente é a única fonte da data de exclusão quando ela existe.

X-Idempotency é a chave obrigatória de repetição do transporte. Uma nova tentativa com a mesma chave retorna a resposta armazenada em vez de reenviá-la ao trilho, como ocorre nas rotas de averbação e anexo CCB. Esta rota ainda não tem armazenamento durável de repetições respaldado por PostgreSQL, portanto, diferentemente da rota de lance, a garantia não sobrevive a uma remoção do Redis nem a uma reinicialização.

POST

consignado

portabilidade

{numero_unico}

averbacao

Registrar a averbação de uma portabilidade após a exclusão de origem

curl --request POST \
  --url https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "codigoInscricaoEmpregador": "1",
  "cpfTrabalhador": "99999999999",
  "dataFimContrato": "2031-01-01T00:00:00Z",
  "dataInicioContrato": "2026-01-01T00:00:00Z",
  "dataPrimeiroDesconto": "2026-02-01T00:00:00Z",
  "matricula": "99999999999-A",
  "nomeTrabalhador": "Trabalhador 99999999999",
  "numeroContrato": "199971600000",
  "numeroInscricaoEmpregador": "99999999999881",
  "numeroParcelas": 48,
  "temGarantias": false,
  "valorCETAnual": "11.00",
  "valorCETMensal": "0.90",
  "valorEmprestimo": "2160.00",
  "valorPago": "2000.00",
  "valorParcela": "180.00",
  "valorTaxaAnual": "10.00",
  "valorTaxaMensal": "0.80",
  "cnpjOperador": "12345678000199",
  "competenciaInicioDesconto": "202602",
  "dataExclusaoOrigem": "2026-01-01T00:00:00Z",
  "numeroProposta": "7K9M2P4R6T8V3W5X2Y4Z",
  "percVerbaRescisoriaGarantia": "15.00",
  "valorMultaRescisoriaGarantiaFgts": "300.00",
  "valorSaldoDisponivelGarantiaFgts": "600.00"
}
'

import requests

url = "https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao"

payload = {
    "codigoInscricaoEmpregador": "1",
    "cpfTrabalhador": "99999999999",
    "dataFimContrato": "2031-01-01T00:00:00Z",
    "dataInicioContrato": "2026-01-01T00:00:00Z",
    "dataPrimeiroDesconto": "2026-02-01T00:00:00Z",
    "matricula": "99999999999-A",
    "nomeTrabalhador": "Trabalhador 99999999999",
    "numeroContrato": "199971600000",
    "numeroInscricaoEmpregador": "99999999999881",
    "numeroParcelas": 48,
    "temGarantias": False,
    "valorCETAnual": "11.00",
    "valorCETMensal": "0.90",
    "valorEmprestimo": "2160.00",
    "valorPago": "2000.00",
    "valorParcela": "180.00",
    "valorTaxaAnual": "10.00",
    "valorTaxaMensal": "0.80",
    "cnpjOperador": "12345678000199",
    "competenciaInicioDesconto": "202602",
    "dataExclusaoOrigem": "2026-01-01T00:00:00Z",
    "numeroProposta": "7K9M2P4R6T8V3W5X2Y4Z",
    "percVerbaRescisoriaGarantia": "15.00",
    "valorMultaRescisoriaGarantiaFgts": "300.00",
    "valorSaldoDisponivelGarantiaFgts": "600.00"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    codigoInscricaoEmpregador: '1',
    cpfTrabalhador: '99999999999',
    dataFimContrato: '2031-01-01T00:00:00Z',
    dataInicioContrato: '2026-01-01T00:00:00Z',
    dataPrimeiroDesconto: '2026-02-01T00:00:00Z',
    matricula: '99999999999-A',
    nomeTrabalhador: 'Trabalhador 99999999999',
    numeroContrato: '199971600000',
    numeroInscricaoEmpregador: '99999999999881',
    numeroParcelas: 48,
    temGarantias: false,
    valorCETAnual: '11.00',
    valorCETMensal: '0.90',
    valorEmprestimo: '2160.00',
    valorPago: '2000.00',
    valorParcela: '180.00',
    valorTaxaAnual: '10.00',
    valorTaxaMensal: '0.80',
    cnpjOperador: '12345678000199',
    competenciaInicioDesconto: '202602',
    dataExclusaoOrigem: '2026-01-01T00:00:00Z',
    numeroProposta: '7K9M2P4R6T8V3W5X2Y4Z',
    percVerbaRescisoriaGarantia: '15.00',
    valorMultaRescisoriaGarantiaFgts: '300.00',
    valorSaldoDisponivelGarantiaFgts: '600.00'
  })
};

fetch('https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'codigoInscricaoEmpregador' => '1',
    'cpfTrabalhador' => '99999999999',
    'dataFimContrato' => '2031-01-01T00:00:00Z',
    'dataInicioContrato' => '2026-01-01T00:00:00Z',
    'dataPrimeiroDesconto' => '2026-02-01T00:00:00Z',
    'matricula' => '99999999999-A',
    'nomeTrabalhador' => 'Trabalhador 99999999999',
    'numeroContrato' => '199971600000',
    'numeroInscricaoEmpregador' => '99999999999881',
    'numeroParcelas' => 48,
    'temGarantias' => false,
    'valorCETAnual' => '11.00',
    'valorCETMensal' => '0.90',
    'valorEmprestimo' => '2160.00',
    'valorPago' => '2000.00',
    'valorParcela' => '180.00',
    'valorTaxaAnual' => '10.00',
    'valorTaxaMensal' => '0.80',
    'cnpjOperador' => '12345678000199',
    'competenciaInicioDesconto' => '202602',
    'dataExclusaoOrigem' => '2026-01-01T00:00:00Z',
    'numeroProposta' => '7K9M2P4R6T8V3W5X2Y4Z',
    'percVerbaRescisoriaGarantia' => '15.00',
    'valorMultaRescisoriaGarantiaFgts' => '300.00',
    'valorSaldoDisponivelGarantiaFgts' => '600.00'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-Idempotency: <x-idempotency>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao"

	payload := strings.NewReader("{\n  \"codigoInscricaoEmpregador\": \"1\",\n  \"cpfTrabalhador\": \"99999999999\",\n  \"dataFimContrato\": \"2031-01-01T00:00:00Z\",\n  \"dataInicioContrato\": \"2026-01-01T00:00:00Z\",\n  \"dataPrimeiroDesconto\": \"2026-02-01T00:00:00Z\",\n  \"matricula\": \"99999999999-A\",\n  \"nomeTrabalhador\": \"Trabalhador 99999999999\",\n  \"numeroContrato\": \"199971600000\",\n  \"numeroInscricaoEmpregador\": \"99999999999881\",\n  \"numeroParcelas\": 48,\n  \"temGarantias\": false,\n  \"valorCETAnual\": \"11.00\",\n  \"valorCETMensal\": \"0.90\",\n  \"valorEmprestimo\": \"2160.00\",\n  \"valorPago\": \"2000.00\",\n  \"valorParcela\": \"180.00\",\n  \"valorTaxaAnual\": \"10.00\",\n  \"valorTaxaMensal\": \"0.80\",\n  \"cnpjOperador\": \"12345678000199\",\n  \"competenciaInicioDesconto\": \"202602\",\n  \"dataExclusaoOrigem\": \"2026-01-01T00:00:00Z\",\n  \"numeroProposta\": \"7K9M2P4R6T8V3W5X2Y4Z\",\n  \"percVerbaRescisoriaGarantia\": \"15.00\",\n  \"valorMultaRescisoriaGarantiaFgts\": \"300.00\",\n  \"valorSaldoDisponivelGarantiaFgts\": \"600.00\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao")
  .header("X-Idempotency", "<x-idempotency>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"codigoInscricaoEmpregador\": \"1\",\n  \"cpfTrabalhador\": \"99999999999\",\n  \"dataFimContrato\": \"2031-01-01T00:00:00Z\",\n  \"dataInicioContrato\": \"2026-01-01T00:00:00Z\",\n  \"dataPrimeiroDesconto\": \"2026-02-01T00:00:00Z\",\n  \"matricula\": \"99999999999-A\",\n  \"nomeTrabalhador\": \"Trabalhador 99999999999\",\n  \"numeroContrato\": \"199971600000\",\n  \"numeroInscricaoEmpregador\": \"99999999999881\",\n  \"numeroParcelas\": 48,\n  \"temGarantias\": false,\n  \"valorCETAnual\": \"11.00\",\n  \"valorCETMensal\": \"0.90\",\n  \"valorEmprestimo\": \"2160.00\",\n  \"valorPago\": \"2000.00\",\n  \"valorParcela\": \"180.00\",\n  \"valorTaxaAnual\": \"10.00\",\n  \"valorTaxaMensal\": \"0.80\",\n  \"cnpjOperador\": \"12345678000199\",\n  \"competenciaInicioDesconto\": \"202602\",\n  \"dataExclusaoOrigem\": \"2026-01-01T00:00:00Z\",\n  \"numeroProposta\": \"7K9M2P4R6T8V3W5X2Y4Z\",\n  \"percVerbaRescisoriaGarantia\": \"15.00\",\n  \"valorMultaRescisoriaGarantiaFgts\": \"300.00\",\n  \"valorSaldoDisponivelGarantiaFgts\": \"600.00\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://consignado.sandbox.lerian.net/v1/consignado/portabilidade/{numero_unico}/averbacao")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Idempotency"] = '<x-idempotency>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"codigoInscricaoEmpregador\": \"1\",\n  \"cpfTrabalhador\": \"99999999999\",\n  \"dataFimContrato\": \"2031-01-01T00:00:00Z\",\n  \"dataInicioContrato\": \"2026-01-01T00:00:00Z\",\n  \"dataPrimeiroDesconto\": \"2026-02-01T00:00:00Z\",\n  \"matricula\": \"99999999999-A\",\n  \"nomeTrabalhador\": \"Trabalhador 99999999999\",\n  \"numeroContrato\": \"199971600000\",\n  \"numeroInscricaoEmpregador\": \"99999999999881\",\n  \"numeroParcelas\": 48,\n  \"temGarantias\": false,\n  \"valorCETAnual\": \"11.00\",\n  \"valorCETMensal\": \"0.90\",\n  \"valorEmprestimo\": \"2160.00\",\n  \"valorPago\": \"2000.00\",\n  \"valorParcela\": \"180.00\",\n  \"valorTaxaAnual\": \"10.00\",\n  \"valorTaxaMensal\": \"0.80\",\n  \"cnpjOperador\": \"12345678000199\",\n  \"competenciaInicioDesconto\": \"202602\",\n  \"dataExclusaoOrigem\": \"2026-01-01T00:00:00Z\",\n  \"numeroProposta\": \"7K9M2P4R6T8V3W5X2Y4Z\",\n  \"percVerbaRescisoriaGarantia\": \"15.00\",\n  \"valorMultaRescisoriaGarantiaFgts\": \"300.00\",\n  \"valorSaldoDisponivelGarantiaFgts\": \"600.00\"\n}"

response = http.request(request)
puts response.read_body

{
  "codigoSucesso": "BD",
  "competenciaInicioDesconto": 202602,
  "numeroContrato": "199971600000",
  "numeroUnico": "100000000000000000001",
  "submittedAt": "2026-01-15T00:00:00Z",
  "mensagem": "Averbacao realizada com sucesso"
}

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Autorizações

Authorization

string

header

obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency

string

obrigatório

Required transport replay key, scoped by authenticated tenant.

Required string length: 1 - 128

Exemplo:

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

Parâmetros de caminho

numero_unico

string

obrigatório

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}$

Exemplo:

"100000000000000000001"

Corpo

application/json

codigoInscricaoEmpregador

string

obrigatório

1 CNPJ, 2 CPF.

Pattern: ^[12]$

Exemplo:

"1"

cpfTrabalhador

string

obrigatório

Worker CPF, 11 digits.

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

Exemplo:

"99999999999"

dataFimContrato

string<date-time>

obrigatório

Contract end date.

Exemplo:

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

dataInicioContrato

string<date-time>

obrigatório

Contract start date.

Exemplo:

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

dataPrimeiroDesconto

string<date-time>

obrigatório

First payroll discount date.

Exemplo:

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

matricula

string

obrigatório

Worker registration number at the employer.

Required string length: 1 - 30

Exemplo:

"99999999999-A"

nomeTrabalhador

string

obrigatório

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

Exemplo:

"Trabalhador 99999999999"

numeroContrato

string

obrigatório

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

Exemplo:

"199971600000"

numeroInscricaoEmpregador

string

obrigatório

Employer inscription number.

Required string length: 1 - 15

Exemplo:

"99999999999881"

numeroParcelas

integer<int64>

obrigatório

Number of instalments.

Intervalo obrigatório: 1 <= x <= 999

Exemplo:

48

temGarantias

boolean

obrigatório

Whether this averbação pledges FGTS collateral.

Exemplo:

false

valorCETAnual

string

obrigatório

Annual total effective cost in percent.

Maximum string length: 10

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

Exemplo:

"11.00"

valorCETMensal

string

obrigatório

Monthly total effective cost in percent.

Maximum string length: 10

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

Exemplo:

"0.90"

valorEmprestimo

string

obrigatório

Principal plus financed costs as an exact decimal string.

Maximum string length: 13

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

Exemplo:

"2160.00"

valorPago

string

obrigatório

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})?$

Exemplo:

"2000.00"

valorParcela

string

obrigatório

Instalment amount as an exact decimal string.

Maximum string length: 13

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

Exemplo:

"180.00"

valorTaxaAnual

string

obrigatório

Annual interest rate in percent.

Maximum string length: 10

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

Exemplo:

"10.00"

valorTaxaMensal

string

obrigatório

Monthly interest rate in percent.

Maximum string length: 10

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

Exemplo:

"0.80"

cnpjOperador

string

OPTIONAL correspondent/cooperado CNPJ.

Maximum string length: 14

Exemplo:

"12345678000199"

competenciaInicioDesconto

string

OPTIONAL. yyyyMM.

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

Exemplo:

"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).

Exemplo:

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

numeroProposta

string

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

Maximum string length: 20

Exemplo:

"7K9M2P4R6T8V3W5X2Y4Z"

percVerbaRescisoriaGarantia

string

OPTIONAL severance-pay percentage pledged as collateral.

Maximum string length: 6

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

Exemplo:

"15.00"

valorMultaRescisoriaGarantiaFgts

string

OPTIONAL rescission-penalty amount pledged as collateral.

Maximum string length: 13

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

Exemplo:

"300.00"

valorSaldoDisponivelGarantiaFgts

string

OPTIONAL consignable FGTS balance pledged as collateral.

Maximum string length: 13

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

Exemplo:

"600.00"

Resposta

codigoSucesso

string

obrigatório

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

Maximum string length: 32

Pattern: ^[A-Za-z0-9_-]*$

Exemplo:

"BD"

competenciaInicioDesconto

integer<int64>

obrigatório

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

Exemplo:

202602

numeroContrato

string

obrigatório

Contract number echoed by Dataprev.

Exemplo:

"199971600000"

numeroUnico

string

obrigatório

The portability identity addressed by this averbação.

Exemplo:

"100000000000000000001"

submittedAt

string<date-time>

obrigatório

UTC instant the gateway submitted this averbação.

Exemplo:

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

mensagem

string

Rail message, relayed verbatim.

Exemplo:

"Averbacao realizada com sucesso"

⌘I

Pix — Lerian SPI (mensageria nativa)

Pix — JD (interface, direto)

Pix — BTG (interface, indireto)

TED — Lerian SPB (mensageria nativa)

TED — JD (interface)

Boletos — BTG (interface)

Lerian SILOC (mensageria nativa)

Lerian SLC (mensageria nativa)

Lerian STA (mensageria nativa)

Lerian SISBAJUD (mensageria nativa)

Lerian Consignado — Dataprev

Registrar a averbação de uma portabilidade após a exclusão de origem

Autorizações

Cabeçalhos

Parâmetros de caminho

Corpo

Resposta