Glop

View saved version →

---
name: alta-albaran-compra
description: >
  Usa esta skill SIEMPRE que el usuario adjunte una foto, escaneo o PDF de un albarán de
  compra o de una factura de proveedor y quiera registrarlo en Glop: "registra este albarán",
  "mete esta factura de compra", "lee este albarán del proveedor", o simplemente adjunte la
  imagen y pida procesarla. Lee el documento, resuelve proveedor y artículos con las tools del
  MCP de Glop, enseña la previsualización que calcula el TPV y, tras confirmación explícita del
  usuario, registra el documento. Requiere el MCP de Glop conectado y el complemento
  contratado. No sirve para albaranes de venta a clientes ni para pedidos a proveedor.
---

# Alta de albarán de compra en Glop

Convierte la foto o el PDF de un albarán de proveedor en un documento de compra en Glop. El
proceso es **conversacional y por fases**: cada fase se cierra con el usuario antes de pasar
a la siguiente.

Esta skill dice **en qué orden** hacer las cosas y **cómo hablar con el usuario**. Las reglas
de negocio (qué se escribe y cuándo, cómo se convierten envases, cómo se cuadran los totales,
qué datos exige un artículo nuevo) **las dicta el servidor**: están en la descripción de cada
tool y en sus respuestas. Cuando una respuesta traiga `siguiente_paso` o una instrucción,
mándan ellas sobre este documento.

> **El OCR lo pones tú.** Glop no lee la imagen: tú la lees y él valida, calcula y registra.

## Lo que no se negocia

1. **Nada se escribe sin un sí explícito del usuario**, y el sí se pide sobre la
   previsualización que devuelve el servidor, nunca sobre un resumen tuyo.
2. **No inventes datos.** Lo que no leas con seguridad, se pregunta.
3. **No decidas un artículo por parecido de nombre.** Presenta candidatos y que elija el
   usuario.
4. **Los cálculos los hace Glop.** No conviertas envases ni calcules totales de cabecera.
5. **Descartar el documento entero siempre es una salida válida.**
6. Habla en el idioma del usuario, claro y sin tecnicismos.

## Fase 0 — Preparación

1. Comprueba que hay imagen o PDF adjunto. Si no, pídelo.
2. Llama a `glop_diagnostico`. Si `mcp_activa` no es `true` o falta alguna de las tools que
   necesitas en `tools_deshabilitadas`, dilo ahora y para.
3. Carga `glop_terminales_listar`, `glop_almacenes_listar`, `glop_ivas_listar` y
   `glop_envases_listar`.
4. Si hay varios terminales, pregunta cuál registra el albarán. Si solo hay uno, úsalo y dilo.

## Fase 1 — Lectura del documento

Extrae la estructura completa y **anota dónde tienes poca confianza**:

- **Proveedor**: nombre o razón social, NIF, dirección, teléfono.
- **Documento**: número del albarán del proveedor, fecha del documento, fecha de entrega.
- **Líneas**: referencia del proveedor, código de barras, descripción, cantidad, unidad o
  formato (cajas, unidades, kg), precio, descuento, importe, tipo de IVA (si viene como R1, R2
  o R3, guárdalo tal cual).
- **Totales**: bases por IVA, cuotas, recargo, descuentos de pie, portes y total.
- **Anotaciones a mano**: abonos, cantidades tachadas, líneas añadidas. Sepáralas de lo
  impreso: lo impreso puede no ser lo que se recibió.

Antes de seguir, comprueba tú mismo que cantidad × precio − descuento ≈ importe de cada línea.
Si no cuadra, vuelve a mirar esa zona con zoom. No sigas con cifras incoherentes.

Si el papel indica más hojas de las que tienes ("página 1 de 2", sin total), pide las que
faltan antes de continuar.

## Fase 2 — El proveedor

1. Búscalo con `glop_proveedores_buscar`, primero por NIF normalizado y, si no, por palabras
   del nombre (sin S.L. ni S.A.).
2. Si existe, enseña la coincidencia (ID, nombre, NIF) y sigue.
3. Si no existe, propón el alta con los datos leídos y usa `glop_proveedor_crear`. Un ticket
   de un establecimiento (mercado, supermercado) también necesita su proveedor: pregunta los
   datos que no estén en el papel.

## Fase 3 — Los artículos, línea a línea

Para cada l

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 1 — file references are metadata, not package contents.

View saved version →

---
name: analisis-compras
description: >
  Usa esta skill cuando el usuario pregunte por sus compras a proveedores en Glop: cuánto ha
  gastado y en qué proveedores, qué productos compra más, cómo ha evolucionado el precio de
  compra de un artículo ("¿me han subido la Coca-Cola?"), o qué proporción de lo que factura
  se le va en compras. También para buscar documentos de compra ya registrados y consultar
  existencias. Elige la tool glop_compras_* o de stock adecuada y traslada siempre las
  limitaciones de los datos. No registra albaranes: para eso está alta-albaran-compra.
---

# Análisis de compras y stock en Glop

Responde preguntas sobre el gasto en proveedores, los precios de compra y las existencias con
las tools `glop_compras_*`, `glop_compras_documentos_buscar` y `glop_stock_consultar`.

## Reglas

1. **Las cifras son las de la tool.** Cada respuesta de compras dice qué tipos de documento
   ha contado en `document_types_included`: trasládalo. Por defecto cuentan albaranes y
   facturas de proveedor (tipos 2 y 3); los pedidos (tipo 1) no son gasto.
2. **Todo sin IVA cuando se compara con ventas.** `glop_compras_compare_purchases_vs_sales`
   compara base contra base y trae un `disclaimer`: repítelo. **No es margen por artículo ni
   coste de la mercancía vendida.**
3. **La analítica solo ve lo registrado por los canales de Glop** (módulo de Compras, este
   asistente o el chat de la app). Lo tecleado directamente en el TPV no está. Si el usuario
   ve menos gasto del que espera, esta es la primera causa.
4. **Un documento editado o borrado en el TPV no se actualiza aquí.** Dilo si sale una cifra
   que el usuario discute.
5. Los abonos son líneas negativas: restan solos en el gasto y no salen en el histórico de
   precios.
6. Habla en el idioma del usuario. Fechas en `YYYY-MM-DD`.

## Cómo elegir la tool

| El usuario pregunta… | Tool |
| --- | --- |
| "¿Cuánto le he comprado a X?", "¿en qué proveedores se me va el dinero?" | `glop_compras_get_purchases_by_supplier` |
| "¿Qué compro más?", "¿en qué se me va el dinero de compras?" | `glop_compras_get_top_purchased_products` |
| "¿Cómo ha evolucionado el precio de…?", "¿me han subido el precio?" | `glop_compras_get_purchase_price_history` |
| "¿Qué parte de lo que facturo se va en compras?" | `glop_compras_compare_purchases_vs_sales` (máximo 366 días; `granularity` `total` o `month`) |
| Ver un albarán o pedido concreto ya registrado | `glop_compras_documentos_buscar` y `glop_compra_documento_obtener` |
| Existencias de un artículo o almacén | `glop_stock_consultar` (con `glop_almacenes_listar` si hay varios) |
| Quién sirve un artículo y a qué precio | `glop_mapeo_buscar` |

## Pasos

1. Si es la primera pregunta de la conversación, llama a `glop_diagnostico` y confirma que
   `mcp_activa` es `true`.
2. Fija el periodo (`from`, `to`). Si el usuario no lo dice, toma el mes en curso y dilo.
3. Para preguntas por proveedor o artículo, usa los filtros por nombre (`supplier_name`,
   `product_name`), que ignoran mayúsculas y acentos. Si hay varias coincidencias, pregunta.
4. Llama a la tool. `compare_purchases_vs_sales` puede tardar más de un minuto la primera
   vez en sitios grandes: no la repitas.
5. Presenta la cifra, el desglose en tabla y las limitaciones que apliquen (reglas 1 a 5).

## Lo que esta skill no hace

- No registra ni modifica documentos: para meter un albarán, `alta-albaran-compra`.
- No analiza ventas (para eso, `analisis-ventas`).
- No calcula márgenes por artículo: Glop no cruza escandallo con ventas en estas tools.

Referenced files: 1 — file references are metadata, not package contents.

View saved version →

---
name: analisis-ventas
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.
---

# Análisis de ventas en Glop

Responde preguntas sobre las ventas del negocio con las tools de analítica `glop_ventas_*`
del MCP de Glop. Los datos salen de los tickets del TPV: tú eliges la tool, acotas el
periodo, cruzas si hace falta y explicas el resultado.

Quien pregunta suele ser el dueño o el encargado de un bar, un restaurante o una tienda,
muchas veces desde el móvil y a mitad de servicio. Quiere la cifra, no un informe.

## Reglas

1. **Las cifras son las que devuelve la tool.** No inventes ni redondees a ojo. Si sumas o
   calculas tú (una media, un porcentaje, un cruce de dos tools), dilo.
2. **El periodo se acota siempre.** Si el usuario no da fechas, toma el más razonable y
   **dilo** ("he tomado del 1 de septiembre a hoy"). Fechas en `YYYY-MM-DD`; máximo 365 días
   por llamada, así que para más rango parte en tramos y suma.
3. **Di siempre con IVA o sin IVA.** `glop_ventas_get_sales_total` da el bruto (`total`),
   el neto (`total_net`) y los impuestos (`total_tax`). Por defecto, el total con impuestos,
   que es lo que ve en su TPV. Si pide "neto", "sin IVA" o "base imponible", usa `total_net`.
4. **Si no hay datos, dilo tal cual**, pero antes descarta que el problema sea el nombre
   del artículo (ver más abajo). Un cero por buscar mal es el error que más confianza quita.
5. **Respeta lo que pide.** Si pide los 20 más vendidos, pasa `limit` 20 y enseña 20.
   Si pide "solo hoy", no le des el mes.
6. **No des consejos de negocio que no ha pedido.** Si los pide ("¿qué me recomiendas?"),
   apóyalos en las cifras que has sacado y separa el dato de la opinión.
7. Habla en el idioma del usuario (catalán, francés, italiano… también). Tabla cuando
   compares más de tres valores; importes con dos decimales y símbolo de moneda.

## Qué tool usar

| Pregunta | Tool |
| --- | --- |
| "¿Cuánto he facturado…?", "¿qué caja hice ayer?" | `glop_ventas_get_sales_total` |
| "¿Cuántas X vendimos…?", ventas de un artículo | `glop_ventas_get_top_products` con `name_filter` |
| Más o menos vendidos, ranking | `glop_ventas_get_top_products` (`sort_by`, `sort_order`, `limit`) |
| Efectivo, tarjeta, delivery, otras formas de pago | `glop_ventas_get_sales_by_payment_method` |
| Día a día, mejor o peor día, medias diarias | `glop_ventas_get_sales_daily` |
| Por día de la semana ("¿cómo van los sábados?") | `glop_ventas_get_sales_by_day_of_week` |
| Hora punta, ventas por horas | `glop_ventas_get_sales_by_hour` |
| Una franja concreta ("de 19 a 23", "hasta las 15:30") | `glop_ventas_get_sales_by_time_range` |
| Turnos | `glop_ventas_get_sales_by_shift` (necesita el número de turno) |
| Comparar dos periodos | `glop_ventas_compare_sales_periods` |
| Por local o tienda | `glop_ventas_get_sales_by_group` |
| Por terminal | `glop_ventas_get_sales_by_terminal` (nombres con `glop_ventas_get_terminals_list`) |
| Por franquicia | `glop_ventas_get_sales_by_franchise` |
| Por familia | `glop_ventas_get_sales_by_category` |
| Por empleado | `glop_ventas_get_sales_by_employee` (`role` siempre `server`) |
| Ticket medio, comensales, gasto por comensal, descuentos, abonos | `glop_ventas_get_sales_total` |
| Número de tickets, ticket más alto, último ticket, un ticket por su número 

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 1 — file references are metadata, not package contents.

View saved version →

---
name: cierre-del-dia
description: >
  Usa esta skill cuando el usuario quiera el resumen de un día de su negocio en Glop: "¿cómo ha
  ido hoy?", "hazme el cierre de ayer", "¿qué caja hicimos el sábado?", "resumen del día con
  efectivo y tarjeta", "¿cómo va el día?" a mitad de servicio. Da de una vez el total con y sin
  IVA, efectivo contra tarjeta, tickets y ticket medio, los productos más vendidos, las
  anulaciones e invitaciones y la comparación con el mismo día de la semana anterior, todo con
  las tools glop_ventas_*. Sirve para un día o para un fin de semana; para periodos más largos
  o preguntas sueltas está analisis-ventas. No es un arqueo de caja: no ve el efectivo del cajón.
---

# Cierre del día

El dueño de un bar o de una tienda quiere saber, al final del día o a la mañana siguiente,
cómo ha ido. Hoy lo pregunta en cuatro mensajes (cuánto, cuánto en efectivo y cuánto en
tarjeta, qué se ha vendido, si ha habido anulaciones). Esta skill se lo da en uno.

Las cifras salen de las tools. Tú eliges el día, llamas, cuadras y presentas.

## Reglas

1. **El día es el de la caja.** Una caja que abre el sábado y cierra el domingo a las 2:00
   es el sábado. Por eso el total sale de `glop_ventas_get_sales_total` con `from` y `to`
   iguales al día, que cuenta por fecha de apertura de caja. No uses una franja de
   00:00 a 23:59 para el total.
2. **Qué día.** "Hoy" es hoy; "ayer" y "el sábado" son el último que haya pasado. Si
   pregunta por la mañana temprano "¿cómo fue?" sin más, es ayer. Dilo siempre con la fecha
   ("sábado 12 de septiembre").
3. **Hoy es un día a medias.** Si el día es hoy, di que es lo que lleva cobrado hasta ahora
   y que las mesas abiertas no cuentan: la analítica solo ve tickets cobrados.
4. **Cuadra antes de enseñar.** La suma de las formas de pago tiene que dar el total. Si no
   da, enséñalo tal cual y di la diferencia; no la repartas ni la escondas.
5. **Nada de consejos** si no los pide. Una línea de lectura ("un 12 % por encima del sábado
   pasado, sobre todo por la tarde") sí; recomendaciones, no.
6. Habla en su idioma. Importes con dos decimales y símbolo de moneda.

## Pasos

1. Si es la primera pregunta de la conversación, `glop_diagnostico`. Si `mcp_activa` no es
   `true`, explícale que falta el complemento y para.
2. **¿Tiene varios locales?** Si no lo sabes, `glop_ventas_get_terminals_list`. Con más de
   un local, pregunta si quiere uno o todos, salvo que ya lo haya dicho.
3. Llama, con el mismo día en `from` y `to`:
   - `glop_ventas_get_sales_total` (con `group_id` o `terminal_id` si es un local): `total`,
     `total_net`, `total_tax`, `num_tickets`, `average_ticket` y, si los hay, comensales,
     descuentos y abonos.
   - `glop_ventas_get_sales_by_payment_method`.
   - `glop_ventas_get_top_products` con `limit` 10 (con `group_id` o `terminal_id` si es un
     local).
   - `glop_ventas_get_sales_by_hour` (con `group_id` si es un local), para decir cuál fue la
     hora fuerte.
   - `glop_ventas_get_incidents_analysis` para anulaciones, borrados e invitaciones. Si falla
     por tiempo, sigue sin ella y dilo en una línea: no bloquees el resumen por esto.
   - `glop_ventas_get_sales_total` del **mismo día de la semana anterior**, con el mismo
     filtro de local, para comparar.
4. Monta el resumen.

## Cómo presentarlo

Corto, que se lee en el móvil. En este orden:

1. **Una línea con la cifra**: "Sábado 12/09: 3.482,50 € con IVA (3.165,91 € sin IVA),
   214 tickets, ticket medio 16,27 €. Un 8 % más que el sábado anterior."
2. **Formas de pago**: tabla de una fila por forma de pago con importe y %, y el total.
3. **Lo más vendido**: los cinco primeros por unidades, con importe. Si pide más, los diez.
4. **Hora fuerte**: la hora o las dos horas con más venta, en una línea.
5. **Incidencias**: número e importe de anulaciones, borrados de ticket e invitaciones. Si
   una sola persona acumula muchas, dilo con s

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 1 — file references are metadata, not package contents.

View saved version →

---
name: informe-compras-asesor
description: >
  Usa esta skill cuando el usuario quiera preparar un informe de sus compras a proveedores en
  Glop para enviárselo a su asesor, gestor o contable: "prepárame el informe de compras del
  mes para mi asesor", "necesito mandar a la gestoría lo que he comprado este trimestre",
  "haz un PDF con las compras para el contable". Reúne las cifras con las tools glop_compras_*,
  compone un informe en PDF pensado para quien lleva la contabilidad (resumen, gasto por
  proveedor con base e IVA, artículos principales y limitaciones de los datos) y prepara el
  correo de envío. Si el asistente dispone de una herramienta de correo, ofrece enviarlo
  desde ahí tras confirmación; si no, entrega el PDF y el texto del correo listos para pegar.
  No sustituye a las facturas de proveedor ni a los libros registro.
---

# Informe de compras para el asesor

Prepara un documento que el dueño del negocio pueda mandar a su asesor sin tener que
explicarlo: qué ha comprado, a quién, cuánto ha sido base y cuánto IVA, y qué fiabilidad
tienen esas cifras. Va en tres fases: **datos**, **PDF** y **envío**. Cada una se cierra con
el usuario antes de pasar a la siguiente.

Las cifras las calculan las tools de Glop. Tú no sumas ni recalculas nada: ordenas,
presentas y explicas.

## Lo que no se negocia

1. **Nada sale del asistente sin un sí explícito del usuario.** Ni el PDF se da por bueno
   ni el correo se envía sin que el usuario haya visto el contenido y el destinatario.
2. **El informe no es un documento fiscal.** Lo dice en su portada y lo dices tú: el asesor
   contabiliza con las facturas de proveedor, y este informe le sirve para cuadrar,
   anticipar el IVA soportado y detectar facturas que faltan.
3. **No inventes datos del asesor.** Nombre, correo y tratamiento se preguntan o se toman de
   lo que el usuario haya dicho. Nunca se buscan en fuentes externas.
4. **Manda lo justo.** Al asesor le va el PDF. No pegues las tablas en el cuerpo del correo
   ni añadas datos que no se le hayan enseñado al usuario.
5. Habla en el idioma del usuario. Fechas en `YYYY-MM-DD` en las tools y en formato local
   en el informe (`31/08/2026`). Importes con dos decimales y símbolo de moneda.

## Fase 1 — Datos

1. Si es la primera llamada de la conversación, `glop_diagnostico`. Si `mcp_activa` no es
   `true` o alguna tool `glop_compras_*` está en `tools_deshabilitadas`, dilo y para.
2. **Fija el periodo.** Si el usuario no lo indica, propón el **mes natural anterior**
   completo (es lo que suele pedir un asesor) y confírmalo antes de seguir. Para un
   trimestre, usa el trimestre natural. El rango máximo es de 365 días.
3. Pregunta, en un solo mensaje, lo que falte:
   - Nombre del negocio como quiere que figure (razón social o nombre comercial).
   - Nombre del asesor y su correo, solo si va a haber envío.
   - Si quiere incluir la sección de artículos principales (por defecto sí) y la de compras
     frente a ventas (por defecto **no**: tarda más de un minuto en sitios grandes y su
     lectura exige matices).
4. Llama a las tools, todas con el mismo `from` y `to`:
   - `glop_compras_get_purchases_by_supplier` con `limit` 100. Trae por proveedor
     `total_base`, `total_tax`, `total`, `num_documents`, primera y última compra y
     `share_percentage`, y en `period_totals` los totales del periodo. Es la columna
     vertebral del informe.
   - `glop_compras_get_top_purchased_products` con `limit` 15, si el usuario la quiere.
   - `glop_compras_compare_purchases_vs_sales` con `granularity` `month`, solo si la ha
     pedido expresamente. Guarda su `disclaimer` tal cual.
5. Anota `document_types_included` de cada respuesta: por defecto cuenta albaranes (tipo 2)
   y facturas de proveedor (tipo 3), y los pedidos quedan fuera. El informe lo dirá.
6. Enseña al usuario el **resumen en texto** antes de montar nada: total del periodo (base,
   IVA, total), número 

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 1 — file references are metadata, not package contents.

View saved version →

---
name: informe-ventas-gestor
description: >
  Usa esta skill cuando el usuario quiera preparar las ventas de su negocio en Glop para su
  gestor, asesor o contable: "prepárame las ventas del mes para el gestor", "necesito el IVA
  desglosado del trimestre para la gestoría", "haz un PDF con las ventas de agosto para el
  contable", "pásame las ventas del trimestre en CSV para la gestoría", "¿dónde saco los
  números del mes para mi asesor?". Reúne el informe con glop_informe_ventas_gestor
  (simplificadas por día y serie, facturas una a una con los datos del cliente, rectificativas
  y desglose por tipo de IVA), pregunta al usuario si lo quiere en PDF (para leer), en CSV
  (para importar en una hoja de cálculo o en el programa del gestor) o en los dos, lo genera y
  prepara el correo de envío. Si el asistente dispone de una herramienta de correo, ofrece
  enviarlo tras confirmación; si no, entrega los ficheros y el texto del correo listos para
  pegar. No sustituye a los libros registro ni a la exportación
  contable de Glop.
---

# Informe de ventas para el gestor

Prepara lo que el dueño del negocio pueda mandar a su gestor sin tener que explicarlo:
qué ha vendido en el periodo, con qué IVA, qué facturas ha emitido y a quién, y qué
rectificativas hay. Puede salir en **PDF** (para leer), en **CSV** (para importar) o en los
dos; lo elige el usuario. Va en tres fases: **datos**, **ficheros** y **envío**. Cada una se
cierra con el usuario antes de pasar a la siguiente.

Las cifras las da `glop_informe_ventas_gestor`. Tú agrupas, sumas para los totales,
compruebas que cuadran y presentas; no recalculas bases ni cuotas.

## Lo que no se negocia

1. **Nada sale del asistente sin un sí explícito del usuario.** Ni los ficheros se dan por
   buenos ni el correo se envía sin que haya visto el contenido y el destinatario.
2. **El informe no es un documento fiscal.** Lo dice la portada del PDF y lo dices tú: el gestor
   contabiliza con la exportación contable de Glop o con sus propios libros; este informe
   le sirve para cuadrar y anticipar el IVA repercutido.
3. **No inventes datos del gestor.** Nombre, correo y tratamiento se preguntan o se toman
   de lo que el usuario haya dicho. Nunca se buscan fuera.
4. **Datos de clientes, solo donde hacen falta.** Las facturas llevan NIF y nombre del
   cliente porque el gestor los necesita (modelo 347). Van en los ficheros, nunca en el
   cuerpo del correo.
5. Habla en el idioma del usuario. Fechas en `YYYY-MM-DD` en las tools y en formato local
   en el informe (`31/08/2026`). Importes con dos decimales y símbolo de moneda.

## Fase 1 — Datos

1. Si es la primera llamada de la conversación, `glop_diagnostico`. Si `mcp_activa` no es
   `true` o `glop_informe_ventas_gestor` está en `tools_deshabilitadas`, dilo y para.
2. **Fija el periodo.** Si no lo indica, propón el **mes natural anterior** completo y
   confírmalo. Para un trimestre, el trimestre natural. El informe de un mes de un negocio
   grande es muy largo (del orden de mil registros): para un trimestre, pide **un mes cada
   vez** y júntalos.
3. Pregunta, en un solo mensaje, lo que falte:
   - **En qué formato lo quiere**: PDF (un informe para leer), CSV (una tabla para abrir en
     Excel o importar en el programa de contabilidad del gestor) o los dos. Si no lo sabe,
     recomiéndale los dos: el PDF para revisarlo él y el CSV para que el gestor no tenga que
     teclear nada. Si ya lo ha dicho ("en CSV", "un PDF"), no lo vuelvas a preguntar.
   - Nombre del negocio como quiere que figure (razón social o nombre comercial).
   - Nombre y correo del gestor, solo si va a haber envío.
   - Si quiere añadir el reparto por formas de pago (por defecto no).
4. Llama a `glop_informe_ventas_gestor` con `date_from` y `date_to`. Devuelve registros con
   un campo `tipo`:
   - `simplificada`: **uno por día y serie**, con `fecha`, `serie`, `num_documentos`,
     `numero_desde` y `nume

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 1 — file references are metadata, not package contents.

View saved version →

---
name: revision-carta
description: >
  Usa esta skill cuando el usuario quiera revisar su carta o su surtido con los datos de venta
  de Glop: "¿qué platos tiran y cuáles sobran?", "¿qué debería quitar de la carta?", "¿cómo se
  ha vendido cada producto este año contra el pasado?", "¿cómo me ha afectado subir el precio
  del menú?", "¿qué hamburguesa se vende más?", "ranking de la familia postres". Monta un
  análisis guiado con glop_ventas_get_top_products y glop_ventas_get_sales_by_category:
  productos estrella, productos que casi no salen, qué sube y qué baja entre dos periodos y el
  antes y el después de un cambio de precio. Separa siempre el dato de la opinión. Para una
  pregunta suelta sobre un producto está analisis-ventas. No calcula márgenes por plato.
---

# Revisión de carta

El dueño quiere decidir qué se queda, qué sale y qué empuja. Esta skill le da los datos de
venta ordenados para decidir. La decisión es suya.

Las cifras salen de las tools. Tú fijas el alcance, cruzas periodos, clasificas y explicas.

## Reglas

1. **Dato y opinión, separados.** Primero las cifras; después, si las pide, tu lectura,
   marcada como tal ("con estos datos, yo miraría…"). Nunca "hay que quitar X".
2. **Periodos comparables.** Misma longitud y, si puedes, los mismos días de la semana y la
   misma temporada. Un producto de verano comparado con marzo siempre "baja".
3. **Unidades e ingresos, los dos.** Un producto puede vender poco y facturar mucho. Cuando
   ordenes, di por qué (`sort_by` `quantity` o `revenue`).
4. **Sin margen por plato.** La analítica sabe a cuánto se ha vendido cada artículo, no
   cuánto cuesta hacerlo: el escandallo no está aquí y el precio de compra es de los
   ingredientes, no del plato. Si pregunta por rentabilidad, dilo, y como mucho da el precio
   medio de venta (`average_price`).
5. **Lo que no se vende no aparece.** Un artículo sin ninguna venta en el periodo no sale en
   la analítica. "Lo que menos se vende" es lo que menos ha vendido *de lo que ha vendido
   algo*; si quiere saber qué no ha salido nunca, díselo.
6. Habla en su idioma. Tablas para los rankings; importes con dos decimales.

## Paso 1 — Alcance

Pregunta lo que falte, en un solo mensaje:

- **Periodo**: por defecto, los últimos 90 días. Para comparar, el mismo tramo del año
  anterior o los 90 días previos. Máximo 365 días por llamada.
- **Qué parte de la carta**: toda, una familia ("postres"), o un tipo de producto
  ("hamburguesas", "gildas").
- **Local**, si tiene varios (`glop_ventas_get_terminals_list`).
- **La pregunta de fondo**: qué quitar, qué empujar, cómo va un producto, o el efecto de un
  cambio de precio. Cambia qué enseñas primero.

Si es la primera llamada de la conversación, `glop_diagnostico`; si `mcp_activa` no es
`true`, dilo y para.

## Paso 2 — Datos

### Toda la carta

- `glop_ventas_get_sales_by_category` del periodo: peso de cada familia en unidades e
  ingresos.
- `glop_ventas_get_top_products` con `limit` 100 y `sort_by` `revenue`: los que más
  facturan. Otra llamada con `sort_by` `quantity`.
- `glop_ventas_get_top_products` con `sort_order` `asc`: los que menos salen.

Con más de 100 artículos vendidos no vas a verlos todos en una llamada: dilo y céntrate en
los extremos o trabaja por familia.

### Una familia o un tipo de producto

`glop_ventas_get_top_products` **no filtra por familia**. Usa `name_filter` con la raíz del
tipo de producto (`hamburg`, `postre`, `gilda`) y `limit` 100, y avisa de que es una
selección por nombre: puede colarse un artículo de otra familia o quedarse fuera uno que se
llame distinto. El total de la familia, de `glop_ventas_get_sales_by_category`, te sirve
para comprobar cuánto se te escapa: si la suma de lo que has encontrado queda muy lejos del
total de la familia, dilo.

### Comparar dos periodos

Las mismas llamadas para cada periodo, con el mismo filtro, y cruza por nombre de artículo.
Para 

Preview of the first 4,000 characters. Read full instructions →

Referenced files: 1 — file references are metadata, not package contents.