Manual de Usuario

1. Inicio de sesión

Al abrir el panel, verás la pantalla de acceso. Usa el mismo usuario o correo y contraseña que en la app iOS.

• Usuario o correo: el que te asignó el administrador (ej. danielzablah o danielzablah@gmail.com).
• Contraseña: la que configuraste en Firebase Authentication (o la que recibiste al darte de alta).
• Acceso alterno: también puedes ingresar con Google o teléfono (SMS) si tu cuenta está vinculada.

¿Olvidaste tu contraseña?

Haz clic en ¿Olvidaste tu contraseña?, ingresa tu usuario o correo y pulsa Enviar enlace. Revisa tu correo y sigue el enlace para restablecer la contraseña.

2. Panel principal (Dashboard)

Tras iniciar sesión, el menú lateral te lleva al Panel (inicio). Ahí verás:

• Saludo y tu nombre.
• Alertas: productos con stock bajo (enlace directo al inventario filtrado).
• Métricas: enlace a Finanzas, ventas de hoy, ventas del mes, ganancia del mes, por cobrar, facturas por vencer (ventana configurable), tu comisión del mes (solo vendedores), pendientes de aprobar (solo administradores), stock bajo.
• Centro de alertas: vista unificada de riesgo por vencimientos en CxC, CxP y Operaciones (severidad alta/media).
• Score y semáforo: cada alerta se prioriza con score y color (rojo, ámbar, verde).
• Ruta sugerida hoy: listado de acciones recomendadas según prioridad de riesgo.
• Botón Gestionar: registra la gestión de la alerta y te abre el módulo correspondiente para ejecutar acción.
• Bitácora diaria: en el panel se muestran alertas gestionadas hoy y altas gestionadas hoy.
• Exportar riesgos PDF: reporte ejecutivo del centro de alertas para seguimiento gerencial.
• Tablero ejecutivo WMS/ERP: KPIs de cumplimiento SLA de operaciones y aging de CxC/CxP.
• Exportar KPIs PDF: reporte ejecutivo del tablero para comité/directiva.

Los números en rojo o con enlace te llevan a la pantalla correspondiente para revisar detalles.

3. Ventas

Desde el menú lateral, Ventas muestra el listado de ventas. Puedes filtrar por estado (completada, pendiente de aprobación, etc.).

Nueva venta

En Ventas, usa el botón Nueva venta. Agrega líneas por código de barras o búsqueda, cantidades y precios. Los descuentos mayores a un cierto porcentaje pueden requerir aprobación de un administrador.

Detalle de venta

Al hacer clic en una venta verás el detalle: líneas, total, estado. Desde ahí puedes registrar pago (por cobrar), aplicar nota de crédito/devolución (admin, con reingreso a inventario) o, si eres admin, aprobar ventas pendientes de aprobación.

4. Inventario

Listado de productos

En Inventario verás la tabla de productos: nombre, código, stock, límite de stock bajo, precio. Puedes:

• Buscar por nombre o código.
• Marcar Solo stock bajo para ver solo los que están por debajo del límite.
• Exportar Excel (botón superior) para descargar el listado.
• Nuevo producto: agregar un producto con código de barras, nombre, precio, costo, cantidad inicial, categoría, marca, proveedor, límite de stock bajo, tasa de impuesto.

Ver y editar producto

Haz clic en el nombre del producto o en Ver para abrir el detalle. Desde el detalle puedes Editar (cambiar nombre, código, precios, categoría, etc.) o registrar movimientos.

Entradas y salidas

Desde Más → Inventario tienes acceso a:

• Ingresos de inventario — Registrar entradas de stock por producto.
• Entrada por lotes (códigos) — Escanear o ingresar códigos de barras para dar de alta cantidades.
• Salidas de inventario — Registrar salidas (mermas, ajustes).
• Registro de movimientos — Historial de movimientos de inventario.

Desde Más → Configuración de inventario se gestionan categorías, marcas y proveedores (y se enlaza con Zonas para comercios).

5. Comercios

Comercios es el listado de clientes/tiendas. Puedes crear un nuevo comercio (nombre, tipo, zona, contacto, etc.), abrir el detalle de uno y editar desde ahí. El detalle muestra la información del comercio y su relación con ventas y rutas.

6. Rutas

Solo administradores

En Rutas se gestionan las rutas de clientes (giras). Puedes crear una ruta nueva o editar una existente, además de iniciar/cerrar giras desde el listado.

• Detalle de gira: desde Historial puedes abrir cada gira para ver y operar su plan de visitas por cliente.
• Visitas: marca cada cliente como visitado, no efectivo, omitido o pendiente, con nota operativa.
• Venta desde visita: botón directo a Nueva venta con cliente preseleccionado y vínculo a la visita.

7. Finanzas

El módulo Finanzas incluye:

• Resumen: ventas hoy, ventas del mes, ganancia del mes, por cobrar (monto y número de facturas), facturas por vencer según ventana configurable. Botón Exportar resumen PDF.
• Desglose por día del mes actual (ventas y total por día).
• Por cobrar: listado de ventas con saldo pendiente y cuentas manuales; puedes crear cuentas por cobrar manuales, editarlas y registrar abonos/cobro total. También se ven los documentos por vencer.
• Por pagar: cuentas por pagar a proveedores; al registrar pago se solicita método de pago y se refleja en tesorería. Incluye exportación PDF y columna de origen (manual/operación).
• Flujo de caja: ingresos y egresos con categoría; puedes asociar cuenta bancaria para impactar saldos/ledger de tesorería. Incluye filtros por tipo/categoría/fecha y exportación PDF.
• Capital: resumen y gestión de cuentas de capital (crear, editar, eliminar), con registro de movimientos e historial.
• Capital por tipo: desglose patrimonial por categoría (aporte de socios, utilidades retenidas, reserva, ajuste patrimonial, otros).
• Operaciones WMS/ERP: enlace al módulo operativo para traspasos, traslados, SOLPED, compras, facturas de proveedor y créditos.

Desde Más → Cuentas bancarias y métodos de pago puedes administrar catálogos de tesorería: crear, editar, activar/desactivar, marcar cuenta bancaria por defecto, controlar saldos y revisar el ledger de movimientos.

7.1 Operaciones WMS / ERP

El módulo Operaciones centraliza procesos operativos y administrativos:

• Registro de Traspaso, Traslado, SOLPED, Compra, Factura de proveedor y Crédito.
• Campos por operación: referencia, origen, destino, proveedor/contraparte, monto, vencimiento y notas.
• Soporte de líneas múltiples por operación (varios productos/cantidades).
• Backlog con filtros por tipo, estado y rango de fechas.
• Cambio de estado operativo: pendiente, en proceso, completado, cancelado.
• Botón Completar + aplicar: ejecuta efectos automáticos por tipo (inventario y/o cuenta por pagar).
• Botón Editar para ajustar encabezado y líneas (mientras no haya sido aplicada).
• Botones Exportar PDF y PDF trazabilidad para reporte operativo y detalle por línea.
• Botón Adjuntar para asociar evidencia por URL (documentos/fotos) a la operación.
• Tablero SLA con operaciones vencidas, por vencer y en tiempo.

8. Contabilidad

Solo administradores

En Contabilidad se accede a reportes contables y exportación en PDF (libro de ventas, resumen de utilidad, ISV, proyección de ventas, estado de resultados, flujo de efectivo, balance general, libro de ingresos y egresos, capital, libro de compras, aging CxC/CxP, etc.).

9. Más (menú secundario)

El menú Más agrupa opciones de cuenta, inventario, finanzas y administración.

Cuenta

• Perfil — Ver y editar nombre, usuario, correo, rol; cambiar contraseña y gestionar métodos de acceso (Google, teléfono y correo/contraseña).
• Mi comisión vendedores — Porcentaje y comisión del mes.
• Viáticos vendedores — Registro y consulta de gastos de viáticos por gira.
• Ver como vendedor admin — Ver el panel y las ventas como otro vendedor; un banner permite volver a tu sesión.

Inventario

• Buscar producto por código — Búsqueda rápida por código de barras.
• Importar / Exportar Excel — Importar productos desde un archivo Excel (columnas: Código, Nombre, Cantidad, Precio, Costo, Límite stock bajo, Categoría, Marca, Proveedor) o exportar productos/ventas. La exportación de ventas incluye resumen y detalle por línea con ISV por ítem.
• Configuración de inventario — Acceso a Categorías, Marcas, Proveedores y enlace a Zonas.
• Zonas (para comercios) — Gestionar zonas para asignar a comercios.
• Enlaces directos a Ingresos, Entrada por lotes, Salidas y Registro de movimientos de inventario.
• Operaciones WMS/ERP — Traspasos, traslados, SOLPED, compras, facturas y créditos en un solo backlog.

Finanzas

• Enlace al Módulo Finanzas (con aviso de facturas por vencer si aplica).
• Cuentas bancarias y métodos de pago — Gestión completa de catálogos (alta, edición, activación y cuenta bancaria por defecto).

Administración

Solo administradores

• Datos de empresa — Nombre, RTN, logo, dirección, teléfono, tasa HNL/USD (usado en PDFs).
• Tipos de comercio — Bar, restaurante, tienda, etc.
• Todos los usuarios — Listar y editar usuarios.
• Vendedores — Filtrar solo vendedores.
• Giras y viáticos — Registro y control de gastos por gira/vendedor.
• Transacciones (auditoría) — Eventos de auditoría del sistema.
• Cumplimiento de alertas — Historial de alertas gestionadas, filtros por fecha, ranking semanal por usuario, metas semanales por usuario (con semáforo), generación de cierre semanal, comparativo WoW, detección de desviaciones automáticas y plan correctivo sugerido por usuario, además de exportación PDF.
• Inconsistencias inventario — Reportes de auditoría de inventario (con aviso de pendientes por revisar).

Rutas de ventas

Solo administradores

• Rutas de clientes — Giras y rutas (desde el menú lateral o desde Más), incluyendo detalle operativo por gira.

10. Roles y permisos

Los usuarios se gestionan en Firebase Authentication; el perfil (rol, nombre, etc.) se guarda en Firestore y lo edita un administrador desde Más → Todos los usuarios.