El ciclo de vida de la solicitud
Una solicitud recorre estados con nombre. Cada transición es una operación distinta, y cada una guarda un registro de decisión o desembolso:
Pasos
Previsualiza el cronograma (opcional)
POST /api/v1/loan-applications/preview-schedule calcula el cronograma de amortización para términos prospectivos sin originar nada. Úsalo para mostrar cuotas y divulgaciones antes de que alguien se comprometa.Envía la solicitud
POST /api/v1/loan-applications crea la solicitud contra una versión de producto activa. Las escrituras son idempotentes — envía una clave de idempotencia y un envío reintentado colapsa a la misma solicitud.Decide
Resuelve la solicitud con exactamente una de:
POST /api/v1/loan-applications/{id}/approve— acéptala; se guarda un registro de decisión.POST /api/v1/loan-applications/{id}/reject— recházala, con un registro de decisión.POST /api/v1/loan-applications/{id}/withdraw— retírala antes de que sea decidida.
Qué obtienes
El desembolso produce una cuenta de préstamo — la vista de servicing del contrato vivo, que lleva su cronograma, transacciones, cargos e historial de auditoría. Continúa en Servicing de un préstamo.
Qué pasa downstream
El ciclo de vida emite
loan_application.submitted, loan_application.approved, loan_application.rejected, loan_application.withdrawn y loan_application.disbursed. El desembolso también impulsa un posting al ledger vía la ruta de posting.
La originación brasileña añade pasos regulados — divulgación de CET y consentimiento de capitalización — cubiertos en el Pack regulatorio de Brasil. El flujo de consignado con descuento en nómina se origina en una sola llamada; consulta Consignado privado.
Próximos pasos
Servicing de un préstamo
Registra repagos, prepaga, reprograma y corrige una cuenta de préstamo activa.

