Pular para o conteúdo principal

​
Realizar Proposta

Tipo: Assíncrona Esta é a primeira requisição necessária para participação no Leilão.
Ela deve ser executada após o recebimento do callback de Nova Solicitação Feita na CTPS.
Por meio desta requisição, o parceiro envia sua proposta de crédito para a BMP, participando do leilão interno associado à solicitação realizada pelo trabalhador.

​
Endpoint

POST /contrato/oferta-leilao/incluir-proposta

​
Pré-requisitos

  • Recebimento do evento Nova Solicitação Feita na CTPS;
  • Token de autenticação válido;
  • Identificação da solicitação por meio do campo idSolicitacao.

​
Parâmetros da Requisição

CampoObrigatórioDescrição
numeroSolicitacaoSimIdentificador da solicitação (idSolicitacao) recebido no evento de nova solicitação feita na CTPS.
dataHoraValidadePropostaSimData e hora de validade da proposta no formato ddMMyyyyHHmmss.
contatosSimLista de contatos para retorno ao trabalhador. Deve conter obrigatoriamente ao menos um contato do tipo URL.
valorLiberadoSimValor do crédito ofertado.
numeroParcelasSimQuantidade de parcelas da operação.
valorTaxaMensalSimTaxa de juros mensal aplicada à proposta.

​
Tabela de Referência — Campo contatos

CódigoDescrição
0URL
1WhatsApp
2Telefone
3E-mail

​
Exemplo de Requisição

curl --request POST --location 'https://econsignadotrabalhador.moneyp.dev.br/contrato/oferta-leilao/incluir-proposta' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
    "numeroSolicitacao": "1",
    "dataHoraValidadeProposta": "ddMMyyyyHHmmss",
    "contatos": [
      {
        "contato": "https://moneyp.com.br/",
        "tipo": 0
      },
      {
        "contato": "<telefone de contato>?text=<texto url encoded>",
        "tipo": 1
      },
      {
        "contato": "40038389",
        "tipo": 2
      },
      {
        "contato": "[email protected]",
        "tipo": 3
      }
    ],
    "valorLiberado": 9000,
    "numeroParcelas": 24,
    "valorTaxaMensal": 3.75
  }'

​
Comportamento Esperado

Após o envio da proposta:
  • O parceiro deve aguardar o callback de Atualização de Situação de Proposta;

​
Considerações Técnicas

  • O envio da proposta não gera contrato nem CCB;
  • A proposta enviada representa apenas um orçamento no contexto do leilão;
  • A geração do contrato ocorre somente após a seleção da proposta pelo trabalhador;
  • Todo o acompanhamento do fluxo deve ser realizado por meio de callbacks.