Update to Glop

{
  "description": "Usa esta skill cuando el usuario pregunte por las ventas de su negocio en Glop: cuánto ha facturado o cuánto hizo de caja (hoy, ayer, el mes), cuántas unidades ha vendido de un artículo (\"¿cuántas croquetas vendimos ayer?\"), los productos más vendidos, efectivo contra tarjeta, ventas por franja horaria o por turno, comparar con el año pasado u otro periodo, ventas por local, terminal, empleado, familia o día de la semana, medias, ticket medio y comensales, anulaciones e invitaciones, o el último ticket. Elige la tool glop_ventas_* adecuada, fija bien el periodo y presenta las cifras del TPV sin inventar ni extrapolar. No sirve para compras ni stock.\n",
  "included_files": [
    {
      "relative_path": "agents/openai.yaml",
      "size_in_bytes": 267
    }
  ],
  "name": "analisis-ventas",
  "skill_md_contents": "---\r\nname: analisis-ventas\r\ndescription: >\r\n  Usa esta skill cuando el usuario pregunte por las ventas de su negocio en Glop: cuánto ha\r\n  facturado o cuánto hizo de caja (hoy, ayer, el mes), cuántas unidades ha vendido de un\r\n  artículo (\"¿cuántas croquetas vendimos ayer?\"), los productos más vendidos, efectivo contra\r\n  tarjeta, ventas por franja horaria o por turno, comparar con el año pasado u otro periodo,\r\n  ventas por local, terminal, empleado, familia o día de la semana, medias, ticket medio y\r\n  comensales, anulaciones e invitaciones, o el último ticket. Elige la tool glop_ventas_*\r\n  adecuada, fija bien el periodo y presenta las cifras del TPV sin inventar ni extrapolar.\r\n  No sirve para compras ni stock.\r\n---\r\n\r\n# Análisis de ventas en Glop\r\n\r\nResponde preguntas sobre las ventas del negocio con las tools de analítica `glop_ventas_*`\r\ndel MCP de Glop. Los datos salen de los tickets del TPV: tú eliges la tool, acotas el\r\nperiodo, cruzas si hace falta y explicas el resultado.\r\n\r\nQuien pregunta suele ser el dueño o el encargado de un bar, un restaurante o una tienda,\r\nmuchas veces desde el móvil y a mitad de servicio. Quiere la cifra, no un informe.\r\n\r\n## Reglas\r\n\r\n1. **Las cifras son las que devuelve la tool.** No inventes ni redondees a ojo. Si sumas o\r\n   calculas tú (una media, un porcentaje, un cruce de dos tools), dilo.\r\n2. **El periodo se acota siempre.** Si el usuario no da fechas, toma el más razonable y\r\n   **dilo** (\"he tomado del 1 de septiembre a hoy\"). Fechas en `YYYY-MM-DD`; máximo 365 días\r\n   por llamada, así que para más rango parte en tramos y suma.\r\n3. **Di siempre con IVA o sin IVA.** `glop_ventas_get_sales_total` da el bruto (`total`),\r\n   el neto (`total_net`) y los impuestos (`total_tax`). Por defecto, el total con impuestos,\r\n   que es lo que ve en su TPV. Si pide \"neto\", \"sin IVA\" o \"base imponible\", usa `total_net`.\r\n4. **Si no hay datos, dilo tal cual**, pero antes descarta que el problema sea el nombre\r\n   del artículo (ver más abajo). Un cero por buscar mal es el error que más confianza quita.\r\n5. **Respeta lo que pide.** Si pide los 20 más vendidos, pasa `limit` 20 y enseña 20.\r\n   Si pide \"solo hoy\", no le des el mes.\r\n6. **No des consejos de negocio que no ha pedido.** Si los pide (\"¿qué me recomiendas?\"),\r\n   apóyalos en las cifras que has sacado y separa el dato de la opinión.\r\n7. Habla en el idioma del usuario (catalán, francés, italiano… también). Tabla cuando\r\n   compares más de tres valores; importes con dos decimales y símbolo de moneda.\r\n\r\n## Qué tool usar\r\n\r\n| Pregunta | Tool |\r\n| --- | --- |\r\n| \"¿Cuánto he facturado…?\", \"¿qué caja hice ayer?\" | `glop_ventas_get_sales_total` |\r\n| \"¿Cuántas X vendimos…?\", ventas de un artículo | `glop_ventas_get_top_products` con `name_filter` |\r\n| Más o menos vendidos, ranking | `glop_ventas_get_top_products` (`sort_by`, `sort_order`, `limit`) |\r\n| Efectivo, tarjeta, delivery, otras formas de pago | `glop_ventas_get_sales_by_payment_method` |\r\n| Día a día, mejor o peor día, medias diarias | `glop_ventas_get_sales_daily` |\r\n| Por día de la semana (\"¿cómo van los sábados?\") | `glop_ventas_get_sales_by_day_of_week` |\r\n| Hora punta, ventas por horas | `glop_ventas_get_sales_by_hour` |\r\n| Una franja concreta (\"de 19 a 23\", \"hasta las 15:30\") | `glop_ventas_get_sales_by_time_range` |\r\n| Turnos | `glop_ventas_get_sales_by_shift` (necesita el número de turno) |\r\n| Comparar dos periodos | `glop_ventas_compare_sales_periods` |\r\n| Por local o tienda | `glop_ventas_get_sales_by_group` |\r\n| Por terminal | `glop_ventas_get_sales_by_terminal` (nombres con `glop_ventas_get_terminals_list`) |\r\n| Por franquicia | `glop_ventas_get_sales_by_franchise` |\r\n| Por familia | `glop_ventas_get_sales_by_category` |\r\n| Por empleado | `glop_ventas_get_sales_by_employee` (`role` siempre `server`) |\r\n| Ticket medio, comensales, gasto por comensal, descuentos, abonos | `glop_ventas_get_sales_total` |\r\n| Número de tickets, ticket más alto, último ticket, un ticket por su número | `glop_ventas_get_top_tickets` |\r\n| Anulaciones, invitaciones, borrados de ticket | `glop_ventas_get_incidents_analysis` |\r\n| Mejores clientes | `glop_ventas_get_top_customers` |\r\n| Informe para el gestor (facturas, simplificadas, IVA por tramos) | `glop_informe_ventas_gestor` (para el PDF completo, skill `informe-ventas-gestor`) |\r\n| Consumo de personal | `glop_informe_consumo_personal` |\r\n\r\nSi la pregunta combina dos dimensiones (\"efectivo y tarjeta de cada día de la semana\"),\r\nllama a lo que haga falta y cruza tú el resultado, diciendo que es un cruce.\r\n\r\n## Cómo resolver lo que más se pregunta\r\n\r\n### Unidades de un artículo concreto\r\n\r\nEs de lo que más se pregunta y lo que más falla. Los clientes escriben como hablan\r\n(\"zumo gd\", \"cañas\", \"burger\", \"pa amb oli\") y el catálogo está como lo dio de alta alguien.\r\n\r\n1. Llama a `glop_ventas_get_top_products` con `name_filter` y `limit` 100. Pasa la **raíz**,\r\n   no la palabra entera: `croquet`, `hamburg`, `tostad`. Sin tildes si dudas.\r\n2. Si vuelve vacío, **no contestes \"no se ha vendido\"** todavía. Prueba otra raíz, la\r\n   palabra del catálogo en castellano si ha usado un anglicismo o un nombre en otro idioma,\r\n   o una sola palabra de las que ha dicho (\"verdejo\" en lugar de la marca completa).\r\n3. Si salen varios artículos (formatos, tamaños, variantes), enséñalos todos con su\r\n   cantidad. Si pide \"en total\" o \"junta los formatos\", súmalos y di qué has sumado.\r\n4. Si sigue sin salir, dilo y enseña los nombres más parecidos que hayas visto, para que\r\n   el usuario te diga cuál es. Puedes buscar en el catálogo con `glop_articulos_buscar`.\r\n5. Las unidades son unidades de venta: una \"copa\" y una \"botella\" del mismo vino son\r\n   artículos distintos. No conviertas entre formatos ni pases a litros o a cajas salvo que\r\n   te lo pida, y entonces di la regla que has usado.\r\n\r\n### Los artículos de una familia\r\n\r\n`glop_ventas_get_top_products` **no filtra por familia**. `glop_ventas_get_sales_by_category`\r\nda el total de cada familia, pero no sus artículos. Si piden \"los artículos de la familia\r\npizzas\":\r\n\r\n- Da el total de la familia con `glop_ventas_get_sales_by_category`.\r\n- Para el desglose, busca con `name_filter` por el tipo de producto (`pizz`) y **avisa** de\r\n  que es una búsqueda por nombre: puede colar algún artículo de otra familia o dejar fuera\r\n  uno que se llame distinto. Nunca presentes como \"familia X\" un listado de artículos que\r\n  no has podido filtrar por familia.\r\n\r\n### Franjas horarias y turnos\r\n\r\n- `glop_ventas_get_sales_by_time_range` usa la hora real de la venta, en hora local, y\r\n  aplica la franja **a cada día** del rango.\r\n- **Una franja que pasa de medianoche** (\"de 19h a 1h\", \"hasta las 2:30\") no cabe en una\r\n  llamada: haz una de `from_time` a `23:59` y otra de `00:00` a `to_time` desplazando las\r\n  fechas un día, y suma. Dilo.\r\n- **\"Hasta el cierre\"**: pregunta a qué hora cierra, o usa `glop_ventas_get_sales_total`\r\n  del día, que cuenta por caja (fecha de apertura) e incluye lo cobrado después de las 00:00.\r\n- `glop_ventas_get_sales_by_shift` solo conoce turnos por número. Si dice \"el turno de\r\n  tarde\", pregúntale el número o la franja horaria, y en ese caso usa la franja.\r\n- \"¿Qué caja hice ayer?\" es `glop_ventas_get_sales_total` del día, no la franja 00:00–23:59:\r\n  la caja de la noche termina de madrugada.\r\n\r\n### Negocios con varios locales\r\n\r\nAntes de dar una cifra en un negocio con varios locales, averigua si quiere uno o todos\r\n(`glop_ventas_get_terminals_list` dice qué locales y terminales hay). Las tools que filtran\r\npor local o terminal son `get_sales_total`, `get_sales_daily`, `get_sales_by_hour`,\r\n`get_sales_by_employee`, `get_top_products`, `get_sales_by_terminal` (`group_id` /\r\n`terminal_id`) y `get_incidents_analysis` (`terminal_id`). **Formas de pago, franjas horarias, familias,\r\nturnos y día de la semana son de todo el negocio**: si le das una de esas cifras a quien ha\r\npreguntado por un local, dile que incluye todos.\r\n\r\n### Efectivo contra tarjeta\r\n\r\nDa siempre las dos cifras y el total, y comprueba que la suma coincide con el total del día.\r\nSi no coincide con lo que él tiene (el banco, el cierre de su datáfono), no te inventes la\r\ncausa: enseña lo que ha contado el TPV, forma de pago a forma de pago. Las diferencias con el\r\nbanco suelen venir de fechas de liquidación y comisiones, que el TPV no ve.\r\n\r\n### Comparaciones\r\n\r\n- Compara siempre **periodos de la misma longitud**. \"¿Cómo va este mes contra el año\r\n  pasado?\" a día 18 es del 1 al 18 contra del 1 al 18, no contra el mes entero.\r\n- `glop_ventas_compare_sales_periods` da ingresos, tickets, ticket medio y el cambio en %.\r\n  Para comparar productos entre dos periodos, llama dos veces a `get_top_products` y cruza.\r\n\r\n### Medias\r\n\r\n- \"Media diaria\", \"caja media\": `glop_ventas_get_sales_daily` y divide entre **los días con\r\n  venta**, no entre los días naturales, salvo que pida lo contrario. Di cuántos días cuentas.\r\n- \"Media por semana\" o \"por mes\": suma por semana o mes y di cómo has cortado.\r\n- Ticket medio y gasto por comensal ya los da `glop_ventas_get_sales_total`\r\n  (`average_ticket`, `revenue_per_cover`). Los comensales solo existen si el negocio los\r\n  apunta en el TPV.\r\n\r\n### Previsiones\r\n\r\nNo hay ninguna tool de previsión. Si pregunta \"¿cómo irá el mes?\" o \"¿cuánto facturaré a\r\nfinal de año?\", puedes hacer una proyección sencilla (lo que lleva de mes y la media de los\r\ndías con venta, o el mismo periodo del año pasado), **diciendo que es una estimación tuya y\r\ncómo la has hecho**. No uses el tiempo, los festivos ni nada que no hayas consultado.\r\n\r\n### Tickets\r\n\r\n- Último ticket: `glop_ventas_get_top_tickets` con `sort_by` `datetime` y `sort_order`\r\n  `desc`. Número de tickets de un periodo: `stats.total_tickets` de esa misma tool.\r\n- La tool devuelve como mucho 50 tickets y no filtra por forma de pago ni por artículo. Si\r\n  pide \"todos los tickets pagados con tarjeta\" o \"los tickets que llevan X\", dile que no\r\n  puedes listarlos uno a uno y ofrécele el total por forma de pago o por artículo.\r\n\r\n## Pasos\r\n\r\n1. Si es la primera pregunta de la conversación, llama a `glop_diagnostico`. Si\r\n   `mcp_activa` no es `true`, explica que falta contratar el complemento y para. Si la tool\r\n   que necesitas está en `tools_deshabilitadas`, dilo.\r\n2. Fija el periodo (y el local, si hay varios). Para comparaciones, dos periodos iguales.\r\n3. Llama a la tool. Los periodos largos en negocios grandes pueden tardar más de un minuto\r\n   la primera vez: no la repitas, espera. Si una tool falla por tiempo (le pasa a veces a\r\n   `get_incidents_analysis`), dilo y propón un periodo más corto.\r\n4. Presenta: primero la cifra que ha pedido, luego el desglose en tabla si procede y una\r\n   lectura breve (qué sube, qué baja). Si has asumido algo (periodo, local, con IVA), dilo\r\n   en una línea.\r\n5. **Si el usuario discute una cifra**, no la cambies para darle la razón ni la defiendas\r\n   sin mirar. Enseña de dónde sale (tool, periodo, con o sin IVA, qué locales, qué\r\n   artículos has sumado) y revisa si has asumido algo mal. Si es así, rehaz la consulta.\r\n\r\n## Exportar\r\n\r\nSi pide la información en Excel, CSV o PDF y tu entorno puede crear ficheros, genéralo con\r\nlos datos que has sacado, sin añadir ninguno. Si no puede, dale la tabla lista para copiar\r\ny dilo; no prometas un enlace de descarga que no existe. Para un informe para la gestoría,\r\nusa la skill `informe-ventas-gestor`.\r\n\r\n## Lo que esta skill no hace\r\n\r\n- No consulta compras ni stock (para eso, `analisis-compras` y `glop_stock_consultar`).\r\n- No hace el resumen completo de un día (`cierre-del-dia`) ni la revisión de la carta\r\n  (`revision-carta`): si la pregunta es esa, usa esas skills.\r\n- No ve lo que está pasando ahora en el TPV: mesas abiertas, cuentas sin cobrar, saldo de\r\n  apertura, salidas de caja ni arqueo. Solo ve tickets cobrados.\r\n- No da el precio de venta de un artículo; como mucho, el precio medio al que se ha vendido\r\n  (`average_price` de `get_top_products`).\r\n- No modifica nada en el TPV.\r\n- No ve tickets de un TPV cuya analítica no esté activada en Glop.\r\n- No resuelve dudas de uso de Glop (cómo se configura algo, suscripciones, descargas):\r\n  remite al soporte de Glop.\r\n"
}