Guía
API Verifactu de pago o librería open source: qué integrar en tu software
Si desarrollas un software que emite facturas, tienes dos caminos para cumplir Verifactu: contratar una API comercial que hace de intermediario con la AEAT, o integrar directamente con una librería open source. Ninguno es «el bueno» para todos los casos — esta es la comparativa honesta.
Los dos modelos, en una frase
Una API comercial de Verifactu recibe tus facturas en JSON, genera por ti el registro, la huella y el QR, y las envía a la AEAT con su propio certificado actuando como colaborador social. Una librería open source como Traazza genera todo eso dentro de tu propio software y envía los registros directamente a la AEAT con tu certificado.
Comparativa directa
| API comercial | Librería open source | |
|---|---|---|
| Coste | Cuota mensual o por factura, para siempre | Software gratuito; pagas solo el desarrollo inicial |
| Certificado digital | No lo necesitas (usan el suyo como colaborador social) | Necesitas el del obligado o un representante |
| Datos de facturación | Pasan por los servidores de un tercero | No salen de tu sistema: van directos a la AEAT |
| Dependencia | Si el proveedor cae, sube precios o cierra, te afecta | Ninguna: el código es tuyo y auditable |
| Cambios normativos | Los absorbe el proveedor | Actualizas la librería (o contribuyes al proyecto) |
| Tiempo de integración | Días: una llamada REST | Días o semanas, según tu software |
| Transparencia | Caja negra: confías en que lo hacen bien | Código abierto: puedes ver exactamente qué se genera y firma |
Cuándo tiene sentido una API de pago
- No quieres gestionar certificados digitales ni tocar SOAP.
- Tu volumen de facturas es bajo y la cuota te compensa frente al desarrollo.
- Necesitas cubrir también TicketBAI u otros territorios forales con el mismo contrato.
- No tienes equipo técnico propio que mantenga la integración.
Cuándo gana la librería open source
- Emites muchas facturas: el coste por factura de una API se convierte en un peaje permanente que crece con tu negocio.
- No quieres que los datos de facturación de tus clientes pasen por un tercero.
- Vendes un software de facturación y no puedes atar tu producto (y tu margen) al precio de un proveedor externo.
- Quieres poder auditar qué se firma y se envía exactamente: huella encadenada, XML, QR.
Qué resuelve exactamente Traazza
Traazza es una librería Python open source (MIT) que implementa la parte difícil del RRSIF: el encadenamiento de huellas SHA-256, el QR tributario, la generación y validación del XML contra los esquemas oficiales, la firma XAdES y el envío SOAP a la AEAT — tanto al entorno de pruebas como al real. Puedes probar los conceptos en el playground online sin instalar nada.
Honestidad ante todo: si no tienes equipo técnico, una API comercial probablemente te dé menos dolores de cabeza. La librería open source brilla cuando hay un desarrollador detrás — y si lo necesitas, yo mismo hago integraciones de Traazza en software de facturación existente.
El error de decidir solo por precio inicial
La API parece «gratis de integrar» y la librería «cara de desarrollar», pero la cuenta cambia con el tiempo: una cuota de 30-100 €/mes son 1.800-6.000 € en cinco años, más lo que crezca tu volumen. La integración open source se paga una vez. Haz el cálculo con tus números reales antes de decidir — y recuerda que migrar de proveedor con los registros ya encadenados no es trivial.
Preguntas frecuentes
¿Necesito certificado digital con una librería open source?
Sí: el envío directo a la AEAT se autentica con el certificado del obligado tributario o de un representante. Es un trámite, no una barrera — cualquier empresa puede obtenerlo.
¿Es legal integrar directamente contra la AEAT?
Completamente. La AEAT publica los esquemas y servicios web oficiales para eso. El colaborador social es una comodidad, no un requisito.
¿Y si cambia la normativa?
Con una API, el proveedor la adapta y tú heredas el cambio. Con la librería, actualizas a la versión nueva — el histórico de cambios es público y auditable.
Aviso: esto es información técnica para desarrolladores, no asesoramiento legal ni fiscal. Ante dudas normativas, consulta la sede de la AEAT o a tu asesor.
