---
audiencia: usuario
screen_key: tablero
titulo: Tablero — cómo va el negocio, con sus pestañas de Inteligencia Artificial
aliases: [tablero, dashboard, panel, ia dashboard, dashboard ia, tablero ia, resumen ia, alertas ia, timeline, predicciones, chat ia, chat con datos, convertido, sin cotización, desglose por moneda, por qué no veo una tarjeta, inicio del director, tablero general, kpis, ventas del mes, cuentas por cobrar, rentabilidad, presupuestos, movimientos de caja, solo mis números, ver todo, mi comisión, mis promesas, ves solo tus números, actualizar análisis, configurar ia, api key ia]
---

# Tablero — Guía para el Usuario

El **Tablero** muestra cómo va el negocio de un vistazo: ventas, compras, presupuestos, cuentas por cobrar, rentabilidad y movimientos de caja, más las pestañas de **Inteligencia Artificial** (Resumen, Alertas, Timeline, Predicciones y Chat). Reemplaza al antiguo **Dashboard** y al **IA Dashboard**: las dos pantallas viejas son ahora pestañas de una sola.

## Dónde está

`Análisis → Tablero` (ruta `/dashboard`). Aparece en el menú si el usuario puede ver el Tablero general o la IA. Quien entra a un enlace viejo `/ai-dashboard` llega a la pestaña equivalente del Tablero.

Los enlaces: `/dashboard?tab=general`, `resumen-ia`, `alertas-ia`, `timeline`, `predicciones` y `chat`.

## Pestaña General

Arriba hay tres filtros y el botón **Actualizar** (vuelve a pedir todas las tarjetas):

- **Período**: Hoy, 7 días, 30 días, Este mes, Mes anterior, Este año.
- **Sucursal**: las sucursales a las que el usuario tiene acceso. **Todas** aparece solo si su alcance cubre toda la empresa (ver más abajo).
- **Moneda**: **Convertido a <moneda base>** (por ejemplo «Convertido a PYG») y una opción por cada moneda con movimientos.

Tarjetas: indicadores de ventas (con contado y crédito, ventas por hora, productos más vendidos, categorías y clientes), compras, presupuestos con su embudo, cuentas por cobrar, rentabilidad y los últimos movimientos de caja con el enlace **Ver todos** (lleva a Tesorería › Movimientos). El badge «En vivo» ya no existe: se actualiza con el botón.

Cada tarjeta carga por separado: si una falla, muestra el mensaje y **Reintentar** sin tumbar a las demás; si no hay datos, lo dice con un vacío. Hay un **Ver tutorial** para recorrer la pantalla.

### Regla de monedas

- Con **una moneda elegida** (por ejemplo US$), todas las tarjetas muestran solo documentos en esa moneda, con su símbolo.
- Con **Convertido**, cada documento se convierte a la moneda base **con su propia cotización** (la del documento, no la de hoy). El monto lleva el rótulo «convertido a PYG» y **Ver por moneda** abre el **desglose** de cuánto fue en cada moneda, sin convertir.
- Un documento en moneda extranjera **sin cotización** no entra en el total convertido: queda en el desglose y la tarjeta avisa cuántos quedaron afuera («sin cotización»). Se arregla cargando la cotización.
- **Cuentas por cobrar** es una foto del saldo vigente (no usa período). En «Convertido», cada cuota se convierte con la cotización de su documento; no hay revaluación a la cotización de hoy (para el contador: sirve como referencia comercial, no como ajuste contable).
- Si la empresa no tiene moneda base definida, el Tablero lo avisa y muestra «—» en vez de inventar una moneda.

### Sucursal y alcance

Un usuario con alcance limitado (solo algunas sucursales, o un rubro) ve únicamente sus sucursales y no tiene la opción **Todas**. Pedir datos de una sucursal fuera de su alcance es rechazado por el sistema. Los datos de cada tarjeta ya vienen recortados por el alcance.

### Quién ve solo lo suyo

Si el usuario está **vinculado como vendedor o cobrador** (`Contactos → Equipo comercial`, campo **Usuario vinculado**) y su perfil **no** tiene el permiso **«Ver los números de toda la empresa en el Tablero»** (`REP_DSH_VER_TODO`, submódulo Dashboard de Reportes), el Tablero le muestra **solo sus números** y arriba aparece el aviso «Ves solo tus números (<nombre>).». Quien tiene ese permiso ve toda la empresa aunque esté vinculado.

**Sin «ver todo» y sin vínculo** (el usuario no figura en Equipo comercial, o su vínculo está inactivo), el Tablero **no muestra tarjetas de datos** y avisa: «Tu usuario no está vinculado a un vendedor o cobrador. Pedile al administrador que lo vincule en Contactos › Equipo comercial, o que te dé «Ver los números de toda la empresa».». Nunca muestra la empresa porque falte el vínculo. El superadministrador y los usuarios de la empresa holding ven siempre toda la empresa.

Este recorte es **solo del Tablero**. Las otras pantallas (Cuentas a cobrar › Antigüedad, el Reporte de rentabilidad, los listados) muestran lo que el permiso de su módulo permite, con sus indicadores y sus listas del mismo universo.

Qué ve cada uno con alcance propio:

- **Vendedor**: Ventas, Presupuestos, Rentabilidad y Cuentas por cobrar, solo de sus facturas.
- **Cobrador**: Cuentas por cobrar de su cartera (las facturas que tiene asignadas, directo o por su cliente/dirección); su cobrado incluye gastos y diferencia del recibo.
- **Ambos** (vendedor y cobrador): lo de los dos.
- **Compras** y **Movimientos de caja** no se muestran.
- En Cuentas por cobrar, el cobrado del vendedor es lo aplicado a sus facturas (plata recibida, sin notas de crédito ni retenciones).

Tarjetas propias, con el período del filtro (por moneda, nunca sumadas entre monedas):

- **Mi comisión**: sus comisiones por tipo (venta o cobranza) y estado (pendiente, aprobada, liquidada), según la fecha del documento. Las que no se pueden asignar a una moneda se avisan aparte y no se suman.
- **Mis promesas de pago**: solo para cobradores. Promesas de sus clientes por estado y las próximas a vencer (hasta 10, desde hoy).

Quien tiene «ver todo» y además un vínculo ve el Tablero de toda la empresa y **no** estas dos tarjetas.

**La IA no se muestra** a quien ve solo lo suyo (vinculado o no): la IA analiza toda la empresa y mostraría números ajenos; para usarla hace falta «ver todo». El Tablero avisa «La IA analiza toda la empresa; tu usuario ve solo sus números.» (si la pidiera igual, el sistema responde `IA_SOLO_PROPIO`).

**Cómo darle «ver todo» a alguien**: `Configuración → Usuarios y permisos → Perfiles y roles`, editar un perfil propio (o clonar uno de sistema), abrir `Reportes → Dashboard` y marcar «Ver los números de toda la empresa en el Tablero». Los perfiles que ya administraban o tenían reportes lo recibieron automáticamente al actualizar; Director y Supervisor lo traen de sistema.

**Si un vendedor ve los números de toda la empresa en el Tablero**: su perfil tiene «ver todo» (o es superadministrador / usuario de la holding). Para que vea solo lo suyo: quitar el permiso del perfil y vincular su usuario en `Contactos → Equipo comercial` (ficha → **Usuario vinculado**).

**Si aparece el aviso «Tu usuario no está vinculado…»**: el usuario no tiene «ver todo» y no está vinculado (o el vínculo está inactivo). Vincularlo en `Contactos → Equipo comercial` o darle el permiso «ver todo», según corresponda.

**Si un vendedor o cobrador vinculado ve sus tarjetas vacías**: sus comprobantes no lo tienen asignado. Las ventas cuentan por el vendedor de la factura o del presupuesto; la cartera del cobrador, por el cobrador de la factura, de la dirección del cliente, del cliente o de la asignación de cobranza. Revisar esas asignaciones.

### Por qué falta una tarjeta

Cada tarjeta exige un **permiso** y que la empresa tenga contratado el **submódulo** correspondiente. Si falta alguno, la tarjeta no se muestra (no aparece vacía ni con «Sin datos»):

| Tarjeta | Permiso | Submódulo |
|---|---|---|
| Ventas | `VEN_FAC_FACTURA_VER` | Facturación |
| Compras | `CMP_FAC_FACTURA_PROV_VER` (o el de reportes de compras) | Compras / reportes |
| Presupuestos | `VEN_PRE_PRESUPUESTO_VER` | Presupuestos |
| Cuentas por cobrar | `COB_CC_CUENTA_COBRAR_VER` | Cuentas por cobrar |
| Rentabilidad | `REP_FAC_REPORTE_VER` | Reportes de facturación |
| Movimientos de caja | `TES_MOV_MOVIMIENTO_VER` | Movimientos de Tesorería |

Si falta una tarjeta, hay que pedir al administrador que revise el **perfil** del usuario (Configuración → Usuarios y permisos → Perfiles y roles) y, si el permiso está, que el submódulo esté contratado en la suscripción.

## Pestañas de Inteligencia Artificial

Aparecen solo si la empresa tiene el submódulo **Dashboard IA** y el usuario tiene permiso de verlo (`REP_DIA_DASHBOARD_VER`). Además, **la IA analiza la empresa entera**: un usuario con alcance limitado a algunas sucursales (o a un rubro) **no ve las pestañas IA** y, si las pidiera, el sistema responde `IA_REQUIERE_ALCANCE_TOTAL`. En ese caso el Tablero muestra un aviso con el motivo: con un **rubro elegido**, hay que elegir «Todos los rubros» en el selector de rubro del panel lateral; si el **usuario está limitado a algunas sucursales**, hay que pedirle a un administrador acceso a todas. El aviso aparece solo a quien tiene el submódulo y el permiso de la IA.

- **Resumen**: indicadores y narrativa del negocio generados por la IA; bloque de RRHH si corresponde. **Actualizar análisis** (permiso `REP_DIA_RECALCULAR`) genera uno nuevo.
- **Alertas**: alertas detectadas, con **Marcar leída** y **Resolver**; la pestaña muestra una insignia con las pendientes.
- **Timeline**: eventos del negocio agrupados por día (Hoy, Ayer, fechas); filtros **Todos / 7 días / 3 días / Hoy**. Las ventas por encima del umbral de «venta alta» se destacan.
- **Predicciones**: proyecciones con gráficos.
- **Chat**: preguntas en lenguaje natural sobre los datos del negocio (permiso `REP_DIA_CHAT_USAR`): conversaciones guardadas, sugerencias, selector de tabla o gráfico, preguntas de seguimiento y **favoritos** (guardar una consulta, **ejecutarla** de nuevo con datos frescos o eliminarla).

Cada pestaña tiene su ayuda («¿Cómo funciona esta sección?») y el tutorial de la IA se muestra una sola vez.

Los montos de la IA se consolidan en la moneda base de la empresa.

### Dónde se configura la IA

`Configuración → Inteligencia artificial` (`/configuracion?seccion=ia-config`). Solo la ve quien tiene `REP_DIA_DASHBOARD_CONFIG`: el Administrador (el Contador de sistema y el Director no). Ahí se elige proveedor, API key y modelo, se prueba la conexión y se ajustan:

- **Máximo de tokens** por respuesta (100 a 8000).
- **Días de mora para alerta crítica**.
- **Venta alta en el Timeline** (monto, en la moneda base).
- Frecuencia del análisis automático.

También se ve el consumo del período y el **tope mensual de tokens**. Si falta la API key, las pestañas IA muestran un aviso que lleva a esa sección (o dice a quién pedirla, si el usuario no puede configurarla).

## Inicio para usuarios de consulta

La pantalla **Inicio** de un usuario que solo consulta (no tiene ningún permiso de crear, editar, anular o emitir; por ejemplo el perfil **Director**) muestra, debajo del saludo y las Alertas, el **Tablero General** en lugar de Puesta en marcha, Tu trabajo y Módulos. Quien opera ve el Inicio de siempre: placa de la empresa, Puesta en marcha (un solo listado de 9 pasos, que une los viejos pasos de Inicio y del banner del Dashboard), Atención, Tu trabajo y Módulos.

## Problemas frecuentes

- **«No veo la pestaña IA»**: falta el submódulo contratado, el permiso `REP_DIA_DASHBOARD_VER`, el usuario tiene alcance limitado a sucursales, o ve solo sus números (sin «ver todo», vinculado o no).
- **«Una tarjeta dice sin cotización»**: hay documentos en otra moneda sin cotización cargada; cargarla en Contabilidad › Tipo de cambio.
- **«No me deja elegir Todas en sucursal»**: el alcance del usuario no cubre toda la empresa.
- **«Soy vendedor/cobrador y no veo Compras ni la IA»**: es lo esperado con alcance propio; si debe ver toda la empresa, pedir el permiso «ver todo».
- **«Soy vendedor y mis tarjetas están vacías»**: sus facturas o presupuestos no tienen a ese vendedor asignado (o, si es cobrador, sus clientes no lo tienen como cobrador).
- **«Soy vendedor y veo toda la empresa»**: su perfil tiene «Ver los números de toda la empresa en el Tablero».
- **«El Tablero dice que mi usuario no está vinculado»**: no tiene «ver todo» ni vínculo activo en Contactos › Equipo comercial; el administrador lo vincula o le da «ver todo».
- **«Falta la API key»**: se carga en Configuración → Inteligencia artificial.
- **Un monto «convertido» no coincide con el de otra pantalla**: el Tablero convierte cada documento con su cotización; otras pantallas pueden usar la de hoy.
