1. Manejo del Inicio y Cierre de Sesión

• Paso 1 (Credenciales): Ingresa tu correo institucional y contraseña. Por seguridad bancaria, el sistema jamás autocompleta ni guarda tus datos al recargar o abrir otra pestaña.
• Paso 2 (Captcha Dinámico): Escribe los 6 caracteres alfanuméricos del recuadro azul. Puedes refrescarlo con el botón .
• Paso 3 (Código 2FA por Correo): Al pulsar "Continuar y Enviar Código 2FA", recibirás en tu correo un código único de 6 dígitos con vigencia temporal.
• Cierre Automático por Inactividad: Si no mueves el ratón ni tecleas durante el tiempo configurado (ej. 15 min), la sesión se cierra sola para proteger la información financiera.

2. Controles Comunes en Todos los Reportes

• Selector de Empresa (PROCA / SCULT): Permite alternar entre la base de datos de Procables (PROCA) o Sculptor (SCULT).
• Doble Barra de Desplazamiento Horizontal: En todas las matrices anchas dispones de un deslizador "Desplazar tabla" en la parte superior y otro al pie de la tabla que se mueven sincronizados.
• Ordenamiento por Columna (⇅): Al hacer clic en cualquier encabezado de columna, la tabla ordena de mayor a menor o alfabéticamente.
• Exportación a Excel (.xlsx) y CSV: Todos los reportes cuentan con botón verde para descargar la tabla respetando los filtros activos en pantalla.

📌 1. ¿Qué es "Venta de Inventario Puro"? Proviene del kárdex de movimientos de producto (invt_producto_movimientos). Suma salidas por venta (FT, FA, FC, FAC, FV) y resta entradas por devolución (RT, NC, DEV, DV). Excluye el grupo SERVI (fletes, maniobras, cargos administrativos) y excluye Anticipos para reflejar únicamente el desplazamiento real de mercancía física sin IVA.

💱 2. Conversión Automática USD a MXN (Tipo de Cambio del Documento) Todos los reportes de ventas, rentabilidad, comparativos e inventarios consolidan sus importes en Moneda Nacional (MXN). Cuando una factura o partida fue emitida en Dólares (US / USD / DLS), el sistema convierte el importe multiplicándolo por el tipo de cambio registrado en el propio documento en MBA3 (evaluando en orden de prelación: 1° cotizacion_movimiento, 2° cotizacionrefpedido, 3° cotizacion fiscal de la factura y 4° cotizacioncomercial de la factura), garantizando exactitud total tanto en PROCA como en SCULT.

🏢 3. Almacenes Operativos vs No Operativos En cálculos de ventas, resurtido, valor de inventario y sin rotación se consideran las 17 sucursales operativas y sus bodegas de venta. Se excluyen automáticamente bodegas de Garantías (GAR), Mermas (MRM), Obsoletos, Inactivas y Tránsito (TRN) (excepto en el reporte específico de Tránsito).

🧾 4. Separación de Anticipos y Notas de Crédito Los Anticipos (tipos FANT, ANT, ANTICIPO en clnt_factura_principal) y las Notas de Crédito Financieras (tipos NC02, NC03, NC04 en ntdc_client_prov_principal por pronto pago, bonificación o descuento financiero) se consultan en métricas dedicadas para no distorsionar el costo ni el margen del inventario físico.

🎯 Propósito y Explicación de Uso:

Permite auditar la rentabilidad comercial de un día específico factura por factura, por vendedor y por sucursal, detectando de inmediato ventas con margen bajo o negativo.

🛠️ Cómo se maneja:

1. Selecciona la Fecha de Consulta, la Empresa (PROCA / SCULT), Zona, Sucursal o Vendedor y presiona "Filtrar".
2. Revisa las tarjetas superiores con la Venta Neta del Día, Costo Total, Utilidad Bruta ($) y Margen Promedio (%).
3. En la tabla inferior puedes inspeccionar cada factura emitida y hacer clic para ver el desglose de productos vendidos en ese comprobante.

📐 Fórmulas y Cálculos Aplicados:

• Venta Neta ($) = Subtotal Facturado sin IVA - Descuentos Aplicados
• Costo Total ($) = Σ (Cantidad Vendida × Costo Promedio Unitario MBA3 al momento de la salida)
• Utilidad Bruta ($) = Venta Neta ($) - Costo Total ($)
• Margen de Rentabilidad (%) = (Utilidad Bruta / Venta Neta) × 100

🗄️ Datos Obtenidos (Origen MBA3):

Tablas clnt_factura_principal, clnt_factura_detalle e invt_producto_movimientos. Considera únicamente facturas vigentes (anulada = FALSE y confirmado = TRUE), convirtiendo facturas en USD al tipo de cambio del día de emisión.

🎯 Propósito y Explicación de Uso:

Evalúa la utilidad bruta y el margen comercial acumulado en cualquier rango de fechas (semanal, quincenal, mensual o trimestral), agrupando resultados por sucursal, zona, vendedor y línea de negocio.

🛠️ Cómo se maneja:

1. Define Fecha Inicio y Fecha Fin en los selectores superiores.
2. Filtra opcionalmente por Empresa, Zona Geográfica, Sucursal o Vendedor y pulsa "Consultar Periodo".
3. Compara en las gráficas y tablas de resumen quién aporta mayor volumen de venta vs quién aporta mayor utilidad real en pesos.

📐 Fórmulas y Cálculos Aplicados:

• Venta Neta Acumulada = Σ Ventas Facturadas sin IVA del periodo - Devoluciones sobre Venta
• Utilidad Acumulada ($) = Σ Venta Neta Acumulada - Σ Costo de Ventas del Periodo
• Margen Ponderado (%) = (Utilidad Acumulada / Venta Neta Acumulada) × 100
• Participación de Utilidad (%) = (Utilidad del Vendedor o Sucursal / Utilidad Total Empresa) × 100

🗄️ Datos Obtenidos (Origen MBA3):

Cruce de clnt_factura_principal, clnt_factura_detalle e invt_producto_movimientos filtrado por rango de fechas, homologado con el catálogo unificado de Zonas y Sucursales del portal.

🎯 Propósito y Explicación de Uso:

Presenta a la Dirección General el Estado de Resultados (P&L) y los indicadores financieros clave del ejercicio o mes seleccionado, mostrando la cascada desde los Ingresos Brutos hasta la Utilidad Operativa y Neta.

🛠️ Cómo se maneja:

1. Selecciona el Año, Mes o Periodo y la Empresa.
2. Consulta los bloques de Ingresos, Costo de Ventas, Gastos de Operación (OPEX) y Resultado Neto, así como el porcentaje que representa cada rubro sobre las Ventas Netas.

📐 Fórmulas y Cálculos Aplicados:

• Ventas Netas = Ventas Brutas Facturadas - Devoluciones y Bonificaciones
• Utilidad Bruta = Ventas Netas - Costo de lo Vendido
• Utilidad Operativa (EBIT) = Utilidad Bruta - Gastos de Venta y Administración (OPEX)
• % Sobre Venta = (Monto del Rubro Contable / Ventas Netas) × 100

🗄️ Datos Obtenidos (Origen MBA3):

Pólizas y saldos contables (cont_movimientos, cont_cuentas) conciliados con la facturación comercial (clnt_factura_principal) e inventario (invt_producto_movimientos).

🎯 Propósito y Explicación de Uso:

Analiza el ritmo de facturación por día y por franja horaria mediante un Mapa de Calor con Semáforo Configurable, ideal para identificar horas pico de facturación, horas muertas en mostrador y carga operativa por sucursal.

🛠️ Cómo se maneja:

1. Selecciona Fecha Inicio, Fecha Fin, Presentación (Diario, Semanal, Mensual), Intervalo (Por Hora o Cada 30 min), Empresa, Zona, Sucursal y Vendedor, y haz clic en "Filtrar".
2. En Configuración Personalizada de Rangos del Semáforo puedes ajustar el Tope Bajo (Rojo) y Tope Medio (Amarillo) tanto en pesos ($) como en número de facturas (#) y pulsar "Aplicar Criterios".
3. Alterna el mapa de calor entre vista por $ Monto ($) y # No. Documentos o descárgalo con "Descargar Excel (.xlsx)".

📐 Fórmulas y Cálculos Aplicados:

• Venta Total Facturada = Σ Monto Total de Facturas Vigentes en el rango
• Ticket Promedio ($) = Venta Total Facturada / Número de Facturas Emitidas
• Hora Pico de Ventas = Franja horaria con mayor monto acumulado en el periodo
• Semáforo Horario = Rojo (≤ Tope Bajo), Amarillo (> Tope Bajo y ≤ Tope Medio), Verde (> Tope Medio)

🗄️ Datos Obtenidos (Origen MBA3):

Tabla clnt_factura_principal cruzando los campos fecha_factura y hora de emisión del comprobante, filtrando comprobantes vigentes (anulada = FALSE).

🎯 Propósito y Explicación de Uso:

Muestra el desempeño mes a mes (Enero a Diciembre + Total Anual) de cada vendedor para el año seleccionado (a partir de 2024), permitiendo evaluar no solo cuánto vendió, sino su utilidad, margen, cartera de clientes, cotizaciones, pedidos, cancelaciones y notas de crédito.

🛠️ Cómo se maneja:

1. En la barra superior elige la Empresa (PROCA/SCULT), el Mes (o Todo el Año) y el Año (2024, 2025, 2026).
2. Usa el selector de Vista: Desglosado (Vendedor + Sucursal) muestra en qué sucursal vendió cada ejecutivo; Consolidado (Total por Vendedor) suma todas las sucursales de un mismo vendedor en una sola fila.
3. Cambia el selector de Métrica (16 opciones) para transformar toda la tabla entre Ventas de Inventario Puro ($), Utilidad ($), Margen (%), Anticipos, Clientes Únicos, Facturas, Cancelados, Notas de Crédito (NC02-NC04), Cotizaciones y Pedidos.
4. El botón "Clasificar Vendedores (PDV / Proyectos)" permite abrir el clasificador rápido sin salir del reporte.

📐 Fórmulas y Cálculos Aplicados:

• Venta Inventario Puro ($) = Σ Salidas Venta (FT,FA,FC,FAC,FV) - Σ Entradas Devolución (RT,NC,DEV,DV) (sin IVA, sin grupo SERVI).
• Utilidad Bruta ($) = Venta Inventario Puro ($) - Costo Total Kárdex ($)
• Margen Real (%) = (Utilidad Bruta / Venta Inventario Puro) × 100
• % Efectividad Cotizaciones = (Cotizaciones Confirmadas / Total Cotizaciones Emitidas) × 100

🗄️ Datos Obtenidos (Origen MBA3):

Movimientos de inventario (invt_producto_movimientos) vinculados a facturas (clnt_factura_principal para obtener el vendedor y sucursal de cada transacción), ntdc_client_prov_principal para Notas de Crédito financieras (NC02, NC03, NC04) y clnt_pedidos_principal para Cotizaciones (CT) y Pedidos (PE, OC).

🎯 Propósito y Explicación de Uso:

Sucursales concentra el rendimiento mensual de los 17 puntos de venta/CEDIS operativos, mientras que Zonas agrupa dichas sucursales en regiones estratégicas (Zona Centro, Zona Sur, Zona Norte, Zona Online) con desglose interactivo.

🛠️ Cómo se maneja:

1. Selecciona el Año (2024 en adelante) y la Métrica deseada (Ventas Inventario Puro, Utilidad, Margen %, Anticipos, Clientes, Facturas, Cancelaciones, Notas de Crédito, Cotizaciones o Pedidos).
2. En el reporte de Zonas, haz clic sobre el nombre de cualquier Zona para desplegar (drill-down) las sucursales que la integran.
3. Con el botón "Organizar Zonas y Sucursales" puedes reasignar una sucursal de zona en vivo y recalcular la matriz al instante.

📐 Fórmulas y Cálculos Aplicados:

• Venta Mensual Sucursal = Σ Venta Inventario Puro de las bodegas operativas asignadas a la sucursal
• Venta Mensual Zona = Σ Venta Mensual de las sucursales activas pertenecientes a esa Zona
• % Participación (Share) = (Venta Anual de la Sucursal o Zona / Venta Anual Total Empresa) × 100

🗄️ Datos Obtenidos (Origen MBA3):

invt_producto_movimientos mapeado por código de bodega/almacén hacia las 17 sucursales oficiales del catálogo maestro unificado, excluyendo almacenes inactivos, mermas y garantías.

🎯 Propósito y Explicación de Uso:

Muestra el historial mensual de compras (Enero a Diciembre) de cada cliente registrado, identificando su Vendedor Actual Asignado, su volumen de compra, la utilidad que deja a la empresa y sus notas de crédito o cancelaciones.

🛠️ Cómo se maneja:

1. Selecciona el Año y la Métrica (Ventas Inventario Puro, Utilidad, Margen %, Anticipos, Facturas Emitidas, Facturas Canceladas o Notas de Crédito).
2. Usa el buscador instantáneo para localizar un cliente por su código MBA3, razón social o nombre del vendedor asignado.

📐 Fórmulas y Cálculos Aplicados:

• Venta Neta por Cliente = Σ Salidas de Inventario facturadas al cliente - Devoluciones del cliente
• Margen Cliente (%) = ((Venta Neta Cliente - Costo Kárdex Cliente) / Venta Neta Cliente) × 100
• Vendedor Actual = Vendedor de su última factura vigente o vendedor titular en ficha maestra

🗄️ Datos Obtenidos (Origen MBA3):

invt_producto_movimientos, clnt_factura_principal y catálogo clnt_ficha_principal. Se excluyen cuentas genéricas de "Ventas de Mostrador / Público en General" cuando se analiza cartera nominal.

🎯 Propósito y Explicación de Uso:

Estos tres reportes cruzan las familias de producto (Grupo → Subgrupo, como CNDMX, SQD, QUALI, ARGOS, BTICI, LEVIT) contra Sucursales, Zonas o Vendedores para conocer qué marcas se venden más y con qué margen en cada plaza.

🛠️ Cómo se maneja:

1. Haz clic en el icono ▸ junto a cualquier GRUPO (o usa el botón "Expandir / Colapsar") para abrir el detalle de todos sus Subgrupos.
2. En Ventas x Grupo x Sucursal usa el filtro "Todas las Sucursales" para aislar una sola sucursal o comparar las 17 en paralelo.
3. En Ventas x Grupo x Vendedor puedes filtrar por Tipo de Vendedor (PDV o PROYECTO), elegir un vendedor específico y cambiar entre 5 vistas: Ventas ($), Utilidad ($), % Margen, % Participación o Vista Completa (V / U / P).

📐 Fórmulas Exactas de las 4 Columnas por Sucursal / Zona:

• VENTA ($): Venta neta de inventario puro del Grupo/Subgrupo en esa Sucursal o Zona.
• % UTIL (Margen de Utilidad): (Utilidad Bruta del Grupo en la Sucursal / Venta del Grupo en la Sucursal) × 100. Se pinta en verde (≥15%) o rojo (<15%).
• % SUC / % ZONA (Peso Local): (Venta del Grupo en esa Sucursal / Venta Total de TODOS los grupos en esa misma Sucursal) × 100. La suma vertical de esta columna en cada sucursal da el 100%.
• % GLOBAL (Peso Empresa): (Venta del Grupo en esa Sucursal / Venta Total Global de toda la Empresa) × 100.

🗄️ Datos Obtenidos (Origen MBA3):

invt_producto_movimientos unido al catálogo maestro de artículos invt_ficha_principal (campos grupo y subgrupo), excluyendo el grupo SERVI.

🎯 Propósito y Explicación de Uso:

Monitorea exclusivamente el posicionamiento, desplazamiento en piezas, facturación y rentabilidad de las tres marcas propias de Procables: ALPHA, SERLIGHT (SERLI) e IDEAL.

🛠️ Cómo se maneja:

1. Filtra por una marca específica (ALPHA, SERLIGHT, IDEAL) o deja "Todas las Marcas De Casa".
2. Alterna entre Monto ($) y Piezas (Unidades).
3. Navega por sus 5 pestañas de análisis: 1) Por Marca / Subgrupo, 2) Por Sucursal, 3) Por Zona, 4) Por Vendedor y 5) Detalle SKUs (código por código).

📐 Fórmulas y Cálculos Aplicados:

• Venta De Casa ($) = Σ Venta Neta de productos con grupo ALPHA, SERLI/SERLIGHT o IDEAL
• % Participación en Empresa = (Venta Total De Casa / Venta Total de Inventario de toda la Empresa) × 100
• Margen Marca Propia (%) = ((Venta De Casa - Costo Kárdex De Casa) / Venta De Casa) × 100

🗄️ Datos Obtenidos (Origen MBA3):

invt_producto_movimientos e invt_ficha_principal filtrando estrictamente los grupos de marca propia sobre almacenes operativos.

🎯 Propósito y Explicación de Uso:

• Cartera de Clientes: Muestra la antigüedad de saldos por cobrar a una Fecha de Corte seleccionable, separando la deuda vigente (En Tiempo) de la deuda vencida por cubetas de atraso (1–30, 31–60, 61–90 y +90 días).
• Análisis de Crédito: Evalúa el riesgo crediticio comparando el Límite de Crédito Autorizado de cada cliente contra su saldo utilizado, mostrando el crédito disponible y el estatus de bloqueo.
• Clientes de Crédito (Tablero Directivo): Resumen ejecutivo de cobranza con indicadores de cartera vencida, porcentaje de morosidad y días promedio de pago.

📐 Fórmulas y Cálculos Aplicados:

• Saldo Total en Cartera = Σ Saldo Pendiente de Facturas Vigentes a la Fecha de Corte
• Días de Mora = Fecha de Corte - Fecha de Vencimiento de la Factura (si es ≤ 0 está En Tiempo; si es > 0 está Vencido).
• Crédito Disponible ($) = Límite de Crédito Autorizado - Saldo Total Utilizado
• % Utilización de Línea = (Saldo Total Utilizado / Límite de Crédito Autorizado) × 100

🗄️ Datos Obtenidos (Origen MBA3):

Ficha maestra de clientes (clnt_ficha_principal para límites y plazos de crédito) y documentos por cobrar con saldo pendiente en clnt_factura_principal.

🎯 Propósito y Explicación de Uso:

Rastrea toda la mercancía que salió de un almacén de origen (mediante transferencia inter-almacén) pero que la sucursal destino aún no ha recepcionado, evitando pérdidas o retrasos logísticos.

🛠️ Cómo se maneja:

1. Filtra por Sucursal/Bodega Origen, Sucursal/Bodega Destino o nivel de alerta del semáforo.
2. Usa el buscador para encontrar un número de documento de transferencia, código de producto o descripción.

📐 Fórmulas y Cálculos Aplicados:

• Días en Tránsito = Fecha Actual - Fecha de Envío de la Transferencia
• Valor en Tránsito ($) = Cantidad Enviada Pendiente × Costo Promedio Unitario MBA3
• Semáforo de Antigüedad: Verde (Normal, ≤ 3 días), Amarillo (Alerta, 4 a 7 días), Rojo (Crítico, > 7 días sin recibir).

🗄️ Datos Obtenidos (Origen MBA3):

Transferencias entre bodegas y saldos activos en almacenes de tránsito (TRN) dentro de invt_producto_movimientos e invt_producto_saldos.

🎯 Propósito y Explicación de Uso:

Calcula automáticamente cuántas unidades necesita pedir o transferir cada sucursal combinando su velocidad real de venta diaria, los pedidos de clientes pendientes de surtir, su existencia física actual y la mercancía que ya viene en camino.

🛠️ Cómo se maneja:

1. Elige el Modo de Cálculo: Proceso Completo (Confirmados + Sin Confirmar) o Solo Confirmados.
2. Selecciona la Sucursal, la Ventana de Ventas (7, 15, 30, 60 o 90 días), el filtro de Grupo/Subgrupo y si deseas ocultar productos Condumex.
3. Auditoría de Documentos (Drill-down): Haz clic en el botón "DOCS" de cualquier fila para abrir una ventana emergente con todas las Facturas (FA), Pedidos de Venta (PE), Tránsitos (TR), Órdenes de Compra (OC) y Recepciones (RP) que integran el cálculo de ese producto.

📐 Fórmulas Exactas del Motor de Resurtido:

• Promedio Venta / Día = Unidades Netas Vendidas en el Periodo (ej. 30d) / Días del Periodo (30)
• Demanda Total Requerida = Unidades Vendidas en el Periodo + Pedidos de Venta Pendientes (PE Conf. + PE Sin Conf.)
• Stock Disponible + En Camino = Existencia Física Actual + Tránsito (Conf. + Sin Conf.) + Órdenes de Compra a Proveedor (OC) + Recepciones en Proceso (RP)
• CANTIDAD REQUERIDA A RESURTIR = MAX(0, Demanda Total Requerida - Stock Disponible + En Camino)
• Valor Estimado de Resurtido ($) = Cantidad Requerida × Costo Promedio Unitario MBA3

🗄️ Datos Obtenidos (Origen MBA3):

Integra en tiempo real 5 fuentes de MBA3: invt_producto_saldos (existencia física), invt_producto_movimientos (ventas y tránsitos), clnt_pedidos_principal/detalle (pedidos de clientes PE) y prov_ordenes_compra_principal/detalle (OC y recepciones RP).

🎯 Propósito y Explicación de Uso:

• Productos Menos Vendidos: Lista los artículos que sí tuvieron al menos una venta en el periodo, pero se encuentran en el fondo del ranking comercial (por menor monto en pesos o menor cantidad de piezas), comparándolo contra el stock que sigue almacenado.
• Productos sin Rotación (Inventario Inmovilizado): Detecta productos que tienen Existencia Física > 0 hoy en almacén, pero registran CERO ventas durante los últimos 3, 6, 9, 12, 13, 18, 24 o 36 meses, permitiendo diseñar promociones de liquidación o traspasos entre sucursales.

📐 Fórmulas y Cálculos Aplicados:

• Valor Inmovilizado ($) = Existencia Física Actual en Almacenes Operativos × Costo Unitario Promedio MBA3
• Días sin Venta = Fecha Actual - Fecha de la Última Factura de Venta del Producto
• % Capital Inmovilizado = (Valor Inmovilizado sin Rotación / Valor Total del Inventario) × 100

🗄️ Datos Obtenidos (Origen MBA3):

Cruza invt_producto_saldos (artículos con saldo físico positivo en bodegas operativas) contra el historial completo de salidas de venta en invt_producto_movimientos.

🎯 Propósito y Explicación de Uso:

Audita el nivel de servicio (Fill Rate) de los proveedores comparando lo que Compras pidió en cada Orden de Compra (OC) contra lo que Almacén realmente recibió y confirmó en su Recepción de Compra (RP).

🛠️ Cómo se maneja:

1. Selecciona el Mes/Periodo, el tipo de órdenes (Recepcionadas Completas + Parciales o Todas), Sucursal/Zona, Bodega y Proveedor.
2. Alterna entre la vista "Por Producto (OC + RP)" (detalle línea por línea de cada artículo pedido vs recibido) y "Agrupado por Orden (OC)" (resumen por folio de orden de compra).
3. Identifica en la columna final el nombre del Usuario Confirmador que dio entrada a la mercancía en MBA3.

📐 Fórmulas y Cálculos Aplicados:

• Faltantes por Recibir (Piezas) = MAX(0, Unidades Ordenadas en OC - Unidades Recepcionadas en RP)
• % Cumplimiento del Proveedor = (Unidades Recepcionadas RP / Unidades Ordenadas OC) × 100
• Valor Recibido ($) = Unidades Recepcionadas RP × Costo Unitario pactado en la OC (en MXN)
• Valor Faltante ($) = Unidades Faltantes × Costo Unitario OC

🗄️ Datos Obtenidos (Origen MBA3):

Tablas prov_ordenes_compra_principal, prov_ordenes_compra_detalle y movimientos de recepción de mercancía (RP) en invt_producto_movimientos.

🎯 Propósito y Explicación de Uso:

• Valor Inventario (Ejecutivo): Tablero financiero de control del capital invertido en almacenes, con distribución por bodega y familia.
• Valor Inventario x Sucursal: Desglosa cuánto vale hoy el inventario físico de cada una de las 17 sucursales operativas, cuántas piezas y cuántos códigos (SKUs) activos aloja cada plaza.
• Valor Inventario x Grupo: Matriz cruzada desplegable (Grupo → Subgrupo en filas vs Sucursales en columnas) que permite alternar entre Valor en Pesos ($) y Existencia en Piezas.

📐 Fórmulas y Cálculos Aplicados:

• Valor Inventario Producto ($) = Existencia Física Actual × Costo Promedio Ponderado Unitario MBA3
• % Share Sucursal = (Valor Inventario de la Sucursal / Valor Total Inventario Empresa) × 100
• % Share Grupo = (Valor Inventario del Grupo o Marca / Valor Total Inventario Empresa) × 100

🗄️ Datos Obtenidos (Origen MBA3):

Saldos actuales en invt_producto_saldos unidos a costos unitarios vigentes en invt_ficha_principal sobre bodegas operativas (excluyendo mermas, garantías e inactivos).

🎯 Propósito y Explicación de Uso:

Integra en una sola plataforma los reportes corporativos de Sell-Out (desplazamiento de ventas) y Stock (existencias por sucursal) requeridos para la negociación y seguimiento con los fabricantes estratégicos Bticino y Leviton, además de incluir pestañas internas de Ventas por Vendedor y Auditoría Fiscal SAT (RFC/CP/UUID).

🛠️ Cómo se maneja:

1. Selecciona el Proveedor (BTICINO o LEVITON), la Empresa y el Rango de Fechas (Inicio y Fin).
2. Haz clic en "Consultar" para ver por cada código de producto las unidades vendidas, el importe vendido y la existencia física actual desglosada en cada sucursal.
3. Usa las pestañas superiores del módulo si deseas revisar el desglose por Vendedor o la Auditoría Fiscal SAT (RFC, Código Postal receptor y UUID CFDI), y exporta a Excel con un clic.

📐 Fórmulas y Cálculos Aplicados:

• Unidades Netas Vendidas = Σ Piezas Facturadas del Proveedor - Σ Piezas Devueltas en el periodo
• Venta Neta ($) = Σ Importe sin IVA de los artículos de la marca en el rango seleccionado
• Existencia Total Marca = Σ Existencia Física Actual en las 17 sucursales operativas

🗄️ Datos Obtenidos (Origen MBA3):

Cruza invt_ficha_principal (filtrando códigos/grupos de Bticino y Leviton), invt_producto_movimientos, invt_producto_saldos y datos fiscales CFDI en clnt_factura_principal y clnt_ficha_principal.

🏢 1. Zonas y Sucursales (Catálogo Maestro Unificado):

Aquí se administra la lista oficial de las 17 sucursales operativas, su nombre comercial homologado, a qué Zona Geográfica pertenecen (Zona Centro, Zona Sur, Zona Norte, Zona Online), qué códigos de bodega de MBA3 agrupan y si están Activas o Inactivas. Cualquier cambio guardado aquí actualiza automáticamente los reportes de Dirección, Comparativo Anual, Ventas, Inventarios (incluyendo Productos en Tránsito y Análisis de Inventarios) y Proveedores.

👔 2. Vendedores y Tipos (PDV vs Proyectos):

Permite clasificar a cada vendedor como 🏪 Vendedores PDV (Mostrador/Sucursal), 🏗️ Vendedores Proyectos o ⚪ Sin Asignar, editar su nombre oficial, activar/inactivar ejecutivos o registrar nuevos códigos con el botón "+ Agregar Vendedor". Esta clasificación alimenta en vivo los selectores segmentados Todos / PDV / Proyectos en todos los reportes.

📂 3. Datos Adicionales (Listas Externas):

Permite cargar archivos Excel (.xlsx), .csv o .json con catálogos o metas que no residen en MBA3 (ej. presupuestos, mínimos/máximos de stock o listas especiales) para previsualizarlos y utilizarlos en el portal.

🔐 4. Usuarios, Matriz RBAC Completa, Correo SMTP, Tiempo de Sesión y Sincronización General:

• Gestión de Usuarios: Alta de nuevos usuarios, edición de nombre/rol, cambio de contraseña cifrada (PBKDF2-SHA256) y activación/bloqueo inmediato de cuentas.
• Asignación de Permisos (Matriz Unificada): Selecciona un usuario y marca con casillas exactamente qué reportes de 1. Dirección y Análisis, 2. Comparativo Anual, 3. Análisis de Ventas, 4. Inventarios, 5. Proveedores (Bticino, Leviton, Ventas por Vendedor, Cruce SAT y Fechas Libres) o Configuraciones puede visualizar.
• Sincronizar Datos (Réplica MBA3): Opción exclusiva para administradores autorizados (permiso sincronizacion_db) que permite actualizar bajo demanda todos los datos y cachés de Ventas, Inventarios y Catálogos para PROCA, SCULT o ambas empresas.
• Configuración de Correo (SMTP) y Tiempo de Sesión: Define el servidor SMTP para los códigos 2FA y el límite de inactividad (de 1 a 60 minutos) para cierre automático de sesión.