{"id":84496,"plugin_id":"plugin_asdk_app_6ad86440568081918ff9dae945918393","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-11-06T12:12:24.533Z","digest":"f012a8b8da09c2810fd582beb3d4078893981d0bc95b21661bbbc75866b84170","against":null,"payload":{"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.\n","included_files":[{"relative_path":"agents/openai.yaml","size_in_bytes":267}],"name":"alta-albaran-compra","skill_md_contents":"---\r\nname: alta-albaran-compra\r\ndescription: >\r\n  Usa esta skill SIEMPRE que el usuario adjunte una foto, escaneo o PDF de un albarán de\r\n  compra o de una factura de proveedor y quiera registrarlo en Glop: \"registra este albarán\",\r\n  \"mete esta factura de compra\", \"lee este albarán del proveedor\", o simplemente adjunte la\r\n  imagen y pida procesarla. Lee el documento, resuelve proveedor y artículos con las tools del\r\n  MCP de Glop, enseña la previsualización que calcula el TPV y, tras confirmación explícita del\r\n  usuario, registra el documento. Requiere el MCP de Glop conectado y el complemento\r\n  contratado. No sirve para albaranes de venta a clientes ni para pedidos a proveedor.\r\n---\r\n\r\n# Alta de albarán de compra en Glop\r\n\r\nConvierte la foto o el PDF de un albarán de proveedor en un documento de compra en Glop. El\r\nproceso es **conversacional y por fases**: cada fase se cierra con el usuario antes de pasar\r\na la siguiente.\r\n\r\nEsta skill dice **en qué orden** hacer las cosas y **cómo hablar con el usuario**. Las reglas\r\nde negocio (qué se escribe y cuándo, cómo se convierten envases, cómo se cuadran los totales,\r\nqué datos exige un artículo nuevo) **las dicta el servidor**: están en la descripción de cada\r\ntool y en sus respuestas. Cuando una respuesta traiga `siguiente_paso` o una instrucción,\r\nmándan ellas sobre este documento.\r\n\r\n> **El OCR lo pones tú.** Glop no lee la imagen: tú la lees y él valida, calcula y registra.\r\n\r\n## Lo que no se negocia\r\n\r\n1. **Nada se escribe sin un sí explícito del usuario**, y el sí se pide sobre la\r\n   previsualización que devuelve el servidor, nunca sobre un resumen tuyo.\r\n2. **No inventes datos.** Lo que no leas con seguridad, se pregunta.\r\n3. **No decidas un artículo por parecido de nombre.** Presenta candidatos y que elija el\r\n   usuario.\r\n4. **Los cálculos los hace Glop.** No conviertas envases ni calcules totales de cabecera.\r\n5. **Descartar el documento entero siempre es una salida válida.**\r\n6. Habla en el idioma del usuario, claro y sin tecnicismos.\r\n\r\n## Fase 0 — Preparación\r\n\r\n1. Comprueba que hay imagen o PDF adjunto. Si no, pídelo.\r\n2. Llama a `glop_diagnostico`. Si `mcp_activa` no es `true` o falta alguna de las tools que\r\n   necesitas en `tools_deshabilitadas`, dilo ahora y para.\r\n3. Carga `glop_terminales_listar`, `glop_almacenes_listar`, `glop_ivas_listar` y\r\n   `glop_envases_listar`.\r\n4. Si hay varios terminales, pregunta cuál registra el albarán. Si solo hay uno, úsalo y dilo.\r\n\r\n## Fase 1 — Lectura del documento\r\n\r\nExtrae la estructura completa y **anota dónde tienes poca confianza**:\r\n\r\n- **Proveedor**: nombre o razón social, NIF, dirección, teléfono.\r\n- **Documento**: número del albarán del proveedor, fecha del documento, fecha de entrega.\r\n- **Líneas**: referencia del proveedor, código de barras, descripción, cantidad, unidad o\r\n  formato (cajas, unidades, kg), precio, descuento, importe, tipo de IVA (si viene como R1, R2\r\n  o R3, guárdalo tal cual).\r\n- **Totales**: bases por IVA, cuotas, recargo, descuentos de pie, portes y total.\r\n- **Anotaciones a mano**: abonos, cantidades tachadas, líneas añadidas. Sepáralas de lo\r\n  impreso: lo impreso puede no ser lo que se recibió.\r\n\r\nAntes de seguir, comprueba tú mismo que cantidad × precio − descuento ≈ importe de cada línea.\r\nSi no cuadra, vuelve a mirar esa zona con zoom. No sigas con cifras incoherentes.\r\n\r\nSi el papel indica más hojas de las que tienes (\"página 1 de 2\", sin total), pide las que\r\nfaltan antes de continuar.\r\n\r\n## Fase 2 — El proveedor\r\n\r\n1. Búscalo con `glop_proveedores_buscar`, primero por NIF normalizado y, si no, por palabras\r\n   del nombre (sin S.L. ni S.A.).\r\n2. Si existe, enseña la coincidencia (ID, nombre, NIF) y sigue.\r\n3. Si no existe, propón el alta con los datos leídos y usa `glop_proveedor_crear`. Un ticket\r\n   de un establecimiento (mercado, supermercado) también necesita su proveedor: pregunta los\r\n   datos que no estén en el papel.\r\n\r\n## Fase 3 — Los artículos, línea a línea\r\n\r\nPara cada línea llama a **`glop_articulo_resolver`** con todo lo que traiga el papel\r\n(`provider_id`, `provider_ref`, `barcode`, `description`) y **haz lo que diga\r\n`siguiente_paso`**. No busques a mano con `glop_articulos_buscar`.\r\n\r\n- **Resuelto**: usa ese `PRODUCT_ID`.\r\n- **Candidatos**: enséñaselos al usuario y que elija. Si venía referencia del proveedor,\r\n  propón guardar el vínculo con `glop_mapeo_crear`: es lo que hace que el siguiente albarán\r\n  de ese proveedor se reconozca solo.\r\n- **No existe**: ofrece tres salidas: crearlo con `glop_articulo_crear` (la tool te dirá qué\r\n  datos necesita; pregúntaselos al usuario, no los inventes), asociarlo a un artículo que\r\n  indique el usuario, o dejar la línea fuera.\r\n\r\nManda cada línea como viene en el papel: la cantidad en el envase que indique (cajas,\r\nunidades) y el IVA impreso. Si algo de la línea no coincide con lo que Glop tiene en la ficha,\r\nla previsualización lo avisará; entonces se pregunta, no se decide.\r\n\r\n### Si dejas una línea fuera\r\n\r\nLos importes del papel la incluyen y el documento no. **Resta del total impreso el importe de\r\nesa línea con su IVA** y dilo en el resumen (\"total del albarán 32,67 €; se registran 26,40 €\r\nporque la línea X queda fuera\"). Deja constancia en `NOTES`. No mandes el total del papel y\r\nluego fuerces la aceptación de la diferencia: apagarías la comprobación que detecta líneas mal\r\nleídas.\r\n\r\n## Fase 4 — Previsualización\r\n\r\nLlama a `glop_compra_documento_crear` **sin `confirmar`** y **sin pedir permiso para\r\nhacerlo**: esa llamada no escribe nada. Devuelve el documento calculado por el TPV, el\r\nresultado del cuadre y los avisos (variación de precio de compra, envases, IVA distinto al\r\nde la ficha). Es ese resumen, y no uno tuyo, el que se enseña al usuario.\r\n\r\nSi el cuadre falla, **no confirmes**. La respuesta dice qué línea o grupo falla; busca la\r\ncausa en el papel en este orden:\r\n\r\n1. Una línea que dejaste fuera sin ajustar el total (fase 3).\r\n2. Un descuento de pie, portes o un cargo que no leíste.\r\n3. Una línea que se te pasó.\r\n4. Una cifra mal leída: vuelve a esa zona con zoom.\r\n\r\nPlantéaselo al usuario con la línea concreta. Solo si acepta la diferencia de forma expresa,\r\ny después de descartar las cuatro causas, repite con lo que la tool indique para aceptarla.\r\n\r\n**El aviso de variación del precio de compra enséñalo siempre**, con el precio anterior y el\r\nnuevo: es lo más útil que hace este flujo.\r\n\r\n## Fase 5 — Confirmación y alta\r\n\r\n1. Presenta el resumen de la previsualización: proveedor (y si es alta nueva), cabecera, tabla\r\n   de líneas (artículo de Glop, línea del papel, cantidad, envase, precio, IVA, total), vínculos\r\n   nuevos, totales calculados frente a los impresos, variaciones de precio y qué stock se va a\r\n   mover. Todas las dudas del papel (anotaciones a mano, contradicciones) van en este mismo\r\n   mensaje.\r\n2. Pide confirmación. Sin un sí claro, no hay alta.\r\n3. Repite la llamada con `confirmar=true`. Comprueba en la respuesta que las existencias se\r\n   movieron como se anunció; si algo no cuadra, dilo.\r\n4. Informa: serie y número del documento, total, y que puede verlo en Glop en Documentos de\r\n   compra.\r\n\r\nSi el alta falla, **no reintentes a ciegas**: comprueba con `glop_compras_documentos_buscar`\r\nsi el documento quedó registrado. Un alta que falla no deja el documento a medias.\r\n\r\n## Lo que esta skill no hace\r\n\r\n- No corrige ni borra documentos ya registrados: eso se hace desde Glop.\r\n- No toca el escandallo. Si creas un artículo, avisa de que nace sin él y no descontará nada\r\n  al vender hasta que se complete en Glop.\r\n- No registra pedidos (tipo 1) ni convierte documentos.\r\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}