Submit a one-or-two proposal set to the payroll rail

Submits the complete one-or-two proposal set through inclusao-garantias (Manual 001 v1.10 §3.1) synchronously, except under the pre-auction (quote mode), which answers 202 without calling Dataprev. X-Idempotency is mandatory and durable.

Case	Result	Rail call
Same key + same body, known outcome	200 replay of the stored response	No
Same key + different body	422 unprocessable entity	No
New key + same solicitação	409 conflict	No
Unknown-outcome retry	Retry the unresolved submission with the same proposal IDs	May call the rail with the same proposal IDs
Quote mode: same key + same body	202 replay of the stored receipt, also after the window closed	No
Quote mode: same key + different body	422 IDEMPOTENCY_KEY_REUSE	No
Quote mode: new key + same pair, window open	202 new revision, same proposal numbers	No
Quote mode: new key + another pair, window open	202	No
Quote mode: new key after the window closed	422 BID_QUOTE_WINDOW_CLOSED	No

Partner route: the text above describes the party’s own route. Here the path names no party: the call runs as the one originador the partner credential’s scope holds, which must be registered under the caller’s tenant, exactly as the party’s own credential would. A credential whose scope holds more than one originador is refused 403 AUT-1022: name the originador on this route’s /v1/consignado/originadores/ form instead. An originador the bancarizador deactivated is refused 403 ORIGINADOR_DEACTIVATED until it is reactivated.

POST /v1/consignado/originador/leilao/solicitacoes/{id_solicitacao}/propostas

Submit a one-or-two proposal set to the payroll rail

cURL

curl --request POST \
  --url https://br-consignado-gw.sandbox.lerian.net/v1/consignado/originador/leilao/solicitacoes/{id_solicitacao}/propostas \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "matricula": "EMP-7K9M2P",
  "propostas": [
    {
      "dataHoraValidadeProposta": "2030-01-01T10:00:00Z",
      "numeroParcelas": 12,
      "temGarantias": true,
      "valorCETAnual": "11.00",
      "valorCETMensal": "0.90",
      "valorEmprestimo": "2160.00",
      "valorIOF": "10.00",
      "valorLiberado": "2000.00",
      "valorParcela": "180.00",
      "valorTaxaAnual": "10.00",
      "valorTaxaMensal": "0.80",
      "contatos": [
        {
          "contato": "[e-mail]",
          "tipo": 3
        }
      ],
      "percVerbaRescisoriaGarantia": "15.00",
      "valorMultaRescisoriaGarantiaFgts": "300.00",
      "valorSaldoDisponivelGarantiaFgts": "600.00"
    }
  ],
  "fundoRef": "fundo-a",
  "originadorRef": "originador-a",
  "portalBaseUrl": "https://partner.example.com/formalizacao"
}
'

200

{
  "idSolicitacao": "18406",
  "propostas": [
    {
      "accepted": true,
      "codigo": "BD",
      "dataHoraValidadeProposta": "2030-01-01T10:00:00Z",
      "numeroProposta": "7K9M2P4R6T8V3W5X2Y4Z"
    }
  ],
  "submittedAt": "2026-07-31T12:00:00Z"
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency · string · required

Required durable replay key, scoped by authenticated tenant and bounded like the service's other indexed opaque request references.

Required string length: 1 - 128

Example:

"idem-bid-2026-07-31-0001"

Path Parameters

id_solicitacao · string · required

Canonical positive int64 Dataprev solicitação identifier, bounded by 9223372036854775807. Leading-zero aliases are normalized before idempotency fingerprinting.

Required string length: 1 - 19

Pattern: ^([1-9][0-9]{0,17}|[1-8][0-9]{18}|9[01][0-9]{17}|92[01][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[01][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6]|9223372036854775807)$

Example:

"18406"

Body

application/json

matricula · string · required

Employment bond matrícula echoed from the discovered solicitação and checked against its durable snapshot.

Required string length: 1 - 30

Example:

"EMP-7K9M2P"

propostas · object[] · required

Required array length: 1 - 2 elements

Show child attributes

fundoRef · string

Fund that funds this quote, as the rail's fund reference. Required while the solicitação is under the pre-auction; refused otherwise.

Required string length: 1 - 128

Example:

"fundo-a"

originadorRef · string

Originador this bid is placed for, as registered under this tenant. Preserved byte for byte: never trimmed, case-folded, or normalized. A bancarizador names one of its own registered originadores here, and the bid then formalizes on that originador's registered portal unless it carries a portalBaseUrl of its own. An originador authenticating with its own credential does not need to send it — the reference is taken from the credential — and if it does send one it must be its own, or the request is refused. Omit it for a bancarizador bidding on its own account.

Required string length: 1 - 128

Example:

"originador-a"

portalBaseUrl · string

Optional formalization portal base URL for this bid alone, for a tenant that originates through several partners and formalizes each bid on that partner's portal. It wins over every registered value: the portal the named originador registered, and the tenant's own. Must be an absolute HTTPS URL with no credentials and no fragment; an invalid value is refused with rule PORTAL_URL and nothing is submitted to the rail. The server still mints the type 0 contact itself, appending id_solicitacao and numero_proposta. Omit it to fall back on the named originador's registered portal, then the tenant's.

Maximum string length: 255

Example:

"https://partner.example.com/formalizacao"

Response

200

application/json

OK

idSolicitacao · string · required

Dataprev solicitação identifier addressed by the bid.

Example:

"18406"

propostas · object[] | null · required

Show child attributes

submittedAt · string<date-time> · required

UTC instant when the full rail outcome was durably recorded.

Example:

"2026-07-31T12:00:00Z"