Verifacti API - Integración Directa

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.
• Configure el control de carga del sistema (carga máxima permitida, default: 4.0)
• Establezca la fecha mínima de facturas a enviar (por defecto: 01/01/2025)
• Configure reintentos (1-10, default: 3) y delay entre reintentos (1-30s, default: 2s)
• Si es hostelería/retail: Marque "Sector Especial" para límite de 3.000€ en facturas simplificadas
• Pruebe la conexión para verificar configuración

💡 Configuración avanzada: El módulo incluye control inteligente de carga del sistema que pausa automáticamente el envío si el CPU está sobrecargado. Puede configurar el límite de load average (default: 4.0) y el sistema reanudará automáticamente cuando las condiciones mejoren.

1.1. Control Inteligente de Carga

Sistema automático de gestión de carga del CPU:

• Monitorización continua: El sistema verifica el load average del servidor
• Pausa automática: Si la carga supera el límite configurado, pausa el envío automáticamente
• Reanudación inteligente: Reanuda automáticamente cuando las condiciones mejoran
• Indicadores visuales: Estado de pausa visible en configuración de compañía
• Reanudación manual: Botón para forzar reanudación si es necesario
• Logs detallados: Registro de todas las pausas y reanudaciones

🎯 Recomendación: Configure la carga máxima como: Número de CPUs × 0.7. Por ejemplo, un servidor con 8 CPUs debería usar 5.6 como límite.

2. Configuración de Clientes

Gestión completa de clientes nacionales e internacionales:

• Clientes españoles: NIF automático sin prefijo "ES" (12345678A, X1234567A, A12345678)
• Clientes UE: Automáticamente detecta NIFs intracomunitarios (DE123456789, FR12345678901) y los envía en formato "id_otro" con id_type="02"
• Clientes internacionales: NIFs de terceros países detectados automáticamente con id_type="04"
• Facturas simplificadas: No requieren datos del cliente (anónimas por normativa)
• Validación AEAT: Opción para validar NIFs en base de datos de la AEAT antes de enviar
• Validación VIES: Verificación automática de IVAs intracomunitarios

3. Creación de Facturas con Validaciones Inteligentes

Sistema de validación y sugerencia automática:

• Tipo de factura automático: Sugiere F1/F2/R1/R5 según importe y tipo de documento
• Corrección automática: Corrige F2→F1 si supera 400€ (o 3.000€ si sector especial)
• Límites por sector:
  • Hostelería/Retail: hasta 3.000€ para F2/R5
  • Otros sectores: hasta 400€ para F2/R5
• Normalización de impuestos: Ajusta automáticamente tipos impositivos a valores VeriFactu permitidos
• Detección de impuestos: Identifica automáticamente IVA (01), IPSI (02), IGIC (03) usando tax_scope de Odoo
• Warnings informativos: Notifica cuando se realizan ajustes automáticos
• Validación completa: Verifica todos los datos según normativa AEAT antes de enviar

✨ Experiencia mejorada: El sistema sugiere y corrige automáticamente para cumplir la normativa, reduciendo errores de usuario.

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.

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. Benefíciese del límite ampliado de 3.000€ para facturas simplificadas al marcar "Sector Especial" en configuración.

Alto Volumen de Facturas

Optimizado para millones de facturas con estadísticas SQL directas (COUNT(*)), savepoints para transacciones seguras, y control inteligente de carga del sistema que pausa automáticamente el envío durante picos de CPU.

¿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 Community o Enterprise Edition
• Cuenta activa en Verifacti.com
• API Key de Verifacti por cada NIF emisor
• Conexión a internet para llamadas API
• Python 3.8+ con bibliotecas estándar (requests, json)

¿Es compatible con Odoo Community Edition?

Sí, totalmente compatible con Odoo Community Edition. No requiere Odoo Enterprise ni módulos adicionales de pago. El módulo está optimizado para funcionar con millones de facturas sin problemas de rendimiento.

¿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

¿Cómo funciona el control de carga del sistema?

Sistema inteligente de gestión automática:

• Monitoriza continuamente el load average del servidor
• Si la carga supera el límite configurado (default: 4.0), pausa automáticamente el envío
• Reanuda automáticamente cuando las condiciones mejoran
• Muestra estado de pausa en configuración de compañía
• Incluye botón de reanudación manual si es necesario

Recomendación: Configure la carga máxima como: Número de CPUs × 0.7

¿Qué son los tipos impositivos normalizados?

El módulo normaliza automáticamente los tipos impositivos a valores VeriFactu permitidos:

• VeriFactu solo acepta valores específicos: 0, 0.5, 1.75, 2, 4, 5, 7, 9.5, 10, 13.5, 15, 20, 21%
• Si un impuesto tiene 21.5%, se normaliza automáticamente a 21%
• Si la diferencia es > 0.5%, el sistema registra una advertencia
• Recalcula automáticamente las cuotas con el tipo normalizado
• Muestra en chatter los ajustes realizados

¿Cómo detecta el módulo si un impuesto es IVA, IPSI o IGIC?

Detección inteligente con dos métodos:

• Método principal: Usa el campo tax_scope del impuesto (estándar Odoo l10n_es)
  • tax_scope = 'vat' → IVA (código 01)
  • tax_scope = 'consu' → IPSI (código 02, Ceuta/Melilla)
  • tax_scope = 'igic' → IGIC (código 03, Canarias)
• Método fallback: Si tax_scope no existe, usa el nombre del impuesto

¿Qué es el sector especial para hostelería?

Límite ampliado para facturas simplificadas según Art. 4.2 RD 1619/2012:

• Sectores especiales (límite 3.000€): Hostelería, ventas retail, ambulancias, autopistas, discotecas, peluquerías, instalaciones deportivas, transporte de personas
• Otros sectores (límite 400€): Servicios profesionales, comercio mayorista, industria
• Marque "Sector Especial" en configuración de compañía para aplicar límite de 3.000€
• El sistema sugiere automáticamente F2 o F1 según el límite configurado

¿Cómo gestiona clientes extranjeros?

Gestión automática de NIFs españoles, UE e internacionales:

• NIFs españoles: Detecta automáticamente (12345678A, X1234567A, A12345678) y los envía sin prefijo "ES"
• NIFs UE: Detecta prefijos UE (DE, FR, IT...) y envía en formato "id_otro" con id_type="02"
• NIFs terceros países: Envía en formato "id_otro" con id_type="04"
• Facturas simplificadas (F2/R5): No envían datos del cliente (anónimas por normativa)
• Compatible con validación VIES para NIFs intracomunitarios

¿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