Dashboard - KPIs en tiempo real

Qué mide cada sección del dashboard de Mosce ERP, cómo funciona el selector de período y qué hacer si un número no coincide con lo esperado.

El dashboard principal de Mosce ERP muestra un resumen del estado de tu negocio en tiempo casi real: ventas, cuentas por cobrar, cuentas por pagar, operación e inventario - todo en una sola pantalla, adaptado a los permisos de tu rol. Usa el selector de período en la cabecera del panel para ver el mes en curso, el mes pasado, el trimestre o el año. Este artículo explica qué mide cada sección y cuándo es normal que los números tarden en reflejarse.

Tiempo de lectura: ~7 min

Cuándo usar esto

Es tu primer inicio de sesión del día y quieres una foto rápida del negocio.
Quieres cambiar el período analizado sin abrir los reportes individuales.
Un número del dashboard parece incorrecto y quieres entender cómo se calcula.
Acabas de emitir varias facturas y te preguntas por qué el dashboard todavía no las refleja.
Quieres entender la diferencia entre los números del dashboard y los de los reportes detallados.

El dashboard no muestra las mismas secciones para todos los usuarios. Cada sección está protegida por un permiso específico que el administrador del tenant asigna desde Ajustes → Roles. Si un usuario no tiene el permiso correspondiente, esa sección no aparece en su panel.

Permiso	Sección que desbloquea
`dashboard:sales`	Ventas
`dashboard:receivables`	Cuentas por Cobrar
`dashboard:payables`	Cuentas por Pagar
`dashboard:operations`	Operación y Caja
`dashboard:inventory`	Inventario

Los roles Propietario y Administrador tienen acceso a todas las secciones por defecto. Los demás roles (Gerente, Vendedor, Cajero, Visualizador) no - el administrador del tenant decide cuáles activar según las responsabilidades de cada persona.

Si no ves ninguna sección, el panel muestra un mensaje informativo. No es un error de la plataforma - significa que tu rol aún no tiene ningún permiso dashboard:* asignado. Habla con el administrador de tu cuenta.

Para más detalles sobre la gestión de roles, consulta Usuarios, roles y permisos.

Selector de período

En la cabecera del panel encontrarás un selector con cuatro opciones:

Opción	Período que cubre
Este mes (default)	Del día 1 del mes calendario actual al día de hoy
Mes pasado	El mes calendario anterior completo
Este trimestre	Del primer día del trimestre calendario en curso al día de hoy
Este año	Del 1 de enero del año en curso al día de hoy

El panel recuerda tu selección mientras navegas. La selección afecta:

Todos los KPIs de cada sección - los totales y conteos se recalculan para el período elegido.
El delta porcentual - compara el período seleccionado contra el período anterior equivalente (este mes vs. el mes anterior, mes pasado vs. el mes previo a ese, este trimestre vs. el trimestre anterior, este año vs. el año anterior).
La granularidad del gráfico - diaria en "Este mes" y "Mes pasado", semanal en "Este trimestre", mensual en "Este año".

Alertas y acciones rápidas

En la parte superior del panel hay un strip de alertas accionables que aparece solo cuando hay algo que requiere tu atención:

Facturas vencidas - enlaza directamente al reporte de cuentas por cobrar filtrado por vencidas. Solo visible si tienes el permiso dashboard:receivables.
Stock bajo - enlaza al reporte de inventario filtrado por productos bajo mínimo. Solo visible si tienes el permiso dashboard:inventory.
Contingencia fiscal activa - aparece únicamente si hay un episodio de contingencia de facturación electrónica en curso, con un enlace a la pantalla de contingencia para gestionarlo.

Debajo de las alertas encontrarás botones de acción rápida para crear una factura, un cliente o un producto. Cada botón solo aparece si tu rol tiene el permiso de creación correspondiente (invoices:create, clients:create, products:create). Si no los ves, es normal - tu rol no tiene esos permisos habilitados.

Los indicadores del dashboard

Sección Ventas (`dashboard:sales`)

Total facturado del período Suma de los ingresos de todas las facturas de venta emitidas en el período seleccionado. Usa base acumulada - incluye facturas pagadas, pendientes, parciales, vencidas y acreditadas. Excluye borradores y anuladas.

Muestra el delta en porcentaje respecto al período comparable anterior.

Utilidad bruta del período Diferencia entre los ingresos del período y el costo de los productos vendidos (COGS) en el mismo rango. Mismo conjunto de facturas que el indicador de total facturado.

Limitación: si alguno de tus productos no tiene costo configurado, su COGS es cero y la utilidad bruta aparece sobreestimada. Revisa el catálogo de productos si este número parece incorrecto.

Producto top del período El producto con mayor ingreso facturado en el período. Equivale al primer resultado del ranking de top productos por ingresos para el período seleccionado.

Gráfico Bruto / Descuentos / Neto Gráfico multi-serie con tres líneas: ingreso bruto, descuentos aplicados e ingreso neto por cada punto del período. La granularidad se ajusta automáticamente según la opción del selector.

Sección Cuentas por Cobrar (`dashboard:receivables`)

Saldo por cobrar (AR) Suma del saldo pendiente de cobro de todas las facturas abiertas (estado: pendiente, parcialmente pagada o vencida) - sin importar el mes de emisión. Es un indicador de saldo acumulado a la fecha, no del período seleccionado.

Facturas pendientes Número de facturas en estado pendiente de pago (no vencidas) al momento de la consulta.

Facturas vencidas Número de facturas cuya fecha de vencimiento ya pasó y que aún tienen saldo pendiente. Un número alto aquí requiere atención de cobranza.

Gráfico Facturado / Cobrado / Saldo Gráfico multi-serie que muestra la evolución del monto facturado, lo efectivamente cobrado y el saldo pendiente para cada punto del período seleccionado.

Sección Cuentas por Pagar (`dashboard:payables`)

Facturas de proveedor pendientes Número de facturas de proveedor que aún no han sido pagadas, y su monto total acumulado.

Órdenes de compra pendientes de recibir Número de órdenes de compra que han sido emitidas al proveedor pero cuya mercancía aún no ha sido registrada como recibida en el sistema.

Gráfico Facturado / Pagado Gráfico multi-serie con la evolución de lo facturado por proveedores vs. lo pagado en el período seleccionado.

Sección Operación y Caja (`dashboard:operations`)

Sesiones de caja abiertas Número de sesiones de caja actualmente abiertas en todos los puntos de venta de tu cuenta.

Órdenes de punto de venta (POS) pendientes Número de órdenes del punto de venta que están en proceso y aún no han sido completadas o anuladas.

Cotizaciones abiertas Número de cotizaciones enviadas a clientes que aún no han sido convertidas a factura ni expiradas.

Gráfico Entradas / Salidas de caja Gráfico multi-serie con los movimientos de entrada y salida de caja registrados en el período seleccionado.

Sección Inventario (`dashboard:inventory`)

Productos con stock bajo Número de productos cuya cantidad disponible cayó por debajo del umbral mínimo de stock configurado en el catálogo.

Haz clic en el indicador para ir al reporte de inventario filtrado por productos bajo mínimo.

Esta sección muestra solo KPIs - no incluye gráfico.

Estados del panel

El dashboard maneja cuatro estados distintos:

Cargando - mientras el panel obtiene los datos del servidor se muestran skeletons animados en lugar de los valores. Esto dura típicamente menos de un segundo.
Error - si la carga falla (por ejemplo, una interrupción de red), cada sección muestra un mensaje de error con la opción de reintentar sin recargar toda la página.
Primera carga - si el tenant acaba de ser creado y aún no tiene datos registrados, el panel muestra un mensaje de bienvenida con pasos sugeridos para comenzar, en lugar de ceros en todos los KPIs.
Saludo personalizado - la cabecera del panel muestra un saludo que varía según la hora del día (buenos días, buenas tardes, buenas noches) junto a tu nombre.

Frecuencia de actualización - por qué los números pueden tardar

Los datos del dashboard se almacenan en caché por aproximadamente 2 minutos. Una ráfaga de actividad (varias facturas emitidas en pocos segundos) no se verá reflejada inmediatamente - el dashboard mostrará los valores anteriores hasta que expire la caché.

Esto es intencional: sin caché, la plataforma procesaría la consulta en cada carga de página de todos los usuarios simultáneamente, lo que ralentizaría la respuesta en horas de alto tráfico.

La caché se segmenta por tenant, período y conjunto de permisos: dos usuarios con los mismos permisos y el mismo período comparten la respuesta cacheada, pero permisos distintos o períodos distintos generan entradas independientes. Por eso el primer cambio de período (o la primera carga para un rol con permisos diferentes a otro ya cacheado) puede tardar hasta 2 minutos en reflejar los últimos datos.

Si necesitas el dato más fresco:

Espera 2 minutos y recarga la página.
O abre directamente el reporte correspondiente desde Reportes, que consulta en tiempo real sin caché.

Errores comunes

Síntoma	Causa probable	Solución
Los números del dashboard no coinciden con el reporte equivalente	El dashboard está en caché; el reporte consulta en tiempo real	Espera 2 minutos y recarga el dashboard
La utilidad bruta parece incorrecta	Productos sin costo configurado elevan artificialmente el margen	Ve a Catálogo → Productos y configura el costo de los productos sin valor
El indicador de AR incluye facturas que ya pagué	El pago puede no haberse registrado correctamente	Verifica que el pago esté aplicado a la factura en Ventas → Facturas
No veo la sección de stock bajo	Tu rol no tiene el permiso `dashboard:inventory`	Habla con el administrador de tu cuenta para que lo habilite en tu rol
No veo ninguna sección en el dashboard	Tu rol no tiene ningún permiso `dashboard:*` asignado	Habla con el administrador de tu cuenta
El delta porcentual parece incorrecto	El período comparable cambia según la opción del selector	Verifica que el selector esté en la opción esperada y revisa cuál es el período base de comparación

Preguntas frecuentes

¿El dashboard es personalizable?

Sí, a nivel de rol. El administrador de tu cuenta decide qué secciones ve cada rol habilitando los permisos dashboard:* correspondientes desde Ajustes → Roles. Lo que no es configurable es el orden de los indicadores dentro de cada sección - ese orden es fijo.

¿Puedo ver el dashboard de un período pasado?

Sí. Usa el selector de período en la cabecera del panel para cambiar a "Mes pasado", "Este trimestre" o "Este año". El "Mes pasado" muestra el mes calendario anterior completo. Para análisis más granulares o períodos arbitrarios, usa los reportes disponibles en la sección Reportes.

¿Los números del dashboard coinciden exactamente con los reportes?

Los valores deben coincidir con los reportes correspondientes, salvo por el retraso de caché de hasta 2 minutos. Si la discrepancia persiste más allá de ese tiempo, contacta a soporte.

¿Por qué no veo la sección de Cuentas por Pagar (o cualquier otra sección)?

Porque el rol asignado a tu usuario no tiene habilitado el permiso dashboard:payables (o el permiso de la sección que no ves). El administrador de tu cuenta puede activarlo desde Ajustes → Roles. Consulta Usuarios, roles y permisos para ver cómo funciona la asignación de permisos.

¿El dashboard está disponible en la API?

Sí. Los mismos KPIs están disponibles para integraciones autenticadas, con el mismo comportamiento de caché y la misma lógica de segmentación por permisos descritos en este artículo.

Relacionados

Última actualización: 2026-05-24