Tablero del día y Ventas en vivo

Esta sección cubre dos pantallas de gerente que se complementan:

• Tablero (/dashboard) — la foto operativa de tu catálogo, precios, existencias y financiamiento. Responde: ¿está sano mi inventario y mi surtido de información?
• Ventas en vivo (/ventas-en-vivo) — el monitor de ventas en tiempo real, con el total del día, el ticket promedio y el feed de cada venta conforme ocurre.

Importante. Ambas pantallas son solo para gerentes (rol Sales Manager) y cada una depende de que su módulo esté activado en la tienda: Tablero usa el módulo enable_dashboard y Ventas en vivo usa enable_ventas_en_vivo. Si tu rol no es gerente, al intentar entrar te regresa a Panorama con el aviso "Esa sección es solo para Sales Manager.". Si el módulo está apagado, te regresa con "El módulo … está desactivado en esta tienda."

Parte A · Tablero (/dashboard) — Salud de catálogo e inventarios

Qué es

El Tablero es la radiografía de qué tan bien está armado tu negocio por dentro: cuántos productos tienen precio, cuántos tienen foto, dónde está el inventario, cómo va el financiamiento y qué se ha movido últimamente. No es un reporte de "cuánto vendí hoy" — para eso está Ventas en vivo (Parte B).

El encabezado dice Salud de catálogo e inventarios, con el rótulo Tablero · foto operativa y, debajo, cuántos ítems activos tienes:

3,412 ítems activos · catálogo, precios y existencias

El botón Actualizar (arriba a la derecha) recarga todo. La pantalla carga en un solo tirón: catálogo, financiamiento por proveedor y pendientes de conciliar llegan juntos para que no esperes de a poquito.

[captura: vista completa del Tablero con la sección Financiamiento arriba, luego Catálogo con las 3 donas, Stock por almacén y las listas de trabajo]

1. Financiamiento

Si tu tienda maneja ventas a crédito/financiadas, la primera sección es Financiamiento, con un enlace a la derecha: Ver liquidaciones →. Trae cuatro fichas:

• Financiadas (7 d) — cuántas ventas se financiaron en los últimos 7 días. Toca para ir a Ventas a crédito (/financiamiento).
• Cumplimiento — el porcentaje de esas ventas que tienen su documentación completa (los adjuntos requeridos). La pista debajo dice X de Y (p. ej. 18 de 20). Este número debe estar cerca de 100%; si baja, hay ventas financiadas sin sus papeles.
• Liquidación esperada (7 d) — cuánto dinero esperas recibir de las financieras por esas ventas (en formato compacto, p. ej. $45.2k). Si hay bono esperado, aparece debajo + bono $….
• Pend. conciliar — cuánto está pendiente de conciliar (ventas que aún no tienen su liquidación registrada) en los últimos 14 días. La pista dice N ventas sin liquidación. Toca para ir a Liquidaciones.

Debajo, la gráfica Por proveedor (30 d) muestra, en barras, cuántas ventas financiadas hubo por cada proveedor/financiera en los últimos 30 días. La etiqueta dice cuántos proveedores hay.

Nota. Toda la sección de Financiamiento solo aparece si hay datos de financiamiento. Si tu tienda no vende a crédito, no la verás — no es una falla.

2. Catálogo (cobertura)

La sección Catálogo te dice qué tan completo está tu surtido de información. Junto al título dice el total de ítems.

La tarjeta Cobertura de catálogo tiene tres donas (círculos de porcentaje):

• con precio — qué porcentaje de tus ítems tiene precio asignado.
• con stock — qué porcentaje tiene existencia.
• con imagen — qué porcentaje tiene foto.

Debajo de las donas, seis mini-datos con las cifras exactas: Con precio / Sin precio, Con stock / Sin stock, Con imagen / Sin imagen.

Cómo usarlo. Estas donas son tu lista de tareas de catálogo. Un "con imagen" bajo significa que muchos productos no tienen foto (mal para vender en línea y en WhatsApp). Un "sin precio" alto significa productos que no se pueden vender hasta que les pongas precio.

A la derecha hay dos gráficas más:

• Ítems por grupo — cuántos ítems tienes por grupo de producto (top grupos).
• Cobertura por lista de precios — cuántos ítems están cubiertos en cada lista de precios.

[captura: tarjeta Cobertura de catálogo con las 3 donas (con precio, con stock, con imagen) y los seis mini-datos debajo]

3. Stock por almacén

La tarjeta Stock por almacén grafica cuánta existencia hay en cada almacén. Arriba, a la derecha, dice cuántos almacenes tienen stock.

Si tienes más de un almacén, arriba de la gráfica aparecen chips con el nombre de cada uno:

1. Todos empiezan encendidos (incluidos en la gráfica).
2. Toca un chip para apagarlo — se tacha y ese almacén sale de la gráfica.
3. Toca de nuevo para volver a incluirlo.

Esto te deja comparar, por ejemplo, solo dos sucursales sin el ruido de las demás.

4. Listas de trabajo (worklists)

Tres tarjetas con pendientes accionables:

• Stock bajo (≤ N) — los ítems con existencia en o por debajo del umbral (el número N es el umbral configurado). Cada renglón muestra el nombre, el código y una etiqueta ámbar con la existencia. Si está vacía: "Sin ítems en este rango."
• Sin existencias (recientes) — ítems que se quedaron en cero recientemente, con su grupo de producto. Si está vacía: "Todo con stock."
• Necesitan foto — cuenta cuántos ítems no tienen imagen (missing / total) y trae una lista de trabajo. Si está completa: "Cobertura completa."

Subir fotos en bulto

Dentro de la tarjeta Necesitan foto hay una zona para cargar muchas fotos de golpe:

1. Nombra cada archivo de foto con el código del ítem o su código de barras (por ejemplo PROD-00123.jpg).
2. Toca la zona que dice "📁 Subir fotos en bulto — nombra cada archivo con el código o barcode del ítem" y selecciona todas las fotos.
3. El sistema empareja cada archivo con su ítem por el nombre, sube la foto al producto y la primera foto se vuelve la imagen principal del ítem.
4. Al terminar verás un resumen: una etiqueta verde ✓ N subidas y, si algunas no encontraron a qué ítem pegarse, una ámbar ⚠ N sin match (pasa el cursor para ver cuáles).

Advertencia. Si una foto se nombra con un código que no existe en el catálogo, se reporta como "sin match" y no se sube. Revisa que los nombres de archivo coincidan exactamente con el código o barcode del producto.

[captura: las tres tarjetas de listas de trabajo (Stock bajo, Sin existencias, Necesitan foto) con la zona de carga de fotos en bulto]

5. Movimientos recientes

Hasta abajo, la sección Movimientos recientes trae dos bitácoras (ledgers):

• Movimientos de inventario — los últimos movimientos de existencia. Cada renglón: la cantidad con signo (verde si entró +5, roja si salió −3), el nombre del ítem, y debajo código · almacén · tipo de comprobante y folio. A la derecha, hace cuánto y qué usuario lo hizo.
• Cambios de precio — los últimos cambios de precio. Cada renglón: el nuevo precio (en color de acento), el nombre del ítem, y debajo código · lista de precios con la marca · venta o · compra. A la derecha, hace cuánto y qué usuario.

Nota. Estas bitácoras se cargan al desplegarse, un instante después del resto del tablero, para que la pantalla pinte rápido. Es normal que aparezcan medio segundo después.

Cómo usarlas. Son tu auditoría rápida: ¿quién bajó ese precio?, ¿quién ajustó ese stock y cuándo? Aquí lo ves sin entrar a Desk.

Parte B · Ventas en vivo (/ventas-en-vivo) — Monitor de ventas

Qué es

Ventas en vivo es el monitor de ventas en tiempo real. Aquí sí ves cuánto llevas vendido hoy, tu ticket promedio, cuántos cajeros están activos y cada venta conforme entra. El encabezado dice Monitor de ventas, con un puntito parpadeante y el rótulo Ventas en vivo · streaming.

Debajo del título:

Actualización automática cada 10 s · última 8s

• Se actualiza solo cada 10 segundos (mucho más seguido que Panorama).
• El "última 8s" te dice hace cuánto fue el último refresco.
• Cuando entran ventas nuevas, aparece arriba una etiqueta verde +2 nuevas y la lista se desplaza suavemente hasta arriba — pero solo si estás cerca del inicio, para no interrumpirte si andas revisando ventas más abajo.

Nota. El monitor deja de refrescar cuando escondes la pestaña (para ahorrar recursos) y se reanuda en cuanto regresas. También tienes el botón Actualizar para forzarlo.

[captura: Ventas en vivo con la tarjeta grande "VENTAS DE HOY", las dos tarjetas de la derecha, y el feed de ventas con etiquetas de estado]

1. Las tres tarjetas de arriba

• Ventas de hoy (la tarjeta grande, con puntito en vivo) — el total vendido hoy. Debajo:

  12 ventas · ticket prom. $1,120.00

  Aquí está tu ticket promedio: es el total de hoy dividido entre el número de ventas de hoy. Sube cuando vendes cosas más caras o más piezas por ticket; baja cuando dominan las ventas chicas.

• Con saldo — cuánto dinero de estas ventas quedó a crédito (sin pagar), y cuántas facturas lo forman. Es la cartera que se está generando en el momento.

• Cajeros activos — cuántos cajeros distintos aparecen en las últimas 100 ventas. La pista dice en las últimas 100.

Importante — la ventana es de 100 ventas. Ventas en vivo trabaja siempre con las últimas 100 facturas. Los totales de "hoy" y "con saldo" se calculan sobre esa ventana. En un día de muchísimas ventas, si ya pasaste de 100, las primeras del día quedan fuera de la ventana. Ténlo en cuenta antes de tomar el total de aquí como el corte fiscal del día — para eso está Contabilidad.

2. El feed de ventas y sus filtros

La tarjeta grande de abajo es el feed. Arriba trae un selector de tres pestañas y herramientas de búsqueda:

• Hoy — solo las ventas de hoy (muestra el conteo).
• Con saldo — solo las que quedaron a crédito (muestra el conteo).
• Todas — las últimas 100, sin filtrar por fecha (muestra el total).
• Buscador — escribe cliente, folio, cajero o nombre de ítem y filtra al instante (Cliente, factura, cajero, ítem…).
• Filtro por cajero — un menú Todos los cajeros con cada cajero (muestra la parte antes del @ de su correo).

Nota. Cambiar de pestaña o de filtro no vuelve a pedir datos al servidor; solo re-filtra lo que ya tiene en pantalla. Por eso es instantáneo.

Cuando hay resultados, un renglón de subtotal te dice cuántas ves y su total:

7 en pantalla · 3 POS — $8,400.00 · $1,200.00 saldo

Cada venta del feed muestra:

• El cliente, con una etiqueta de estado: Pagada (verde), Saldo (ámbar, si debe algo) o Devolución (roja). Si fue punto de venta, también trae POS.
• Debajo: folio, número de ítems y el cajero.
• Las formas de pago con su monto (Efectivo en verde, las demás en azul).
• Una vista previa de ítems: chips con ×cantidad y el nombre del producto; si hubo más de los que caben, un chip +N más.
• A la derecha: el total, el saldo en ámbar (con signo −) si debe, y hace cuánto ocurrió.

Toca cualquier venta y se abre la factura completa en Desk en una pestaña nueva (/desk/sales-invoice/…), por si necesitas ver el detalle contable o corregir algo.

Si el filtro no arroja nada, dice "Sin ventas en este filtro." y te sugiere tocar Todas para ver las últimas 100.

[captura: acercamiento a un renglón del feed con etiqueta "Saldo" ámbar, chips de forma de pago, vista previa de ítems y el saldo en la orilla derecha]

Advertencia. El enlace de cada venta abre Desk (el back-office de ERPNext), no una vista de Mercado. Si tu usuario no tiene permiso a Desk, verás un error de permisos ahí — no en Mercado. [VERIFICAR: confirmar qué ven en /desk/sales-invoice/… los usuarios sin rol de Desk.]

Cómo se usan juntas estas dos pantallas

• Empieza el día en Ventas en vivo para ver el ritmo de ventas y el ticket promedio.
• Usa el Tablero una vez al día (o por semana) para cerrar hoyos de catálogo: productos sin foto, sin precio, stock bajo, y para vigilar el financiamiento.
• ¿Viste una venta rara en el feed? Ábrela en Desk desde el propio renglón.
• ¿El ticket promedio bajó? Cruza con el Tablero: quizá se están agotando los productos de mayor valor (mira Sin existencias).