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

# Transferir um empréstimo consignado por portabilidade

> Como sua instituição, como instituição de origem, exclui no Dataprev pela Lerian um empréstimo consignado que o trabalhador levou para outra instituição.

Exclua um contrato da sua instituição depois que o trabalhador o leva para outra instituição por portabilidade.

> [!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 de origem, que detém o contrato até a exclusão.
* **Lerian.** Lerian Consignado. Troca as requisições com o Dataprev e expõe a API e os eventos que sua instituição usa.
* **Dataprev.** Opera o sistema do Crédito do Trabalhador: os pedidos de portabilidade e o registro dos empréstimos consignados.

## Diagrama

***

![Transferir um empréstimo consignado por portabilidade](https://mintcdn.com/lerian-49cb71fc/WuRfbo_y9uSbzyyX/images/pt/d2/id-release-a-payroll-loan-by-portability.svg?fit=max\&auto=format\&n=WuRfbo_y9uSbzyyX\&q=85\&s=fcb7137b1903dd77a0039a9bd3e0b75f)

## 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}/portabilidade/exclusao`](https://docs.lerian.studio/pt/reference/rails/consignado/excluir-consignado-portabilidade) | Envie a exclusão com o número único da portabilidade, `numeroUnico`, e o código da instituição de destino, `codigoProponente`. |
| 2 | Lerian | Dataprev | API do Dataprev | | A Lerian envia a exclusão por portabilidade ao Dataprev (Manual 008). |
| 3 | Dataprev | Lerian | API do Dataprev | | O Dataprev exclui o contrato e devolve a competência da exclusão. |
| 4 | Lerian | Sua instituição | API da Lerian | [`POST /v1/consignado/contracts/{numero_contrato}/portabilidade/exclusao`](https://docs.lerian.studio/pt/reference/rails/consignado/excluir-consignado-portabilidade) | A Lerian devolve `competenciaExclusao` e o hash da operação do Dataprev. |
| 5 | Lerian | Sua instituição | API da Lerian | Evento `consignado.portabilidade.efetivada` | A Lerian publica que o contrato saiu da sua instituição. |

Sua instituição recebe o número único e a instituição de destino fora da Lerian. O contrato 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.

A exclusão e a averbação pela instituição de destino podem acontecer em qualquer ordem. Depois que o Dataprev aceita a exclusão, a Lerian envia um saldo devedor final de 0,00 para o contrato.

Quando o Dataprev recusa a exclusão com um código que a Lerian reconhece, a Lerian publica `consignado.portabilidade.rejeitada`. Se a resposta não chegar, não envie o comando de novo sob uma nova chave. O código `RAIL_COMMAND_OUTCOME_UNRESOLVED` 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).

## Como saber que terminou

***

A resposta traz `competenciaExclusao`, e a Lerian publica `consignado.portabilidade.efetivada`.

## Relacionados

***

* [Trazer um empréstimo consignado por portabilidade](https://docs.lerian.studio/pt/diagrams/native-rails/bring-in-a-payroll-loan-by-portability.md)
* [Registrar um empréstimo consignado](https://docs.lerian.studio/pt/diagrams/native-rails/register-a-payroll-loan.md)
* [Como funciona o Lerian Consignado](https://docs.lerian.studio/pt/rails/consignado/how-consignado-works.md)
* [Eventos do Consignado](https://docs.lerian.studio/pt/reference/events/consignado.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.