Set a pre-auction fund policy

Writes the policy of a fund known to the validated tenant; a deactivated fund is accepted. An identical PUT changes nothing. X-Idempotency is required. There is no DELETE: participa false takes the fund out of the pre-auction. Counters derive from the reservation ledger in the America/Sao_Paulo day.

PUT /v1/consignado/preleilao/fundos/{fundo_ref}

Set a pre-auction fund policy

cURL

curl --request PUT \
  --url https://br-consignado-gw.sandbox.lerian.net/v1/consignado/preleilao/fundos/{fundo_ref} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "participa": true,
  "peso": 50,
  "horario": {
    "fim": "22:00",
    "inicio": "08:00"
  },
  "limites": {
    "capital": "10000000.00",
    "quantidadeDiaria": 800,
    "valorDiario": "4000000.00"
  },
  "restricoes": {
    "garantiaFgts": "recusa",
    "parcelasMax": 48,
    "parcelasMin": 6,
    "taxaMensalMax": "3.50",
    "taxaMensalMin": "1.80",
    "valorLiberadoMax": "50000.00",
    "valorLiberadoMin": "1000.00",
    "valorParcelaMax": "2000.00"
  }
}
'

200

{
  "configurada": true,
  "fundoRef": "fundo-a",
  "horario": {
    "fim": "22:00",
    "inicio": "08:00"
  },
  "limites": {
    "capital": "10000000.00",
    "quantidadeDiaria": 800,
    "valorDiario": "4000000.00"
  },
  "participa": true,
  "peso": 50,
  "restricoes": {
    "garantiaFgts": "recusa",
    "parcelasMax": 48,
    "parcelasMin": 6,
    "taxaMensalMax": "3.50",
    "taxaMensalMin": "1.80",
    "valorLiberadoMax": "50000.00",
    "valorLiberadoMin": "1000.00",
    "valorParcelaMax": "2000.00"
  },
  "uso": {
    "confirmado": "1240000.00",
    "dia": "2026-11-03",
    "quantidadeHoje": 12,
    "reservado": "92000.00",
    "valorHoje": "184000.00",
    "capitalDisponivel": "8668000.00"
  },
  "createdAt": "2026-11-03T15:00:00Z",
  "updatedAt": "2026-11-03T15:00:00Z",
  "updatedBy": "user-123"
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency · string · requerido

Required key; the same body replays, a different body is refused.

Required string length: 1 - 128

Ejemplo:

"idem-fundo-0001"

Parámetros de ruta

fundo_ref · string · requerido

Registered fund, percent-encoded.

Minimum string length: 1

Ejemplo:

"fundo-a"

Cuerpo

application/json

participa · boolean · requerido

false refuses the fund's quotes and takes it out of the rodizio.

Ejemplo:

true

peso · integer<int64> · requerido

Desired share of the day's value, normalized among the funds that compete; need not sum to 100; unused without the rodizio.

Rango requerido: 1 <= x <= 1000

Ejemplo:

50

horario · object | null

Daily window; absent or null is all day.

Show child attributes

limites · object

Financial limits.

Show child attributes

restricoes · object

Typed restrictions on quote and averbação terms.

Show child attributes

Respuesta

200

application/json

OK

configurada · boolean · requerido

Whether a policy was written; false shows the defaults.

Ejemplo:

true

fundoRef · string · requerido

The fund.

Ejemplo:

"fundo-a"

horario · object | null · requerido

Daily window; null is all day.

Show child attributes

limites · object · requerido

Financial limits.

Show child attributes

participa · boolean · requerido

Whether the fund takes part in the pre-auction.

Ejemplo:

true

peso · integer<int64> · requerido

Weight of the fund in the rodizio.

Ejemplo:

50

restricoes · object · requerido

Typed restrictions on quote and averbação terms.

Show child attributes

uso · object · requerido

Counters derived from the reservation ledger.

Show child attributes

createdAt · string<date-time>

First write.

Ejemplo:

"2026-11-03T15:00:00Z"

updatedAt · string<date-time>

Last change.

Ejemplo:

"2026-11-03T15:00:00Z"

updatedBy · string

Actor of the last change.

Ejemplo:

"user-123"