Glosario VeriFactu para desarrolladores
· Equipo Factuneo
Los términos de VeriFactu que necesitas al integrar la API, explicados al grano: huella, encadenamiento, SIF, XAdES, mTLS, modo representado, tipos de factura, claveRegimen y más.
Un vocabulario rápido de VeriFactu para quien integra la API. Al grano.
VeriFactu
Sistema de la AEAT (RD 1007/2023, Orden HAC/1177/2024) para que los programas de facturación generen registros íntegros, trazables e inalterables y, en su modalidad de remisión, los envíen a Hacienda al emitir.
SIF (Sistema Informático de Facturación)
El software que produce las facturas. Como desarrollador produces un SIF y debes acompañarlo de una declaración responsable de que cumple.
Registro de alta
El registro que se genera al emitir una factura: datos fiscales, huella y encadenado con el anterior.
Huella (hash)
Resumen SHA-256 del registro. Cada registro incluye la huella del anterior, formando una cadena: alterar una factura pasada rompe la secuencia y es detectable.
Encadenamiento
Cada registro referencia la huella del previo. Por eso el orden importa y no se pueden borrar registros.
Código QR
Va impreso en la factura y permite verificarla contra la AEAT. Factuneo te lo devuelve al crear la factura.
Facturae 3.2.2
Formato de factura electrónica estructurada (XML) exigido en B2B por la Ley Crea y Crece. Es distinto de VeriFactu: uno es el registro fiscal, el otro el documento. La API genera ambos.
XAdES-EPES
Perfil de firma electrónica XML avanzada con política de firma, usado para firmar el Facturae según el esquema de la AEAT.
mTLS
TLS con autenticación mutua (cliente y servidor presentan certificado). Es como VeriFactu autentica el envío a la AEAT: por eso hace falta un certificado.
Colaborador social / Apoderamiento
Dos vías para firmar en nombre de terceros: colaboración social (convenio, típico de SL/SA) o apoderamiento (Registro de Apoderamientos de la AEAT). Habilitan el modo Representado: un certificado factura por muchos NIFs.
Modo Propio vs Representado
Propio: cada obligado aporta su certificado. Representado: la cuenta usa un certificado de representación por todos sus emisores.
Tipos de factura (F1, F2, F3, R1–R5)
Clasificación AEAT: F1 (completa), F2 (simplificada/ticket), F3 (sustitutiva), R1–R5 (rectificativas). Determinan si destinatarios es obligatorio.
claveRegimen y calificacionOperacion
En el desglose: claveRegimen (régimen de IVA, p. ej. 01 general) y calificacionOperacion (p. ej. S1 sujeta y no exenta). Definen cómo tributa cada línea.
Anulación
VeriFactu no borra: para dejar sin efecto una factura se emite un registro de anulación, que también encadena y deja rastro.
RechazoPrevio y Subsanación
Al reenviar un registro que la AEAT rechazó, se informa RechazoPrevio=S y Subsanacion=S para indicar que corrige un intento anterior.
¿Te falta un término? Escríbenos y lo añadimos. Empieza por la documentación o la guía de integración.