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

Submits one proposal through inclusao-garantias (Manual 011 v1.7 §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 v1.7 spells this operation’s path without an accent in both §2.2 and §3.2.3.1, and the configured path defaults to that spelling. 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 Dataprev answer instead of resubmitting to the rail. A rejection that the gateway issues on its own is not stored, so a corrected body under the same key is processed. A 500, 503 or 504 that may have reached Dataprev holds the key for its 7-day TTL: that response carries X-Idempotency-Fenced: true, and a resend under the same key is rejected with 422 IDEMPOTENCY_OUTCOME_UNRECORDED. A 503 whose only Dataprev code is OZ (service suspended) does not hold the key. To learn the outcome, resend the same body, with the same numeroProposta, under a new key. Dataprev rejects a proposal number it already holds with SE (Manual 011 v1.7 §3.2.1, §4.1), so a 422 whose upstream member names SE means the first proposal reached Dataprev, and an acceptance means it did not. Never change numeroProposta on that resend. The resend works only before dataHoraValidadeSolicitacao. After that instant the gateway rejects the resend before calling the rail, which proves nothing, and the Dataprev Portal is the only place to check. This endpoint does not have durable PostgreSQL-backed replay storage, so the guarantee does not survive a Redis eviction or service restart.

POST /v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas

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

cURL

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 '
{
  "contatos": [
    {
      "contato": "[e-mail]",
      "tipo": 3
    }
  ],
  "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",
  "percVerbaRescisoriaGarantia": "15.00",
  "valorMultaRescisoriaGarantiaFgts": "300.00",
  "valorSaldoDisponivelGarantiaFgts": "600.00"
}
'

200

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

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-portability-2026-08-10-0001"

Parámetros de ruta

id_solicitacao_proposta · string · requerido

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

Required string length: 1 - 32

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

Ejemplo:

"221"

Cuerpo

application/json

contatos · object[] · requerido

Client contacts: required, at least one (Manual 011 v1.7 §3.2.1).

Minimum array length: 1

Show child attributes

dataHoraValidadeProposta · string<date-time> · requerido

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

Ejemplo:

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

dataHoraValidadeSolicitacao · string<date-time> · requerido

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

Ejemplo:

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

numeroParcelas · integer<int64> · requerido

Number of instalments.

Rango requerido: 1 <= x <= 999

Ejemplo:

12

numeroProposta · string · requerido

Proposal identifier this gateway mints.

Required string length: 1 - 20

Ejemplo:

"7K9M2P4R6T8V3W5X2Y4Z"

temGarantias · boolean · requerido

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

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"

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

200

application/json

OK

accepted · boolean · requerido

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

Ejemplo:

true

codigo · 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"

dataHoraValidadeProposta · string<date-time> · requerido

Proposal validity echoed by Dataprev.

Ejemplo:

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

idSolicitacaoProposta · string · requerido

The solicitação identity addressed by this response.

Ejemplo:

"221"

numeroProposta · string · requerido

Proposal identifier echoed by Dataprev.

Ejemplo:

"7K9M2P4R6T8V3W5X2Y4Z"

submittedAt · string<date-time> · requerido

UTC instant the gateway submitted this proposal.

Ejemplo:

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

hashOperacao · string

Opaque rail audit identifier, when published.

Ejemplo:

"34027710"