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

# Traer un préstamo consignado por portabilidad

> Cómo tu institución responde a una solicitud de portabilidad de un trabajador y registra el préstamo consignado portado en Dataprev por Lerian.

Responde a una solicitud de portabilidad de un trabajador y después registra el préstamo portado en tu institución.

> [!NOTE]
>
> Este flujo es una interpretación sugerida de los manuales de Dataprev para el Crédito do Trabalhador. Los manuales prevalecen sobre esta página. Tu institución valida el flujo y lo implementa sobre las API de Lerian. Consulta [cómo leer los diagramas](https://docs.lerian.studio/es/diagrams/introduction.md).

## Participantes

***

* **Tu institución.** La institución financiera que recibe el préstamo de la institución de origen.
* **Lerian.** Lerian Consignado. Intercambia las solicitudes con Dataprev y expone la API y los eventos que usa tu institución.
* **Dataprev.** Opera el sistema del Crédito do Trabalhador: las solicitudes de portabilidad y el registro de los préstamos consignados.
* **Trabajador.** El empleado que pide propuestas de portabilidad en la aplicación Carteira de Trabalho Digital.

## Diagrama

***

### Responder a la solicitud de portabilidad

![Traer un préstamo consignado por portabilidad: Responder a la solicitud de portabilidad](https://mintcdn.com/lerian-49cb71fc/MbifquGny5fsdtVy/images/es/d2/id-bring-in-a-payroll-loan-by-portability-1.svg?fit=max\&auto=format\&n=MbifquGny5fsdtVy\&q=85\&s=ba11d63774bfa73b61b7af7c39cb4eee)

| # | Origen | Destino | Mensaje | API de Lerian | Qué ocurre |
| - | - | - | - | - | - |
| 1 | Lerian | Dataprev | API de Dataprev | | Lerian lista las solicitudes de portabilidad abiertas de forma programada (Manual 011). |
| 2 | Dataprev | Lerian | API de Dataprev | | Dataprev devuelve las solicitudes abiertas. |
| 3 | Lerian | Tu institución | API de Lerian | Evento `consignado.portability_proposal.received` | Lerian publica cada solicitud nueva y su validez. |
| 4 | Tu institución | Lerian | API de Lerian | [`POST /v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas`](https://docs.lerian.studio/es/reference/rails/consignado/respond-consignado-portability-auction) | Envía una propuesta. Repite la validez de la solicitud en `dataHoraValidadeSolicitacao`. |
| 5 | Lerian | Dataprev | API de Dataprev | | Lerian incluye la propuesta en Dataprev (Manual 011). |
| 6 | Dataprev | Lerian | API de Dataprev | | Dataprev responde a la propuesta. |
| 7 | Lerian | Tu institución | API de Lerian | [`POST /v1/consignado/leilao/portabilidade/solicitacoes/{id_solicitacao_proposta}/propostas`](https://docs.lerian.studio/es/reference/rails/consignado/respond-consignado-portability-auction) | Lerian devuelve la respuesta de Dataprev. |
| 8 | Trabajador | Tu institución | Contacto de la propuesta | | El trabajador analiza las propuestas y puede contactar a tu institución directamente. |

Lerian rechaza una propuesta después de la validez de la solicitud, antes de llamar a Dataprev. Una solicitud que admite una segunda propuesta, con y sin garantía del FGTS, requiere dos llamadas.

### Registrar el préstamo portado

![Traer un préstamo consignado por portabilidad: Registrar el préstamo portado](https://mintcdn.com/lerian-49cb71fc/MbifquGny5fsdtVy/images/es/d2/id-bring-in-a-payroll-loan-by-portability-2.svg?fit=max\&auto=format\&n=MbifquGny5fsdtVy\&q=85\&s=eaf7be906581918519529ad991958fc0)

| # | Origen | Destino | Mensaje | API de Lerian | Qué ocurre |
| - | - | - | - | - | - |
| 1 | Tu institución | Tu institución | Paso interno | | Obtén el número único de la portabilidad, el NSU que viene de la CIP. |
| 2 | Tu institución | Lerian | API de Lerian | [`POST /v1/consignado/portabilidade/{numero_unico}/averbacao`](https://docs.lerian.studio/es/reference/rails/consignado/averbar-consignado-portabilidade) | Envía la averbação del nuevo contrato. Tú eliges el `numeroContrato`: de 2 a 15 letras o dígitos. |
| 3 | Lerian | Dataprev | API de Dataprev | | Lerian envía la averbação por portabilidad a Dataprev (Manual 008). |
| 4 | Dataprev | Lerian | API de Dataprev | | Dataprev responde a la averbação. |
| 5 | Lerian | Tu institución | API de Lerian | [`POST /v1/consignado/portabilidade/{numero_unico}/averbacao`](https://docs.lerian.studio/es/reference/rails/consignado/averbar-consignado-portabilidade) | Lerian devuelve la respuesta de Dataprev. |
| 6 | Tu institución | Lerian | API de Lerian | [`GET /v1/consignado/portabilidade/efetivacoes`](https://docs.lerian.studio/es/reference/rails/consignado/list-consignado-portabilidade-efetivacoes) | Lee el estado de la portabilidad. |
| 7 | Lerian | Dataprev | API de Dataprev | | Lerian lee la portabilidad en Dataprev (Manual 008). |
| 8 | Dataprev | Lerian | API de Dataprev | | Dataprev devuelve `classificadorSituacao`. |
| 9 | Lerian | Tu institución | API de Lerian | [`GET /v1/consignado/portabilidade/efetivacoes`](https://docs.lerian.studio/es/reference/rails/consignado/list-consignado-portabilidade-efetivacoes) | Lerian devuelve el estado tal como Dataprev lo envió. |

La exclusión en la institución de origen y tu averbação pueden ocurrir en cualquier orden. Cuando envías `dataExclusaoOrigem`, Lerian rechaza una averbação después de los 20 días corridos que siguen a esa fecha, antes de llamar a Dataprev.

`classificadorSituacao` indica `0` abierta, `1` cerrada por plazo, `2` cerrada por averbação o `3` cerrada por un cambio del número único. Una averbação aceptada inicia los informes de saldo deudor de Lerian para el nuevo contrato.

Una respuesta `503` o `500` con `X-Idempotency-Fenced: true` puede haber llegado a Dataprev. Para una propuesta, envía el mismo cuerpo con el mismo `numeroProposta` bajo una clave nueva, antes de la validez de la solicitud. Un `422` que nombra `SE` significa que la primera propuesta llegó a Dataprev.

Para una averbação con esa respuesta, no la envíes otra vez bajo una clave nueva, porque eso la envía de nuevo. En su lugar, lee el estado de la portabilidad. Si el estado indica `2`, importa el contrato con [`POST /v1/consignado/contracts/{numero_contrato}/import`](https://docs.lerian.studio/es/reference/rails/consignado/import-consignado-contract), sin el objeto `booking`. La importación inicia los informes de saldo deudor, o responde `409` `CONTRACT_ALREADY_REGISTERED` cuando ya están en curso.

## Cómo saber que terminó

***

Dataprev acepta la averbação, y el estado de la portabilidad indica `2`.

## Relacionados

***

* [Transferir un préstamo consignado por portabilidad](https://docs.lerian.studio/es/diagrams/native-rails/release-a-payroll-loan-by-portability.md)
* [Responder a una solicitud de préstamo consignado](https://docs.lerian.studio/es/diagrams/native-rails/answer-a-payroll-loan-request.md)
* [Cómo funciona Lerian Consignado](https://docs.lerian.studio/es/rails/consignado/how-consignado-works.md)
* [Eventos de Consignado](https://docs.lerian.studio/es/reference/events/consignado.md)


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