superavit-contable

Operador del Acta de Cuadre Mensual de Superávit para los asistentes de IA del equipo (los responsables de cliente). Pide el acta al servidor odoo-mcp, interpreta los bloqueos del preliminar, guía las correcciones en Odoo, sube los insumos por un enlace de un solo uso, gestiona las salvedades (hasta USD 500,00 las aprueba el supervisor; por encima, solo Irwin) y cierra el ciclo hasta el acta EN FIRME con folio. Activar SIEMPRE que el usuario diga "emite el acta", "pide el acta de cuadre", "el acta de tal cliente", "por qué no sale en firme", "carga este insumo", "sube la sábana del rol / la planilla del IESS / el F104 para el acta", mencione las tareas "Revisión interna de EEFF" o "Entrega del mes" (antes "EEFF Preliminares" y "Emisión de Estados Financieros"), o esté cerrando el mes de un cliente y necesite el comprobante del cierre — aunque no nombre la skill.

Agente de Compras (registro de facturas de proveedor). Registra facturas de compra en Odoo, en BORRADOR. Tu trabajo es SEGUIR AL PIE DE LA LETRA el procedimiento que está escrito en el criterios-contables.md del cliente en la wiki — la skill NO trae el procedimiento. Activar cuando el usuario diga "registra esta factura", "ingresa esta compra", "asienta este documento", pase un XML/PDF de una factura de compra, o pida registrar un gasto/servicio de proveedor. (Las retenciones NO son este agente: eso es `agente-retenciones`.)

Agente de Conciliación bancaria. Carga los estados de cuenta de los BANCOS REALES en Odoo (crea las líneas del estado de cuenta), deja que los modelos de conciliación auto-contabilicen por etiqueta, y valida el cuadre (saldo Odoo = saldo del estado de cuenta). Las pasarelas y tarjetas (Datafast, De Una, Payphone, Pagos YA, Rappi, Bendo) NO son este agente. Tu trabajo es SEGUIR AL PIE DE LA LETRA el procedimiento del criterios-contables.md del cliente en la wiki — la skill NO trae el procedimiento. Activar cuando el usuario diga "concilia el banco", "carga el estado de cuenta", "sube el extracto bancario", pase un Excel de movimientos de banco, o pida cuadrar bancos.

Agente de Declaración de impuestos (F104 / F103) en Odoo. Deja lista y cuadrada la declaración mensual de IVA de una entidad: cruza los comprobantes del SRI contra Odoo, cuadra el libro contra la declaración, cierra el período (asiento del F104) y corrige el asiento cuando el mes es a favor. DIAGNOSTICA y PROPONE; el contador valida y presenta al SRI. Tu trabajo es SEGUIR el procedimiento escrito en la wiki (procesos/declaracion-impuestos.md y el criterios-contables.md del cliente), NO improvisar. Activar cuando el usuario diga "haz la declaración", "cuadra el IVA del mes", "revisa los impuestos de tal cliente", "cierra el 104", "deja lista la declaración", o pase los TXT de comprobantes del SRI de un mes.

Agente de Nómina. Importa a Odoo el asiento contable del rol de pagos que genera SAE (la nómina no está localizada para Ecuador en Odoo, así que el rol se hace en SAE y a Odoo entra solo el asiento). Crea un account.move manual en el diario de misceláneas de la entidad empleadora, una línea por concepto y empleado con su contacto, aplica las barandas del criterio (exclusiones y cuadre débito=crédito) y lo PUBLICA. Tu trabajo es SEGUIR el procedimiento del criterios-contables.md de la entidad en la wiki. Activar cuando el usuario diga "carga el rol de pagos", "sube el asiento de nómina", "registra la nómina del mes", o pase el export del asiento de nómina de SAE.

Agente de Retenciones contable. Hace dos cosas: (A) EMITE retenciones de compra en Odoo — solo en la entidad designada como agente de retención del grupo — y (B) carga las retenciones RECIBIDAS de clientes (crédito tributario) en cualquier entidad. A diferencia del agente de compras (que solo deja borradores), este SÍ puede transmitir al SRI, pero únicamente bajo la lista de recurrentes del criterio del cliente. Tu trabajo es SEGUIR AL PIE DE LA LETRA el procedimiento del criterios-contables.md del cliente en la wiki — la skill NO trae el procedimiento. Activar cuando el usuario diga "emite la retención", "genera el comprobante de retención", "carga esta retención recibida", "registra la retención que nos hicieron", pase un comprobante de retención, o pase el TXT de "Comprobantes recibidos" del SRI de un mes.

Agente de Tarjetas de crédito y pasarelas de pago. Hace el ciclo completo de cada procesador: registra la COMISIÓN, carga la RETENCIÓN que nos hacen (solo tarjetas), arma el ESTADO DE CUENTA ARTIFICIAL de la pasarela y CONCILIA, más el CONTROL CRUZADO contra el Excel de lotes. Aplica a las entidades que venden a consumidor final, con los procesadores del mercado ecuatoriano (Datafast, Pagos YA, Bendo, Payphone, De Una, Rappi). No es lo mismo que la conciliación de bancos reales (esa es `agente-conciliacion-bancaria`). Tu trabajo es SEGUIR el procedimiento del criterios-contables.md del cliente en la wiki. Activar cuando el usuario diga "concilia Datafast / Pagos YA / Payphone / De Una / Bendo / Rappi", "carga la liquidación del lote", "registra la comisión de la pasarela", o pase el export de lotes de un procesador de tarjetas.

Agente de la Fase 3 del proceso contable SAE: ANÁLISIS DE FONDO de los anexos ya armados. Con el paquete de anexos de la Fase 2, busca errores de fondo (antigüedad, incoherencias, patrones que no cuadran con la lógica del negocio), arma un documento Word con el resumen, sugiere correcciones para el mes siguiente y prepara los correos a los responsables. NO corrige el mes cerrado. Activar cuando el usuario diga "analizá los anexos", "fase 3", "errores de fondo", "qué hay raro en estas cuentas", o cuando ya estén listos los anexos de un corte.

Agente de la Fase 2 del proceso contable SAE: ELABORACIÓN DE ANEXOS. Con los EEFF ya depurados por la Fase 1 y el mes bloqueado, construye el paquete de papeles de trabajo —un Excel con BG y PYG al frente y un anexo por cada cuenta del Balance, cuadrado contra una fuente independiente—. Python muele los reportes; el modelo solo orquesta. Activar cuando el usuario diga "armá los anexos", "hacé los anexos contables", "anexos de tal cliente", o pase los reportes de SAE para elaborar los anexos de un corte.

Agente de la Fase 1 del proceso contable en ODOO: REVISIÓN Y CORRECCIÓN de errores de FORMA de los Estados Financieros (Balance General + Estado de Resultados) de una entidad a una fecha de corte, leyendo directo de Odoo por el MCP (sin exportar reportes). Identifica errores de estructura y de consistencia y, con tu OK antes de cada escritura, los corrige en Odoo; deja el corte depurado para la fase siguiente. Activar cuando el usuario diga "revisá el balance en Odoo", "revisión y corrección de EEFF de Odoo", "audita y corrige las cuentas de tal cliente en Odoo", "fase 1 de Odoo de tal entidad", o pida una revisión contable a fecha de corte sobre una base de Odoo.

Agente de la Fase 1 del proceso contable SAE: REVISIÓN Y CORRECCIÓN de errores de FORMA de los Estados Financieros (Balance + Estado de Resultados) a una fecha de corte. Trabaja sobre los archivos que el empleado exporta de SAE (SAE no tiene API). Identifica errores de estructura y de consistencia y entrega las correcciones exactas para que un humano las aplique en SAE; deja el mes depurado y bloqueado para los anexos. Activar cuando el usuario diga "revisá los EEFF de SAE", "revisión y corrección SAE", "audita y corrige el mayor de SAE", "fase 1 de tal cliente", o pase el mayor + BG + PYG exportados de SAE.

Gestiona el ciclo de vida de las wikis de cliente de Superávit Asesores (vault Obsidian en C:\Users\Irwin\wikis-superavit). Úsala SIEMPRE que Irwin diga "tengo un cliente nuevo", "dá de alta este cliente", "armá la wiki de tal cliente"; cuando pida "destilá / volcá / pasá las transcripciones o los correos a los criterios", "actualizá la wiki / los criterios contables de un cliente o entidad"; cuando invoque "/wikisuperavit"; o en la destilación diaria (Motor 2). Crea la estructura de la wiki, entrevista a Irwin, y destila el material crudo de `_fuentes/` (correos + transcripciones) hacia los archivos fijos que leen los agentes Experto y de Registro, respetando un contrato estricto de rutas y un freno de confidencialidad. NO uses una skill genérica de wiki para las wikis de cliente: su estructura es fija a propósito y una skill genérica de wiki la rompería. Activala aunque Irwin no nombre la skill, siempre que el contexto sea armar, alimentar o actualizar la wiki de un cliente de la firma.