Saltar al contenido principal
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 la activación 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. El crédito se registra bajo la jurisdicción de Brasil. La base genérica, XX, no registra crédito. 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. Una versión debe declarar su banda de tasa y los tipos de prestatario que admite, o no origina nada.
3

Adjunta cargos

POST /api/v1/loan-product-versions/{id}/charge-templates declara una plantilla de cargo en una versión. POST /api/v1/loan-products/{id}/charges la aplica a una cuenta de préstamo.
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. La activación rechaza una versión sin perfil. 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. Hasta la activación, el producto no origina nada. Una versión brasileña también necesita su carteira, normPortfolioClass, antes de activarse. 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 fija la primera versión. La promoción fija todas las siguientes. Cambia la versión vigente de un producto que ya está vivo, 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. Las lleva 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ó. Su cronograma, sus precios y sus cargos leen de esa versión durante toda la vida del préstamo. Cada solicitud todavía en vuelo también conserva su versió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 eventos (consulta Lender en la plataforma).

​
Próximos pasos

Originar un préstamo

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