Respond to an inbound portability leilão solicitação

curl --request POST \
  --url https://br-consignado-gw.sandbox.lerian.net/v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "dataHoraValidadeProposta": "2030-01-01T10:00:00Z",
  "dataHoraValidadeSolicitacao": "2025-10-30T23:45:29Z",
  "numeroParcelas": 12,
  "numeroProposta": "7K9M2P4R6T8V3W5X2Y4Z",
  "temGarantias": false,
  "valorCETAnual": "11.00",
  "valorCETMensal": "0.90",
  "valorEmprestimo": "2160.00",
  "valorParcela": "180.00",
  "valorTaxaAnual": "10.00",
  "valorTaxaMensal": "0.80",
  "contatos": [
    {
      "contato": "bidder@example.com",
      "tipo": 3
    }
  ],
  "percVerbaRescisoriaGarantia": "15.00",
  "valorMultaRescisoriaGarantiaFgts": "300.00",
  "valorSaldoDisponivelGarantiaFgts": "600.00"
}
'

package main

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

func main() {

	url := "https://br-consignado-gw.sandbox.lerian.net/v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas"

	payload := strings.NewReader("{\n  \"dataHoraValidadeProposta\": \"2030-01-01T10:00:00Z\",\n  \"dataHoraValidadeSolicitacao\": \"2025-10-30T23:45:29Z\",\n  \"numeroParcelas\": 12,\n  \"numeroProposta\": \"7K9M2P4R6T8V3W5X2Y4Z\",\n  \"temGarantias\": false,\n  \"valorCETAnual\": \"11.00\",\n  \"valorCETMensal\": \"0.90\",\n  \"valorEmprestimo\": \"2160.00\",\n  \"valorParcela\": \"180.00\",\n  \"valorTaxaAnual\": \"10.00\",\n  \"valorTaxaMensal\": \"0.80\",\n  \"contatos\": [\n    {\n      \"contato\": \"bidder@example.com\",\n      \"tipo\": 3\n    }\n  ],\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))

}

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    dataHoraValidadeProposta: '2030-01-01T10:00:00Z',
    dataHoraValidadeSolicitacao: '2025-10-30T23:45:29Z',
    numeroParcelas: 12,
    numeroProposta: '7K9M2P4R6T8V3W5X2Y4Z',
    temGarantias: false,
    valorCETAnual: '11.00',
    valorCETMensal: '0.90',
    valorEmprestimo: '2160.00',
    valorParcela: '180.00',
    valorTaxaAnual: '10.00',
    valorTaxaMensal: '0.80',
    contatos: [{contato: 'bidder@example.com', tipo: 3}],
    percVerbaRescisoriaGarantia: '15.00',
    valorMultaRescisoriaGarantiaFgts: '300.00',
    valorSaldoDisponivelGarantiaFgts: '600.00'
  })
};

fetch('https://br-consignado-gw.sandbox.lerian.net/v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://br-consignado-gw.sandbox.lerian.net/v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas"

payload = {
    "dataHoraValidadeProposta": "2030-01-01T10:00:00Z",
    "dataHoraValidadeSolicitacao": "2025-10-30T23:45:29Z",
    "numeroParcelas": 12,
    "numeroProposta": "7K9M2P4R6T8V3W5X2Y4Z",
    "temGarantias": False,
    "valorCETAnual": "11.00",
    "valorCETMensal": "0.90",
    "valorEmprestimo": "2160.00",
    "valorParcela": "180.00",
    "valorTaxaAnual": "10.00",
    "valorTaxaMensal": "0.80",
    "contatos": [
        {
            "contato": "bidder@example.com",
            "tipo": 3
        }
    ],
    "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)

{
  "accepted": true,
  "codigo": "BD",
  "dataHoraValidadeProposta": "2030-01-01T10:00:00Z",
  "idSolicitacaoProposta": "221",
  "numeroProposta": "7K9M2P4R6T8V3W5X2Y4Z",
  "submittedAt": "2025-10-28T00:00:00Z",
  "hashOperacao": "34027710"
}

{
  "code": "AVERBACAO_ARTIFACT_CONFLICT",
  "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"
  }
}

{
  "code": "AVERBACAO_ARTIFACT_CONFLICT",
  "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"
  }
}

{
  "code": "AVERBACAO_ARTIFACT_CONFLICT",
  "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"
  }
}

Respond to an inbound portability leilão solicitação

Submits one proposal through inclusao-garantias (Manual 011 v1.6 §3.2) in response to a portability auction request that the client received on a consignado.portability_proposal.received fact. Unlike the M001 bid operation, this endpoint accepts one proposal per call: a request that permits a second proposal, with or without FGTS collateral, requires two separate calls rather than an array.

dataHoraValidadeSolicitacao is the same field that the initiating fact carried. It is response-side data from Manual 011 §3.1.3 and is not sent to Dataprev in this request. The client echoes it so the gateway can reject a response to an expired record before calling the rail. Expiration is evaluated per record without consulting a calendar.

Manual 011 uses two spellings for this operation’s path: §2.2 omits an accent, while §3.2.3.1 includes one. Because M011 publishes no Swagger path to resolve the discrepancy, the configured path spelling must be validated during homologation. The request and response otherwise follow Manual 011 §3.2.1 and §3.2.2.

X-Idempotency is the mandatory transport replay key. A retry with the same key returns the stored response instead of resubmitting to the rail, as on the averbação and CCB attachment routes. This endpoint does not have durable PostgreSQL-backed replay storage, so the guarantee does not survive a Redis eviction or service restart.

POST

consignado

leilao

portabilidade

solicitacoes

{id_solicitacao_proposta}

propostas

Respond to an inbound portability leilão solicitação

curl --request POST \
  --url https://br-consignado-gw.sandbox.lerian.net/v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "dataHoraValidadeProposta": "2030-01-01T10:00:00Z",
  "dataHoraValidadeSolicitacao": "2025-10-30T23:45:29Z",
  "numeroParcelas": 12,
  "numeroProposta": "7K9M2P4R6T8V3W5X2Y4Z",
  "temGarantias": false,
  "valorCETAnual": "11.00",
  "valorCETMensal": "0.90",
  "valorEmprestimo": "2160.00",
  "valorParcela": "180.00",
  "valorTaxaAnual": "10.00",
  "valorTaxaMensal": "0.80",
  "contatos": [
    {
      "contato": "bidder@example.com",
      "tipo": 3
    }
  ],
  "percVerbaRescisoriaGarantia": "15.00",
  "valorMultaRescisoriaGarantiaFgts": "300.00",
  "valorSaldoDisponivelGarantiaFgts": "600.00"
}
'

package main

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

func main() {

	url := "https://br-consignado-gw.sandbox.lerian.net/v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas"

	payload := strings.NewReader("{\n  \"dataHoraValidadeProposta\": \"2030-01-01T10:00:00Z\",\n  \"dataHoraValidadeSolicitacao\": \"2025-10-30T23:45:29Z\",\n  \"numeroParcelas\": 12,\n  \"numeroProposta\": \"7K9M2P4R6T8V3W5X2Y4Z\",\n  \"temGarantias\": false,\n  \"valorCETAnual\": \"11.00\",\n  \"valorCETMensal\": \"0.90\",\n  \"valorEmprestimo\": \"2160.00\",\n  \"valorParcela\": \"180.00\",\n  \"valorTaxaAnual\": \"10.00\",\n  \"valorTaxaMensal\": \"0.80\",\n  \"contatos\": [\n    {\n      \"contato\": \"bidder@example.com\",\n      \"tipo\": 3\n    }\n  ],\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))

}

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    dataHoraValidadeProposta: '2030-01-01T10:00:00Z',
    dataHoraValidadeSolicitacao: '2025-10-30T23:45:29Z',
    numeroParcelas: 12,
    numeroProposta: '7K9M2P4R6T8V3W5X2Y4Z',
    temGarantias: false,
    valorCETAnual: '11.00',
    valorCETMensal: '0.90',
    valorEmprestimo: '2160.00',
    valorParcela: '180.00',
    valorTaxaAnual: '10.00',
    valorTaxaMensal: '0.80',
    contatos: [{contato: 'bidder@example.com', tipo: 3}],
    percVerbaRescisoriaGarantia: '15.00',
    valorMultaRescisoriaGarantiaFgts: '300.00',
    valorSaldoDisponivelGarantiaFgts: '600.00'
  })
};

fetch('https://br-consignado-gw.sandbox.lerian.net/v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://br-consignado-gw.sandbox.lerian.net/v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas"

payload = {
    "dataHoraValidadeProposta": "2030-01-01T10:00:00Z",
    "dataHoraValidadeSolicitacao": "2025-10-30T23:45:29Z",
    "numeroParcelas": 12,
    "numeroProposta": "7K9M2P4R6T8V3W5X2Y4Z",
    "temGarantias": False,
    "valorCETAnual": "11.00",
    "valorCETMensal": "0.90",
    "valorEmprestimo": "2160.00",
    "valorParcela": "180.00",
    "valorTaxaAnual": "10.00",
    "valorTaxaMensal": "0.80",
    "contatos": [
        {
            "contato": "bidder@example.com",
            "tipo": 3
        }
    ],
    "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)

{
  "accepted": true,
  "codigo": "BD",
  "dataHoraValidadeProposta": "2030-01-01T10:00:00Z",
  "idSolicitacaoProposta": "221",
  "numeroProposta": "7K9M2P4R6T8V3W5X2Y4Z",
  "submittedAt": "2025-10-28T00:00:00Z",
  "hashOperacao": "34027710"
}

{
  "code": "AVERBACAO_ARTIFACT_CONFLICT",
  "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"
  }
}

{
  "code": "AVERBACAO_ARTIFACT_CONFLICT",
  "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"
  }
}

{
  "code": "AVERBACAO_ARTIFACT_CONFLICT",
  "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-portability-2026-08-10-0001"

Parâmetros de caminho

id_solicitacao_proposta

string

obrigatório

Portability solicitação identity, echoed from the initiating fact. A digit string — Manual 011 v1.6 §3.2.1 publishes 32 algarismos, which overflows an int64.

Required string length: 1 - 32

Pattern: ^[0-9]{1,32}$

Exemplo:

"221"

Corpo

application/json

dataHoraValidadeProposta

string<date-time>

obrigatório

This proposal's own validity instant — a SEPARATE validity from dataHoraValidadeSolicitacao above, informed by the client (Manual 011 v1.6 §3.2.1).

Exemplo:

"2030-01-01T10:00:00Z"

dataHoraValidadeSolicitacao

string<date-time>

obrigatório

The portability solicitação's own validity instant, echoed from the consignado.portability_proposal.received fact (Manual 011 v1.6 §3.1.3). Authoritative per record; judged against the gateway's clock before the rail is called.

Exemplo:

"2025-10-30T23:45:29Z"

numeroParcelas

integer<int64>

obrigatório

Number of instalments.

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

Exemplo:

12

numeroProposta

string

obrigatório

Proposal identifier this gateway mints.

Required string length: 1 - 20

Exemplo:

"7K9M2P4R6T8V3W5X2Y4Z"

temGarantias

boolean

obrigatório

Whether this proposal 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"

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"

contatos

object[] | null

Client contacts.

Maximum array length: 4

Show child attributes

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

accepted

boolean

obrigatório

True only when the rail's codigo equalled the observed success code.

Exemplo:

true

codigo

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"

dataHoraValidadeProposta

string<date-time>

obrigatório

Proposal validity echoed by Dataprev.

Exemplo:

"2030-01-01T10:00:00Z"

idSolicitacaoProposta

string

obrigatório

The solicitação identity addressed by this response.

Exemplo:

"221"

numeroProposta

string

obrigatório

Proposal identifier echoed by Dataprev.

Exemplo:

"7K9M2P4R6T8V3W5X2Y4Z"

submittedAt

string<date-time>

obrigatório

UTC instant the gateway submitted this proposal.

Exemplo:

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

hashOperacao

string

Opaque rail audit identifier, when published.

Exemplo:

"34027710"

Configuração do tenant e credenciais

Dados do trabalhador e margem

Leilões e propostas

Registro e documentos do contrato

Correções do contrato

Ciclo de vida do contrato

Refinanciamento, renegociação e portabilidade

Contratos legados

Garantias do FGTS

Conciliação e calendário

Fundos e cessões

Capacidade e uso

Monitoramento

Subscriptions de eventos

Tratamento de erros

Eventos

Respond to an inbound portability leilão solicitação

Autorizações

Cabeçalhos

Parâmetros de caminho

Corpo

Resposta