Skip to main content
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 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.

​
Pasos

1

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.)
2

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

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

Vincula un perfil contable

POST /api/v1/loan-products/{id}/accounting-profiles declara cómo se contabiliza el producto en el . 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.
5

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.

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

​
Inspeccionar productos

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.

​
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).

​
Próximos pasos

Originar un préstamo

Toma un producto activo y origina un préstamo contra él.