Tul xxx Tul

Viewing: Manual de uso.md

# SISCAPS – Manual de uso (por módulos)

Este manual explica, de forma breve y práctica, qué hace cada módulo y cómo usarlo en el día a día. La interfaz se adapta a tu rol (ADMIN, CAJERO, LECTOR, CLIENTE) y el menú lateral muestra solo lo que necesitas.

## 1) Primeros pasos

- Iniciar sesión
  - Soy Cliente: Ingresa tu Código de Cliente (no requiere contraseña).
  - Usuario Interno (ADMIN/CAJERO/LECTOR): Ingresa usuario/correo y contraseña.
- Cerrar sesión
  - Usa “Salir” en el menú lateral. Si trabajas con varias sesiones, puedes cerrar solo la del cliente o la interna.

Consejos
- Si ves un aviso “Sesión inválida”, recarga la página e intenta nuevamente.
- Las notificaciones (éxito/error) aparecen en la parte superior tras cada acción.

---

## 2) Dashboard

Para qué sirve
- Resumen general del sistema (internos) o del cliente (portal). Verás tarjetas con indicadores, accesos rápidos y, para clientes, gráficas de consumo.

Acciones típicas
- Internos: entrar a módulos clave (Clientes, Lecturas, Facturas, Pagos).
- Cliente: revisar deuda, última factura, pagos del mes y consumo reciente.

---

## 3) Clientes (ADMIN/CAJERO)

Para qué sirve
- Gestiona el padrón de clientes, su información básica y sus medidores.

Lo más importante
- Crear Cliente
  - Completa datos básicos (nombre, dirección, sector/casa, teléfono, email).
  - El Código de Cliente se genera automáticamente.
  - Registra al menos un medidor (número, estado, lectura inicial).
  - Guarda para ir a la ficha del cliente.
- Editar Cliente
  - Actualiza datos y el medidor asignado. El código de cliente se mantiene.
- Ver Ficha
  - Consulta datos, medidores y facturas abiertas (deuda).
- Eliminar
  - Solo si no tiene lecturas, facturas o pagos asociados.

Tips
- El listado tiene buscador por nombre, código y número de medidor.
- Estados de cliente: Activo, Suspendido, Cancelado.

---

## 4) Lecturas (ADMIN/CAJERO/LECTOR)

Para qué sirve
- Registrar y administrar lecturas de medidores con validaciones.

Lo más importante
- Nueva lectura
  - Selecciona el cliente y el medidor.
  - La lectura anterior se carga automáticamente (o se toma la inicial).
  - La lectura actual no puede ser menor a la anterior.
  - Guarda y se abre el Comprobante de Lectura (voucher).
- Editar lectura
  - Corrige fechas, valores o notas. El cliente de esa lectura no cambia.
- Listado y exportación
  - Filtra por cliente, medidor y fechas. Exporta a CSV.
- Voucher
  - Abre el comprobante para imprimirlo desde el navegador cuando lo necesites.

Tips
- Si un medidor no aparece, verifica que esté asignado al cliente correcto.
- El rol LECTOR solo ve y opera este módulo.

---

## 5) Facturas (ADMIN/CAJERO)

Para qué sirve
- Emitir, consultar y administrar facturas. Generación automática por periodo basada en lecturas.

Lo más importante
- Generar facturas por periodo
  - Indica periodo inicio/fin. El sistema agrega a cada cliente el consumo de lecturas que se superpongan con ese rango.
  - Usa la “Tarifa activa” (global o la asignada al cliente si es válida en la fecha).
- Ver factura
  - Consulta detalle, líneas, consumo facturado y totales. Descarga/Imprime.
- Marcar como pagada
  - Se recalcula automáticamente según los pagos registrados (Pendiente/Parcial/Pagado).
- Editar/Eliminar
  - Ajusta fechas, estado y notas. Puedes eliminar si procede.
- Listado y exportación
  - Filtra por cliente, estado y fechas. Exporta a CSV.

Tips
- Si al generar no salen facturas, revisa que haya lecturas dentro (o superpuestas) al periodo y que exista una tarifa activa.

---

## 6) Pagos (ADMIN/CAJERO)

Para qué sirve
- Registrar y administrar pagos, con control de saldos por factura.

Lo más importante
- Registrar pago
  - Elige cliente y una factura con saldo. Ingresa monto y método (Efectivo, Transferencia, POS, Cheque, Otro).
  - El sistema valida que el monto no supere el saldo.
  - Al guardar, se actualiza el estado de la factura (Pendiente/Parcial/Pagado).
- Recibo
  - Abre el detalle del pago y genera un recibo imprimible o PDF.
- Editar/Eliminar
  - Ajusta un pago y el sistema recalcula el estado de la factura.
- Listado y filtros
  - Busca por cliente, factura, método y fechas.

Tips
- Si no ves facturas al registrar un pago, significa que ese cliente no tiene deudas.

---

## 7) Reportes (ADMIN/CAJERO)

Para qué sirve
- Analítica operativa con tablas, tarjetas y gráficas (Chart.js).

Lo más importante
- Recaudación
  - Filtra por fechas, agrupa por día o mes y visualiza totales y desglose por método de pago.
  - Exporta a CSV con un clic.
- Deuda y Morosos
  - Vistas base para análisis de saldos pendientes.

Tips
- Empieza por Recaudación para obtener cifras claras y rápidas del periodo.

---

## 8) Servicios / Tarifas (ADMIN)

Para qué sirve
- Definir tarifas y su estructura (rangos por m³) y mantener parámetros anuales de costos.

Lo más importante
- Crear/Editar Tarifa
  - Nombre, tipo de sistema (MABE, MAG, PP/PE, MIXTO), fecha de vigencia y estado (Activa/Inactiva).
- Rangos de consumo
  - Agrega o edita rangos (mín–máx m³ y precio por m³).
- Parámetros anuales
  - Carga costos (administración, salarios, energía, químicos, mantenimiento), volumen, pérdidas y tasas.
  - El sistema calcula costo unitario sugerido para apoyar decisiones.
- Activar Tarifa
  - Selecciona la que debe aplicarse por defecto.

Tips
- Para clientes con tarifa específica, el sistema la usa si está vigente en la fecha de emisión.

---

## 9) Usuarios (ADMIN)

Para qué sirve
- Gestionar cuentas internas: ADMIN, CAJERO, LECTOR.

Lo más importante
- Crear usuario
  - Define usuario, correo, rol y contraseña.
- Editar usuario
  - Actualiza datos y, si quieres, la contraseña. Si editas tu propia cuenta, la sesión se actualiza.
- Activar/Desactivar
  - Útil cuando no se puede eliminar por registros asociados.
- Eliminar
  - Restringido si el usuario tiene registros relacionados (ej., pagos).

Tips
- No puedes eliminar ni desactivar tu propia cuenta desde estas acciones de seguridad.

---

## 10) Portal del Cliente (CLIENTE)

Para qué sirve
- Autogestión: ver facturas y pagos, revisar consumos y actualizar datos.

Lo más importante
- Mis Facturas
  - Consulta facturas con filtros, abre el detalle y descarga/Imprime.
- Mis Pagos
  - Historial de pagos con detalle y recibos imprimibles.
- Mi Consumo
  - Gráfica de los últimos 12 meses y listado de lecturas recientes (Chart.js).
- Mi Perfil
  - Actualiza nombre, dirección, teléfono y correo.
  - Cambia tu contraseña (valida la actual y longitud mínima).

Tips
- La seguridad impide que veas datos de otros clientes; si un enlace no abre, puede ser por protección de acceso.

---

## 11) Exportar e imprimir

- CSV: Listados (Lecturas, Facturas, Pagos, Recaudación) ofrecen botón de exportación.
- PDF/Imprimible: Facturas y Recibos abren versión PDF o imprimible del navegador.
- Gráficas: Integradas con Chart.js, se generan al cargar la página.

---

## 12) Resolución rápida de problemas

- No aparece un medidor al cargar una lectura
  - Verifica que el medidor esté asignado al cliente correcto.
- No se generan facturas del periodo
  - Revisa lecturas en el rango, y confirma que tengas una tarifa activa.
- No ves facturas para registrar pago
  - Ese cliente no tiene deudas; elige otro cliente o revisa filtros.
- Mensaje “Sesión inválida”
  - Recarga la página y vuelve a enviar el formulario.

---
User / IP	: 216.73.217.33
Host / Server	: 45.84.207.204 / aircan.me
System	: Linux lt-bnk-web1726.main-hosting.eu 5.14.0-611.36.1.el9_7.x86_64 #1 SMP PREEMPT_DYNAMIC Tue Mar 3 11:23:52 EST 2026 x86_64