Francodesystems
Open source · MIT · Odoo 16 a 20

Pregúntale a Claude qué facturas ha rechazado Hacienda.

Un servidor MCP que lee tu Odoo y contesta lo que se pregunta cada trimestre con Verifactu y el SII: qué está rechazado, qué falta por enviar, por qué y cuánto IVA hay. Funciona con los módulos de Odoo y con los de la OCA, y solo lee.

Por Juan Cantón Rodríguez · Actualizado el

¿Para qué sirve si Odoo ya envía las facturas?

Odoo envía cada factura a la AEAT y guarda la respuesta en esa factura. Lo que no hace es contestarte de golpe qué ha fallado en el trimestre. Para eso hay que abrir facturas una a una, montar filtros o exportar a Excel. Con Verifactu obligatorio para las sociedades desde el 1 de enero de 2027 y para el resto desde el 1 de julio (las fechas y quién entra están en nuestra página de Verifactu), esa pregunta va a ser de cada mes.

Lo conectas a Claude con la URL de tu Odoo y una clave de API, y le preguntas en castellano. Si todavía no tienes Verifactu configurado, empieza por qué trae Odoo de serie y qué hay que activar.

¿Qué le puedes preguntar?

compliance_overview

Qué módulos tienes instalados, cómo está cada empresa (pruebas o producción), los días que le quedan al certificado y cuántas facturas del periodo hay en cada estado. Se empieza por aquí.

verifactu_invoices

Las facturas de cliente con su estado en Verifactu, el CSV de la AEAT y el último error. Se filtran por estado, fechas, empresa y cliente.

verifactu_errors

Los errores del periodo agrupados por mensaje, con cuántas facturas tienen cada uno. Cinco facturas con el mismo error son un solo problema que arreglar.

sii_invoices

Lo mismo para el SII, en facturas emitidas y recibidas, incluidas las que se modificaron después de enviarlas.

invoice_aeat_detail

Una factura entera: el QR, el CSV, cada envío con su error y la factura a la que sustituye.

vat_summary

El IVA repercutido y soportado por impuesto, con bases exentas incluidas. Una ayuda para revisar el 303 antes de presentarlo; no es el modelo oficial.

Respuesta de la herramienta verifactu_errors: cuatro errores distintos agrupados por mensaje, cada uno con su estado, cuántas facturas lo tienen y sus números
Salida real de verifactu_errors sobre una base de prueba de Odoo 20 con datos de demostración y errores cargados a mano. Ningún dato es de un cliente.

¿Cómo queda un cierre de trimestre?

Ejemplo: Distribuciones de Ejemplo S.L.

  1. 1. «¿Cómo vamos este trimestre?» compliance_overview cuenta 412 facturas emitidas: 396 aceptadas, 9 aceptadas con errores, 5 rechazadas y 2 sin enviar. Y avisa de que al certificado le quedan 41 días.
  2. 2. «¿Por qué las rechazadas?» verifactu_errors agrupa las 5 en dos motivos: 4 son del mismo cliente, con el NIF mal escrito en su ficha, y 1 es una factura sin destinatario que no era simplificada.
  3. 3. Se arregla una vez. Corriges el NIF en la ficha del cliente, rectificas esas facturas desde Odoo y la quinta se emite bien. Es una tarde, no cinco.
  4. 4. «¿Cuánto IVA tenemos?» vat_summary da 18.420 € de repercutido y 6.135 € de soportado, 12.285 € de diferencia, con la base de cada tipo para cotejarla con el 303.

¿Qué cambia el primer mes?

  • La configuración son diez minutos: crear una clave de API en Odoo y añadir el servidor a Claude.
  • La revisión de fin de mes pasa de un filtro por estado a una pregunta.
  • Los errores que se repiten salen agrupados, así que se corrige la causa (una ficha de cliente, un impuesto mal mapeado) y no cada factura.
  • La caducidad del certificado deja de ser una sorpresa: compliance_overview la cuenta en días.

Si quieres algo parecido para Holded, lo tenemos en Claude con tus datos de Holded.

Preguntas frecuentes

¿Puede enviar, anular o cambiar facturas?

No. Solo lee. No hay ninguna herramienta que escriba en Odoo ni que hable con la AEAT. Los envíos los sigue haciendo tu módulo de Verifactu o de SII como hasta ahora.

¿Funciona con los módulos de la OCA?

Sí. Detecta si tienes los de Odoo S.A. (l10n_es_edi_verifactu y l10n_es_edi_sii) o los de la OCA (l10n_es_verifactu_oca y l10n_es_aeat_sii_oca) y devuelve los mismos estados en los dos casos. Está probado contra Odoo 20 con los primeros y contra Odoo 18 con los segundos.

¿Y en Odoo Online?

Necesita acceso a la API externa de Odoo. En Odoo Online eso depende del plan: Odoo lo incluye en el plan Custom y no en el Standard. En Odoo.sh y en Odoo instalado en tu servidor no hay esa limitación.

¿Tengo que usar Claude?

Funciona con cualquier programa que hable MCP. Lo hemos probado con un cliente MCP propio; Claude Desktop y Claude Code se configuran con la URL de tu Odoo y una clave de API.

¿Es oficial de Odoo o de la AEAT?

No. Es un proyecto de código abierto de Francodesystems con licencia MIT. Lee los datos que ya guardan los módulos oficiales de Odoo y de la OCA.

¿Verifactu todavía sin montar en tu Odoo?

Lo configuramos con tu certificado, revisamos impuestos y series y lo dejamos probado en el entorno de pruebas de la AEAT antes de pasar a producción.