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

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency

string

requerido

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

Required string length: 1 - 128

Ejemplo:

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

Parámetros de ruta

id_solicitacao

string

requerido

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

Ejemplo:

"18406"

Cuerpo

application/json

matricula

string

requerido

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

Required string length: 1 - 30

Ejemplo:

"EMP-7K9M2P"

propostas

object[]

requerido

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

Ejemplo:

"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

Ejemplo:

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

Respuesta

idSolicitacao

string

requerido

Dataprev solicitação identifier addressed by the bid.

Ejemplo:

"18406"

propostas

object[] | null

requerido

Show child attributes

submittedAt

string<date-time>

requerido

UTC instant when the full rail outcome was durably recorded.

Ejemplo:

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

Configuración del tenant y credenciales

Datos del trabajador y margen

Subastas y propuestas

Registro y documentos del contrato

Correcciones del contrato

Ciclo de vida del contrato

Refinanciación, renegociación y portabilidad

Contratos legados

Garantías del FGTS

Conciliación y calendario

Fondos y cesiones

Capacidad y uso

Monitoreo

Suscripciones de eventos

Manejo de errores

Eventos

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

Autorizaciones

Encabezados

Parámetros de ruta

Cuerpo

Respuesta