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

# Definir un producto de préstamo

> Crea un producto de préstamo, congela sus términos en una versión inmutable, adjunta cargos y tasas, vincula un perfil contable y actívalo para la originación.

export const GLedger = ({children}) => <Tooltip headline="Ledger" tip="El libro financiero central que registra todas las transacciones, saldos y operaciones de una organización. Es la única fuente de verdad de las finanzas de una unidad de negocio." cta="Ver glosario" href="/es/start-here/glossary">
    {children}
  </Tooltip>;

Un producto de préstamo es la plantilla desde la que se origina cada préstamo. Definir uno es una secuencia corta: crea el producto, versiona sus términos, describe cómo se contabiliza en el ledger y luego activa el producto. Originas cada préstamo contra una **versión de producto**, y el desembolso necesita que esa versión lleve un perfil contable.

## Antes de empezar

***

* Necesitas un token bearer de Lender (un JWT que emite tu Access Manager). Cada operación está autenticada y tiene ámbito de tenant.
* Decide a qué [jurisdicción](/es/products/lender/jurisdictions) pertenece el producto: la línea base genérica o Brasil. Los productos brasileños llevan campos extra que cubre el [Paquete regulatorio de Brasil](/es/products/lender/brazil-regulatory-pack).

## Pasos

***

<Steps>
  <Step title="Crea el producto">
    `POST /api/v1/loan-products` registra el producto con nombre. Esta es la entrada del catálogo de la que cuelgan las versiones. (Brasil tiene un alias, `POST /api/v1/br/loan-products`, que acepta las extensiones BR.)
  </Step>

  <Step title="Crea una versión">
    `POST /api/v1/loan-products/{id}/versions` congela un conjunto de términos (configuración de tasa, plazo y forma del cronograma) como una **versión inmutable**. Cada préstamo se remonta a la versión que usó en la originación. Nunca editas una versión, publicas una nueva.
  </Step>

  <Step title="Adjunta cargos">
    `POST /api/v1/loan-products/{id}/charges` aplica una plantilla de cargo (una comisión de originación, un cargo por servicio) que heredan los préstamos originados desde este producto.
  </Step>

  <Step title="Vincula un perfil contable">
    `POST /api/v1/loan-products/{id}/accounting-profiles` declara cómo se contabiliza el producto en el <GLedger>ledger</GLedger>. El perfil lleva las reglas de asiento (qué patas de partida doble se disparan para cada evento) y la organización del ledger y el ledger en los que se contabilizan. Lender rechaza desembolsar un préstamo cuya versión no tiene perfil, así que vincúlalo antes de originar. Consulta [Contabilidad y corridas de devengo](/es/products/lender/accounting-and-accrual-runs).
  </Step>

  <Step title="Activa el producto">
    `POST /api/v1/loan-products/{id}/activate` pone el producto en activo y fija la versión que nombras como su versión actual. Activar es una puerta, no una etiqueta: hasta que ocurre, el producto no origina nada. Cada solicitud nombra la versión que usa en la originación, así que los préstamos existentes conservan la versión con la que empezaron.
  </Step>
</Steps>

## Promueve una versión nueva

***

La activación es la puerta por la que pasa la **primera** versión. La promoción es la puerta de todas las siguientes: repunta un producto que ya está vivo hacia otra versión vigente, sin bajar el producto y volver a subirlo.

`POST /api/v1/loan-products/{id}/promote` nombra la versión a fijar. Brasil tiene un alias, `POST /api/v1/br/loan-products/{id}/promote`, que se comporta de forma idéntica.

La promoción lleva las mismas dos comprobaciones de alistamiento que lleva la activación — un perfil contable presente y una versión completa para su jurisdicción — porque es el mismo acto. Un segundo camino sin ellas sería una manera silenciosa de saltarse el primero.

| Rechazo | Qué significa |
| - | - |
| `LENDER-0101` (`409`) | El producto no está activo, así que no hay versión vigente que repuntar. Actívalo en su lugar, nombrando la versión a fijar. |
| `LENDER-0102` (`422`) | La versión nombrada no es una versión de este producto. Lee las versiones del propio producto y nombra una de ellas. |

<Warning>
  **La promoción no cambia ningún contrato ni ninguna solicitud.** Cada préstamo ya escrito conserva la versión en que nació — cronograma, precios y cargos leen de esa versión durante toda la vida del préstamo — y cada solicitud todavía en vuelo también. Solo las solicitudes nuevas leen la versión vigente.
</Warning>

## Inspeccionar productos

***

| Operación | Propósito |
| - | - |
| `GET /api/v1/loan-products` | Lista los productos de préstamo. |
| `GET /api/v1/loan-products/{id}` | Lee un solo producto, incluida la versión fijada como actual. |
| `GET /api/v1/loan-products/{id}/floating-rates` | Lee la tabla de tasas flotantes del producto, si referencia una. |

<Tip>
  Un producto de tasa flotante resuelve su tasa aplicable desde la tabla cuando el cronograma la necesita, en lugar de fijar una tasa fija en la originación.
</Tip>

## Qué pasa downstream

***

Crear y activar productos emite `loan_product.created`, `loan_product_version.created`, `loan_product.activated`, `accounting_profile.configured` y `loan_charge.applied` en el backbone de streaming (consulta [Lender en la plataforma](/es/products/lender/lender-in-the-platform)).

## Próximos pasos

***

<Card title="Originar un préstamo" icon="file-signature" href="/es/products/lender/originate-a-loan" horizontal>
  Toma un producto activo y origina un préstamo contra él.
</Card>