Leilão

Na modalidade Leilão, o trabalhador solicitante do crédito realiza uma simulação no aplicativo da Carteira de Trabalho Digital. A BMP realiza um leilão entre parceiros internos e escolhe a melhor proposta para cobrir a simulação.

A proposta vencedora é enviada para o trabalhador. Durante um período de 24 horas, o trabalhador escolhe a proposta vencedora. Após a sua seleção, o parceiro assinará o contrato junto com o trabalhador, e a proposta será averbada pela Dataprev. Após a averbação, a BMP desembolsa o crédito para o trabalhador.

A comunicação de cada etapa do processo é realizada via notificações pela API de callbacks.

O leilão interno tem duração de 1 minuto. Se nenhuma proposta for enviada dentro do período do leilão, consideraremos a primeira proposta enviada posteriormente.

Neste documento, você encontra o detalhamento do fluxo de contratação, além de todos os endpoints necessários para participar do leilão.

Fluxo de Contratação do Leilão

1. Trabalhador acessa o aplicativo da Carteira de Trabalho Digital e realiza uma simulação de crédito. As Instituições Financeiras tem até 24 horas para enviar suas propostas.
2. Em cima dessa simulação, a BMP abre um leilão interno entre seus parceiros.
3. A BMP consulta a Dataprev a cada 15 minutos para capturar novas simulações.
4. Parceiro recebe um callback via API caso tenham leilões disponíveis.
5. Parceiro envia uma proposta para participar do leilão.
6. BMP recebe a proposta e coloca o parceiro no leilão.
7. Parceiro recebe um callback via API sobre sua posição no leilão.
8. Parceiro recebe um callback via API caso sua proposta ganhe o leilão.
9. BMP envia a proposta escolhida para a Dataprev.
10. Trabalhador analisa as propostas recebidas durante 24h.
11. Caso a proposta de um parceiro seja escolhida pelo trabalhador, o parceiro recebe um callback via API.
12. Trabalhador é direcionado para um canal do parceiro, onde informa seus dados.
13. BMP recebe e registra os dados do trabalhador e de seu empregador.
14. Parceiro gera um contrato sem CCB.
15. BMP gera uma CCB não assinada e encaminha para o parceiro coletar a assinatuar com biometria facial do trabalhador.
16. Parceiro envia CCB assinada em Casas de Assinatura terceiras para BMP.
17. BMP encaminha contrato com CCB assinada para averbação na Dataprev.
18. Dataprev devolve contrato averbado.
19. BMP realiza o desenbolso do crédito para o trabalhador.
20. Parceiro recebe callback via API com as informações do contrato finalizado.

Requisições e uso da API

1. Realizar proposta

   Resposta Assíncrona

   Após receber o callback de leilões disponíveis, o parceiro deve enviar sua proposta para participar do leilão interno. O envio dessa proposta é feito pelo endpoint /contrato/oferta-leilao/incluir-proposta.

   Utilize essa requisição para enviar a proposta para a BMP e participar do leilão interno.

   Show 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", // Obrigatório. "idSolicitacao" do evento de nova solicitação feita na CTPS
    "dataHoraValidadeProposta": "ddMMyyyyHHmmss", // Obrigatório
    // Tipo URL é obrigatório
    "contatos": [
     {
      "contato": "https://moneyp.com.br/",
      "tipo": 0
     },
     {
      "contato": "<telefone de contato>?text=<texto url encoded>",
      "tipo": 1
     },
     {
      "contato": "40038389",
      "tipo": 2
     },
     {
      "contato": "[e-mail]",
      "tipo": 3
     }
    ],
    "valorLiberado": 9000, // Obrigatório
    "numeroParcelas": 24, // Obrigatório
    "valorTaxaMensal": 3.75 // Obrigatório
   }'
   

   Tabela de referência do campo contatos:

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

   Show Exemplo de Notificação por Callback

   O exemplo de notificação enviado por callback dessa requisição está disponível no documento Configuração da URL de callback - Evento de atualização de situação de proposta.

2. Consultar lista de vínculos do trabalhador

   Resposta Assíncrona

   Após receber o callback de atualização da situação da proposta, o parceiro deve consultar os vínculos empregatícios do trabalhador.

   Utilize este endpoint para consultar a lista de vínculos empregatícios do trabalhador, o retorno será:

   • O código de inscrição do empregador (1 para CNPJ e 2 para CPF);
   • O número de inscrição do empregador (majoritariamente o CNPJ raiz do empregador);
   • O número de matrícula do trabalhador e a elegibilidade do vínculo.

   Essa requisição é opcional para a contratação do Leilão.

   Na primeira consulta de cada trabalhador, é necessário que o parceiro envie uma autorização de consulta de dados do trabalhador.

   Show Exemplo de Requisição

   curl --location --request POST 'https://econsignadotrabalhador.moneyp.dev.br/trabalhador/listar-autorizados' \
   --header 'Content-Type: application/json' \
   --header 'Authorization: Bearer <token>' \
   --data '{
       "cpfTrabalhador": "string",
       "autorizacao": {
             "nsuAutorizacaoDigital": 0
       }
   }'
   

   Show Exemplo de Notificação por Callback

   O exemplo de notificação por callback dessa requisição está disponível no documento Configuração da URL de callback - Evento de consulta de lista de vínculos empregatícios.

3. Consultar dados do vínculo do trabalhador

   Reposta Assíncrona

   Após consultar a lista de vínculos do trabalhador, o parceiro pode consultar os dados desse vínculo.

   Utilize este endpoint para consultar o valor da base de margem, margem disponível, elegibilidade do vínculo e outras informações para análise de crédito.

   Essa requisição é opcional para a contratação do Leilão.

   Na primeira consulta de cada trabalhador, é necessário que o parceiro envie uma autorização de consulta de dados do trabalhador.

   Show Exemplo de Requisição

   curl --location --request POST 'https://econsignadotrabalhador.moneyp.dev.br/trabalhador/consultar-dados-vinculo' \
   --header 'Content-Type: application/json' \
   --header 'Authorization: Bearer <token>' \
   --data '{
     "cpfTrabalhador": "string",
     "matricula": "string",
     "codigoInscricaoEmpregador ": 0,
     "numeroInscricaoEmpregador": "string",
     "autorizacao": {
       "nsuAutorizacaoDigital": 0
     }
   }'
   

   Show Exemplo de Notificação por Callback

   O exemplo de notificação por callback dessa requisição está disponível no documento Configuração da URL de callback - Evento de consulta de dados de vínculo empregatício.

4. Cadastrar trabalhador

   Resposta Síncrona

   Após receber o callback de que a sua proposta vencedora do leilão foi escolhida pelo trabalhador, é necessário cadastrar os dados desse trabalhador nos sistemas BMP.

   Utilize o endpoint /trabalhador/cadastrar-vinculo para realizar esse cadastro.

   Show Exemplo de Requisição

   curl --location 'https://econsignadotrabalhador.moneyp.dev.br/trabalhador/cadastrar-vinculo' \
   --header 'Content-type: application/json' \
   --header 'Authorization: Bearer <token>' \
   --data-raw '{
     "cpf": "string", // OBRIGATÓRIO
     "matricula": "string", // OBRIGATÓRIO
     "codigoInscricaoEmpregador": 1, // OBRIGATÓRIO 1 para CNPJ e 2 para CPF
     "numeroInscricaoEmpregador": "string", // OBRIGATÓRIO
     "nomeEmpregador": "string", // OBRIGATÓRIO
     "nome": "string", // OBRIGATÓRIO
     "sexo": "M", //Somente 1 caractere: M para Masculino e F para Feminino
     "dataNascimento": "dd-MM-yyyy", // OBRIGATÓRIO
     "codigoCategoriaTrabalhador": 0, // OBRIGATÓRIO
     "elegivel": true, // OBRIGATÓRIO
     "valorTotalVencimentos": 0, // OBRIGATÓRIO
     "valorBaseMargem": 0, // OBRIGATÓRIO
     "valorMargemDisponivel": 0, // OBRIGATÓRIO
     "dataAdmissao": "dd-MM-yyyy", // OBRIGATÓRIO
     "pessoaExpostaPoliticamente": 0, // OBRIGATÓRIO
     "nomeMae": "string",
     "paisNacionalidade": "string",
     "cboDescricao": "string",
     "dadosContato": {
       "email": "string", // OBRIGATÓRIO
       "telefoneFixo1": "string", 
       "telefoneCelular1": "string" // OBRIGATÓRIO
     },
     "dadosComplementares": {
       "rg": "string",
       "rgOrgao": "string",
       "rguf": "string",
       "estadoCivil": 0
     },
     "endereco": { 
       "cep": "string", // OBRIGATÓRIO
       "logradouro": "string", // OBRIGATÓRIO
       "nroLogradouro": "string", 
       "bairro": "string", // OBRIGATÓRIO
       "complemento": "string",
       "cidade": "string", // OBRIGATÓRIO
       "uf": "string" // OBRIGATÓRIO
     }
   }'
   

5. Cadastro do empregador

   Resposta Síncrona

   O empregador foi cadastrado na requisição anterior, utilizando os campos numeroInscricaoEmpregador e nomeEmpregador. Caso queira atualizar ou adicionar mais detalhes do empregador, utilize este endpoint.

   Show Exemplo de Requisição

   curl --location 'https://econsignadotrabalhador.moneyp.dev.br/trabalhador/cadastrar-empregador' \
   --header 'Content-type: application/json' \
   --header 'Authorization: Bearer <token>' \
   --data-raw '{
     "nome": "string", // Obrigatório. Igual retorno da consulta do vínculo.
     "codigoInscricaoEmpregador": 0, // Obrigatório. Igual retorno da consulta do vínculo(1-CNPJ e 2-CPF)
     "numeroInscricaoEmpregador": "string", // Obrigatório. Igual retorno da consulta do vínculo.
     "dadosContato": {
       "email": "string",
       "telefoneFixo1": "string",
       "telefoneCelular1": "string"
     },
     "endereco": {
       "cep": "string",
       "logradouro": "string",
       "nroLogradouro": "string",
       "bairro": "string",
       "complemento": "string",
       "cidade": "string",
       "uf": "string"
     }
   }'
   

6. Gerar contrado do trabalhador

   Resposta Assíncrona

   Após o aceite da proposta no aplicativo da CTPS, o trabalhador irá entrar em contato por meio de um dos canais informados no endpoint /contrato/oferta-leilao/incluir-proposta.

   Utilize o endpoint /contrato/oferta-leilao/gerar-contrato para gerar o documento Cédula de Crédito Bancário (CCB) do E-Consignado Trabalhador.

   Após a geração do contrato, este documento deve ser assinado com a biometria facial do trabalhador e enviado no endpoint /contrato/oferta-leilao/averbar-contrato dentro do prazo da competência correspondente. Se o contrato for enviado após a competência, deverá ser gerado, assinado e enviado novamente.

   Show 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,
       "tipoContrato": "GER",
       "propostaContaPagamento": {
           "tipoConta": 0,
           "agencia": "stri",
           "agenciaDig": "s",
           "conta": "string",
           "contaDig": "s",
           "numeroBanco": "string"
       }
   }'
   

   Código	Descrição
   1	Poupança
   2	Conta Corrente

   Show Exemplo de Notificação por Callback

   O exemplo de notificação por callback dessa requisição está disponível no documento Configuração da URL de callback - Evento de geração de CCB.

7. Assinar CCB

   Após a geração do contrato, o trabalhador deve assinar o documento Cédula de Crédito Bancário (CCB) com a biometria facial.

   A assinatura da CCB do trabalhador deve ser realizada pelo parceiro, utilizando um serviço de assinatura com biometria facial.

   Utilize o endpoint abaixo para imprimir a CCB.

   https://reports.moneyp.dev.br/ImprimirCCB?Code={{CODIGO_PROPOSTA}}&Integracao={{CODIGO_INTEGRACAO}}
   

   O valor do parâmetro code é o CodigoProposta, que é retornado na resposta assíncrona do endpoint /contrato/oferta-leilao/gerar-contrato.

   O código de integração é será informado ao parceiro na entrega das credenciais de homologação e produção.

   Os padrões de assinatura eletrônica aceitos são as Assinaturas Eletrônicas Avançadas, conforme definido pela Lei 14.063/2020.

   Para validação biométrica, são aceitas as bases do Tribunal Superior Eleitoral (TSE), Secretaria Nacional de Trânsito (DENATRAN), Serviço Federal de Processamento de Dados (SERPRO) e Identidade Eletrônica do Registro Civil (IDRC).

   A biometria facial deve atender a requisitos de garantia de vivacidade (liveness), conforme os padrões IEEE Std 2790-2020, ISO/IEC 30107-3 e ISO/IEC 29794-5.

   Caso não haja biometria disponível em bases governamentais, é possível utilizar a validação com a foto de um documento oficial. A biometria capturada deve ser utilizada exclusivamente para o processo de assinatura e não pode ser reutilizada. Durante a captura biométrica, é necessário informar ao trabalhador a finalidade da captura e a possibilidade de uso dos dados pelo MTE/DATAPREV para auditorias e apurações.

   Com a CCB assinada pelo trabalhador, siga com a inclusão da CCB assinada com biometria facial no próximo passo.

8. Incluir CCB assinada

   Resposta Assíncrona

   Após a assinatura no passo anterior, utilize o endpoint /contrato/oferta-leilao/averbar-contrato para incluir as informações do contrato do trabalhador.

   Com a inclusão da CCB assinada, o empréstimo será averbado na DATAPREV, após esta inclusão, o empréstimo estará liberado para fila de pagamento.

   Show Exemplo de Requisição

   curl --request POST --location 'https://econsignadotrabalhador.moneyp.dev.br/contrato/oferta-leilao/averbar-contrato' \
   --header 'Content-Type: application/json' \
   --header 'Authorization: Bearer <token>' \
   --data '{
       "contratoEmprestimo": "Arquivo PDF da CCB assinado em base64", //OBRIGATÓRIO
       "dataHoraAssinatura": "dd-MM-yyyy hh:mm", //OBRIGATÓRIO
       "ip": "string", //OBRIGATÓRIO
       "numeroContrato": "string", //OBRIGATÓRIO
       "tipoDocumento" : 0, //1 para RG e 2 para CNH
       "documentoOficialComFotoFrente": "Arquivo JPG da frente do documento em base64",
       "documentoOficialComFotoVerso": "Arquivo JPG do verso do documento em base64",
       "registroBiometricoFacial": "Arquivo JPG do registro biométrico facial em base64", //OBRIGATÓRIO
       "baseBiometrica": "string", 
       "score": 0,
       "indicadorValidacaoComDocOficial": "<boolean>", //OBRIGATÓRIO
       "latitude": 0,
       "longitude": 0,
       "dispositivo": "string"
   }'
   

   Caso o campo indicadorValidacaoComDocOficial seja true, os seguintes campos se tornam obrigatórios:

   • documentoOficialComFotoFrente;
   • documentoOficialComFotoVerso;
   • tipoDocumento.

   Caso o campo indicadorValidacaoComDocOficial seja false, os seguintes campos se tornam obrigatórios:

   • baseBiometrica;
   • score​.

   Show Exemplo de Notificação por Callback

   O exemplo de notificação por callback dessa requisição está disponível no documento Configuração da URL de callback - Evento de averbação de empréstimo.

APIs Auxiliares

• Atualização da Conta Bancária será utilizado nesta jornada para atualização da conta pagamento.
• Procedimento Técnico Callback será utilizado nesta jornada para confirmação de assintura e confirmação de pagamento.
• Consultar Contrato será utilizado nesta jornada para consultar os dados da proposta.
• Consultar comprovante de Pagamento será utilizado nesta jornada para consultar o comprovante de pagamento da proposta.