DOCUMENTACIÓN DE INGENIERÍA FISCAL
Guía Técnica: Anatomía de los Rechazos en FACe (Facturae 3.2.2) y Especificación Criptográfica Veri*factu
Cuando una Administración Pública rechaza un fichero .xsig en FACe o el entorno de pruebas de la AEAT devuelve un error de huella en un lote SOAP de Veri*factu, el problema rara vez es visual: casi siempre reside en reglas aritméticas de coma flotante, codificación de caracteres o validación estricta de esquemas XSD. A continuación detallamos qué audita exactamente esta herramienta y cómo resolver cada incidencia desde el código fuente.
1. El error #1 en FACe: precisión decimal de línea frente a totales de cabecera
El esquema XSD de Facturae 3.2.2 (Orden PRE/2971/2007 y actualizaciones posteriores) permite expresar precios unitarios (UnitPriceWithoutTax) y cantidades con hasta ocho decimales en sectores como energía, suministros industriales o telecomunicaciones. Sin embargo, los nodos agregados de cabecera (TotalGrossAmount, TotalGrossAmountBeforeTaxes, TotalTaxOutputs e InvoiceTotal) deben cuadrar al céntimo con la suma de bases imponibles agrupadas por tipo impositivo.
Si tu ERP calcula el IVA línea a línea redondeando a dos decimales y luego suma esas cuotas, mientras que FACe recalcula TaxableBase * TaxRate / 100 sobre el acumulado por tramo de IVA (21 %, 10 %, 4 %), aparecerá el clásico descuadre de 0,01 € o 0,02 €. En software financiero en PHP o Laravel utilizamos siempre aritmética entera en céntimos o la extensión BCMath evitando tipos binarios float IEEE 754.
2. Validación de NIF/NIE/CIF y Unidades DIR3 en Licitaciones B2G
En facturas dirigidas al sector público (ayuntamientos, diputaciones, universidades, hospitales o ministerios a través de FACe, e-FACT o PeP), el bloque AdministrativeCentres dentro de BuyerParty debe declarar obligatoriamente la tripleta de códigos del Directorio Común de Unidades Orgánicas y Oficinas (DIR3):
- Rol
01 (Oficina Contable): órgano encargado del registro contable de la factura.
- Rol
02 (Órgano Gestor): entidad competente en la tramitación del expediente de gasto.
- Rol
03 (Unidad Tramitadora): servicio administrativo que conforma la recepción o certificación.
Además, el nodo TaxIdentificationNumber de residentes en España (ResidenceTypeCode = R) exige validar matemáticamente el dígito o letra de control (módulo 23 en DNI/NIE y suma ponderada par/impar en CIF societarios o entidades locales P, Q, S).
3. Firma Electrónica XAdES-EPES (.xsig) y Vigencia del Certificado X.509
Un archivo .xsig no es un formato binario comprimido, sino un documento XML plano que incorpora en su interior el nodo <ds:Signature> en modalidad enveloped siguiendo el estándar europeo XAdES-EPES (o XAdES-T/XL con sellado de tiempo TSA). Para ser admitida, la firma debe referenciar la política oficial de firma de Facturae v3.1, proteger tanto el cuerpo completo de la factura como las propiedades firmadas (SignedProperties, que incluyen el instante de firma SigningTime y el resumen del certificado firmante) y haberse generado con un certificado cualificado vigente en el momento de expedición.
Nuestro analizador decodifica en local el bloque Base64 de X509Certificate para extraer las marcas ASN.1 de validez temporal y alertarte si estás firmando con un certificado caducado o próximo a expirar.
4. Encadenamiento SHA-256 y Código QR en Veri*factu (HAC/1177/2024)
El reglamento Veri*factu (Real Decreto 1007/2023, desarrollado técnicamente por la Orden HAC/1177/2024 y con calendario definitivo fijado por el RD-ley 15/2025 para enero y julio de 2027) introduce dos mecanismos verificables que puedes comprobar en la segunda pestaña de esta página:
Por un lado, cada RegistroFacturacionAlta calcula su huella aplicando SHA-256 sobre ocho campos concatenados con &. Cualquier diferencia mínima —como omitir el huso horario +01:00 / +02:00 en verano, usar coma decimal en lugar de punto o pasar el hash en minúsculas— invalida toda la cadena fiscal ante la AEAT.
Por otro lado, el PDF o ticket impreso debe incluir un código QR tributario apuntando al servicio oficial de cotejo de la Sede Electrónica con los parámetros nif, numserie, fecha (DD-MM-YYYY) e importe correctamente codificados en URL. Si necesitas automatizar este proceso dentro de tu plataforma actual, revisa nuestra arquitectura de adaptación técnica a Veri*factu.