🔍 Buscar Líneas DPF por Institución y Rango de Fechas

📌 Buscar cobros por institución y fechas

¿Necesitas revisar los cobros realizados por una institución en un período específico? Aquí te explicamos cómo hacerlo de forma sencilla:

🧭 Pasos para buscar los cobros

  1. Accede al módulo de cobros de DPF
    Dirígete a la siguiente dirección en el sistema: 

    index.php?c=dpf_lines

  2. Selecciona “Buscar por fecha”
    En el menú lateral izquierdo, haz clic en la opción Buscar por fecha.

  3. Filtra por institución
    Dentro de la sección de búsqueda, selecciona la opción Buscar por institución.

  4. Define el rango de fechas
    Elige la fecha de inicio y la fecha de fin que deseas consultar.

  5. Haz clic en buscar
    El sistema mostrará automáticamente la lista de cobros correspondientes a esa institución dentro del período que seleccionaste.

Captura de pantalla de ejemplo:

Screenshot-From-2025-05-01-17-47-34

✅ ¿Qué información verás?

La búsqueda te mostrará cada línea de cobro, incluyendo:

  • Fecha del cobro
  • Intereses cobrados
  • Valores retenidos
  • Monto total recibido
  • Institución a la que corresponde
  • Estado y detalles adicionales

Esta herramienta es ideal para llevar el control de los ingresos por institución y tener reportes precisos por periodo.

¿Quieres que también incluya capturas de pantalla o un pequeño video/gif paso a paso para esta sección?

https://postimg.cc/yJwXSxXP/4bb7e812

🔍 Buscar Líneas DPF por Institución y Rango de Fechas

Esta función permite obtener las líneas (dpf_lines) correspondientes a depósitos a plazo fijo (DPF) de una institución específica, dentro de un rango de fechas determinado.

📌 Propósito

Filtrar y obtener todas las líneas de depósitos que pertenecen a una institución dada y cuya fecha esté comprendida entre dos valores (from y to). Es útil para generar reportes financieros, seguimientos o auditorías por institución.

🧠 Lógica de Funcionamiento

La función hace lo siguiente:

  1. Valida los parámetros de ordenamiento para evitar inyecciones o errores.
  2. Une las tablas dpf_lines y dpf mediante dpf_id.
  3. Filtra por institution_id y el campo date del registro de la línea.
  4. Ordena los resultados por la columna deseada.
  5. Limita y pagina los resultados con LIMIT y OFFSET.

⚙️ Sintaxis

function dpf_lines_search_from_to_by_institution(
    string $from, 
    string $to, 
    int $institution_id, 
    int $start = 0, 
    int $limit = 999, 
    string $order_col = "order_by", 
    string $order_way = "desc"
): array

📥 Parámetros

Parámetro Tipo Descripción
$from string Fecha de inicio (YYYY-MM-DD).
$to string Fecha de fin (YYYY-MM-DD).
$institution_id int ID de la institución.
$start int Offset de resultados para paginación.
$limit int Número máximo de resultados.
$order_col string Columna por la que se ordena.
$order_way string Dirección del orden: asc o desc.

📤 Retorno

Devuelve un array de líneas DPF (dpf_lines) que cumplen los criterios, cada una con los siguientes campos:

  • id
  • dpf_id
  • date
  • interest
  • retencion
  • collection_date
  • monthly_interest
  • collected_value
  • deposited_in
  • transferred_to
  • income_type
  • order_by
  • status

📎 Notas

  • Asegúrate de que las fechas estén en el formato correcto.
  • Esta función está optimizada para entornos con gran volumen de datos gracias al uso de paginación.
  • Solo se consideran las líneas de dpf_lines vinculadas a un dpf con el institution_id indicado.