Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint

POST /contrato/oferta-leilao/incluir-lance

​
Regras

  • Cada parceiro pode enviar apenas um lance por solicitaçã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": "30764985",
	"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
}'

​
Parâmetros da Requisição

​
numeroSolicitacao
string
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
  • 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": "string",
  "Origem": "/contrato/oferta-leilao/incluir-lance",
  "Conteudo": {
    "CodigoLanceLeilao": "GUID",
    "Mensagem": "Lance em leilão. Acompanhe a posição do lance no webhook pelo CodigoRequisicao desta solicitação"
  }
}
  • 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. 
{
  "CodigoRequisicao": "1db98ef4-70f8-4b27-a5bf-8734ef105f74",
  "Endpoint": "/contrato/oferta-leilao/fim-lote-solicitacoes",
  "Payload": {
    "CodigoLote": "1db98ef4-70f8-4b27-a5bf-8734ef105f74",
    "DataHoraInicioLeilao": "2026-04-23T15:44:01.657",
    "DataHoraFimLeilao": "2026-04-23T16:00:20",
    "Solicitacoes": [
      {
        "NumeroSolicitacao": "30781227",
        "Lances": [
          {
            "CodigoLanceLeilao": "df13c281-77d8-4bd8-bc49-aa08bfe62415",
            "TaxaDeJurosMensal": 5,
            "ValorLiberado": 10000,
            "NumeroParcelas": 18,
            "Posicao": 1,
            "DataHoraInclusao": "2026-04-23T15:56:49.993"
          }
        ]
      },
      {
        "NumeroSolicitacao": "30781228",
        "Lances": []
      },
      {
        "NumeroSolicitacao": "30781232",
        "Lances": [
          {
            "CodigoLanceLeilao": "89e9fbe3-e23c-4718-a84d-cfa99127e43f",
            "TaxaDeJurosMensal": 5,
            "ValorLiberado": 10000,
            "NumeroParcelas": 18,
            "Posicao": 1,
            "DataHoraInclusao": "2026-04-23T15:55:29.913"
          },
          {
            "CodigoLanceLeilao": "fa9730da-0cbf-4d4e-a8bf-4a751aa1a0a7",
            "TaxaDeJurosMensal": 5,
            "ValorLiberado": 10000,
            "NumeroParcelas": 18,
            "Posicao": 2,
            "DataHoraInclusao": "2026-04-23T15:56:21.083"
          }
        ]
      },
      {
        "NumeroSolicitacao": "30781233",
        "Lances": [
          {
            "CodigoLanceLeilao": "2f073427-776c-4ebd-873c-42b422a9498e",
            "TaxaDeJurosMensal": 5,
            "ValorLiberado": 10000,
            "NumeroParcelas": 18,
            "Posicao": 1,
            "DataHoraInclusao": "2026-04-23T15:59:11.627"
          }
        ]
      }
    ]
  }
}

​
Parâmetros do webhook

​
CodigoRequisicao
string
Identifica a chamada à API e é usado para correlacionar eventos
​
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.