Índice de documentación
Módulo

Préstamos

En el menú verás Prestamos (icono de billete) con un contador de préstamos activos. Incluye el reporte de cartera, la creación individual y la carga masiva. Los textos siguientes coinciden con las etiquetas de la aplicación.

Navegación rápida

OpciónDescripción
Reporte PrestamosListado principal de la cartera (loan/data). El título varía según filtros: por defecto Reporte cartera de préstamos; con parámetros puede mostrar variantes como [PENDIENTES], [ESPERANDO DESEMBOLSO], [ACTIVOS], [DECLINADOS], [LLEVADOS A PERDIDA], [SALDADOS], etc.
Crear PrestamoFormulario Crear nuevo préstamo (loan/create).
Carga masivaPantalla Carga Masiva de Préstamos (loan/carga_masiva). Plantilla Excel, validación e integración. Guía.

Indicadores superiores (Highlights)

Al abrir el reporte, arriba se cargan cuatro tarjetas con conteos de préstamos desembolsados según la modalidad de pago configurada:

Mientras cargan verás «Cargando estadísticas…». Si falla la petición, un aviso indicará permisos o error de conexión.

Reporte cartera de préstamos

Botones en la cabecera (según permisos):

Controles de tabla: Buscar:, Mostrar _MENU_ registros (incluye opción Ver todo en algunas configuraciones), mensajes en español y pista de desplazamiento horizontal en móvil.

Columnas del listado

ColumnaContenido
#Número o ID del préstamo.
NombresCliente titular.
PrestadoMonto desembolsado / capital.
ModalidadFrecuencia de pago (Diario, Semanal, Quincenal, Mensual, etc.).
BalanceSaldo pendiente del crédito.
RutaNombre de la ruta (producto) asignada.
EstatusEstado del flujo (pendiente, activo, cerrado, etc.).
AccionesMenú contextual hacia ficha, edición, pagos y más.

Crear nuevo préstamo

Título del formulario: Crear nuevo préstamo. Panel lateral derecho: Ayuda, con explicaciones breves por campo (por ejemplo que al cambiar Ruta se recarga el formulario).

Campos principales (visibles)

Etiqueta en pantallaUso
Ruta *Selecciona el producto/ruta. Opciones cargadas desde tu configuración de rutas.
Nombre del cliente *Lista desplegable «Seleccione» con clientes activos; define el titular del préstamo.
Monto prestado *Capital. Placeholder «Monto aprobado». Valor inicial suele venir del producto.
Cantidad de cuotas *Lista desde «Seleccione» hasta «1000 Cuotas» con formato «01 Cuota», «02 Cuotas», etc.
Modalidad de pago *Opciones: Diario, Semanal, Quincenal, Mensual.
Tipo de cuota *Cuota especifica — introduces el monto fijo por cuota en el siguiente campo. Tasa de interes — el sistema calcula la cuota a partir de la tasa (aparece aviso «La cuota se calculará automáticamente según la tasa»).
Amortizacion *FIJO (Capital + Interes); AMORTIZADO (Capital + Interes recalculado); SOLO INTERES (Interes y Capital en la ultima cuota).
Monto a pagar *En modo cuota fija: importe de cada cuota. En modo tasa: porcentaje de interés (placeholders de ayuda «Ej. 150.00» o «Ej. 10»). La etiqueta puede ajustarse por script según el tipo de cuota.
Fecha de desembolso *Selector con formato dd-mm-yyyy.
Fecha 1er pagoOpcional; mismo formato de fecha.
Penalidad/Mora *Desactivada o Activada.
Configuración penalidadMora por cuota vencida; Mora acumulativa por cuotas vencidas; Mora diaria sobre balance vencido.
Días en el calendario de pagosTarjetas conmutables: ¿Incluir sábados en el calendario de pagos? y ¿Incluir domingos en el calendario de pagos? (definen si esos días cuentan como hábiles).

Si en tu entorno está habilitada la anulación manual de interés, puede mostrarse el bloque Anular interés % con importe.

Botón final: Guardar (texto estándar del sistema; icono de disco).

Carga masiva de préstamos

Desde Reporte cartera de préstamos, el botón Carga masiva abre la pantalla titulada Carga Masiva de Préstamos. Sirve para crear muchos préstamos en bloque desde Excel, con el mismo flujo que en clientes: descargar plantilla, llenar, validar, confirmar e integrar (barra de progreso en volúmenes grandes). Requiere permiso de creación de préstamos (loans.create).

Flujo en pantalla

  1. Descargar plantilla Descargar Plantilla Excel genera plantilla_carga_masiva_prestamos_YYYY-MM-DD.xlsx con encabezados exactos y una fila de ejemplo. La hoja incluye notas al pie (modalidad, amortización, fechas, etc.).
  2. Completar datos Usa los IDs numéricos de tu sistema: id_ruta (producto/ruta) e id_cliente (borrower). Deben existir y corresponder a tu empresa/sucursal. Respeta textos permitidos en modalidad, amortización, tipo de cuota y calendario (ver tabla).
  3. Subir archivo Zona «Arrastra tu archivo Excel aquí» o clic para elegir. Solo .xlsx / .xls. Puedes Remover el archivo y elegir otro.
  4. Validar Validar Archivo revisa todas las filas. El modal Resultados de Validación resume aciertos y errores por fila y campo.
  5. Integrar Si todo es correcto: diálogo Confirmar Integración («¿Está seguro de continuar?»), aviso de que no se puede deshacer, y botón Sí, Integrar Préstamos. Alternativa: Cancelar.
  6. Resultado Modal Préstamos Integrados con resumen, posibles errores residuales y progreso. Cierra con Cerrar y revisa el reporte de préstamos.

Columnas de la plantilla

La primera fila debe contener exactamente estos nombres (como en la plantilla descargada). El sistema normaliza encabezados (minúsculas, espacios a guión bajo); conviene no renombrar columnas.

ColumnaContenido / reglas
id_rutaID de la ruta (producto). Numérico > 0.
id_clienteID del cliente (borrower). Numérico > 0.
monto_prestamoCapital. Numérico > 0.
cantidad_cuotasNúmero de cuotas. Entero > 0.
modalidad_pagoUno de: Diario, Semanal, Quincenal, Mensual.
fecha_desembolsoFormato YYYY-MM-DD.
fecha_primer_pagoMismo formato de fecha.
amortizacionFijo, Amortizado o Solo interes. Amortizado solo es válido si tipo_cuota es Tasa de interes (no con «Cuota especifica»).
monto_a_pagarCuota fija o tasa según tipo_cuota; numérico ≥ 0 según reglas de validación del archivo.
tipo_cuotaCuota especifica o Tasa de interes.
calendario_incluye_sabadosSi o No.
calendario_incluye_domingosSi o No.
penalidadSi o No.
monto_penalidadNo vacío: 0 o valor > 0. Si > 0 se aplica a la primera cuota del cronograma.
monto_feesIgual criterio; si > 0, a la primera cuota.
monto_pagadoColumna obligatoria en el archivo; el valor puede ir vacío en filas sin adelanto. Si tiene valor, debe ser numérico ≥ 0.

Validación estricta e irreversibilidad

La pantalla advierte: con al menos un error en cualquier fila el proceso se detiene y se listan los errores. La integración confirmada no se deshace desde esta herramienta. Las filas totalmente vacías se omiten.

Recordatorios del cuadro amarillo de la app

Generación de contrato

En la ficha del préstamo (Ver detalle / loan/{id}/show), con permiso de ver préstamos (loans.view), aparece el botón azul Generar Contrato. Abre en una pestaña nueva el PDF generado por la ruta loan/{id}/contract/pdf.

Qué contiene el documento

El PDF es un documento formal listo para imprimir o archivar; la validez notarial o comercial depende de tu proceso interno y de la jurisdicción.

Cronograma de pagos y ajustes

En la misma ficha del préstamo, la pestaña Cronograma de Pagos muestra cada cuota con fechas, montos y estado (pagada, parcial, vencida, etc.). Arriba hay tarjetas resumen: total de cuotas, pagadas, pendientes y vencidas, y botón Exportar a Excel del plan de cuotas.

Editar el cronograma (tabla clásica)

La pantalla Editar cronograma (loan/{id}/schedule/edit) presenta una tabla por cuota con: fecha de vencimiento, capital, interés, fees, penalidad, monto adeudado (total de la fila), balance de capital y descripción. Las sumas se recalculan al cambiar importes. Reglas que verás en pantalla (en inglés en la interfaz): la fecha de cuota no puede ser anterior a la fecha de desembolso del préstamo; la descripción puede ser opcional en algunos contextos; si hay penalidades generadas por el sistema, el texto orienta a revisar Editar préstamo y la anulación manual de mora.

Puedes añadir filas indicando cuántas líneas agregar y usando Agregar fila antes de enviar. El envío principal guarda con el botón de envío / guardar del formulario (POST a loan/{id}/schedule/update).

Imprimir, PDF y correo del cronograma

Rutas disponibles en el sistema (según permisos y enlaces en tu interfaz):

Ajustar cuotas y penalidades (préstamo desembolsado)

Si el préstamo está desembolsado y tu rol permite actualizar préstamos, el botón Ajustar Cuotas abre el modal Ajustar Cuotas y Penalidades. Desde ahí se elige el tipo de operación (cada una abre su propio formulario modal):

Cada acción se procesa contra el cronograma vía los endpoints schedule/add-penalty, remove-penalty, add-fee, remove-fee y waive-interest bajo el prefijo del préstamo.

Reestructuración (reschedule)

Para préstamos que entran en flujo de reestructuración, el sistema puede mostrar estados como Pendiente Reestructuración o Reestructurado en listados y fichas. La pantalla de reprogramar préstamo (loan/{id}/reschedule) permite definir de nuevo producto, capital, duración, ciclo de pago, fechas, método y tasa de interés, archivos adjuntos, etc., y enviar el formulario a loan/{id}/reschedule/store. Disponibilidad y campos exactos dependen del permiso loans.reschedule y del estado del crédito.

Relación con otros módulos

Nota sobre permisos. Botones como aprobar, desembolsar, editar o eliminar solo aparecen si tu rol lo permite. Si algo no está visible, consulta al administrador de tu empresa.

Preguntas frecuentes

¿Por qué mi préstamo no aparece como activo?

Revisa el estado en el reporte: puede estar pendiente de aprobación, esperando desembolso o en otra bandeja filtrada.

¿Puedo modificar cuotas ya vencidas?

Las acciones sobre cuotas dependen de permisos y política. Muchos ajustes pasan por flujos formales de reestructuración o condonación.

¿Dónde descargo el contrato?

La guía detalla la sección de contrato PDF en el flujo del préstamo. Si no ves el botón, tu rol puede no incluir exportación.

← Rutas · Índice · Calendario