El puente definitivo entre tu ERP y la Agencia Tributaria (VeriFactu)
Important
📢 ESTADO DEL PRODUCTO: PRÓXIMAMENTE DISPONIBLE El Middleware VeriFactu está finalizando su fase de pruebas y muy pronto estará disponible para descargar e instalar en tu propia infraestructura. ¡Mantente atento a nuestra web para el lanzamiento oficial!
Crea una cuenta con tu email en nuestra web, sin necesidad de aportar más datos. Serás avisado de forma inmediata de la disponibilidad de la descarga de los binarios para Windows y Linux, así como de la disposición de la licencia con la clave de activación.
Bienvenido al repositorio oficial de documentación de la API VeriFactu. Este repositorio contiene las guías técnicas, ejemplos de integración y la arquitectura de nuestro Middleware diseñado para facilitar a otras empresas el cumplimiento normativo exigido por el entorno VeriFactu de la Agencia Tributaria.
Este software opera bajo una Licencia Comercial de uso a largo plazo. No es software de código abierto (no es MIT ni similar) y su explotación requiere una suscripción activa.
Tip
🎁 PROMOCIÓN ESPECIAL DE LANZAMIENTO Para facilitar la adopción y las pruebas en entornos productivos, durante los primeros 18 meses tras la instalación, no se activarán los mecanismos de cobro por licencia. Podrás utilizar y validar el Middleware sin restricciones comerciales durante este extenso periodo de gracia. Las licencias adquiridas están pensadas para una viabilidad a muy largo plazo.
Esta licencia inicial permite hasta tres emisores simultáneos; esto es, llevar las operaciones de tres empresas distintas independientes sin ningún límite de facturas emitidas. Cuando el Middleware esté público disponible, pruébenlo sin miedo y si les satisface no duden en pasarlo a su producción. No habrá sorpresas en el precio de las suscripciones tras este tiempo, ya que estas se ajustarán a la media del mercado. Además, actualmente se está estudiando la viabilidad de ofrecer licencias perpetuamente gratuitas para proyectos de un solo emisor con un volumen de hasta 1.000 operaciones anuales.
El Middleware actúa como una caja negra que recibe tus facturas en formato genérico JSON (desde tu ERP en C#, Delphi, PHP, etc.) y se encarga de firmarlas, estructurarlas y enviarlas a Hacienda, devolviéndote el estado.
graph LR
A[Tu ERP o App] -->|1. Envía Factura JSON| B(Middleware VeriFactu)
B -->|2. Firma y Valida| C{Motor Local}
C -->|3. Comunicación Segura| D[(Agencia Tributaria)]
D -->|4. Respuesta: Aceptada o Error| C
C -->|5. Retorna Estado Final| A
style A fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px;
style B fill:#fff3e0,stroke:#ff9800,stroke-width:2px;
style C fill:#f3e5f5,stroke:#9c27b0,stroke-width:2px;
style D fill:#e8f5e9,stroke:#4caf50,stroke-width:2px;
Toda la documentación está estructurada en la carpeta docs/:
- Visión General del Middleware - Conceptos básicos y propósito del sistema.
- Arquitectura de Componentes - Diagrama general del Frontend, Backend y BD.
- Conceptos y Flujo de Trabajo (Workflows) - Cómo funciona la ingesta de facturas y los estados.
- El Entorno de Simulación - Entorno seguro para pruebas sin enviar a la AEAT real.
- Integración de la API (REST) - Referencia técnica de los endpoints (Ingesta, Ack,...).
- Diccionario de Datos (API y BD) - Definición del modelo JSON de peticiones y respuestas.
- Rutas y Estructura de Proyecto - Organización interna del desarrollo.
- Monitorización y Registro (Logging) - Información operativa del sistema.
En la carpeta docs/sdk_integration_guides/ encontrarás guías listas para ser utilizadas en tu entorno de desarrollo. Ejemplos de conexión para:
Ver Guía de Integración Node.js en el navegador
Ver Guía de Integración Python en el navegador
Ver Guía de Integración C# en el navegador
Ver Guía de Integración PHP en el navegador
Ver Guía Delphi 7 • Ver Guía Delphi 10+
Si eres nuevo en la plataforma, te recomendamos leer primero la Visión General y posteriormente revisar la guía de integración del lenguaje de programación que utilices en tu empresa.