Pular para o conteúdo principal

​
Evento — Geração de CCB

Tipo: Assíncrono Após a execução da requisição de geração de contrato, a BMP realiza a originação da Cédula de Crédito Bancário (CCB) e envia um callback contendo os dados consolidados do contrato. 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.

​
Exemplo de Callback

{ "codigoRequisicao": "d6b6fdc1-5e3b-4e07-88d9-3b2f0416f734", "endpoint": "/contrato/oferta-ativa/gerar-contrato", "payload": { "numeroCCB": 0, "codigoProposta": "string", "valorCETAnual": 0, "valorCETMensal": 0, "valorEmprestimo": 0, "valorIOF": 0, "valorParcela": 0, "valorTaxaAnual": 0, "valorTaxaMensal": 0 } }
Observação:
  • Para Oferta Ativa, o endpoint retornado será /contrato/oferta-ativa/gerar-contrato;
  • Para Leilão, o endpoint retornado será /contrato/oferta-leilao/gerar-contrato.

​
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.

​
Endpoint

POST /contrato/oferta-leilao/gerar-contrato

​
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.

​
Parâmetros da Requisição

Regra:
Deve ser informado apenas um dos campos abaixo, conforme definido na simulação:
  • valorLiberado ou
  • valorParcelas
CampoObrigatórioDescrição
numeroSolicitacaoSimIdentificador da solicitação (idSolicitacao) originada na CTPS.
valorLiberadoCondicionalValor do crédito liberado, conforme simulação.
numeroParcelasSimQuantidade de parcelas da operação.
valorTaxaMensalSimTaxa de juros mensal aplicada ao contrato.
valorSeguroSimValor do seguro contratado (zero quando não aplicável).
numeroApoliceCondicionalObrigatório quando valorSeguro for maior que zero.
tipoContratoNãoTipo de contrato (ex.: GER).
propostaContaPagamentoSimDados da conta para pagamento do crédito ao trabalhador.

​
Tabela de Referência — Campo tipoConta

CódigoDescrição
1Poupança
2Conta Corrente

​
Exemplo de Requisição

curl --request POST --location 'https://econsignadotrabalhador.moneyp.dev.br/contrato/oferta-leilao/gerar-contrato' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer <token>' \ --data '{ "numeroSolicitacao": "30682694", "valorLiberado": 9000, "numeroParcelas": 24, "valorTaxaMensal": 3.75, "valorSeguro": 0, "numeroApolice": "string", "tipoContrato": "GER", "propostaContaPagamento": { "tipoConta": 0, "agencia": "stri", "agenciaDig": "s", "conta": "string", "contaDig": "s", "numeroBanco": "string" } }'

​
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.