Este caso de uso é referente ao fluxo de Contratação Ativa, direto pelos Canais das Instituições Financeiras.Com esse fluxo, é possível oferecer empréstimos consignados através da sua própria aplicação, sem depender que o trabalhador faça uma solicitação no aplicativo da Carteira de Trabalho (CTPS).O principal aspecto dessa modalidade é que o serviço de averbação não exigirá uma proposta vinculada a uma solicitação feita no aplicativo da CTPS para realizar a operação de averbação na DATAPREV.É permitido apenas um contrato por vínculo. Se um trabalhador já tiver um contrato ativo através do Leilão, não será possível realizar uma nova proposta pela Contratação Ativa. Caso o trabalhador já tenha uma proposta ativa através da Contratação Ativa, não será possível realizar uma nova proposta pelo Leilão.Caso o trabalhador tenha enviado propostas e não as vincule na averbação, o sistema limitará automaticamente a taxa de juros à menor taxa entre as propostas ativas enviadas.
O primeiro passo para oferecer crédito nesta modalidade é coletar a autorização do trabalhador para consultar seus dados.Para acessa o modelo do termo da Dataprev, acesse o documento Autorização e consulta do trabalhador – Crédito Trabalhador.
As informações da coleta da assinatura do termo devem ser armazenadas pelo parceiro. Em caso de auditoria da Dataprev, a BMP pode solicitar essa informações.
Após coletar o termo de autorização de uso de dados do trabalhador, o parceiro deve consultar a lista de vínculos empregatícios do trabalhador.Para isso, utilize o endpoint /trabalhador/listar-autorizados 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);
Essa requisição é obrigatória para a contratação no canal do correspondente bancário.
Na primeira consulta de cada trabalhador, é necessário que o parceiro envie a autorização de consulta de dados do trabalhador.
nsuAutorizacaoDigital É o número sequencial único que identifica a autorização assinada pelo cliente durante sua jornada. A BMP pode solicitar informações adicionais sobre o registro desse NSU para fins de auditoria, caso a Dataprev questione a existência do aceite do cliente para a consulta de dados.
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 é obrigatória para a contratação no canal do correspondente bancário.Na primeira consulta de cada trabalhador, é necessário que o parceiro envie a autorização de consulta de dados do trabalhador.
nsuAutorizacaoDigital É o número sequencial único que identifica a autorização assinada pelo cliente durante sua jornada. A BMP pode solicitar informações adicionais sobre o registro desse NSU para fins de auditoria, caso a Dataprev questione a existência do aceite do cliente para a consulta dos dados.
Poucas informações são necessárias para fazer uma simulação de empréstimo. Há a possibilidade de simular com o prazo definido ou não e o mesmo para a taxa de juros.
Se informar o prazo na requisição, será retornada o resultado da simulação detalhada;
Se não informar o prazo, serão retornadas as alternativas de parcelamento e suas respectivas taxas e valores de parcela;
Se informar a taxa de juros na requisição , o cálculo será feito com a taxa informada;
Se não informa a taxa de juros, o cálculo será feito com a taxa previamente cadastrada na BMP.
Não é obrigatório que já tenha feito o onboarding do trabalhador, mas é recomendado para que possa desabilitar opções de parcelamento que excedam a margem disponível do trabalhador.
Esta requisição tem resposta síncrona.
Show Exemplo de Requisição de Simulação Detalhada
Utilize a Simulação Detalhada caso já saiba a quantidade de parcelas que irá ofertar para o cliente. O retorno será uma lista com os detalhes das parcelas desta simulação.Exemplo de requisição de simulação detalhada:
Show Exemplo de Requisição de Simulação Multiparcelamento
Utilize a Simulação Multiparcelamento para apresentar as possibilidades de parcelamento com base no prazo configurado para a operação do parceiro. No exemplo abaixo apresentamos as opções de parcelamento para um produto configurado com o prazo de 1 a 36 parcelas. O retorno será uma lista com alternativas de empréstimo com base no prazo.Exemplo de requisição de Simulação Multiparcelamento:
Show Exemplo de Requisição de Simulação por Valor de Parcela
Simulação de um empréstimo consignado informando diretamente o valor da parcela desejada pelo cliente, tornando a experiência mais intuitiva e alinhada à realidade financeira do cliente, especialmente considerando a margem consignável disponível.A partir do valor da parcela informado, o sistema realiza os cálculos necessários para determinar o valor total que pode ser liberado.Essa abordagem facilita o atendimento, pois muitos clientes têm como referência o valor que podem comprometer mensalmente, e não necessariamente o montante total do empréstimo.
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.
Esta requisição tem resposta síncrona.
Show Exemplo de Requisição
Copy
Ask AI
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" }}'
No modelo de contratação ativa não há uma solicitação feita na CTPS para associação do trabalhador, empregador e matrícula, sendo assim, com relação a geração de contrato no modelo leilão a diferença é que nesta requisição numeroSolicitacao não deve ser informado, mas cpfTrabalhador, matricula e numeroInscricaoEmpregador devem ser informados.
O trabalhador e empregador devem ter sido previamente cadastrados e neste modelo é obrigatória a consulta da margem disponível para o vínculo do trabalhador que será feito o empréstimo consignado.
Esta requisição tem resposta síncrona e assíncrona.
Esta funcionalidade permite a inclusão de TEDs ou boletos na geração do contrato, possibilitando a realização de pagamentos prévios antes do desembolso do valor de troco ao cliente.Foi desenvolvida para atender cenários em que parte do valor do empréstimo precisa ser direcionada a terceiros ou a compromissos financeiros específicos, antes da liberação do restante dos recursos ao cliente. Com isso, o sistema passa a permitir a configuração de múltiplos lançamentos financeiros dentro da mesma proposta.
A soma dos lançamentos informados deve ser menor ou igual ao valor liberado.
É necessária a configuração prévia dos splits pela equipe BMP para poder usar a solução.
O valor do parâmetro code é o CodigoProposta, que é retornado na resposta assíncrona do endpoint /contrato/oferta-ativa/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), 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 passo 7.
9. Requisição para Averbar, Incluir CCB Assinada e Biometria Facial
Após a assinatura no passo anterior, utilize o endpoint /contrato/oferta-ativa/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.
Esta requisição tem resposta assíncrona.
O tamanho do payload enviado nessa requisição deve ser menor que 10MB.
Show Exemplo de Requisição
Copy
Ask AI
curl --request POST --location 'https://econsignadotrabalhador.moneyp.dev.br/contrato/oferta-ativa/averbar-contrato' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer <token>' \--data '{ "contratoEmprestimo": "Arquivo PDF da CCB assinado em base64", //OBRIGATÓRIO "dataHoraAssinatura": "ddMMyyyyHHmmss", //OBRIGATÓRIO - Exemplo 060219971500 "ip": "string", //OBRIGATÓRIO "numeroContrato": "Número da CCB", //OBRIGATÓRIO - Igual ao "numeroCCB" do evento de geração de CCB "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:
