Detalle
| Campo | Descripción |
|---|---|
| Manual de Usuario | Cómo consultar las cuotas pendientes de cobro de los créditos de un cliente, ver mora, abonado y saldo, y analizar la deuda período a período y los pagos realizados. |
| Módulo | Préstamos |
| Tipo de pantalla | Consulta (solo lectura) y exportación |
| Acceso | Pestaña PRESTAMOS, botón "Vencimientos de Clientes". También desde la pantalla de Clientes. |
Introducción
La función Vencimientos de Clientes permite consultar en detalle las cuotas pendientes de cobro de los créditos de un cliente, ver la mora, lo abonado y el saldo, además de analizar la deuda período a período y los pagos ya realizados.
La pantalla es de solo consulta: no se cobran ni modifican cuotas desde aquí; sirve para visualizar, analizar y exportar la información de la cartera de un cliente.
Acceso al módulo
- Ingresá a la pestaña PRESTAMOS de la barra principal.
- En el grupo de búsquedas de préstamos, presioná el botón Vencimientos de Clientes.
- Se abre la pantalla "Vencimientos de cuotas de créditos" dentro del panel principal.
- Alternativamente, abrí la pantalla de Clientes, seleccioná un cliente y elegí la opción de consulta de vencimientos de cuotas: la pantalla se abre ya filtrada por ese cliente y ejecuta la búsqueda automáticamente.
Importante: El acceso depende de la licencia/módulo de Préstamos. Si la licencia no habilita esta función, al presionar el botón se muestra el mensaje de la licencia y la pantalla no se abre.
Pantalla principal
La pantalla muestra arriba una barra de filtros (Cliente, Especie/Moneda, Crédito y la casilla Limpiar) y, debajo, un control de solapas con cuatro vistas de la información. Tras presionar Buscar, las cuatro solapas se completan con los datos del cliente consultado:
- Detalle de Cuotas — listado cuota por cuota de los vencimientos pendientes.
- Cuotas mes por mes — resumen de la deuda agrupada por período (año/mes).
- Detalle por Entidad — tabla dinámica (pivot) que cruza Entidad/Comercio con año y mes.
- Pagos Realizados — comprobantes de cobro ya registrados, con el detalle de los conceptos cobrados.
Importante: La pantalla es de solo consulta. No se cobran ni modifican cuotas desde aquí.
Filtros de búsqueda
Los vencimientos se filtran con los siguientes campos de la barra superior y luego se presiona Buscar:
| Campo | Descripción |
|---|---|
| Cliente | Cliente cuyas cuotas se quieren consultar. Es obligatorio: si no se indica un cliente válido (numérico), el sistema avisa "Debe especificar un Cliente a buscar...". |
| Especie / Moneda | Moneda de los créditos a consultar. Es obligatoria; por defecto viene en 1 (moneda principal). Si está vacía o no es numérica, avisa "Debe especificar una especie/moneda...". |
| Crédito | Número de crédito, para acotar la búsqueda a un crédito puntual. |
| Limpiar (P) | Casilla que limpia los filtros de Cliente y Crédito y vuelve la Especie/Moneda al valor por defecto 1. |
Importante: Solo se listan cuotas impagas de créditos otorgados, no anulados y no cancelados. Las cuotas ya cobradas no aparecen en el detalle de cuotas (sí se ven en la solapa Pagos Realizados).
Resultados
Tras buscar, la información se presenta en las cuatro solapas descriptas a continuación.
Solapa "Detalle de Cuotas"
Es la vista principal. Cada fila es una cuota pendiente con estas columnas:
| Campo | Descripción |
|---|---|
| Cuota | Número de cuota sobre el plazo total (formato nro/plazo). |
| Vencimiento | Fecha de vencimiento de la cuota. |
| Crédito# | Número de crédito al que pertenece la cuota. |
| Solicitud# | Número de solicitud que originó el crédito. |
| Valor Cuota | Importe de la cuota (total punible). |
| Punitorios | Intereses punitorios devengados por la mora. |
| V. Cuota + Punit. | Valor de la cuota más punitorios e IVA de punitorios (total a cobrar). |
| Entidad | Entidad o comercio asociado al crédito. |
| Abonado | Importe ya cobrado de esa cuota. |
| Saldo | Saldo pendiente de la cuota (valor más punitorios, menos lo cobrado). |
| Mora | Días de atraso respecto a la fecha de operación (negativo si aún no venció). |
Importante: Las filas se colorean según la mora para identificar el riesgo de un vistazo: salmón cuando la mora supera los 30 días, texto rojo entre 1 y 30 días de mora, azul para cuotas próximas a vencer (hasta 5 días) y negro para las que vencen más adelante.
El pie de la grilla muestra los totales (sumas) de Valor Cuota, Punitorios, V. Cuota + Punit., Abonado y Saldo. La grilla tiene fila de autofiltro para filtrar por cualquier columna.
Solapa "Cuotas mes por mes"
Agrupa la deuda por período para ver cómo se distribuye en el tiempo:
| Campo | Descripción |
|---|---|
| Período | Año/mes del vencimiento. |
| Cuotas | Suma de las cuotas (valor más punitorios) de ese período. |
| Saldo | Suma del saldo pendiente de ese período. |
Solapa "Detalle por Entidad"
Tabla dinámica (pivot) que muestra el Valor Cuota distribuido por Entidad/Comercio en las filas y por Año y Mes en las columnas. Permite analizar la concentración de vencimientos por entidad.
Importante: En esta solapa se deshabilitan los botones de resultado y de exportar a Excel/PDF; al volver a otra solapa se reactivan.
Solapa "Pagos Realizados"
Muestra los comprobantes de cobro ya registrados para las cuotas del cliente, agrupados por crédito y cuota. Se divide en dos bloques de columnas.
Comprobantes
| Campo | Descripción |
|---|---|
| Crédito | Número de crédito. |
| Cuota | Número de cuota sobre el plazo. |
| Fecha | Fecha del cobro. |
| Fecha Anulación | Fecha en que se anuló el cobro (si corresponde). |
| Tipo De Comprobante | Tipo de comprobante del cobro; "Manual" si no tiene tipo asociado. |
| Nº Comprobante | Número del comprobante (p. ej. recibo RC con letra y punto de venta). |
| Importe | Importe total cobrado en ese comprobante. |
Cobrados (apertura de conceptos cobrados)
| Campo | Descripción |
|---|---|
| Capital | Capital cobrado. |
| Interes | Interés cobrado. |
| Iva Interes | IVA sobre el interés. |
| Gastos | Gastos cobrados. |
| Iva Gastos | IVA sobre gastos. |
| Percepciones | Percepciones de gastos. |
| Punitorios | Punitorios cobrados. |
| Iva Punitorios | IVA sobre punitorios. |
| Percep. Punitorios | Percepciones de punitorios. |
| C. Seguro | Cuota de seguro cobrada. |
| Iva Seguro Cuota | IVA del seguro de la cuota. |
| Percepc. Seguro | Percepciones del seguro. |
| Total | Total cobrado sumando todos los conceptos. |
Acciones disponibles
| Acción | Descripción |
|---|---|
| Buscar | Ejecuta la consulta con los filtros indicados y llena las cuatro solapas. |
| Limpiar (P) | Restablece los filtros de Cliente y Crédito y deja la Especie/Moneda en 1. |
| Exportar a Excel | Exporta a Excel la grilla de la solapa activa (no disponible en Detalle por Entidad). |
| Exportar a PDF | Exporta a PDF la grilla de la solapa activa (no disponible en Detalle por Entidad). |
| Autofiltro y agrupación | Filtra por columna en cada grilla y, en Pagos Realizados, agrupa arrastrando los encabezados. |
Buscar
Validá que estén cargados un Cliente válido y la Especie/Moneda y presioná Buscar. Si no hay cuotas para el criterio, el sistema avisa "No se encontraron cuotas pendientes según el criterio de búsqueda...".
Limpiar (P)
Al tildar la casilla Limpiar se vacían los campos Cliente y Crédito y la Especie/Moneda vuelve al valor por defecto 1, para iniciar una nueva consulta.
Exportar a Excel / PDF
Posicionate en la solapa Detalle de Cuotas, Cuotas mes por mes o Pagos Realizados y usá los botones de exportación. En la solapa Detalle por Entidad estos botones están deshabilitados por ser una tabla dinámica.
Autofiltro y agrupación
Cada grilla incluye fila de autofiltro para acotar por columna. En la solapa Pagos Realizados, además, podés arrastrar encabezados al panel de agrupación para reorganizar los comprobantes.
Ejemplo práctico
Un gestor de cobranzas necesita revisar la deuda del cliente 1234 en moneda principal:
- Abre PRESTAMOS → Vencimientos de Clientes.
- Ingresa el Cliente
1234, deja la Especie/Moneda en1y presiona Buscar. - En Detalle de Cuotas identifica de inmediato, por el color salmón, las cuotas con más de 30 días de mora y revisa el total del pie de grilla.
- Cambia a Cuotas mes por mes para ver en qué períodos se concentra la deuda.
- Abre Pagos Realizados para confirmar qué cobros ya se registraron y con qué comprobantes.
- Vuelve a Detalle de Cuotas y Exporta a Excel el listado para adjuntarlo a su gestión.
Consejos útiles
- Verificá siempre la Especie/Moneda del filtro: una consulta vacía suele deberse a que el cliente no tiene cuotas impagas en esa moneda.
- Usá los colores de la grilla para priorizar: el salmón marca la mora más crítica (más de 30 días).
- Si "no aparecen" cuotas que esperabas, recordá que solo se listan créditos otorgados, no anulados y no cancelados con cuotas impagas; lo ya cobrado está en Pagos Realizados.
- Para analizar concentración por entidad, usá la solapa Detalle por Entidad; para exportar, pasá antes a otra solapa.
- Abrir la consulta desde la pantalla de Clientes ahorra pasos: llega filtrada y ya ejecutada para el cliente seleccionado.
Preguntas frecuentes
Busco un cliente y aparece "No se encontraron cuotas pendientes según el criterio de búsqueda".
Significa que ese cliente no tiene cuotas impagas para la especie/moneda elegida, o que sus créditos están cancelados, anulados o aún no otorgados. Verificá la moneda del filtro y revisá la solapa Pagos Realizados para ver lo ya cobrado.¿Por qué hay filas en rojo o salmón?
El color indica la mora de la cuota: salmón cuando supera los 30 días de atraso, texto rojo entre 1 y 30 días, azul cuando está por vencer (hasta 5 días) y negro cuando vence más adelante. Es una ayuda visual para priorizar la gestión de cobranza.¿Puedo cobrar una cuota desde esta pantalla?
No. Es una pantalla de consulta y exportación. El cobro de cuotas se realiza desde los módulos correspondientes de Préstamos/Tesorería.¿Por qué no puedo exportar en la solapa "Detalle por Entidad"?
En esa solapa los botones de exportar se deshabilitan porque es una tabla dinámica. Cambiá a Detalle de Cuotas, Cuotas mes por mes o Pagos Realizados para exportar a Excel o PDF.Permisos
El acceso a esta pantalla no se controla con un permiso de objeto con nombre, sino con la licencia/módulo de Préstamos. Al abrir desde el menú se valida la licencia y, si no está habilitada, se muestra un mensaje y no se abre la pantalla.
| Permiso | Habilita |
|---|---|
Licencia módulo Préstamos (KeyLicences.Instance.Access(2, 2, Nothing, 2)) |
Abrir la pantalla Vencimientos de Clientes desde el menú Préstamos. Si la licencia no lo permite, se muestra el mensaje de la licencia y no se abre la pantalla. |
Información técnica
Sección de referencia para soporte/desarrollo. Basada en el análisis del formulario real de la v14 (
FormPrestamosClientesVencimientosCuotas.cs).
Formularios principales
| Componente | Detalle |
|---|---|
| Formulario | FormPrestamosClientesVencimientosCuotas (C#) — : FrmResult (VPNET_WinForms\VPNET_WinForms\Prestamos\FormPrestamosClientesVencimientosCuotas.cs). Título de ventana "Vencimientos de cuotas de créditos". Constructor (int Id_Cliente = 0, int Id_Especie = 1): si recibe cliente, ejecuta Buscar() automáticamente. |
| Controles UI | UC_BuscarIdGenerico para Cliente (uC_BuscarIdCliente), Especie (uC_BuscarIdEspecie, default 1) y Crédito (uC_BuscarIdCredito); casilla ckbLimpiarP; grillas DevExpress gvCuotas, gvDeudaMesxMes, gvDetalleCobros (banded) y pivotGridControl1; tabPane1 con 4 páginas (Detalle de Cuotas, Cuotas mes por mes, Detalle por Entidad, Pagos Realizados). |
| Lanzamiento | frmNewMain.vb → btnCuotasVencimientos_ItemClick (caption "Vencimientos de Clientes", Id 288): valida licencia y abre con ShowFrmInDockPanel(New FormPrestamosClientesVencimientosCuotas()). También desde frmClientes.vb con New FormPrestamosClientesVencimientosCuotas(Id_Cliente) pasando el cliente seleccionado. |
Permisos reales
El acceso no usa un permiso de objeto con nombre, sino la licencia/módulo de Préstamos.
| Permiso | Habilita |
|---|---|
Licencia módulo Préstamos (KeyLicences.Instance.Access(2, 2, Nothing, 2)) |
Abrir la pantalla desde el menú Préstamos. Si no lo permite, muestra KeyLicences.Instance.Mensaje y no abre. |
Tablas de base de datos principales
Acceso a datos Entity Framework —
VisualPlenarioNetContext, consultas LINQ directas en el form (sin manager dedicado). Fecha de corte víaGeneric_Base_Manager.GetFechaOperacion().
| Tabla / entidad | Contenido |
|---|---|
PrestamosCreditos |
Crédito otorgado (filtra por cliente, especie, no anulado/cancelado, Fecha_Otorgado con valor). |
PrestamosCreditosDetalle |
Cuotas del crédito (vencimiento, valor punible, punitorios, IVA, cobrado). |
PrestamosCreditosDetalleCobros |
Cobros aplicados a cada cuota (solapa Pagos Realizados). |
PrestamosSolicitudes |
Plazo y datos del solicitante (apellido, nombre, domicilio). |
Entidades |
Nombre de la entidad/comercio del crédito. |
Clientes |
Cliente del crédito. |
TipoComprobantes |
Tipo de comprobante del cobro ("Manual" si nulo). |
Recibos |
Datos del recibo (letra, punto de venta, número) cuando el tipo de comprobante es 16. |
Relación con otros módulos / manuales
Esta funcionalidad forma parte de Préstamos. No declara otro manual operativo como dependencia directa en su metadata actual.
Notas para soporte (comportamiento real del código)
- Pantalla de solo consulta: no cobra ni modifica cuotas.
- Filtro de datos: solo cuotas impagas (
Fecha_Cobro == null) de créditos conFecha_Anulacion == null,Fecha_Cancelacion == nullyFecha_Otorgadocon valor, acotadas porId_ClienteeId_Especie. - Validaciones de búsqueda: Cliente y Especie/Moneda deben ser numéricos no vacíos (mensajes "Debe especificar un Cliente a buscar..." / "Debe especificar una especie/moneda..."). Sin resultados: "No se encontraron cuotas pendientes segun el criterio de búsqueda...".
- Cálculos: mora con
DbFunctions.DiffDays(Fecha_Vencimiento, Fecha_Trabajo); "V. Cuota + Punit." =Punitorios + TotalPunible + IvaPunitorios; el número de comprobante de recibos (tipo 16) se arma conSqlFunctions.Replicatecomo "RC {Letra} {Punto_Vta} {ceros}{Id}". - Coloreo por mora en
gvCuotas_RowStyle: >30 días salmón; 1–30 texto rojo; −5 a 0 azul; < −5 negro. - La solapa Detalle por Entidad es un
pivotGridControl1que desactiva los botones de Resultado / Exportar Excel / Exportar PDF (EnabledControls(false)) y los reactiva al volver a otra solapa. - La casilla Limpiar (P) vacía Cliente y Crédito y vuelve Especie/Moneda al valor
1(hardcodeado enckbLimpiarP_CheckedChanged). - Distinto del informe de gestión de "vencimientos de lotes" (otra pantalla).