Desglosa los gastos de un mes por categoria (proveedores, nomina, servicios, etc.).

Responde preguntas como "cuanto gaste en julio" o "en que se me fue el dinero el mes pasado". Devuelve el total, el reparto por categoria con porcentajes, la separacion entre gastos fijos y variables, los principales proveedores y los movimientos individuales mas grandes.

Args: mes: Mes a analizar en formato 'YYYY-MM' (ej. '2026-08'). Si se omite, se usa el ultimo mes con datos registrados. incluir_comparacion: Si es True, agrega la comparacion contra el mes anterior y contra el promedio de los tres meses previos.

Detecta gastos inusuales comparando cada categoria contra su propio historial.

Util para responder "hubo algun gasto raro?" o para explicar por que un mes salio mal. Calcula el z-score de cada categoria por mes y reporta las desviaciones que superan el umbral, junto con el movimiento que las explica.

Args: meses: Cuantos meses hacia atras inspeccionar (minimo 3). umbral_z: Desviaciones estandar minimas para reportar un gasto como atipico. 2.0 es estricto; 1.5 muestra mas casos.

Analiza si los ingresos estan creciendo o bajando, con numeros concretos.

Responde "mis ventas van subiendo o bajando?". Entrega tres niveles de evidencia: la variacion contra el mes anterior, la comparacion interanual (que elimina el efecto de la estacionalidad) y una tendencia ajustada por minimos cuadrados con su R2 para indicar que tan confiable es.

Args: mes: Ultimo mes de la ventana de analisis en formato 'YYYY-MM'. Si se omite, se usa el ultimo mes con datos. meses: Tamano de la ventana de analisis, entre 3 y 24 meses.

Genera el estado de resultados de un mes: ingresos, gastos, utilidad y margen.

Responde "gane o perdi dinero en mayo?". Muestra los ingresos y gastos desglosados por categoria, separa gastos fijos de variables y calcula la utilidad neta y el margen, con el mes anterior como referencia.

Args: mes: Mes en formato 'YYYY-MM'. Si se omite, se usa el ultimo mes con datos.

Proyecta si alcanzara el dinero para cubrir los gastos del proximo mes.

Responde "me va a alcanzar el mes que viene?". Proyecta los ingresos con una tendencia corregida por estacionalidad, los gastos fijos categoria por categoria (lo que hace que julio con Bono 14 y diciembre con aguinaldo salgan correctos) y los gastos variables como proporcion de los ingresos. Devuelve el flujo neto, el saldo proyectado y una respuesta directa.

Args: meses: Cuantos meses proyectar hacia adelante, entre 1 y 6. saldo_inicial: Saldo en caja al inicio de la proyeccion, en quetzales. Si se omite se usa el resultado acumulado de los ultimos 6 meses como aproximacion, y se advierte en la respuesta. ventana: Cuantos meses de historial usar para ajustar la tendencia (3 a 18).

Resumen general del negocio en una sola pantalla.

Util como primera llamada cuando el usuario pregunta algo amplio como "como va mi negocio?". Devuelve promedios de los ultimos 6 meses, margen neto, cobertura de gastos fijos, peso de la nomina, meses con perdida en el ultimo ano y la planilla activa.