Document for reference only. Active Hiring endpoints are under development.
This use case refers to the Active Hiring flow, directly through Financial Institution Channels.
With this flow, it is possible to take out a loan in your own application without depending on the worker to make a request in the Work Card (CTPS) application.
The main aspect of this change is that the endorsement service will no longer require a proposal linked to a request made in the CTPS application to perform the endorsement operation in DATAPREV.
Despite this, the auction mechanism via the work card application will continue to be available as an alternative channel for the worker. It is worth noting that it will not be possible to endorse more than one contract per relationship, with only one contract per relationship being allowed.
If the worker has sent proposals and does not link them in the endorsement, the system will automatically limit the interest rate to the lowest rate among the active proposals sent.
1. Request to consult the worker’s employment relationship list
Use this endpoint to consult the worker’s employment relationship list. The return will be the employer’s federal document, worker’s registration number and employment eligibility.
This request is mandatory for hiring through the bank correspondent channel.
In the first consultation of each worker, the partner must send the authorization to consult the worker’s data.
nsuAutorizacaoDigital This is the unique sequential number that identifies the authorization signed by the client during his/her journey. BMP may request additional information about the registration of this NSU for audit purposes, in case Dataprev questions the existence of the client’s acceptance for data consultation.
Use this endpoint to consult the margin base value, available margin, eligibility of the bond and other information for credit analysis.
This request is mandatory for hiring in the bank correspondent channel.
In the first consultation of each employee, the partner must send the authorization to consult the employee’s data.
nsuAutorizacaoDigital This is the unique sequential number that identifies the authorization signed by the client during their journey. BMP may request additional information about the registration of this NSU for audit purposes, in case Dataprev questions the existence of the client’s acceptance to consult the data.
Little information is required to simulate a loan. It is possible to simulate with or without a defined term and the same for the interest rate.
If you enter the term in the request, the result of the detailed simulation will be returned;
If you do not enter the term, the installment alternatives and their respective rates and installment amounts will be returned;
If you enter the interest rate in the request, the calculation will be made with the rate informed;
If you do not enter the interest rate, the calculation will be made with the rate previously registered in BMP.
It is not mandatory that you have already onboarded the worker, but it is recommended so that you can disable installment options that exceed the worker’s available margin.
In the active hiring model, there is no request made in the CTPS for the association of the worker, employer and registration number, therefore, regarding the generation of a contract in the auction model, the difference is that in this request numeroSolicitacao should not be informed, but cpfTrabalhador, registra and numeroInscricaoEmpregador should be informed.
The worker and employer must have been previously registered and in this model, it is mandatory to consult the margin available for the worker’s employment relationship to which the loan will be made.
The proposal code is the same as the request code sent in the callback of the /emprestimos/gerar-contrato-trabalhador endpoint.
The integration code will be informed to the partner when the approval and production credentials are delivered.
The accepted electronic signature standards are Advanced Electronic Signatures, as defined by Law 14.063/2020.
For biometric validation, the databases of the Superior Electoral Court (TSE), National Traffic Secretariat (DENATRAN), Federal Data Processing Service (SERPRO) and Electronic Identity of the Civil Registry (IDRC) are accepted.
Facial biometrics must meet liveness guarantee requirements, according to the IEEE Std 2790-2020, ISO/IEC 30107-3 and ISO/IEC 29794-5 standards.
If there are no biometrics available in government databases, it is possible to use validation with the photo of an official document. The captured biometrics must be used exclusively for the signature process and cannot be reused. During biometric capture, it is necessary to inform the worker of the purpose of the capture and the possibility of using the data by MTE/DATAPREV for audits and investigations.
With the CCB signed by the worker, continue with the inclusion of the CCB signed with facial biometrics in step 7.
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", //MANDATORY "dataHoraAssinatura": "dd-MM-yyyy hh:mm", //MANDATORY "ip": "<string>", //MANDATORY "numeroContrato": "<string>", //MANDATORY "tipoDocumento" : "<number>", //1 for RG and 2 for 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", //MANDATORY "baseBiometrica": "<string>", "score": "<number>", "indicadorValidacaoComDocOficial": "<boolean>", //MANDATORY "latitude": "<number>", "longitude": "<number>", "dispositivo": "<string>"}'
If the indicadorValidacaoComDocOficial field is true, the following fields become mandatory:
