Pular para o conteúdo principal

​
Endpoint

POST /contrato/oferta-leilao/incluir-lance

​
Regras

  • Cada parceiro pode enviar apenas um lance por solicitação, logo não é possível fazer o reposicionamento do lance em tempo de leilão;
  • O critério de ranking é menor taxa de juros mensal;
  • Lances enviados fora do prazo seguem regra de exceção descrita na jornada;
curl --location --request POST 'https://econsignadotrabalhador.moneyp.dev.br/contrato/oferta-leilao/incluir-lance' \
--header 'Accept: application/json' \
--header 'Content-type: application/json' \
--header 'Authorization: Bearer {token}' \
--data-raw '{
  "numeroSolicitacao": 1234,
  "LanceComGarantia": {
    "dataHoraValidadeLance": "2026-04-23T15:30:00.000",
    "contatos": [
      {
        "contato": "https://moneyp.com.br/",
        "tipo": 0
      },
      {
        "contato": "<telefone de contato>?text=<texto url encoded>",
        "tipo": 1
      },
      {
        "contato": "40038389",
        "tipo": 2
      },
      {
        "contato": "atendimento@moneyp.com.br",
        "tipo": 3
      }
    ],
    "valorLiberado": 300,
    "numeroParcelas": 9,
    "valorTaxaMensal": 2.45,
    "ValorSaldoDisponivelGarantiaFgts": 1000,
    "ValorMultaRescisoriaGarantiaFgts": 4000,
    "PercVerbaRescisoriaGarantia": 35
  },
  "LanceSemGarantia": {
    "dataHoraValidadeLance": "2026-04-23T15:30:00.000",
    "contatos": [
      {
        "contato": "https://moneyp.com.br/",
        "tipo": 0
      },
      {
        "contato": "<telefone de contato>?text=<texto url encoded>",
        "tipo": 1
      },
      {
        "contato": "40038389",
        "tipo": 2
      },
      {
        "contato": "atendimento@moneyp.com.br",
        "tipo": 3
      }
    ],
    "valorLiberado": 300,
    "numeroParcelas": 9,
    "valorTaxaMensal": 3.45
  }
}'
​
numeroSolicitacao
number
obrigatório
Identificador da solicitação recebido no webhook de evento de novas solicitações de leilão.
​
dataHoraValidadeLance
string<date-time>
obrigatório
Data e hora de validade do lance.Não pode ser maior que 7 dias da data e hora do lance.
​
contatos
object[]
obrigatório
Lista de canais de contato utilizados pelo trabalhador para dar continuidade à contratação. Deve conter obrigatoriamente ao menos um contato do tipo URL, que será apresentado na CTPS.
​
contatos[].contato
string
Valor do contato conforme o tipo informado:
  • URL: endereço completo
  • WhatsApp: telefone com query string como o exemplo <telefone de contato>?text=<texto url encoded>
  • Telefone: número de telefone para contato
  • E-mail: Endereço de e-mail válido
​
contatos[].tipo
number
Código do tipo de contato, conforme enumeração definida abaixo:
  • 0 - URL(Obrigatório)
  • 1 - WhatsApp
  • 2 - Telefone
  • 3 - E-mail
​
valorLiberado
number
obrigatório
Valor líquido do crédito proposto para a solicitação do trabalhador.
​
numeroParcelas
number
obrigatório
Quantidade de parcelas proposta para a solicitação do trabalhador.
​
valorTaxaMensal
number
obrigatório
Taxa de juros mensal aplicada ao lance. Deve ser maior que 0.01 e inferior a 4.98.

​
Responses

Há 6 possíveis responses do endpoint de inclusão de lance:
  • Lance aceito dentro do leilão
    • Se for para uma solicitação com garantia, haverão dois CodigosLances.
    • Se for para uma solicitação sem garantia, haverá apenas um codigoLance
  • Lance aceito fora do leilão
  • Lance rejeitado por duplicidade
  • Lance rejeitado por solicitação inexistente
  • Lance rejeitado por solicitação expirada
  • Lance rejeitado por prazo de validade superior a 7 dias
{
	"CodigoRequisicao": "b7ac78a4-099c-4df5-8e4b-fc5f3e11e1f7",
	"Origem": "/contrato/oferta-leilao/incluir-lance",
	"Conteudo": {
		"CodigosLances": {
			"ComGarantia": "01888fb8-93b6-43e6-83b1-5c010936beaa",
			"SemGarantia": "b7ac78a4-099c-4df5-8e4b-fc5f3e11e1f7"
		},
		"Message": "Lance em leilão. Acompanhe a posição do lance no webhook pelo CodigoSolicitacaoLeilao desta solicitação."
	},
	"Erros": []
}
  • CodigoRequisicao identifica a chamada à API e é usado para correlacionar eventos;
  • CodigoLanceLeilao identifica o lance dentro do leilão e aparece no webhook de fim de leilão;
  • No contexto de leilão, CodigoLanceLeilao corresponderá ao CodigoRequisicao.

​
Webhook de fim do leilão

Este webhook é disparado ao término do leilão interno de um lote de solicitações e ele informa, para cada solicitação participante do lote, a lista de lances recebidos, já ranqueados conforme o critério de menor taxa de juros. O evento permite ao parceiro:
  • Identificar se houve lances para cada solicitação;
  • Verificar a posição do seu lance em relação aos demais participantes;
  • Correlacionar os lances enviados anteriormente por meio do CodigoLanceLeilao.
O campo CodigoLote corresponde ao mesmo código do lote enviado no webhook de novas solicitações de leilão, permitindo o rastreamento completo do ciclo do leilão. 
{
  "Endpoint": "/contrato/oferta-leilao/fim-lote-solicitacoes",
  "Payload": {
    "Conteudo": {
      "CodigoLote": "61848733-737f-46e8-a468-48b488dd149b",
      "DataHoraInicioLeilao": "2026-06-17T14:12:20.92",
      "DataHoraFimLeilao": "2026-06-17T14:12:50.92",
      "Solicitacoes": [
        {
          "NumeroSolicitacao": "30815499",
          "Lances": [
            {
              "CodigoLanceLeilao": "10792e33-1a43-4b8f-8625-8a575ef8d8c4",
              "TaxaDeJurosMensal": 1,
              "ValorLiberado": 5000,
              "NumeroParcelas": 24,
              "Posicao": 1,
              "DataHoraInclusao": "2026-06-17T14:12:29.407",
              "TemGarantias": true,
              "ValorSaldoDisponivelGarantiaFgts": 800,
              "ValorMultaRescisoriaGarantiaFgts": 3200,
              "PercVerbaRescisoriaGarantia": 20
            },
            {
              "CodigoLanceLeilao": "51ef7e3f-06b6-483c-9777-4dbb3208b3bf",
              "TaxaDeJurosMensal": 4.98,
              "ValorLiberado": 5000,
              "NumeroParcelas": 24,
              "Posicao": 1,
              "DataHoraInclusao": "2026-06-17T14:12:29.193",
              "TemGarantias": false,
              "ValorSaldoDisponivelGarantiaFgts": null,
              "ValorMultaRescisoriaGarantiaFgts": null,
              "PercVerbaRescisoriaGarantia": null
            }
          ]
        }
      ]
    },
    "Errors": []
  }
}
​
Endpoint
string
Identifica o evento de origem do webhook.
​
Payload
object
Conteúdo do evento.
​
Payload.CodigoLote
string
Código do lote.
​
Payload.DataHoraInicioLeilao
string<date-time>
Data e hora de início do leilão.
​
Payload.DataHoraFimLeilao
string<date-time>
Data e hora de fim do leilão.
​
Solicitacoes
object[]
Lista das solicitações do lote que estavam em leilão.
​
Solicitacoes[].NumeroSolicitacao
string
Número da solicitação feita pelo trabalhador.
​
Solicitacoes[].Lances
object[]
Lista de lances enviados para a solicitação durante o leilão. Quando estiver vazio, significa que nenhum parceiro enviou lance para a solicitação.
​
Lances[].CodigoLanceLeilao
string
Identificador único do lance no leilão.
​
Lances[].TaxaDeJurosMensal
number
Taxa de juros mensal do lance.
​
Lances[].ValorLiberado
number
Valor liberado do lance.
​
Lances[].NumeroParcelas
number
Número de parcelas do lance.
​
Lances[].Posicao
number
Posição do lance no ranking com relação aos demais lances.
​
Lances[].DataHoraInclusao
string<date-time>
Data e hora de inclusão do lance.
Este evento é enviado ao ganhador do leilão para confirmar a conclusão do leilão interno na BMP. O lance feito será encaminhado para a Dataprev.
{
  "CodigoRequisicao": "3dec911c-4785-4aa1-a159-0c5636205a1f",
  "Endpoint": "/contrato/oferta-leilao/incluir-lance",
  "Payload": {
    "Conteudo": {
      "Mensagem": "Sua proposta para a Solicitação n.º {NumeroSolicitacao} foi contemplada e será encaminhada à DataPrev"
    },
    "Erros": []
  }
}
Este evento é enviado ao ganhador do leilão após a mensagem da Dataprev quanto a inclusão da proposta. Este evento confirma que a proposta está disponível para o trabalhador no aplicativo da CTPS.
{
  "CodigoRequisicao": "3dec911c-4785-4aa1-a159-0c5636205a1f",
  "Endpoint": "/contrato/oferta-leilao/incluir-lance",
  "Payload": {
    "conteudo": {
      "codigo": "BD",
      "mensagem": "Inclusão efetuada com sucesso",
      "numeroProposta": "{NumeroSolicitacao}",
      "idSolicitacaoResposta": 0,
      "hashOperacao": 0,
      "dataHoraValidadeProposta": "dataHoraValidadeLance em formato ddmmaaaahhmmss"
    },
    "errors": [],
    "hashOperacao": ""
  }
}
Considerando que 1. Não é mais possível o reposicionamento em tempo de leilão e 2. O evento de fim de leilão já informa o posicionamento do parceiro, então não é mais enviado o evento que informa o posicionamento do parceiro em tempo de leilão, apenas no término do leilão.