| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Contacts (contacts)
• Discuss (mail) • Invoicing (account) |
| Lines of code | 1858 |
| Technical Name |
verifacti_api |
| License | LGPL-3 |
| Website | https://github.com/oak-soft-dev/verifacti-api |
| Versions | 13.0 14.0 15.0 16.0 17.0 18.0 19.0 |
Verifacti API - Integración Directa
Integración directa con la API de Verifacti para cumplir con VeriFactu España
Normativa VeriFactu 2026
VeriFactu será obligatorio para cumplir con la normativa de facturación de la Agencia Tributaria (AEAT):
- 1 de enero de 2026: Empresas que tributan por el Impuesto de Sociedades
- 1 de julio de 2026: Resto de empresas y autónomos
Implemente la solución ahora para garantizar el cumplimiento normativo desde el primer día.
Ventaja Clave: Sin Certificados Digitales
Verifacti gestiona los certificados digitales por ti. No necesitas instalar ni configurar certificados en tu sistema.
- Configuración simple: Solo necesitas una API Key
- Sin mantenimiento: Verifacti gestiona renovaciones y actualizaciones
- Multi-tenant nativo: Gestiona múltiples NIFs emisores con diferentes API Keys
Arquitectura Multi-Proveedor
Ideal para gestorías, aplicaciones SaaS y empresas con múltiples NIFs
Cada proveedor/emisor tiene su propia API Key y gestión independiente de facturas
Nuevas Funcionalidades 2025
- QR en PDF según normativa AEAT: Código QR automático en facturas impresas (35mm, arriba, centrado)
- Integración con account.move: Envío de facturas de Odoo directamente a Verifacti
- Actualización automática: Formularios se refrescan sin recargar al enviar facturas
- Operaciones masivas configurables: Límite de operaciones masivas ajustable por compañía (por defecto 10)
- Envío automático inteligente: Control de carga del sistema para alto volumen de facturas
- Texto normativo: "Factura verificable en la sede electrónica de la AEAT - VERI*FACTU"
- Huella digital visible: Incluida de forma discreta en el pie de las facturas
Características Principales
Gestión Completa de Facturas
- Envío directo a AEAT mediante Verifacti API
- Generación automática de código QR VeriFactu
- QR en PDF según normativa oficial AEAT
- Cálculo automático de huella (hash)
- Descarga de XMLs de petición y respuesta
- Monitorización en tiempo real del estado
- Integración nativa con facturas de Odoo (account.move)
Operaciones Soportadas
- Crear factura nueva (POST /create)
- Crear facturas en lote - hasta 50 (POST /create_bulk)
- Operaciones masivas con límite configurable
- Envío y verificación masiva de facturas
- Subsanar factura (PUT /modify)
- Anular factura (POST /cancel)
- Consultar estado factura (POST /status)
- Listar, exportar y descargar XMLs
Tipos de Factura Soportados
- F1: Factura (Art. 6, 7.2 Y 7.3 del RD 1619/2012)
- F2: Factura simplificada
- R1-R5: Facturas rectificativas (varios artículos)
- F3: Factura en sustitución de simplificadas
- Soporte completo para todos los tipos AEAT
Gestión de Clientes
- Integración nativa con Contactos de Odoo
- Validación de NIF/CIF españoles en AEAT
- Validación de IVAs intracomunitarios (VIES)
- Gestión de clientes extranjeros
- Marcado específico de clientes VeriFactu
Monitorización y Auditoría
- Log completo de llamadas API
- Visualización de requests y responses
- Sistema de tracking de errores
- Códigos de estado HTTP detallados
- Historial de cambios con Chatter
- Estadísticas por proveedor emisor
Configuración Multi-Proveedor
- Gestión de múltiples NIFs emisores
- API Key independiente por proveedor
- Entornos Test y Producción separados
- Panel integrado en Ajustes de Odoo
- Validación automática de credenciales
Stack Tecnológico
- Verifacti API REST - API REST directa con autenticación por API Key
- Sin certificados digitales - Verifacti gestiona los certificados por ti
- Validación NIF/CIF AEAT - Validación automática en base de datos de la AEAT
- VIES Integration - Validación de IVAs intracomunitarios
- Colas y Cron Jobs - Gestión automática de estados y reintentos
- Multi-tenant Ready - Arquitectura preparada para múltiples emisores
- VeriFactu AEAT - Cumplimiento 100% con normativa española
- Odoo 16 - Integración nativa con framework Odoo
Flujo de Trabajo
1. Configuración de Compañía
Configure su compañía para usar VeriFactu:
- Registre el NIF de su compañía en Verifacti.com
- Obtenga la API Key específica para su NIF
- Configure la API Key en Odoo: Configuración > Compañías > [Tu Compañía] > Pestaña Verifacti
- Active el envío automático si lo desea
- Ajuste la configuración avanzada: límite de operaciones masivas (por defecto 10), control de carga, reintentos, etc.
- Pruebe la conexión para verificar configuración
💡 Configuración avanzada: El límite de operaciones masivas determina cuántas facturas se pueden enviar o verificar simultáneamente. Ajústelo según sus necesidades.
2. Configuración de Clientes
Marque sus contactos existentes en Odoo como clientes VeriFactu. El sistema validará automáticamente sus NIFs en la base de datos de la AEAT antes de enviar facturas.
3. Creación de Facturas
Cree facturas VeriFactu seleccionando el proveedor emisor, cliente, tipo de factura y líneas. El sistema validará automáticamente todos los datos según normativa AEAT.
4. Envío a Verifacti
Con un solo clic, envíe la factura a la AEAT mediante Verifacti. El sistema usa automáticamente la API Key del proveedor emisor seleccionado.
5. Monitorización Automática
El cron job verifica automáticamente cada 5 minutos el estado de las facturas pendientes y actualiza códigos QR, huellas y XMLs.
5.1. Operaciones Masivas
Procese múltiples facturas simultáneamente:
- Envío masivo: Seleccione múltiples facturas y envíelas todas a la vez
- Verificación masiva: Compruebe el estado de varias facturas simultáneamente
- Límite configurable: Por defecto 10 facturas, ajustable en Configuración Avanzada
- Notificación inteligente: Si selecciona más facturas del límite, se procesarán las primeras y recibirá una advertencia
- Refresco automático: Los formularios se actualizan automáticamente tras las operaciones masivas
⚙️ Personalización: Modifique el límite en Configuración > Compañías > [Tu Compañía] > Verifacti > Configuración Avanzada > Límite Operaciones Masivas.
6. Descarga de Documentos y QR
Una vez aceptada la factura, descargue los XMLs de petición y respuesta, visualice el código QR y la huella VeriFactu. Al imprimir la factura, el QR aparecerá automáticamente en la parte superior según normativa AEAT.
7. Código QR en Facturas Impresas
Cumplimiento automático con la normativa AEAT:
- Posición: Arriba, centrado (según especificación oficial)
- Tamaño: 35mm x 35mm (dentro del rango 30-40mm requerido)
- Texto obligatorio: "Factura verificable en la sede electrónica de la AEAT - VERI*FACTU"
- Huella digital: Incluida de forma discreta al final
- Formato: Blanco y negro para máxima legibilidad
✓ Integración perfecta: Se aplica automáticamente a todas las facturas enviadas a Verifacti al imprimir desde Odoo.
Validaciones Automáticas
Validaciones de Datos
- Proveedor emisor obligatorio en todas las facturas
- Máximo 12 líneas por factura (restricción AEAT)
- Descripción máximo 500 caracteres
- Tipos impositivos solo valores permitidos (0, 2, 4, 5, 7.5, 10, 21)
- Operaciones exentas sin tipo ni cuota
Validaciones de Negocio
- Validación de NIF del destinatario en AEAT
- Unicidad por proveedor (serie, número, fecha)
- Coherencia de importes y totales
- Validación de tipos de factura según normativa
- Verificación de claves de régimen válidas
Estados de Factura
| Estado | Descripción | Acciones Disponibles |
|---|---|---|
| Borrador | Factura creada pero no enviada | Editar, Enviar a Verifacti |
| Enviado | Factura enviada a Verifacti | Verificar Estado |
| Pendiente | Factura en cola de procesamiento AEAT | Verificar Estado (auto cada 5 min) |
| Correcto | Factura aceptada por la AEAT | Descargar XMLs, Ver QR, Anular |
| Error | Factura rechazada o con errores | Ver error, Subsanar |
| Anulado | Factura anulada correctamente | Solo lectura |
Ventajas de la Integración con Verifacti
Verifacti es una plataforma especializada en el cumplimiento de VeriFactu que elimina la complejidad de la gestión de certificados digitales. Su API REST simple y robusta permite enviar facturas a la AEAT sin necesidad de instalar certificados en tu sistema.
Con arquitectura multi-tenant nativa, este módulo es ideal para gestorías y aplicaciones SaaS que necesitan gestionar facturas de múltiples clientes/emisores, cada uno con su propio NIF y credenciales.
La validación automática de NIFs en la base de datos de la AEAT antes del envío reduce drásticamente los rechazos y garantiza que solo se envíen facturas con datos correctos.
Casos de Uso Principales
Gestorías y Asesorías
Gestione facturas VeriFactu de múltiples clientes desde una única instalación de Odoo. Cada cliente tiene su propio NIF emisor y API Key de Verifacti.
Aplicaciones SaaS Multi-tenant
Ofrezca cumplimiento VeriFactu a sus clientes sin complicaciones. Cada tenant puede configurar sus propios emisores y gestionar sus facturas de forma independiente.
Empresas con Múltiples NIFs
Si su empresa opera con varios NIFs (matriz y filiales), gestione todos desde un único sistema con control independiente por NIF.
Comercio Retail y Hostelería
Emita facturas simplificadas (F2) sin necesidad de NIF del cliente, ideal para tickets de venta y operaciones de caja.
Modelo de Precios Verifacti
Sin costes iniciales. Sin compromiso de permanencia. Cancela cuando quieras. Paga solo por lo que usas.
1 NIF de Prueba - GRATIS
0€ / mes
Sin tarjeta de crédito. Prueba la API y haz tu integración sin coste.
- Empresa de prueba con su API Key
- Crea tu cuenta y haz tus primeras llamadas en segundos
- Entorno de test completamente funcional
- Ideal para desarrollo e integración
Hasta 100 NIFs Emisores
desde 2.9€ por NIF/mes
Elige el número de NIFs que necesites (mensual o anual - ¡ahorra un 10%!)
- API VeriFactu completa
- API TicketBAI incluida
- API de gestión de NIFs
- NIFs ilimitados en test
- Webhooks para notificaciones
- Validación automática de llamadas
- Comprobación de destinatario en AEAT
- Declaración responsable automatizada
- Automatización de representación
- Arquitectura serverless escalable
- Guía de integración completa
- Ejemplos de llamadas API
- Soporte dedicado
Límite de seguridad: 3.000 facturas por NIF/mes incluidas. Si se supera: +2€ por cada 1.000 facturas adicionales.
Más de 100 NIFs Emisores
Precio a Medida
Contáctanos y te daremos un presupuesto ajustado a tu número de NIFs y volumen de facturas.
Precios sin IVA. Modelo de suscripción con pagos recurrentes mensuales o anuales.
Enlaces de Referencia
Preguntas Frecuentes
¿Puedo gestionar facturas de múltiples emisores/NIFs?
Sí, es una de las características principales del módulo. Cada proveedor tiene su propia API Key de Verifacti y puede emitir facturas de forma independiente. Ideal para gestorías y aplicaciones SaaS.
¿Necesito certificado digital?
No. Este módulo usa la API de Verifacti que gestiona los certificados por ti. Solo necesitas una API Key.
¿El módulo es realmente gratuito?
Sí, el módulo es completamente gratuito bajo licencia LGPL-3. Sin embargo, necesitas una cuenta de pago en Verifacti para el entorno de producción. El entorno de test de Verifacti es gratuito para pruebas.
¿Qué requisitos necesito para la instalación?
Requisitos técnicos:
- Odoo 16.0 (Community o Enterprise Edition)
- Cuenta activa en Verifacti.com
- API Key de Verifacti por cada NIF emisor
- Conexión a internet para llamadas API
¿Es compatible con Odoo Community Edition?
Sí, totalmente compatible con Odoo Community Edition 16.0. No requiere Odoo Enterprise ni módulos adicionales de pago.
¿Cuánto cuesta Verifacti?
El módulo de Odoo es gratuito. Los precios de Verifacti son:
- Entorno de test: GRATIS - Sin tarjeta de crédito, incluye 1 NIF de prueba
- Producción (hasta 100 NIFs): Desde 2.9€/NIF/mes (planes mensuales o anuales con 10% descuento)
- Producción (+100 NIFs): Precio personalizado según volumen
- Sin costes iniciales, sin permanencia - Cancela cuando quieras
El coste depende del número de NIFs emisores activos en producción. Pagas solo por lo que usas.
¿Qué es un NIF emisor en Verifacti?
Un NIF emisor es cada contribuyente u obligado tributario que emite facturas usando tu software:
- Software vendido/distribuido: Cada usuario de tu software que emite facturas (número de clientes)
- Software interno: Tu propio NIF, o varios NIFs si eres un grupo de empresas
- Gestorías/Asesorías: Cada cliente tuyo que gestiones (cada NIF que facturas en su nombre)
- Autofacturas: Los obligados tributarios sujetos pasivos del IVA
¿Cómo funciona el pago por NIFs?
Sistema de pago flexible y transparente:
- Planes mensuales: Pagas por adelantado cada mes. Al añadir NIFs se prorratean y ajustan automáticamente
- Planes anuales (10% descuento): Pago adelantado anual. Los NIFs nuevos se prorratean hasta el siguiente ciclo
- Sin devoluciones: Si desactivas un NIF, dejas de pagar en el siguiente ciclo (no hay reembolso del tiempo no usado)
- Escalable: Añade o desactiva NIFs cuando quieras sin penalización
¿Hay límite de facturas por NIF?
Sí, pero es muy generoso: Cada plan incluye hasta 3.000 facturas por NIF/mes.
Este es un límite de seguridad que casi nunca se alcanza. Si lo superas:
- La operativa NO se interrumpe
- Se añaden 2€ por cada 1.000 facturas adicionales
- Si tu volumen es mayor, contacta para un plan personalizado
¿El precio incluye TicketBAI?
Sí. Todos los planes de Verifacti permiten usar tanto VeriFactu como TicketBAI sin coste adicional. Puedes elegir qué sistema usar para cada NIF sin que afecte al precio.
¿Hay API para gestionar NIFs automáticamente?
Sí. Verifacti incluye una API completa para:
- Activar y desactivar NIFs programáticamente
- Configurar webhooks para notificaciones
- Gestión automatizada de modelos de representación
- Todo incluido en el precio, sin coste adicional
¿El precio depende del número de TPVs o locales?
No. Los precios de Verifacti son por contribuyente (NIF) e independientes del número de TPVs, locales o puntos de venta desde los cuales se emitan las facturas. Es una API en la nube que no requiere instalación local de software.
¿Se integra con el módulo de facturación de Odoo?
Sí, ahora incluye integración con account.move. Puede enviar facturas de Odoo directamente a VeriFactu desde el módulo de facturación estándar.
¿Puedo procesar más de 10 facturas a la vez?
Sí. El límite de 10 facturas para operaciones masivas es configurable por compañía:
- Vaya a Configuración > Compañías > [Tu Compañía] > Verifacti > Configuración Avanzada
- Modifique el campo Límite Operaciones Masivas al valor deseado
- El límite se aplica tanto para envío masivo como para verificación masiva de estado
- Si selecciona más facturas del límite, se procesarán solo las primeras y recibirá una notificación
¿Incluye soporte técnico oficial?
Este es un módulo desarrollado por la comunidad. No incluye soporte técnico oficial. Para servicios profesionales de implementación, personalización o soporte, puede contactar con Oak Soft en oak.soft.develop@gmail.com
Aviso sobre la Independencia del Módulo
Este módulo ha sido desarrollado de forma independiente y no pertenece ni cuenta con respaldo oficial de Verifacti.
Su uso requiere disponer de una cuenta y credenciales de API proporcionadas por Verifacti. Verifacti no asume ninguna responsabilidad sobre el funcionamiento, mantenimiento o soporte de este módulo.
Para obtener una cuenta de Verifacti y acceder a la API, visite: www.verifacti.com
Please log in to comment on this module