Manual Completo de Uso, Operación, Fórmulas y Origen de Datos

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:

Tablero ejecutivo interanual que enfrenta lado a lado el Año Base vs Año Comparado (2025 vs 2026, 2026 vs 2027, 2024 vs 2025 o 2024 vs 2026) en todos los indicadores clave: Ventas de Inventario Puro, Anticipos, Servicios, Costo de Inventario, Utilidad Bruta, Margen Real %, Clientes Únicos, Facturas Emitidas, Documentos Cancelados y Notas de Crédito.

🛠️ Cómo se maneja:

1. En la barra superior elige la Empresa (PROCA / SCULT), el Mes (Todo el Año (Acumulado) o un mes específico de Enero a Diciembre) y el par de años en Comparativo: (2025 vs 2026, 2026 vs 2027, 2024 vs 2025, 2024 vs 2026).
2. Usa la barra de filtros secundarios (Sucursal, Vendedor, Marca/Grupo en formato CODIGO - NOMBRE, ej. CNDMX - CONDUMEX) y presiona "Filtrar" para aislar el comparativo interanual de una plaza, marca o ejecutivo específico.

📐 Fórmulas y Cálculos Aplicados:

• Diferencia Neta ($) = Valor Año Comparado - Valor Año Base
• Variación Interanual YoY (%) = ((Valor Año Comparado - Valor Año Base) / Valor Año Base) × 100
• Variación de Margen (pp) = Margen % Año Comparado - Margen % Año Base (en puntos porcentuales).

🗄️ Datos Obtenidos (Origen MBA3):

Cruza invt_producto_movimientos (ventas de inventario puro y costos), clnt_factura_principal (facturación total, anticipos y cancelados) y ntdc_client_prov_principal (notas de crédito NC02–NC04).

🎯 Propósito y Explicación de Uso de cada Reporte:

• Comparativo Anual x Mes: Tabla y gráfica mes a mes (Enero a Diciembre) enfrentando el Año Base contra el Año Comparado, mostrando diferencia en pesos ($), crecimiento porcentual (%), mejor mes del año y promedio mensual.
• Comparativo Mensual x Sucursal: Matriz mensual que compara cada una de las 17 sucursales entre ambos años en Ventas, Utilidad, Margen %, Anticipos, Clientes, Facturas, Cancelados y Notas de Crédito. Incluye el Filtro Segmentado de Tipo de Vendedor (👥 Todos | 🏪 PDV | 💼 Proyectos) para evaluar el desempeño de mostrador o proyectos en cada sucursal.
• Comparativo Mensual x Zona: Consolida el comparativo interanual por Zona Geográfica con expansión (drill-down) hacia sus sucursales, botón de Personalizar Sucursales y Filtro Segmentado de Tipo de Vendedor (Todos / PDV / Proyectos).
• Comparativo Mensual x Vendedor: Evalúa el crecimiento o caída interanual de cada vendedor mes a mes y en el acumulado anual, contando con el Filtro Segmentado (Todos / PDV / Proyectos) alineado en su barra de herramientas.
• Comparativo Anual x Grupo y Subgrupo: Matriz jerárquica desplegable (Grupo → Subgrupo) con nombres homologados CODIGO - NOMBRE (ej. CNDMX - CONDUMEX, LEVIT - LEVITON) que compara ventas, utilidad y margen entre los dos años seleccionados, filtrable por Sucursal, Tipo de Vendedor (Todos / PDV / Proyectos) y Vendedor.

📐 Fórmulas y Cálculos Aplicados:

• Diferencia Mensual ($) = Venta Mes (Año Comparado) - Venta Mes (Año Base)
• % Crecimiento YoY = ((Venta Año Comparado - Venta Año Base) / Venta Año Base) × 100
• % Share Grupo = (Venta del Grupo en el Año / Venta Total Empresa en el Año) × 100

🗄️ Datos Obtenidos (Origen MBA3):

invt_producto_movimientos, invt_ficha_principal, invt_grupo_subgrupo_lista, clnt_factura_principal y ntdc_client_prov_principal homologados con los catálogos maestros de Zonas, Sucursales y Clasificación de Vendedores.

🎯 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 (Enero a Diciembre) 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, 2025, 2026, 2027) 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, utiliza el Selector de Zona (Todas las Zonas o una zona específica) para filtrar tanto las tarjetas KPI superiores como la tabla mensual, o haz clic sobre el nombre de cualquier Zona para desplegar (drill-down) sus sucursales.
3. Con el botón "Personalizar Sucursales" puedes activar/desactivar sucursales o reasignarlas 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 en formato CODIGO - NOMBRE, como CNDMX - CONDUMEX, SQD - SQUARE D, BTICI - BTICINO, LEVIT - LEVITON) contra Sucursales, Zonas o Vendedores, permitiendo además filtrar por un Mes específico o Todo el Año (Acumulado) desde la barra superior.

🛠️ Cómo se maneja:

1. En la barra superior puedes seleccionar el Mes (Todo el Año (Acumulado) o un mes individual de Enero a Diciembre) y el Año.
2. Haz clic en el icono ▸ junto a cualquier GRUPO (o usa los botones "Expandir / Colapsar") para abrir el detalle de todos sus Subgrupos.
3. En Ventas x Grupo x Sucursal dispones del selector de Sucursal y del nuevo Selector de Grupo (CODIGO - NOMBRE) sincronizado con el buscador rápido.
4. En Ventas x Grupo x Zona dispones tanto del Selector de Zona Geográfica como del Selector de Grupo (CODIGO - NOMBRE) para recalcular KPIs y matriz al instante.
5. En Ventas x Grupo x Vendedor puedes filtrar por Tipo de Vendedor (Todos / PDV / Proyectos), elegir un vendedor o grupo 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 e invt_grupo_subgrupo_lista (campos grupo, subgrupo y nombre), 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 propia 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 por Grupo de Productos (formato CODIGO - NOMBRE).
2. Utiliza el botón "Agrupación Sucursales" para abrir el Organizador Dinámico Unificado de Sucursales y Zonas (Zona Centro, Zona Sur, Zona Norte, Zona Online), el cual está 100% integrado con la configuración general de zonas del portal.
3. Usa el buscador para encontrar cualquier número de documento de transferencia, código SKU, descripción o memo.

📐 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, sincronizados con el Catálogo Maestro Unificado de Zonas.

🎯 Propósito y Explicación de Uso:

Evalúa en un solo tablero los 7 pilares operativos y financieros de cualquier Grupo o Marca de productos (Ventas Netas/Brutas, Devoluciones, Documentos Emitidos, Compras Recepcionadas RP, Existencias Físicas, Valor de Inventario y Rotación).

🛠️ Cómo se maneja:

1. Al ingresar o refrescar la vista, el selector de Grupos de Productos inicia limpio en "Todos los Grupos" sin dejar selecciones pegadas. Puedes marcar uno o varios grupos en formato CODIGO - NOMBRE (ej. SIEME - SIEMENS, CNDMX - CONDUMEX), elegir Subgrupo, Zona Operativa, Sucursal y Rango de Fechas.
2. En la pestaña 1. Concentrado por Zona / Sucursal, elige el Modo de Agrupación:
   • 📌 Consolidado por Zona (Sumado General): Suma todas las sucursales de cada zona en un solo renglón consolidado.
   • 📂 Zona con Desglose por Sucursal: Árbol desplegable Zona → Sucursales.
   • 🏪 Por Sucursal Individual: Tabla plana comparativa de todas las sucursales.
3. Auditoría de Documentos con Vendedor: Pulsa el botón "Ver Documentos Emitidos" (o haz clic en cualquier SKU en la pestaña 2) para abrir el modal de auditoría que detalla cada Factura de Venta (FT), Devolución (NC/RT) y Recepción de Compra (RP), incluyendo la columna VENDEDOR (Código y Nombre Oficial del Ejecutivo) responsable del documento.

📐 Fórmulas y Cálculos Aplicados:

• Venta Neta ($) = Venta Bruta Facturada (FT) - Devoluciones sobre Venta (NC / RT)
• Tasa de Devolución (%) = (Devoluciones $ / Venta Bruta $) × 100
• Valor de Inventario ($) = Existencia Física Actual × Costo Promedio Unitario MBA3
• Días de Inventario (Zona o Sucursal) = Existencia Física Total / (Unidades Netas Vendidas / Días del Periodo)
• Índice de Rotación = Costo de Ventas del Periodo / Valor del Inventario Actual

🗄️ Datos Obtenidos (Origen MBA3 + Catálogos Unificados):

Cruza en tiempo real invt_ficha_principal, invt_grupo_subgrupo_lista, invt_bodegas_saldos, invt_producto_movimientos, clnt_factura_principal y ntdc_client_prov_principal (para obtener el código y nombre del vendedor en cada FT/NC) junto con clnt_pedidos_principal/detalle y el Catálogo Maestro de Vendedores.

🎯 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 (incluyendo permisos granulares de Bticino, Leviton, Ventas por Vendedor, Cruce SAT y Fechas Libres) o Configuraciones puede visualizar. Las opciones no autorizadas se ocultan de su menú lateral y se bloquean en el servidor.
• 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.