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.
120 lines
5.2 KiB
C#
120 lines
5.2 KiB
C#
using GestionIntegral.Api.Dtos.Suscripciones;
|
|
using GestionIntegral.Api.Services.Suscripciones;
|
|
using Microsoft.AspNetCore.Authorization;
|
|
using Microsoft.AspNetCore.Mvc;
|
|
using System.Security.Claims;
|
|
|
|
namespace GestionIntegral.Api.Controllers.Suscripciones
|
|
{
|
|
[Route("api/facturacion")]
|
|
[ApiController]
|
|
[Authorize]
|
|
public class FacturacionController : ControllerBase
|
|
{
|
|
private readonly IFacturacionService _facturacionService;
|
|
private readonly ILogger<FacturacionController> _logger;
|
|
private const string PermisoGestionarFacturacion = "SU006";
|
|
private const string PermisoEnviarEmail = "SU009";
|
|
|
|
public FacturacionController(IFacturacionService facturacionService, ILogger<FacturacionController> logger)
|
|
{
|
|
_facturacionService = facturacionService;
|
|
_logger = logger;
|
|
}
|
|
|
|
private bool TienePermiso(string codAcc) => User.IsInRole("SuperAdmin") || User.HasClaim(c => c.Type == "permission" && c.Value == codAcc);
|
|
|
|
private int? GetCurrentUserId()
|
|
{
|
|
if (int.TryParse(User.FindFirstValue(ClaimTypes.NameIdentifier) ?? User.FindFirstValue("sub"), out int userId)) return userId;
|
|
_logger.LogWarning("No se pudo obtener el UserId del token JWT en FacturacionController.");
|
|
return null;
|
|
}
|
|
|
|
[HttpPut("{idFactura:int}/numero-factura")]
|
|
[ProducesResponseType(StatusCodes.Status204NoContent)]
|
|
public async Task<IActionResult> UpdateNumeroFactura(int idFactura, [FromBody] string numeroFactura)
|
|
{
|
|
if (!TienePermiso(PermisoGestionarFacturacion)) return Forbid();
|
|
|
|
var userId = GetCurrentUserId();
|
|
if (userId == null) return Unauthorized();
|
|
|
|
var (exito, error) = await _facturacionService.ActualizarNumeroFactura(idFactura, numeroFactura, userId.Value);
|
|
|
|
if (!exito)
|
|
{
|
|
if (error != null && error.Contains("no existe")) return NotFound(new { message = error });
|
|
return BadRequest(new { message = error });
|
|
}
|
|
return NoContent();
|
|
}
|
|
|
|
// POST: api/facturacion/{idFactura}/enviar-factura-pdf
|
|
[HttpPost("{idFactura:int}/enviar-factura-pdf")]
|
|
public async Task<IActionResult> EnviarFacturaPdf(int idFactura)
|
|
{
|
|
if (!TienePermiso("SU009")) return Forbid();
|
|
|
|
var (exito, error) = await _facturacionService.EnviarFacturaPdfPorEmail(idFactura);
|
|
|
|
if (!exito)
|
|
{
|
|
return BadRequest(new { message = error });
|
|
}
|
|
return Ok(new { message = "Email con factura PDF enviado a la cola de procesamiento." });
|
|
}
|
|
|
|
// POST: api/facturacion/{anio}/{mes}/suscriptor/{idSuscriptor}/enviar-aviso
|
|
[HttpPost("{anio:int}/{mes:int}/suscriptor/{idSuscriptor:int}/enviar-aviso")]
|
|
[ProducesResponseType(StatusCodes.Status200OK)]
|
|
[ProducesResponseType(StatusCodes.Status400BadRequest)]
|
|
[ProducesResponseType(StatusCodes.Status404NotFound)]
|
|
public async Task<IActionResult> EnviarAvisoPorEmail(int anio, int mes, int idSuscriptor)
|
|
{
|
|
// Usamos el permiso de enviar email
|
|
if (!TienePermiso("SU009")) return Forbid();
|
|
|
|
var (exito, error) = await _facturacionService.EnviarAvisoCuentaPorEmail(anio, mes, idSuscriptor);
|
|
|
|
if (!exito)
|
|
{
|
|
if (error != null && (error.Contains("no encontrada") || error.Contains("no es válido")))
|
|
{
|
|
return NotFound(new { message = error });
|
|
}
|
|
return BadRequest(new { message = error });
|
|
}
|
|
|
|
return Ok(new { message = "Email consolidado para el suscriptor ha sido enviado a la cola de procesamiento." });
|
|
}
|
|
|
|
// GET: api/facturacion/{anio}/{mes}
|
|
[HttpGet("{anio:int}/{mes:int}")]
|
|
public async Task<IActionResult> GetFacturas(
|
|
int anio, int mes,
|
|
[FromQuery] string? nombreSuscriptor,
|
|
[FromQuery] string? estadoPago,
|
|
[FromQuery] string? estadoFacturacion)
|
|
{
|
|
if (!TienePermiso(PermisoGestionarFacturacion)) return Forbid();
|
|
if (anio < 2020 || mes < 1 || mes > 12) return BadRequest(new { message = "El período no es válido." });
|
|
|
|
var resumenes = await _facturacionService.ObtenerResumenesDeCuentaPorPeriodo(anio, mes, nombreSuscriptor, estadoPago, estadoFacturacion);
|
|
return Ok(resumenes);
|
|
}
|
|
|
|
|
|
[HttpPost("{anio:int}/{mes:int}")]
|
|
public async Task<IActionResult> GenerarFacturacion(int anio, int mes)
|
|
{
|
|
if (!TienePermiso(PermisoGestionarFacturacion)) return Forbid();
|
|
var userId = GetCurrentUserId();
|
|
if (userId == null) return Unauthorized();
|
|
if (anio < 2020 || mes < 1 || mes > 12) return BadRequest(new { message = "El año y el mes proporcionados no son válidos." });
|
|
var (exito, mensaje, facturasGeneradas) = await _facturacionService.GenerarFacturacionMensual(anio, mes, userId.Value);
|
|
if (!exito) return StatusCode(StatusCodes.Status500InternalServerError, new { message = mensaje });
|
|
return Ok(new { message = mensaje, facturasGeneradas });
|
|
}
|
|
}
|
|
} |