Pular para o conteúdo principal

​
Geração do Contrato — Modalidade Leilão

Tipo: Assíncrona Nesta etapa, o parceiro deve utilizar o endpoint de geração de contrato para originar a Cédula de Crédito Bancário (CCB) do E-Consignado Trabalhador, no contexto da modalidade Leilão.

​
Pré-requisitos

  • Aceite da proposta pelo trabalhador no aplicativo da CTPS;
  • Trabalhador previamente cadastrado;
  • Empregador previamente cadastrado;
  • Consulta de dados do vínculo realizada com sucesso;
  • Margem consignável disponível validada para o vínculo selecionado;
  • Token de autenticação válido.
Importante:
A geração do contrato realiza a validação do valor da parcela em relação à margem consignável disponível, conforme o resultado da última consulta de vínculo.
Caso a consulta esteja em cache, será considerada a informação armazenada, com validade de 24 horas.

​
Regras de Negócio

  • O contrato deve ser gerado, assinado e enviado para averbação dentro da competência correspondente;
    • Caso o contrato seja enviado fora da competência, será necessário:
      • Gerar um novo contrato;
      • Realizar nova assinatura;
      • Enviar novamente para averbação;
  • O contrato gerado deve ser obrigatoriamente assinado com biometria facial do trabalhador;
  • A assinatura deve ser enviada por meio do endpoint:
    • POST /contrato/oferta-leilao/averbar-contrato.

​
Endpoint

POST /contrato/oferta-leilao/gerar-contrato
​
numeroSolicitacao
string
obrigatório
Identificador da solicitação recebido no webhook de evento de novas solicitações de leilão.
​
valorLiberado
number
Valor líquido do crédito proposto para a solicitação do trabalhador. O valor da parcela será calculado pela BMP com base neste valor.
​
valorParcela
number
Valor de parcela proposta para a solicitação do trabalhador. O valor liberado será calculado pela BMP com base neste valor
Apenas valorLiberado ou valorParcela deve ser informado na requisição.
​
numeroParcelas
number
obrigatório
Quantidade de parcelas proposta para a solicitação do trabalhador.
​
valorTaxaMensal
number
obrigatório
Taxa de juros mensal aplicada para a operação.
  • Deve ser maior que 0.01 e inferior a 4.98.
  • Deve ser menor ou igual a taxa de juros mensal informada no lance
​
valorSeguro
string
Valor do seguro aplicado na operação.
​
numeroApolice
string
Número da apólice do seguro da operação. Preenchimento obrigatório caso valorSeguro seja preenchido.
​
tipoContrato
string
Tipo do contrato utilizado para especificar o fundo desta operação.
​
cpfAgenteCredito
string
obrigatório
Cpf do agente de crédito responsável pela operação.
​
propostaContaPagamento
object
obrigatório
Dados da conta do cliente para pagamento.
​
TipoConta
number
obrigatório
  1. Para conta poupança;
  2. Para conta corrente.
​
Agencia
string
obrigatório
Número da agência.
​
AgenciaDig
string
obrigatório
Dígito da agência.
​
Conta
string
obrigatório
Número da conta.
​
ContaDig
string
obrigatório
Dígito da conta.
​
NumeroBanco
string
obrigatório
Número do banco.
curl --location --request POST 'https://econsignadotrabalhador.moneyp.dev.br/contrato/oferta-leilao/gerar-contrato' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {Token}' \
--data '{
	"numeroSolicitacao": "30756591",
	"valorLiberado": 4500,
	"numeroParcelas": 24,
	"valorTaxaMensal": 2.40,
	"cpfAgenteCredito": "53153153124"
	"propostaContaPagamento": {
		"tipoConta": 1,
		"agencia": "0001",
		"agenciaDig": "8",
		"conta": "1234",
		"contaDig": "5",
		"numeroBanco": "274"
	}
}'

{
	"codigoRequisicao": "9d95c8b1-26ed-43f4-b40e-c9d413abcd0f"
}

​
Webhook de geração de CCB

Após a requisição de geração de contrato, a BMP gera a Cédula de Crédito Bancário (CCB) e envia um webhook contendo os dados do contrato gerado. Este evento retorna, entre outras informações, o número da CCB e o código da proposta, que deve ser utilizado para impressão do documento e continuidade do fluxo de formalização. 
{
  "CodigoRequisicao": "13318a89-2e2a-4575-98b8-e5c3eaeb4d54",
  "Endpoint": "/oferta-leilao/gerar-contrato",
  "Payload": {
    "NumeroCCB": "5234034",
    "ValorCETAnual": 3.7624,
    "ValorCETMensal": 0.30825,
    "ValorEmprestimo": 1135.49,
    "ValorIOF": 24.49,
    "ValorParcela": 103.3,
    "ValorTaxaAnual": 0.12007,
    "ValorTaxaMensal": 0.01,
    "ValorSeguro": 0,
    "CodigoProposta": "5c83c565-ec06-44d8-ae27-74319f4d0318"
  }
}
​
NumeroCCB
string
Número da CCB.
​
ValorCETAnual
number
Percentual da CET anual.
​
ValorCETMensal
number
Percentual da CET mensal.
​
ValorEmprestimo
number
Valor do empréstimo. Corresponde ao valor liberado + IOF + Seguro.
​
ValorIOF
number
Valor do IOF.
​
ValorParcela
number
Valor de parcela.
​
ValorTaxaAnual
number
Valor da taxa de juros anual.
​
ValorTaxaMensal
number
Valor da taxa de juros mensal.
​
ValorSeguro
number
Valor do seguro.
​
CodigoProposta
string
Código da proposta. Este código é utilizado para impressão do arquivo da CCB.

​
Comportamento Esperado

Após o envio da requisição:
  • A BMP realizará a originação da CCB;
  • O parceiro deverá aguardar o callback de Geração de CCB;
  • O retorno assíncrono conterá as informações necessárias para:
    • Impressão da CCB;
    • Continuidade do fluxo de assinatura biométrica;
    • Envio para averbação.

​
Considerações Técnicas

  • A geração do contrato não conclui a operação de crédito;
  • A assinatura biométrica e a averbação são etapas obrigatórias para liberação do crédito;
  • Divergências de margem, dados cadastrais ou parâmetros da simulação podem resultar em falha na geração do contrato;
  • Todo o acompanhamento do fluxo deve ser realizado por meio de callbacks.