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

# Registrar un préstamo consignado

> Cómo la averbação de un préstamo consignado y la documentación del contrato llegan a Dataprev por Lerian.

Registra el descuento en nómina de un préstamo en Dataprev y después envía la documentación del contrato.

> [!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 otorga el préstamo.
* **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 subastas de préstamos y el registro de los préstamos consignados.

## Diagrama

***

![Registrar un préstamo consignado](https://mintcdn.com/lerian-49cb71fc/MbifquGny5fsdtVy/images/es/d2/id-register-a-payroll-loan.svg?fit=max\&auto=format\&n=MbifquGny5fsdtVy\&q=85\&s=97ffd028749bc049a2c1500fdff584ef)

## Pasos

***

| # | Origen | Destino | Mensaje | API de Lerian | Qué ocurre |
| - | - | - | - | - | - |
| 1 | Tu institución | Lerian | API de Lerian | [`POST /v1/consignado/contracts/{numero_contrato}/averbacao`](https://docs.lerian.studio/es/reference/rails/consignado/averbar-consignado-contract) | Envía la averbação del contrato, sin ningún documento. Tú eliges el `numero_contrato`: de 2 a 15 letras o dígitos. |
| 2 | Lerian | Dataprev | API de Dataprev | | Lerian envía la averbação a Dataprev (Manual 003). |
| 3 | Dataprev | Lerian | API de Dataprev | | Dataprev acepta la averbação y queda con el mandato de descuento en nómina. |
| 4 | Lerian | Tu institución | API de Lerian | [`POST /v1/consignado/contracts/{numero_contrato}/averbacao`](https://docs.lerian.studio/es/reference/rails/consignado/averbar-consignado-contract) | La operación responde `attachment_pending`: el contrato espera su documentación. |
| 5 | Lerian | Tu institución | API de Lerian | Evento `consignado.averbacao.accepted` | Lerian publica la averbação aceptada. |
| 6 | Tu institución | Lerian | API de Lerian | [`POST /v1/consignado/contracts/{numero_contrato}/ccb-attachment`](https://docs.lerian.studio/es/reference/rails/consignado/attach-consignado-ccb) | Envía la documentación bajo su propia clave `X-Idempotency`: la CCB firmada, la evidencia de firma y `data_hora_assinatura`, el instante en que firmó el trabajador. |
| 7 | Lerian | Dataprev | API de Dataprev | | Lerian envía la información del contrato a Dataprev (Manual 004). |
| 8 | Dataprev | Lerian | API de Dataprev | | Dataprev acepta la documentación y devuelve el hash de la operación. |
| 9 | Lerian | Tu institución | API de Lerian | [`POST /v1/consignado/contracts/{numero_contrato}/ccb-attachment`](https://docs.lerian.studio/es/reference/rails/consignado/attach-consignado-ccb) | La operación responde `confirmed`. |
| 10 | Lerian | Tu institución | API de Lerian | Evento `consignado.averbacao.confirmed` | Lerian publica la averbação confirmada. |

El Manual 004 de Dataprev da a tu institución 7 días después de la averbação para enviar la documentación. [`GET /v1/consignado/contracts/{numero_contrato}/averbacao`](https://docs.lerian.studio/es/reference/rails/consignado/get-consignado-contract-averbacao-operation) muestra `documentation_due_at` y `documentation_overdue`.

Un contrato acepta una sola documentación aceptada. Lerian informa a Dataprev el saldo deudor del contrato desde la averbação aceptada.

Cuando Dataprev rechaza la averbação con un código que Lerian reconoce, la operación indica `rejected`, y Lerian publica `consignado.averbacao.rejected`. Cuando Dataprev responde a la averbação con cualquier otro código, o su respuesta no llega, la operación indica `averbacao_unknown`. No la envíes otra vez bajo una clave nueva. Lee la averbação y contacta a Lerian con el número del contrato si sigue en `averbacao_unknown`.

La documentación enviada antes de que Dataprev acepte la averbação responde `409` `AVERBACAO_NOT_ACCEPTED`, y nada llega a Dataprev. Si Dataprev rechaza la documentación, la respuesta es `422` con los códigos de Dataprev en `upstream`. Envía la documentación corregida bajo una clave `X-Idempotency` nueva. Si la llamada termina sin veredicto, envía la misma documentación otra vez.

## Cómo saber que terminó

***

La documentación responde `confirmed`, y Lerian publica `consignado.averbacao.confirmed`.

## Relacionados

***

* [Responder a una solicitud de préstamo consignado](https://docs.lerian.studio/es/diagrams/native-rails/answer-a-payroll-loan-request.md)
* [Refinanciar un préstamo consignado](https://docs.lerian.studio/es/diagrams/native-rails/refinance-a-payroll-loan.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.