Cómo auditar cada KPI

Antes de comparar, mira el estado de cada KPI — te dice si conviene auditarlo ya:

• ✓ Verificado · la definición fue aprobada y congelada (estable, reproducible).
• En revisión · calculado pero todavía no aprobado, sujeto a ajuste.
• Sin dato · falta data para calcularlo. No inventa un número: te dice qué falta (ej. "faltan datos de costes, conecta tu ERP o una hoja de costes"). Es intencional, no un bug — sáltalo hasta conectar esa fuente.

Para forzar un refresh: Recalcular ahora (un KPI) o Recalcular todos (el tablero). Cada KPI guarda su historial (sparkline) para ver la evolución.

Fija el horizonte temporal con el selector. Cada KPI trae un indicador de cobertura.

• Si dice parcial o "sin datos tan atrás", ese número no es comparable: falta data en esa ventana, no es un error de cálculo.
• Tenlo en cuenta al elegir contra qué período comparas.

El KPI aplica ciertos criterios (neto/bruto de IVA, estados de reserva, canales…). Muchos no están fijos en el código: salen de reglas (Cerebro).

Cada KPI te muestra las reglas aplicadas + el desglose, para ver exactamente contra qué comparas.

Si falta un filtro o está mal, lo corriges agregando o ajustando una regla:

• desde el chat de revisión, en lenguaje natural (se guarda como regla sola);
• o directamente en el Cerebro, creando/editando la regla.

La regla aplica a ese KPI y se propaga a los demás donde sea relevante.

Por defecto el KPI usa las tablas del sistema (Hostify, Holded, Monday). Si el dato que necesitas vive en un archivo de Drive (un presupuesto, un inventario, una hoja de referencia…), puedes vincular ese archivo como fuente del KPI.

Requisito: el archivo tiene que estar confirmado antes en Integraciones → Google Drive — ahí se vuelve "vinculable" y aparece en el selector. Los archivos de costos/ingresos no se vinculan a mano: alimentan los KPIs financieros automáticamente (figuran como "Auto").

En el detalle del KPI, sección "Fuente de datos":

• Vincular: botón "Vincular Drive" → el selector lista los archivos vinculables (con su tipo, estado y N filas · N columnas) → eliges uno → recalcula y el KPI pasa a leer de ese archivo.
• Cambiar: con un archivo ya vinculado, el botón "Cambiar" reabre el selector para elegir otro.
• Quitar: dentro del selector, "Quitar fuente" desvincula el archivo y el KPI vuelve a usar las tablas del sistema.

Cualquier cambio de fuente (vincular, cambiar o quitar) modifica la definición → el KPI recalcula y vuelve a "en revisión" hasta que lo apruebes de nuevo (paso 7).

¿No aparece ningún archivo? Confirma primero un archivo de datos en Integraciones → Google Drive y aparecerá en el selector.

La cascada muestra cada término que suma o resta para llegar al valor, en lenguaje de negocio, más la fórmula derivada y las reglas aplicadas.

Ahí ves exactamente qué hizo — sin tecnicismos ni SQL.

• Para entender: "¿cómo se calcula este KPI?" / "¿por qué dio este valor?" → responde leyendo el cálculo real, no inventa.
• Para corregir: indicas el ajuste ("esto va neto de IVA", "excluye las canceladas") → recalcula al instante y muestra el nuevo valor + desglose.

Iteras hasta que esté bien.

Cuando lo das por correcto, lo apruebas y queda congelada la definición. Hasta entonces figura "en revisión".

• Determinista y estable. Deja de fluctuar noche a noche: se reusa el cálculo congelado, sin que la IA lo reescriba. Resuelve las métricas inestables.
• El valor sí sigue al dato. Con data nueva del sync el valor cambia (misma definición); lo que queda fijo es el método.
• Reversible. Puedes re-abrir y corregir. Si cambias la definición (una regla, una fuente nueva), vuelve a "en revisión" hasta re-aprobar.
• Auditable. Queda quién aprobó, cuándo, y la definición (fórmula, explicación, valor de referencia, período).

Las correcciones se guardan como reglas y aplican a todos los KPIs donde son relevantes. Por eso conviene empezar por los base:

Corrigiendo los base y las reglas transversales (IVA, estados, canales) arreglas varios derivados de una vez.

Si algo simplemente no cuadra, puede ser un bug o un error en el sync de datos que debemos corregir — pásame el caso puntual.