XX.
Un préstamo regulado brasileño se origina por el pack regulatorio de Brasil, no por
POST /api/v1/loan-applications. Lee el Pack regulatorio de Brasil para esa ruta.A qué se ata una solicitud
Una solicitud se ata a una versión del producto, nunca a un producto por sí solo. La versión fija la moneda, los términos de tasa y la base de devengo, así que un contrato siempre rastrea a los términos con los que fue creado. Una versión posterior no cambia un préstamo que ya existe. Ata un perfil contable a esa versión antes de desembolsar. El desembolso construye su posting con los asientos del perfil, y un desembolso sin perfil falla. Consulta Definir un producto de préstamo.
Previsualiza, si quieres
La previsualización de cronograma calcula las cuotas y la divulgación de costo para términos prospectivos. No crea nada y no cambia nada. Úsala para mostrarle al deudor cómo se ve el préstamo antes de que alguien se comprometa. Este paso es opcional.
Envía
La llamada de envío crea la solicitud en
pending_approval. Lleva la versión del producto, el deudor, el principal solicitado, la tasa de interés mensual solicitada, la cantidad de cuotas y una fecha esperada de desembolso. Lender acepta hasta 600 cuotas.
Un campo no va en el body: el oficial asignado. Lender lo toma del sujeto autenticado de la llamada de envío. Las decisiones posteriores se verifican contra ese oficial, así que envía con la identidad que también va a aprobar y desembolsar.
Decide
Exactamente una decisión resuelve una solicitud pendiente.
Una solicitud aprobada todavía se puede retirar.
rejected y withdrawn son finales, y nada sale de ellos.
El monto aprobado es un límite, no un pago. Acota cada desembolso que sigue.
Desembolsa
El desembolso mueve dinero, así que carga la mayor cantidad de guardas. Tres cosas van en el request:
- Un header
X-Idempotency. Lender lo exige en esta operación. - El identificador de la cuenta de préstamo. Es un UUID que eliges tú, y Lender no acuña uno por ti. El cronograma, las transacciones, los cargos y el rastro de auditoría se direccionan todos por él.
- El monto bruto solicitado y el monto neto entregado.
La regla de balance es la que sorprende a los integradores. Bajo el perfil genérico no hay retenciones, así que el neto iguala el bruto. Un neto menor deja el posting sin cuadrar y Lender rechaza el desembolso.
Una transacción, cuatro resultados
Un desembolso es una sola transacción de base de datos. Adentro pasan cuatro cosas.
1
La solicitud pasa a disbursed
Lender agrega un evento de desembolso que registra los montos, la fecha y el actor que desembolsó.
2
Lender escribe el cronograma
Lender calcula un cronograma de amortización Price (francés) sobre el principal desembolsado acumulado. Guarda el resultado como versión 1 del cronograma, con la razón de cambio
origination.3
Corre el pipeline de la jurisdicción
Bajo el perfil genérico el pipeline no calcula nada, así que no agrega ninguna retención al desembolso.
4
Lender encola la intención de posting
Lender escribe una intención de posting balanceada en el outbox: principal debitado al bruto, caja acreditada al neto, y un crédito por cada retención.
approved.
Más de un tramo
Puedes desembolsar una solicitud aprobada más de una vez. El estado queda en
disbursed, Lender agrega otro evento de desembolso, y Lender escribe una versión nueva del cronograma sobre el principal acumulado. La versión nueva sustituye a la anterior en la lectura.
El total de los tramos todavía no puede exceder el monto aprobado, y cada tramo usa el mismo identificador de la cuenta de préstamo.
Dos llamadas, una solicitud
Cada escritura del ciclo de vida declara el estado que espera encontrar. Cuando dos llamadas deciden la misma solicitud al mismo tiempo, una gana y la otra recibe
409 Conflict sin cambiar nada. Un desembolso repetido que no coincide con el primero se rechaza igual.
El modelo de estados
Qué tienes al final
- Una solicitud que lee
disbursed, con un evento de desembolso por tramo. - Una cuenta de préstamo bajo el identificador que aportaste, con su cronograma, sus transacciones, sus cargos y sus eventos de auditoría.
- Una intención de posting en camino al ledger. Esa contabilización es asíncrona, así que cae poco después de que el request retorna, no durante.
- Un evento de ciclo de vida en el backbone de streaming por cada transición.
Próximos pasos
Servicing de un préstamo
Registra repagos, prepaga, reprograma y corrige una cuenta de préstamo activa.
Arquitectura de Lender
Los dominios, la costura de jurisdicción y el outbox que saca el dinero.
Contabilidad y ejecuciones de devengo
Reglas de posting, ejecuciones de devengo y la referencia de asiento que ata una contabilización.
Pack regulatorio de Brasil
IOF, CET, consentimiento de capitalización y el resto del perfil brasileño.