> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Refinanciar um empréstimo consignado > Como um novo empréstimo consignado quita empréstimos consignados ativos no Dataprev pela Lerian, e como reverter o refinanciamento dentro do prazo. Quite um ou mais empréstimos consignados ativos com um novo empréstimo e, se necessário, reverta o refinanciamento dentro do prazo. > [!NOTE] > > Este fluxo é uma interpretação sugerida dos manuais do Dataprev para o Crédito do Trabalhador. Os manuais prevalecem sobre esta página. Sua instituição valida o fluxo e o implementa sobre as APIs da Lerian. Veja [como ler os diagramas](https://docs.lerian.studio/pt/diagrams/introduction.md). ## Participantes *** * **Sua instituição.** A instituição financeira que detém os empréstimos e concede o novo. * **Lerian.** Lerian Consignado. Troca as requisições com o Dataprev e expõe a API que sua instituição usa. * **Dataprev.** Opera o sistema do Crédito do Trabalhador: os leilões de empréstimo e o registro dos empréstimos consignados. ## Diagrama *** ![Refinanciar um empréstimo consignado](https://mintcdn.com/lerian-49cb71fc/aExJLTeJEpnHlOuM/images/pt/d2/id-refinance-a-payroll-loan.svg?fit=max\&auto=format\&n=aExJLTeJEpnHlOuM\&q=85\&s=6892a915a4cedbf8128102a37e8ef307) ## Passo a passo *** | # | Origem | Destino | Mensagem | API da Lerian | O que acontece | | - | - | - | - | - | - | | 1 | Sua instituição | Lerian | API da Lerian | [`POST /v1/consignado/contracts/{numero_contrato}/refinanciamento`](https://docs.lerian.studio/pt/reference/rails/consignado/realizar-consignado-refinanciamento) | Envie o refinanciamento. O `numero_contrato` é o novo contrato, que você escolhe. O corpo lista os contratos a quitar. | | 2 | Lerian | Dataprev | API do Dataprev | | A Lerian envia o refinanciamento ao Dataprev (Manual 008). | | 3 | Dataprev | Lerian | API do Dataprev | | O Dataprev quita os contratos listados e registra o novo contrato. | | 4 | Lerian | Sua instituição | API da Lerian | [`POST /v1/consignado/contracts/{numero_contrato}/refinanciamento`](https://docs.lerian.studio/pt/reference/rails/consignado/realizar-consignado-refinanciamento) | A Lerian devolve o número do novo contrato, os contratos quitados e o hash da operação do Dataprev. | | 5 | Lerian | Sua instituição | API da Lerian | Evento `consignado.refinanciamento.efetivado` | A Lerian publica os contratos quitados e as condições do novo contrato. | | 6 | Sua instituição | Lerian | API da Lerian | [`POST /v1/consignado/contracts/{numero_contrato}/refinanciamento/reversao`](https://docs.lerian.studio/pt/reference/rails/consignado/reverter-consignado-refinanciamento) | Opcional: reverta o refinanciamento em até 7 dias úteis. | | 7 | Lerian | Dataprev | API do Dataprev | | A Lerian envia a reversão ao Dataprev (Manual 008). | | 8 | Dataprev | Lerian | API do Dataprev | | O Dataprev exclui o novo contrato, e os contratos quitados voltam a ficar ativos. | | 9 | Lerian | Sua instituição | API da Lerian | [`POST /v1/consignado/contracts/{numero_contrato}/refinanciamento/reversao`](https://docs.lerian.studio/pt/reference/rails/consignado/reverter-consignado-refinanciamento) | A Lerian devolve a resposta do Dataprev. | | 10 | Lerian | Sua instituição | API da Lerian | Evento `consignado.refinanciamento.revertido` | A Lerian publica que o novo contrato foi excluído. | Cada contrato a quitar deve ser um contrato que a Lerian mantém para sua instituição: registrado pela Lerian, ou importado com [`POST /v1/consignado/contracts/{numero_contrato}/import`](https://docs.lerian.studio/pt/reference/rails/consignado/import-consignado-contract). Qualquer outro contrato responde `404`, e a Lerian não chama o Dataprev. O mesmo vale para um contrato que a leitura de acompanhamento da Lerian mostra no Dataprev como excluído, encerrado ou fechado por renegociação. Com garantia do FGTS, um refinanciamento quita um contrato. Quando `temGarantias` é `false`, deixe de fora os três valores de garantia do FGTS e nunca envie `0`. A Lerian os recusa com `422` antes de chamar o Dataprev. Adicione o bloco opcional `booking` para contabilizar o novo contrato no Lender. A Lerian nunca o envia ao Dataprev. O bloco tem `loan_product_version`, `expected_disbursement_date`, `formalization_deadline` e `margin_snapshot`, e um `origination_fee_amount` opcional. Envie todos os membros e deixe `origination_fee_amount` de fora quando não houver tarifa. Com o bloco, `competenciaInicioDesconto` é obrigatório. O resultado de `valorEmprestimo` menos `valorIOF` e menos a tarifa deve ser igual a `valorPago` mais `valorTroco`, ou a requisição responde `422` `DECLARED_TERMS_INCONSISTENT`. A Lerian responde `422` com os códigos de contabilização da averbação a qualquer outra contabilização que o Lender recusaria. Sem o bloco, o novo contrato existe apenas no Dataprev, e o Lender não contabiliza nada. A Lerian informa ao Dataprev o saldo devedor do novo contrato. Para cada contrato quitado, ela envia um saldo final de 0,00. Você pode reverter apenas um refinanciamento que a Lerian registrou. A Lerian publica três fatos para um refinanciamento que passa por ela. `consignado.refinanciamento.efetivado` leva o novo contrato, os contratos quitados e as condições aceitas. Com `booking`, ele leva também `novo_contrato`, no formato de `consignado.contract.registered`. `consignado.refinanciamento.revertido` diz que uma reversão excluiu o novo contrato, inclusive uma feita no portal do Dataprev que a leitura de acompanhamento da Lerian encontra. `consignado.refinanciamento.recusado` diz que o refinanciamento foi recusado ou não executou nada, e nomeia os contratos que continuam ativos. Um refinanciamento feito fora da Lerian não publica nada. Com `booking`, a Lerian publica `novo_contrato` apenas com condições que o Dataprev confirmou. Se o Dataprev confirma outra `competenciaInicioDesconto`, a requisição responde `503` `OUTCOME_UNKNOWN` e a Lerian estaciona o comando. A recuperação publica `efetivado` apenas quando a leitura do novo contrato mostra as condições contabilizadas. Se a resposta não resolver o comando, a Lerian o estaciona em `outcome_unknown` e responde `503` `OUTCOME_UNKNOWN`. Não envie o comando de novo sob uma nova chave. A mesma chave encontra `RAIL_COMMAND_OUTCOME_UNRESOLVED`, que significa que a Lerian ainda não conhece o resultado. Leia o comando com [`GET /v1/consignado/rail-commands`](https://docs.lerian.studio/pt/reference/rails/consignado/list-consignado-rail-commands). Se a recuperação não conseguir decidir, o back office da sua instituição fecha o comando estacionado com `POST /v1/consignado/rail-commands/{id}/close`. Envie `outcome` (`accepted` ou `refused`) e `portal_evidence`, que informa o que o portal do Dataprev mostra. A chamada responde `204`. Um fechamento como `accepted` faz a Lerian ler o novo contrato no Dataprev uma vez. Um fechamento como `refused` não lê nada, libera o número do novo contrato e publica `consignado.refinanciamento.recusado` com `reason_code` `GW-BANCO-RECUSADO`. Um comando estacionado há menos de 5 minutos responde `409` `RAIL_COMMAND_NOT_CLOSEABLE`. Quando nada rodou no Dataprev, a Lerian fecha o comando como recusado. Um `503` `DATAPREV_UNAVAILABLE` cujo detalhe diz isso significa que a chamada nunca saiu da Lerian, ou que o Dataprev respondeu apenas `OZ`, o código da virada de competência. Um `422` com os códigos do Dataprev em `upstream` significa que os códigos provam que nada rodou. Envie uma requisição corrigida sob uma nova chave. O código `RAIL_COMMAND_ALREADY_REFUSED` significa que o comando sob a chave antiga foi fechado como recusado, pelo Dataprev ou antes de chegar a ele. ## Como saber que terminou *** A linha 4 devolve o número do novo contrato e os contratos quitados, e a Lerian publica `consignado.refinanciamento.efetivado`. ## Relacionados *** * [Registrar um empréstimo consignado](https://docs.lerian.studio/pt/diagrams/native-rails/register-a-payroll-loan.md) * [Trazer um empréstimo consignado por portabilidade](https://docs.lerian.studio/pt/diagrams/native-rails/bring-in-a-payroll-loan-by-portability.md) * [Como funciona o Lerian Consignado](https://docs.lerian.studio/pt/rails/consignado/how-consignado-works.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.