# DOC — Documentación oficial VERI\*FACTU

Todo lo que hay aquí está **descargado de fuente oficial** (AEAT y BOE) el **2026-08-12**.
Es el material de referencia del proyecto XTRF → micro-SIF propio → VERI\*FACTU → AEAT.

Los dos documentos de trabajo (`XTRF-SIF-VERIFACTU-AEAT.md` y `.excalidraw`) están en el directorio padre.

---

## `aeat-especificaciones/` — los PDF que hay que leer antes de programar

| Fichero | Qué contiene | Para quién |
|---|---|---|
| `Veri-Factu_especificaciones_huella_hash_registros.pdf` | **La receta de la huella**: campos, orden, separadores, formatos, UTF-8 → SHA-256 → hex mayúsculas, y los **vectores de prueba oficiales** con su huella resultante | Quien implemente el encadenamiento. Los ejemplos son tests unitarios listos para usar |
| `DetalleEspecificacTecnCodigoQRfactura.pdf` | Especificación del **QR**: URL base de producción y pruebas, parámetros y su orden, codificación, tamaño (30–40 mm), nivel de corrección M y las leyendas obligatorias | Quien haga la plantilla OpenPDF |
| `Veri-Factu_Descripcion_SWeb.pdf` | Descripción del **servicio web**: endpoints, operaciones, estructura de los mensajes, límites y control de flujo | Quien escriba el cliente SOAP |
| `Validaciones_Errores_VERIFACTU_1.2.2.pdf` | **247 códigos de error** y las validaciones de la AEAT. Solo 10 no rechazan el registro | Quien mapee los datos fiscales y trate las respuestas |
| `errores.properties` | Los mismos códigos en formato clave-valor, cómodo para cargarlos en el código | Ídem |
| `FAQs-Desarrolladores.pdf` | Preguntas frecuentes oficiales para desarrolladores (v1.3, diciembre 2025) | Todo el equipo |

## `aeat-esquemas/` — WSDL y XSD para generar el binding

`SistemaFacturacion.wsdl` · `SuministroInformacion.xsd` (el grande, con todos los tipos) · `SuministroLR.xsd` · `ConsultaLR.xsd` · `RespuestaSuministro.xsd` · `RespuestaConsultaLR.xsd`

- **`xmldsig-core-schema.xsd`**: descargado aparte a propósito. `SuministroInformacion.xsd` lo importa **desde w3.org por URL remota**, así que generar el binding sin red (o con w3.org lento) falla o se cuelga. Redirigid el `schemaLocation` a esta copia local con un catálogo.
- Los ficheros deben permanecer **en la misma carpeta**: el WSDL los importa con rutas relativas.
- **`HALLAZGOS.md`**: análisis de los esquemas parseados campo por campo, con las trampas de binding detectadas y las listas cerradas completas. Empezad por su apartado 0.
- **`fuera-de-alcance/EventosSIF.xsd`**: movido aquí el 2026-08-29. No lo importa el WSDL y corresponde al registro de eventos de sistemas NO VERI\*FACTU, excluido mientras el proyecto opere solo en modo VERI\*FACTU (ver `fuera-de-alcance/NOTA.md`).

## `boe/` — las normas, en PDF oficial

| Fichero | Norma |
|---|---|
| `BOE-A-2023-24840.pdf` | **RD 1007/2023** — el Reglamento. Art. 3.3 (exclusión por SII) y art. 15 (remisión voluntaria) |
| `BOE-A-2024-22138.pdf` | **Orden HAC/1177/2024** — especificaciones técnicas y el anexo con las listas cerradas de valores |
| `BOE-A-2025-6600.pdf` | **RD 254/2025** — modifica el Reglamento |
| `BOE-A-2025-24446.pdf` | **RD-ley 15/2025** — fija las fechas vigentes: 1/1/2027 (Impuesto sobre Sociedades) y 1/7/2027 (resto) |
| `BOE-A-2026-7295.pdf` | **RD 238/2026** — factura electrónica B2B (Ley Crea y Crece). Obligación **paralela**, no sustituye a VERI\*FACTU |

---

## Nota de vigencia

Las fechas de VERI\*FACTU han cambiado **dos veces** (RD 254/2025 y RD-ley 15/2025). Antes de tomar decisiones con fecha, comprobad en boe.es que no hay norma posterior.

Pendiente de vigilar: la **orden ministerial** que desarrolla la solución pública del RD 238/2026. Es la que arranca el plazo de 24 meses y **aún no está publicada**.
