{"id":84501,"plugin_id":"plugin_asdk_app_6ad86440568081918ff9dae945918393","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-11-06T12:12:24.672Z","digest":"94d7191cbbc6b99eb39154b938c9df0dd56c0e885e8fb817bdf597e60092e979","against":null,"payload":{"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.\n","included_files":[{"relative_path":"agents/openai.yaml","size_in_bytes":267}],"name":"informe-ventas-gestor","skill_md_contents":"---\r\nname: informe-ventas-gestor\r\ndescription: >\r\n  Usa esta skill cuando el usuario quiera preparar las ventas de su negocio en Glop para su\r\n  gestor, asesor o contable: \"prepárame las ventas del mes para el gestor\", \"necesito el IVA\r\n  desglosado del trimestre para la gestoría\", \"haz un PDF con las ventas de agosto para el\r\n  contable\", \"pásame las ventas del trimestre en CSV para la gestoría\", \"¿dónde saco los\r\n  números del mes para mi asesor?\". Reúne el informe con glop_informe_ventas_gestor\r\n  (simplificadas por día y serie, facturas una a una con los datos del cliente, rectificativas\r\n  y desglose por tipo de IVA), pregunta al usuario si lo quiere en PDF (para leer), en CSV\r\n  (para importar en una hoja de cálculo o en el programa del gestor) o en los dos, lo genera y\r\n  prepara el correo de envío. Si el asistente dispone de una herramienta de correo, ofrece\r\n  enviarlo tras confirmación; si no, entrega los ficheros y el texto del correo listos para\r\n  pegar. No sustituye a los libros registro ni a la exportación\r\n  contable de Glop.\r\n---\r\n\r\n# Informe de ventas para el gestor\r\n\r\nPrepara lo que el dueño del negocio pueda mandar a su gestor sin tener que explicarlo:\r\nqué ha vendido en el periodo, con qué IVA, qué facturas ha emitido y a quién, y qué\r\nrectificativas hay. Puede salir en **PDF** (para leer), en **CSV** (para importar) o en los\r\ndos; lo elige el usuario. Va en tres fases: **datos**, **ficheros** y **envío**. Cada una se\r\ncierra con el usuario antes de pasar a la siguiente.\r\n\r\nLas cifras las da `glop_informe_ventas_gestor`. Tú agrupas, sumas para los totales,\r\ncompruebas que cuadran y presentas; no recalculas bases ni cuotas.\r\n\r\n## Lo que no se negocia\r\n\r\n1. **Nada sale del asistente sin un sí explícito del usuario.** Ni los ficheros se dan por\r\n   buenos ni el correo se envía sin que haya visto el contenido y el destinatario.\r\n2. **El informe no es un documento fiscal.** Lo dice la portada del PDF y lo dices tú: el gestor\r\n   contabiliza con la exportación contable de Glop o con sus propios libros; este informe\r\n   le sirve para cuadrar y anticipar el IVA repercutido.\r\n3. **No inventes datos del gestor.** Nombre, correo y tratamiento se preguntan o se toman\r\n   de lo que el usuario haya dicho. Nunca se buscan fuera.\r\n4. **Datos de clientes, solo donde hacen falta.** Las facturas llevan NIF y nombre del\r\n   cliente porque el gestor los necesita (modelo 347). Van en los ficheros, nunca en el\r\n   cuerpo del correo.\r\n5. Habla en el idioma del usuario. Fechas en `YYYY-MM-DD` en las tools y en formato local\r\n   en el informe (`31/08/2026`). Importes con dos decimales y símbolo de moneda.\r\n\r\n## Fase 1 — Datos\r\n\r\n1. Si es la primera llamada de la conversación, `glop_diagnostico`. Si `mcp_activa` no es\r\n   `true` o `glop_informe_ventas_gestor` está en `tools_deshabilitadas`, dilo y para.\r\n2. **Fija el periodo.** Si no lo indica, propón el **mes natural anterior** completo y\r\n   confírmalo. Para un trimestre, el trimestre natural. El informe de un mes de un negocio\r\n   grande es muy largo (del orden de mil registros): para un trimestre, pide **un mes cada\r\n   vez** y júntalos.\r\n3. Pregunta, en un solo mensaje, lo que falte:\r\n   - **En qué formato lo quiere**: PDF (un informe para leer), CSV (una tabla para abrir en\r\n     Excel o importar en el programa de contabilidad del gestor) o los dos. Si no lo sabe,\r\n     recomiéndale los dos: el PDF para revisarlo él y el CSV para que el gestor no tenga que\r\n     teclear nada. Si ya lo ha dicho (\"en CSV\", \"un PDF\"), no lo vuelvas a preguntar.\r\n   - Nombre del negocio como quiere que figure (razón social o nombre comercial).\r\n   - Nombre y correo del gestor, solo si va a haber envío.\r\n   - Si quiere añadir el reparto por formas de pago (por defecto no).\r\n4. Llama a `glop_informe_ventas_gestor` con `date_from` y `date_to`. Devuelve registros con\r\n   un campo `tipo`:\r\n   - `simplificada`: **uno por día y serie**, con `fecha`, `serie`, `num_documentos`,\r\n     `numero_desde` y `numero_hasta`.\r\n   - `factura`: **uno por factura**, con `fecha`, `serie`, `numero`, `id_terminal` y\r\n     `cliente` (`id`, `cuenta_contable`, `nif`, `nombre`, `direccion`, `cp`, `localidad`,\r\n     `provincia`).\r\n   - `rectificativa`: uno por abono, con los importes **en negativo** y `cliente` a `null`\r\n     si no estaba identificado.\r\n   - `documentos_sin_lineas`: como mucho uno, con `num_documentos` e `importe` de los\r\n     documentos emitidos que no tienen líneas.\r\n\r\n   Cada registro trae `base`, `cuota`, `total`, a veces `recargo` (solo si hay recargo de\r\n   equivalencia; si falta, es cero) y `ivas`, con un tramo por tipo de IVA (`porcentaje`,\r\n   `base`, `cuota` y, si lo hay, `recargo`).\r\n5. **Suma los totales del periodo** por clase de registro y por porcentaje de IVA, y\r\n   comprueba que base + cuota + recargo da el total. Si algo no cuadra, dilo; no lo ajustes.\r\n6. Si lo ha pedido, `glop_ventas_get_sales_by_payment_method` del mismo periodo, y\r\n   comprueba que suma el total del periodo. Si no coincide al céntimo, di la diferencia en\r\n   una nota y no la repartas: el informe corta por jornada de caja y el reparto por formas\r\n   de pago puede no cortar los días igual.\r\n7. Enseña al usuario el **resumen en texto** antes de montar nada: total del periodo\r\n   (base, IVA, recargo si lo hay, total), el desglose por tipo de IVA, cuántas\r\n   simplificadas, facturas y rectificativas hay, y cualquier cosa que llame la atención\r\n   (una serie con saltos de numeración, una factura sin NIF, documentos sin líneas).\r\n\r\n## Fase 2 — Los ficheros\r\n\r\nGenera solo el formato o los formatos que haya elegido, con la herramienta de creación de\r\nficheros o de ejecución de código que tenga tu entorno. Nombre: `ventas-<negocio>-<YYYY-MM>`\r\n(o `<YYYY>-T<n>` para un trimestre), sin espacios ni acentos, con la extensión `.pdf` o\r\n`.csv`.\r\n\r\nSi tu entorno no puede crear ficheros, dilo y no prometas un enlace de descarga que no\r\nexiste: el PDF lo entregas en HTML o Markdown listo para \"Imprimir → Guardar como PDF\", y\r\nel CSV como bloque de texto para copiar en un fichero (si es muy largo, avisa de que por\r\nesa vía no es práctico y propón partir el periodo).\r\n\r\n### PDF: estructura\r\n\r\n1. **Portada**: \"Informe de ventas\", nombre del negocio, periodo, fecha de emisión, y la\r\n   frase: *\"Informe informativo generado desde el TPV Glop. No sustituye a los libros\r\n   registro ni a la exportación contable.\"*\r\n2. **Resumen del periodo**: base imponible, IVA repercutido, recargo de equivalencia (solo\r\n   si lo hay) y total, en una fila por clase (simplificadas, facturas, rectificativas) y una\r\n   fila de total.\r\n3. **IVA por tipo**: una fila por porcentaje con base, cuota, recargo (si lo hay) y total.\r\n   Es la tabla que más va a mirar el gestor.\r\n4. **Facturas simplificadas**: una fila por día y serie con número de documentos, rango de\r\n   numeración, base, cuota y total. Con muchas series, agrupa por día y deja la serie como\r\n   subfila.\r\n5. **Facturas**: una fila por factura con fecha, serie y número, NIF y nombre del cliente,\r\n   base, cuota y total. Marca las que no tengan NIF.\r\n6. **Rectificativas**: igual que las facturas, con los importes en negativo.\r\n7. **Formas de pago** (solo si se pidió): importe y % de cada una, con la nota de cuadre si\r\n   hace falta.\r\n8. **Notas**, siempre:\r\n   - El periodo se corta por la **jornada de apertura de caja**, igual que la exportación\r\n     contable de Glop: una venta de madrugada cuenta en el día en que se abrió la caja.\r\n   - El NIF y el nombre salen de la **ficha actual del cliente**: si se editó después de\r\n     emitir la factura, aparece el dato nuevo.\r\n   - Si hay `documentos_sin_lineas`: cuántos son y su importe, que no se puede repartir por\r\n     tipo de IVA.\r\n\r\n### PDF: estilo\r\n\r\nSobrio y legible en blanco y negro: tipografía del sistema, tablas con cabecera sombreada,\r\nimportes alineados a la derecha, sin gráficos. Pie de página con \"Generado con Glop ·\r\npágina X de Y\". Sin logotipos que no te haya dado el usuario.\r\n\r\n### CSV\r\n\r\nUn único fichero con **una fila por registro y tipo de IVA**: un registro con dos tipos de\r\nIVA ocupa dos filas. Es la forma en que lo importa un programa de contabilidad y la que\r\npermite sumar por tipo de IVA en una hoja de cálculo sin deshacer nada.\r\n\r\n- **Formato de hoja de cálculo española**: separador `;`, decimales con coma (`1234,56`),\r\n  sin separador de miles ni símbolo de moneda, fechas `DD/MM/AAAA`, codificación UTF-8 con\r\n  BOM (para que Excel lea bien las tildes). Si el usuario o el gestor piden otro formato\r\n  (coma como separador, punto decimal, fechas ISO), úsalo.\r\n- **Columnas, en este orden y con esta cabecera**:\r\n  `tipo;fecha;serie;numero;numero_desde;numero_hasta;num_documentos;cliente_nif;cliente_nombre;cliente_cuenta_contable;cliente_direccion;cliente_cp;cliente_localidad;cliente_provincia;porcentaje_iva;base;cuota;recargo;total`\r\n- **Qué va en cada fila**:\r\n  - `simplificada`: `fecha`, `serie`, `numero_desde`, `numero_hasta` y `num_documentos` del\r\n    registro; `numero` y las columnas del cliente, vacías.\r\n  - `factura` y `rectificativa`: `fecha`, `serie`, `numero` y los datos del `cliente`;\r\n    `numero_desde`, `numero_hasta` y `num_documentos`, vacíos. Una rectificativa sin cliente\r\n    identificado lleva las columnas del cliente vacías.\r\n  - En todas, `porcentaje_iva`, `base`, `cuota` y `recargo` son los **del tramo de IVA**\r\n    (`ivas[]`), no los del registro, y `total` es base + cuota + recargo del tramo.\r\n    `recargo` a `0` cuando el tramo no lo trae. Las rectificativas, en negativo tal como\r\n    vienen.\r\n  - `documentos_sin_lineas`: una fila con `tipo`, `num_documentos` y el `importe` en\r\n    `total`, el resto vacío. No se puede repartir por tipo de IVA.\r\n- **Solo datos**: sin portada, sin filas de totales, sin notas ni líneas en blanco dentro\r\n  del fichero, para que se pueda importar tal cual. Las notas (jornada de caja, NIF de la\r\n  ficha actual, documentos sin líneas) van en el PDF si lo hay y, si no, en el mensaje al\r\n  usuario y en el correo.\r\n- **Comprobación**: antes de entregarlo, suma la columna `total` y compárala con el total\r\n  del periodo de la fase 1. Tiene que coincidir; si no, busca la fila que falta antes de\r\n  darlo por bueno.\r\n\r\n### Revisión\r\n\r\nEnseña lo generado y pide el visto bueno: el PDF o su vista previa; del CSV, la cabecera,\r\nlas primeras filas, el número de filas y la suma de `total`. Un cambio de periodo obliga a\r\nvolver a la fase 1; un cambio de formato o de columnas se resuelve aquí.\r\n\r\n## Fase 3 — Envío al gestor\r\n\r\n1. **Mira qué herramientas de correo tienes** en esta conversación: un conector de Gmail,\r\n   Outlook o Microsoft 365, un servicio de envío, o cualquier tool cuyo nombre o descripción\r\n   hable de enviar correo. No des por hecho que existe ni que no existe.\r\n2. **Si la tienes**: redacta el correo, enséñalo entero (destinatario, asunto, cuerpo y\r\n   nombre de los adjuntos) y pide un sí explícito. Solo entonces envíalo con los ficheros\r\n   adjuntos y, si el conector lo permite, con copia al usuario. Confirma con lo que devuelva la\r\n   herramienta; si falla, dilo y pasa al punto 3.\r\n3. **Si no la tienes**: entrega los ficheros y, en un bloque aparte, el asunto y el cuerpo\r\n   listos para copiar, y explica en una línea que tiene que adjuntarlos desde su correo.\r\n\r\n### Plantilla del correo\r\n\r\n- **Asunto**: `Ventas <negocio> · <periodo>`\r\n- **Cuerpo**: saludo con el nombre del gestor; una frase con el periodo y el total (base,\r\n  IVA, total); una frase que diga que el desglose por tipo de IVA, las simplificadas, las\r\n  facturas y las rectificativas van adjuntos (di si es el PDF, el CSV o los dos), generados\r\n  desde el TPV Glop; si solo va el CSV, una frase con las notas que el PDF llevaría al final\r\n  (el periodo se corta por jornada de caja y el NIF es el de la ficha actual del cliente);\r\n  una frase que recuerde que es informativo y que la contabilización va con la exportación\r\n  contable; despedida con el nombre del usuario.\r\n\r\nSin tablas, sin cifras por cliente y sin NIF en el cuerpo: eso va en el adjunto.\r\n\r\n## Lo que esta skill no hace\r\n\r\n- No genera la exportación contable de Glop: el CSV es una tabla genérica que el gestor\r\n  puede importar, no el formato de un programa de contabilidad concreto.\r\n- No emite libros registro de facturas expedidas ni modelos tributarios (303, 347…).\r\n- No responde preguntas sueltas sobre ventas (`analisis-ventas`) ni prepara el informe de\r\n  compras (`informe-compras-asesor`).\r\n- No busca el correo del gestor en ningún sitio ni envía nada sin confirmación.\r\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}