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

curl --request POST \
  --url https://br-consignado-gw.sandbox.lerian.net/v1/consignado/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": "bidder@example.com",
          "tipo": 3
        }
      ],
      "percVerbaRescisoriaGarantia": "15.00",
      "valorMultaRescisoriaGarantiaFgts": "300.00",
      "valorSaldoDisponivelGarantiaFgts": "600.00"
    }
  ],
  "originadorRef": "originador-a",
  "portalBaseUrl": "https://partner.example.com/formalizacao"
}
'

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"matricula\": \"EMP-7K9M2P\",\n  \"propostas\": [\n    {\n      \"dataHoraValidadeProposta\": \"2030-01-01T10:00:00Z\",\n      \"numeroParcelas\": 12,\n      \"temGarantias\": true,\n      \"valorCETAnual\": \"11.00\",\n      \"valorCETMensal\": \"0.90\",\n      \"valorEmprestimo\": \"2160.00\",\n      \"valorIOF\": \"10.00\",\n      \"valorLiberado\": \"2000.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    }\n  ],\n  \"originadorRef\": \"originador-a\",\n  \"portalBaseUrl\": \"https://partner.example.com/formalizacao\"\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({
    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: 'bidder@example.com', tipo: 3}],
        percVerbaRescisoriaGarantia: '15.00',
        valorMultaRescisoriaGarantiaFgts: '300.00',
        valorSaldoDisponivelGarantiaFgts: '600.00'
      }
    ],
    originadorRef: 'originador-a',
    portalBaseUrl: 'https://partner.example.com/formalizacao'
  })
};

fetch('https://br-consignado-gw.sandbox.lerian.net/v1/consignado/leilao/solicitacoes/{id_solicitacao}/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/solicitacoes/{id_solicitacao}/propostas"

payload = {
    "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": "bidder@example.com",
                    "tipo": 3
                }
            ],
            "percVerbaRescisoriaGarantia": "15.00",
            "valorMultaRescisoriaGarantiaFgts": "300.00",
            "valorSaldoDisponivelGarantiaFgts": "600.00"
        }
    ],
    "originadorRef": "originador-a",
    "portalBaseUrl": "https://partner.example.com/formalizacao"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

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

{
  "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"
  }
}

{
  "refusal": {
    "detail": "matricula must match the discovered solicitacao",
    "field": "matricula",
    "rule": "MATRICULA_MATCH",
    "source": "local"
  },
  "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"
  }
}

{
  "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"
  }
}

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.9 §3.1) synchronously. 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

POST

consignado

leilao

solicitacoes

{id_solicitacao}

propostas

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

curl --request POST \
  --url https://br-consignado-gw.sandbox.lerian.net/v1/consignado/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": "bidder@example.com",
          "tipo": 3
        }
      ],
      "percVerbaRescisoriaGarantia": "15.00",
      "valorMultaRescisoriaGarantiaFgts": "300.00",
      "valorSaldoDisponivelGarantiaFgts": "600.00"
    }
  ],
  "originadorRef": "originador-a",
  "portalBaseUrl": "https://partner.example.com/formalizacao"
}
'

package main

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

func main() {

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

	payload := strings.NewReader("{\n  \"matricula\": \"EMP-7K9M2P\",\n  \"propostas\": [\n    {\n      \"dataHoraValidadeProposta\": \"2030-01-01T10:00:00Z\",\n      \"numeroParcelas\": 12,\n      \"temGarantias\": true,\n      \"valorCETAnual\": \"11.00\",\n      \"valorCETMensal\": \"0.90\",\n      \"valorEmprestimo\": \"2160.00\",\n      \"valorIOF\": \"10.00\",\n      \"valorLiberado\": \"2000.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    }\n  ],\n  \"originadorRef\": \"originador-a\",\n  \"portalBaseUrl\": \"https://partner.example.com/formalizacao\"\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({
    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: 'bidder@example.com', tipo: 3}],
        percVerbaRescisoriaGarantia: '15.00',
        valorMultaRescisoriaGarantiaFgts: '300.00',
        valorSaldoDisponivelGarantiaFgts: '600.00'
      }
    ],
    originadorRef: 'originador-a',
    portalBaseUrl: 'https://partner.example.com/formalizacao'
  })
};

fetch('https://br-consignado-gw.sandbox.lerian.net/v1/consignado/leilao/solicitacoes/{id_solicitacao}/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/solicitacoes/{id_solicitacao}/propostas"

payload = {
    "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": "bidder@example.com",
                    "tipo": 3
                }
            ],
            "percVerbaRescisoriaGarantia": "15.00",
            "valorMultaRescisoriaGarantiaFgts": "300.00",
            "valorSaldoDisponivelGarantiaFgts": "600.00"
        }
    ],
    "originadorRef": "originador-a",
    "portalBaseUrl": "https://partner.example.com/formalizacao"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

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

{
  "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"
  }
}

{
  "refusal": {
    "detail": "matricula must match the discovered solicitacao",
    "field": "matricula",
    "rule": "MATRICULA_MATCH",
    "source": "local"
  },
  "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"
  }
}

{
  "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"
  }
}

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

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

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"

Tenant setup and credentials

Worker data and margin

Auctions and proposals

Contract registration and documents

Contract corrections

Contract lifecycle

Refinancing, renegotiation, and portability

Legacy contracts

FGTS guarantees

Reconciliation and calendar

Funds and assignments

Capacity and usage

Monitoring

Event subscriptions

Error handling

Events

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

Authorizations

Headers

Path Parameters

Body

Response