Este commit introduce una refactorización significativa en el módulo de
suscripciones para alinear el sistema con reglas de negocio clave:
facturación consolidada por empresa, cobro a mes adelantado con
imputación de ajustes diferida, y una interfaz de usuario más clara.
Backend:
- **Facturación por Empresa:** Se modifica `FacturacionService` para
agrupar las suscripciones por cliente y empresa, generando una
factura consolidada para cada combinación. Esto asegura la correcta
separación fiscal.
- **Imputación de Ajustes:** Se ajusta la lógica para que la facturación
de un período (ej. Septiembre) aplique únicamente los ajustes
pendientes cuya fecha corresponde al período anterior (Agosto).
- **Cierre Secuencial:** Se implementa una validación en
`GenerarFacturacionMensual` que impide generar la facturación de un
período si el anterior no ha sido cerrado, garantizando el orden
cronológico.
- **Emails Consolidados:** El proceso de notificación automática al
generar el cierre ahora envía un único email consolidado por
suscriptor, detallando los cargos de todas sus facturas/empresas.
- **Envío de PDF Individual:** Se refactoriza el endpoint de envío manual
para que opere sobre una `idFactura` individual y adjunte el PDF
correspondiente si existe.
- **Repositorios Mejorados:** Se optimizan y añaden métodos en
`FacturaRepository` y `AjusteRepository` para soportar los nuevos
requisitos de filtrado y consulta de datos consolidados.
Frontend:
- **Separación de Vistas:** La página de "Facturación" se divide en dos:
- `ProcesosPage`: Para acciones masivas (generar cierre, archivo de
débito, procesar respuesta).
- `ConsultaFacturasPage`: Una nueva página dedicada a buscar,
filtrar y gestionar facturas individuales con una interfaz de doble
acordeón (Suscriptor -> Empresa).
- **Filtros Avanzados:** La página `ConsultaFacturasPage` ahora incluye
filtros por nombre de suscriptor, estado de pago y estado de
facturación.
- **Filtros de Fecha por Defecto:** La página de "Cuenta Corriente"
ahora filtra por el mes actual por defecto para mejorar el rendimiento
y la usabilidad.
- **Validación de Fechas:** Se añade lógica en los filtros de fecha para
impedir la selección de rangos inválidos.
- **Validación de Monto de Pago:** El modal de pago manual ahora impide
registrar un monto superior al saldo pendiente de la factura.
214 lines
11 KiB
C#
214 lines
11 KiB
C#
using Dapper;
|
|
using GestionIntegral.Api.Data;
|
|
using GestionIntegral.Api.Models.Suscripciones;
|
|
using Microsoft.Extensions.Logging;
|
|
using System;
|
|
using System.Collections.Generic;
|
|
using System.Data;
|
|
using System.Linq;
|
|
using System.Text;
|
|
using System.Threading.Tasks;
|
|
|
|
namespace GestionIntegral.Api.Data.Repositories.Suscripciones
|
|
{
|
|
public class FacturaRepository : IFacturaRepository
|
|
{
|
|
private readonly DbConnectionFactory _connectionFactory;
|
|
private readonly ILogger<FacturaRepository> _logger;
|
|
|
|
public FacturaRepository(DbConnectionFactory connectionFactory, ILogger<FacturaRepository> logger)
|
|
{
|
|
_connectionFactory = connectionFactory;
|
|
_logger = logger;
|
|
}
|
|
|
|
public async Task<Factura?> GetByIdAsync(int idFactura)
|
|
{
|
|
const string sql = "SELECT * FROM dbo.susc_Facturas WHERE IdFactura = @idFactura;";
|
|
using var connection = _connectionFactory.CreateConnection();
|
|
return await connection.QuerySingleOrDefaultAsync<Factura>(sql, new { idFactura });
|
|
}
|
|
|
|
public async Task<IEnumerable<Factura>> GetByPeriodoAsync(string periodo)
|
|
{
|
|
const string sql = "SELECT * FROM dbo.susc_Facturas WHERE Periodo = @Periodo ORDER BY IdFactura;";
|
|
using var connection = _connectionFactory.CreateConnection();
|
|
return await connection.QueryAsync<Factura>(sql, new { Periodo = periodo });
|
|
}
|
|
|
|
public async Task<Factura?> GetBySuscriptorYPeriodoAsync(int idSuscriptor, string periodo, IDbTransaction transaction)
|
|
{
|
|
const string sql = "SELECT TOP 1 * FROM dbo.susc_Facturas WHERE IdSuscriptor = @IdSuscriptor AND Periodo = @Periodo;";
|
|
if (transaction == null || transaction.Connection == null)
|
|
{
|
|
throw new ArgumentNullException(nameof(transaction), "La transacción o su conexión no pueden ser nulas.");
|
|
}
|
|
return await transaction.Connection.QuerySingleOrDefaultAsync<Factura>(sql, new { idSuscriptor, Periodo = periodo }, transaction);
|
|
}
|
|
|
|
public async Task<IEnumerable<Factura>> GetListBySuscriptorYPeriodoAsync(int idSuscriptor, string periodo)
|
|
{
|
|
const string sql = "SELECT * FROM dbo.susc_Facturas WHERE IdSuscriptor = @IdSuscriptor AND Periodo = @Periodo;";
|
|
using var connection = _connectionFactory.CreateConnection();
|
|
return await connection.QueryAsync<Factura>(sql, new { idSuscriptor, Periodo = periodo });
|
|
}
|
|
|
|
public async Task<Factura?> CreateAsync(Factura nuevaFactura, IDbTransaction transaction)
|
|
{
|
|
if (transaction == null || transaction.Connection == null)
|
|
{
|
|
throw new ArgumentNullException(nameof(transaction), "La transacción o su conexión no pueden ser nulas.");
|
|
}
|
|
const string sqlInsert = @"
|
|
INSERT INTO dbo.susc_Facturas (IdSuscriptor, Periodo, FechaEmision, FechaVencimiento, ImporteBruto, DescuentoAplicado, ImporteFinal, EstadoPago, EstadoFacturacion)
|
|
OUTPUT INSERTED.*
|
|
VALUES (@IdSuscriptor, @Periodo, @FechaEmision, @FechaVencimiento, @ImporteBruto, @DescuentoAplicado, @ImporteFinal, @EstadoPago, @EstadoFacturacion);";
|
|
|
|
return await transaction.Connection.QuerySingleAsync<Factura>(sqlInsert, nuevaFactura, transaction);
|
|
}
|
|
|
|
public async Task<bool> UpdateEstadoPagoAsync(int idFactura, string nuevoEstadoPago, IDbTransaction transaction)
|
|
{
|
|
if (transaction == null || transaction.Connection == null)
|
|
{
|
|
throw new ArgumentNullException(nameof(transaction), "La transacción o su conexión no pueden ser nulas.");
|
|
}
|
|
const string sql = "UPDATE dbo.susc_Facturas SET EstadoPago = @NuevoEstadoPago WHERE IdFactura = @IdFactura;";
|
|
var rowsAffected = await transaction.Connection.ExecuteAsync(sql, new { NuevoEstadoPago = nuevoEstadoPago, idFactura }, transaction);
|
|
return rowsAffected == 1;
|
|
}
|
|
|
|
public async Task<bool> UpdateNumeroFacturaAsync(int idFactura, string numeroFactura, IDbTransaction transaction)
|
|
{
|
|
if (transaction == null || transaction.Connection == null)
|
|
{
|
|
throw new ArgumentNullException(nameof(transaction), "La transacción o su conexión no pueden ser nulas.");
|
|
}
|
|
const string sql = @"
|
|
UPDATE dbo.susc_Facturas SET
|
|
NumeroFactura = @NumeroFactura,
|
|
EstadoFacturacion = 'Facturado'
|
|
WHERE IdFactura = @IdFactura;";
|
|
var rowsAffected = await transaction.Connection.ExecuteAsync(sql, new { NumeroFactura = numeroFactura, idFactura }, transaction);
|
|
return rowsAffected == 1;
|
|
}
|
|
|
|
public async Task<bool> UpdateLoteDebitoAsync(IEnumerable<int> idsFacturas, int idLoteDebito, IDbTransaction transaction)
|
|
{
|
|
if (transaction == null || transaction.Connection == null)
|
|
{
|
|
throw new ArgumentNullException(nameof(transaction), "La transacción o su conexión no pueden ser nulas.");
|
|
}
|
|
const string sql = "UPDATE dbo.susc_Facturas SET IdLoteDebito = @IdLoteDebito WHERE IdFactura IN @IdsFacturas;";
|
|
var rowsAffected = await transaction.Connection.ExecuteAsync(sql, new { IdLoteDebito = idLoteDebito, IdsFacturas = idsFacturas }, transaction);
|
|
return rowsAffected == idsFacturas.Count();
|
|
}
|
|
|
|
public async Task<IEnumerable<(Factura Factura, string NombreSuscriptor, int IdEmpresa, decimal TotalPagado)>> GetByPeriodoEnrichedAsync(string periodo, string? nombreSuscriptor, string? estadoPago, string? estadoFacturacion)
|
|
{
|
|
var sqlBuilder = new StringBuilder(@"
|
|
WITH FacturaConEmpresa AS (
|
|
-- Esta subconsulta obtiene el IdEmpresa para cada factura basándose en la primera suscripción que encuentra en sus detalles.
|
|
-- Esto es seguro porque nuestra lógica de negocio asegura que todos los detalles de una factura pertenecen a la misma empresa.
|
|
SELECT
|
|
f.IdFactura,
|
|
(SELECT TOP 1 p.Id_Empresa
|
|
FROM dbo.susc_FacturaDetalles fd
|
|
JOIN dbo.susc_Suscripciones s ON fd.IdSuscripcion = s.IdSuscripcion
|
|
JOIN dbo.dist_dtPublicaciones p ON s.IdPublicacion = p.Id_Publicacion
|
|
WHERE fd.IdFactura = f.IdFactura) AS IdEmpresa
|
|
FROM dbo.susc_Facturas f
|
|
WHERE f.Periodo = @Periodo
|
|
)
|
|
SELECT
|
|
f.*,
|
|
s.NombreCompleto AS NombreSuscriptor,
|
|
fce.IdEmpresa,
|
|
(SELECT ISNULL(SUM(Monto), 0) FROM dbo.susc_Pagos pg WHERE pg.IdFactura = f.IdFactura AND pg.Estado = 'Aprobado') AS TotalPagado
|
|
FROM dbo.susc_Facturas f
|
|
JOIN dbo.susc_Suscriptores s ON f.IdSuscriptor = s.IdSuscriptor
|
|
JOIN FacturaConEmpresa fce ON f.IdFactura = fce.IdFactura
|
|
WHERE f.Periodo = @Periodo");
|
|
|
|
var parameters = new DynamicParameters();
|
|
parameters.Add("Periodo", periodo);
|
|
|
|
if (!string.IsNullOrWhiteSpace(nombreSuscriptor))
|
|
{
|
|
sqlBuilder.Append(" AND s.NombreCompleto LIKE @NombreSuscriptor");
|
|
parameters.Add("NombreSuscriptor", $"%{nombreSuscriptor}%");
|
|
}
|
|
if (!string.IsNullOrWhiteSpace(estadoPago))
|
|
{
|
|
sqlBuilder.Append(" AND f.EstadoPago = @EstadoPago");
|
|
parameters.Add("EstadoPago", estadoPago);
|
|
}
|
|
if (!string.IsNullOrWhiteSpace(estadoFacturacion))
|
|
{
|
|
sqlBuilder.Append(" AND f.EstadoFacturacion = @EstadoFacturacion");
|
|
parameters.Add("EstadoFacturacion", estadoFacturacion);
|
|
}
|
|
|
|
sqlBuilder.Append(" ORDER BY s.NombreCompleto, f.IdFactura;");
|
|
|
|
try
|
|
{
|
|
using var connection = _connectionFactory.CreateConnection();
|
|
var result = await connection.QueryAsync<Factura, string, int, decimal, (Factura, string, int, decimal)>(
|
|
sqlBuilder.ToString(),
|
|
(factura, suscriptor, idEmpresa, totalPagado) => (factura, suscriptor, idEmpresa, totalPagado),
|
|
parameters,
|
|
splitOn: "NombreSuscriptor,IdEmpresa,TotalPagado"
|
|
);
|
|
return result;
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
_logger.LogError(ex, "Error al obtener facturas enriquecidas para el período {Periodo}", periodo);
|
|
return Enumerable.Empty<(Factura, string, int, decimal)>();
|
|
}
|
|
}
|
|
|
|
public async Task<bool> UpdateEstadoYMotivoAsync(int idFactura, string nuevoEstadoPago, string? motivoRechazo, IDbTransaction transaction)
|
|
{
|
|
if (transaction == null || transaction.Connection == null)
|
|
{
|
|
throw new ArgumentNullException(nameof(transaction), "La transacción o su conexión no pueden ser nulas.");
|
|
}
|
|
const string sql = @"
|
|
UPDATE dbo.susc_Facturas SET
|
|
EstadoPago = @NuevoEstadoPago,
|
|
MotivoRechazo = @MotivoRechazo
|
|
WHERE IdFactura = @IdFactura;";
|
|
var rowsAffected = await transaction.Connection.ExecuteAsync(sql, new { NuevoEstadoPago = nuevoEstadoPago, MotivoRechazo = motivoRechazo, idFactura }, transaction);
|
|
return rowsAffected == 1;
|
|
}
|
|
|
|
public async Task<string?> GetUltimoPeriodoFacturadoAsync()
|
|
{
|
|
const string sql = "SELECT TOP 1 Periodo FROM dbo.susc_Facturas ORDER BY Periodo DESC;";
|
|
using var connection = _connectionFactory.CreateConnection();
|
|
return await connection.QuerySingleOrDefaultAsync<string>(sql);
|
|
}
|
|
|
|
public async Task<IEnumerable<Factura>> GetFacturasPagadasPendientesDeFacturar(string periodo)
|
|
{
|
|
// Consulta simplificada pero robusta.
|
|
const string sql = @"
|
|
SELECT * FROM dbo.susc_Facturas
|
|
WHERE Periodo = @Periodo
|
|
AND EstadoPago = 'Pagada'
|
|
AND EstadoFacturacion = 'Pendiente de Facturar';";
|
|
try
|
|
{
|
|
using var connection = _connectionFactory.CreateConnection();
|
|
return await connection.QueryAsync<Factura>(sql, new { Periodo = periodo });
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
_logger.LogError(ex, "Error al obtener facturas pagadas pendientes de facturar para el período {Periodo}", periodo);
|
|
return Enumerable.Empty<Factura>();
|
|
}
|
|
}
|
|
}
|
|
} |