This flow is a suggested interpretation of the Dataprev manuals for Crédito do Trabalhador. The manuals prevail over this page. Your institution validates the flow and implements it on the Lerian APIs. See how to read the diagrams.
Participants
- Your institution. The financial institution that takes the loan from the origin institution.
- Lerian. Lerian Consignado. It exchanges the requests with Dataprev, and exposes the API and the events your institution uses.
- Dataprev. Runs the Crédito do Trabalhador system: the portability requests and the registry of payroll loans.
- Worker. The employee who asks for portability proposals in the Carteira de Trabalho Digital app.
Diagram
Answer the portability request
Lerian refuses a proposal after the validity of the request, before it calls Dataprev. A request that admits a second proposal, with and without FGTS collateral, takes two calls.
Register the ported loan
The exclusion at the origin institution and your averbação can happen in either order. When you send
dataExclusaoOrigem, Lerian refuses an averbação after the 20 calendar days that follow that date, before it calls Dataprev.
classificadorSituacao reads 0 open, 1 closed by deadline, 2 closed by averbação or 3 closed by a change of the número único. An accepted averbação starts the Lerian outstanding-balance reports for the new contract.
A 503 or 500 answer with X-Idempotency-Fenced: true may have reached Dataprev. For a proposal, send the same body with the same numeroProposta under a new key, before the validity of the request. A 422 that names SE means that the first proposal reached Dataprev.
For an averbação with such an answer, do not send it again under a new key, because that submits it again. Read the status of the portability instead. If the status reads 2, import the contract with POST /v1/consignado/contracts/{numero_contrato}/import, without the booking object. The import starts the outstanding-balance reports, or answers 409 CONTRACT_ALREADY_REGISTERED when they already run.
How you know it finished
Dataprev accepts the averbação, and the status of the portability reads
2.