Leilão

No Leilão da CTPS, o trabalhador faz uma solicitação de empréstimo e as instituições financeiras têm até 24 horas para fazerem suas propostas.

As propostas aparecem no aplicativo da CTPS e o trabalhador pode escolher a proposta que melhor o atende.

A BMP envia um callback de evento de nova solicitação feita na CTPS, inicia um leilão interno entre os seus correspondentes bancários e oferece ao trabalhador a proposta com a menor taxa de juros, após o tempo de duração do leilão.

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.

1. Requisição para realizar proposta

Resposta Assíncrona

Após o trabalhador cadastrar a solicitação de proposta no aplicativo da carteira de trabalho, a instituição financeira estará habilitada a fazer uma proposta ao trabalhador.

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

1.1 Exemplo de requisição

curl --request POST --location 'https://econsignadotrabalhador.moneyp.dev.br/propostas-ctps/inclusao' \
--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

1.2 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. Requisição para consultar a lista de vínculos do trabalhador

Resposta Assíncrona

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), número de inscrição do empregador (majoritariamente o CNPJ raiz do empregador), 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 a autorização de consulta de dados do trabalhador.

2.1 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
    }
}'

2.2 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. Requisição para consultar dados do vínculo do trabalhador

Reposta Assíncrona

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 a autorização de consulta de dados do trabalhador.

3.1 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
  }
}'

3.2 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. Requisição para cadastro do trabalhador

Resposta Síncrona

Para gerar o documento da CCB, é necessário que o parceiro faça o cadastro do trabalhador.

4.1 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
  "numeroInscricaoEmpregador": "string", // OBRIGATÓRIO
  "codigoInscricaoEmpregador": 1, // OBRIGATÓRIO 1 para CNPJ e 2 para CPF
  "nome": "string", // OBRIGATÓRIO
  "sexo": "M", //Somente 1 caractere: M para Masculino e F para Feminino
  "dataNascimento": "dd-MM-yyyy hh:mm", // OBRIGATÓRIO
  "codigoCategoriaTrabalhador": 0,
  "elegivel": true, // OBRIGATÓRIO
  "valorTotalVencimentos": 0,
  "valorBaseMargem": 0,
  "valorMargemDisponivel": 0, // OBRIGATÓRIO
  "dataAdmissao": "dd-MM-yyyy hh:mm", // 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. Requisição para cadastro do empregador

Resposta Síncrona

Para gerar o documento da CCB, é necessário que o parceiro faça o cadastro do empregador.

5.1 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. Requisição para gerar contrato 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 /propostas-ctps/inclusao.

Utilize o endpoint /emprestimos/gerar-contrato-trabalhador para gerar o documento Cédula de Crédito Bancário (CCB) do empréstimo consignado.

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

6.1 Exemplo de requisição

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

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

6.2 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 a CCB do trabalhador com biometria facial

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 código da proposta é o mesmo que o código de requisição enviado no callback do endpoint /emprestimos/gerar-contrato-trabalhador.

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. Requisição para incluir a CCB assinada e biometria facial

Resposta Assíncrona

Após a assinatura no passo anterior, utilize o endpoint /emprestimos/incluir-informacoes-contrato-trabalhador 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.

8.1 Exemplo de requisição

curl --request POST --location 'https://econsignadotrabalhador.moneyp.dev.br/emprestimos/incluir-informacoes-contrato-trabalhador' \
--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" : "<number>", //1 para RG e 2 para CPF
    "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": "<number>",
    "indicadorValidacaoComDocOficial": "<boolean>", //OBRIGATÓRIO
    "latitude": "<number>",
    "longitude": "<number>",
    "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​.

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