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

# Trazer um empréstimo consignado por portabilidade

> Como sua instituição responde a um pedido de portabilidade de um trabalhador e registra o empréstimo consignado portado no Dataprev pela Lerian.

Responda a um pedido de portabilidade de um trabalhador e depois registre o empréstimo portado na sua instituição.

> [!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 recebe o empréstimo da instituição de origem.
* **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.
* **Trabalhador.** O empregado que pede propostas de portabilidade no aplicativo Carteira de Trabalho Digital.

## Diagrama

***

### Responder ao pedido de portabilidade

![Trazer um empréstimo consignado por portabilidade: Responder ao pedido de portabilidade](https://mintcdn.com/lerian-49cb71fc/WuRfbo_y9uSbzyyX/images/pt/d2/id-bring-in-a-payroll-loan-by-portability-1.svg?fit=max\&auto=format\&n=WuRfbo_y9uSbzyyX\&q=85\&s=19b80da91c69923df6ee20cfa2edc6d7)

| # | Origem | Destino | Mensagem | API da Lerian | O que acontece |
| - | - | - | - | - | - |
| 1 | Lerian | Dataprev | API do Dataprev | | A Lerian lista os pedidos de portabilidade abertos de forma agendada (Manual 011). |
| 2 | Dataprev | Lerian | API do Dataprev | | O Dataprev devolve os pedidos abertos. |
| 3 | Lerian | Sua instituição | API da Lerian | Evento `consignado.portability_proposal.received` | A Lerian publica cada novo pedido e a validade dele. |
| 4 | Sua instituição | Lerian | API da Lerian | [`POST /v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas`](https://docs.lerian.studio/pt/reference/rails/consignado/respond-consignado-portability-auction) | Envie uma proposta. Repita a validade do pedido em `dataHoraValidadeSolicitacao`. |
| 5 | Lerian | Dataprev | API do Dataprev | | A Lerian inclui a proposta no Dataprev (Manual 011). |
| 6 | Dataprev | Lerian | API do Dataprev | | O Dataprev responde à proposta. |
| 7 | Lerian | Sua instituição | API da Lerian | [`POST /v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas`](https://docs.lerian.studio/pt/reference/rails/consignado/respond-consignado-portability-auction) | A Lerian devolve a resposta do Dataprev. |
| 8 | Trabalhador | Sua instituição | Contato da proposta | | O trabalhador analisa as propostas e pode contatar sua instituição diretamente. |

A Lerian recusa uma proposta depois da validade do pedido, antes de chamar o Dataprev. Um pedido que admite uma segunda proposta, com e sem garantia do FGTS, exige duas chamadas.

### Registrar o empréstimo portado

![Trazer um empréstimo consignado por portabilidade: Registrar o empréstimo portado](https://mintcdn.com/lerian-49cb71fc/aExJLTeJEpnHlOuM/images/pt/d2/id-bring-in-a-payroll-loan-by-portability-2.svg?fit=max\&auto=format\&n=aExJLTeJEpnHlOuM\&q=85\&s=16396ee342b37ae866b1342fd6f393fa)

| # | Origem | Destino | Mensagem | API da Lerian | O que acontece |
| - | - | - | - | - | - |
| 1 | Sua instituição | Sua instituição | Etapa interna | | Obtenha o número único da portabilidade, o NSU que vem da CIP. |
| 2 | Sua instituição | Lerian | API da Lerian | [`POST /v1/consignado/portabilidade/{numero_unico}/averbacao`](https://docs.lerian.studio/pt/reference/rails/consignado/averbar-consignado-portabilidade) | Envie a averbação do novo contrato. Você escolhe o `numeroContrato`: de 2 a 15 letras ou dígitos. Adicione `booking` para contabilizar o contrato no Lender. |
| 3 | Lerian | Dataprev | API do Dataprev | | A Lerian envia a averbação por portabilidade ao Dataprev (Manual 008). |
| 4 | Dataprev | Lerian | API do Dataprev | | O Dataprev responde à averbação. |
| 5 | Lerian | Sua instituição | API da Lerian | [`POST /v1/consignado/portabilidade/{numero_unico}/averbacao`](https://docs.lerian.studio/pt/reference/rails/consignado/averbar-consignado-portabilidade) | A Lerian devolve a resposta do Dataprev. O contrato passa a aguardar a documentação. |
| 6 | Sua instituição | Lerian | API da Lerian | [`POST /v1/consignado/contracts/{numero_contrato}/ccb-attachment`](https://docs.lerian.studio/pt/reference/rails/consignado/attach-consignado-ccb) | Envie a documentação sob a própria chave `X-Idempotency`, como em qualquer averbação. |
| 7 | Lerian | Dataprev | API do Dataprev | | A Lerian envia as informações do contrato ao Dataprev (Manual 004). |
| 8 | Dataprev | Lerian | API do Dataprev | | O Dataprev aceita a documentação. |
| 9 | Lerian | Sua instituição | API da Lerian | [`POST /v1/consignado/contracts/{numero_contrato}/ccb-attachment`](https://docs.lerian.studio/pt/reference/rails/consignado/attach-consignado-ccb) | A operação responde `confirmed`. |
| 10 | Sua instituição | Lerian | API da Lerian | [`POST /v1/consignado/portabilidade/efetivacoes`](https://docs.lerian.studio/pt/reference/rails/consignado/list-consignado-portabilidade-efetivacoes) | Leia o status da portabilidade. Envie os filtros no corpo da requisição. |
| 11 | Lerian | Dataprev | API do Dataprev | | A Lerian lê a portabilidade no Dataprev (Manual 008). |
| 12 | Dataprev | Lerian | API do Dataprev | | O Dataprev devolve `classificadorSituacao`. |
| 13 | Lerian | Sua instituição | API da Lerian | [`POST /v1/consignado/portabilidade/efetivacoes`](https://docs.lerian.studio/pt/reference/rails/consignado/list-consignado-portabilidade-efetivacoes) | A Lerian devolve o status como o Dataprev o enviou. |

A exclusão na instituição de origem deve vir primeiro, com ou sem garantia do FGTS. O Dataprev recusa uma averbação enviada antes da exclusão com a regra `PT`, e uma enviada depois que a portabilidade fechou com a regra `PW`. Depois de qualquer uma dessas recusas, o número do contrato fica livre para uma nova averbação.

Quando você envia `dataExclusaoOrigem`, a Lerian recusa uma averbação depois dos 20 dias corridos que seguem essa data, antes de chamar o Dataprev. Sem ela, a Lerian pula apenas essa verificação, e o Dataprev julga a ordem e o prazo.

`classificadorSituacao` lê `0` aberta, `1` encerrada por prazo, `2` encerrada por averbação ou `3` encerrada por alteração do número único.

Uma averbação aceita registra o contrato como aguardando a documentação e inicia os informes de saldo devedor da Lerian. `GET /v1/consignado/contracts/{numero_contrato}/averbacao` lê `attachment_pending`. A Lerian não publica `consignado.averbacao.accepted` para ela. A documentação segue as regras de [Registrar um empréstimo consignado](https://docs.lerian.studio/pt/diagrams/native-rails/register-a-payroll-loan.md).

Consulte os campos e as validações de `booking` na [averbação por portabilidade](https://docs.lerian.studio/pt/reference/rails/consignado/averbar-consignado-portabilidade.md).

Com `booking`, `consignado.contract.registered` leva um bloco `portability_in` depois que o Dataprev aceita a documentação. O bloco tem `origins[]`, `transferred_principal` e `effective_at`. A Lerian o envia quando o registro de status da portabilidade no Dataprev mostra exatamente as origens contabilizadas. Se o registro mostra outra origem, ou ainda não mostra algumas 20 dias corridos após a documentação confirmada, a Lerian estaciona o contrato e não publica nenhum fato. Sem `booking`, a Lerian guarda a CCB assinada e não publica nenhum fato para o Lender.

Uma resposta `503` ou `500` com `X-Idempotency-Fenced: true` pode ter chegado ao Dataprev. Para uma proposta, envie o mesmo corpo com o mesmo `numeroProposta` sob uma nova chave, antes da validade do pedido. Um `422` que nomeia `SE` significa que a primeira proposta chegou ao Dataprev.

A Lerian reserva o `numeroContrato` antes de chamar o Dataprev. Enquanto o resultado está em aberto, um reenvio sob uma nova chave nunca submete a averbação de novo: responde `409` `CLT-0007` enquanto a primeira chamada ainda pode estar em andamento, depois `503` `OUTCOME_UNKNOWN`. A Lerian então lê o contrato no Dataprev e o registra como aceito ou libera o número. Essa leitura exige a recuperação de averbações (`DATAPREV_AVERBACAO_RECOVERY_ENABLED`, desligada por padrão). Um `numeroContrato` que sua instituição já mantém responde `409` `CONTRACT_ALREADY_REGISTERED`, antes de a Lerian chamar o Dataprev.

## Como saber que terminou

***

A documentação responde `confirmed`, e o status da portabilidade lê `2`.

## Relacionados

***

* [Transferir um empréstimo consignado por portabilidade](https://docs.lerian.studio/pt/diagrams/native-rails/release-a-payroll-loan-by-portability.md)
* [Responder a um pedido de empréstimo consignado](https://docs.lerian.studio/pt/diagrams/native-rails/answer-a-payroll-loan-request.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.