Migrar a VeriFactu en dos semanas: guía realista
Si has llegado tarde, esto es lo mínimo viable en dos semanas. No es lo ideal, pero llega.
Antes de empezar: dos decisiones
No se pueden aplazar, porque condicionan todo lo demás.
- ¿Modalidad VERI*FACTU o no verificable? Si dudas, VERI*FACTU: remitir es más barato que custodiar.
- ¿Quién firma? Tú en representación de tus clientes (necesitas apoderamientos) o cada cliente con su certificado. Si el trámite del apoderamiento te va a llevar semanas, empieza por nombre propio con los clientes que ya tengan certificado.
Semana 1 — que la huella cuadre
Días 1-2 · La huella y nada más
No escribas ni una línea de XML todavía. Implementa el cálculo de la huella y no pases de aquí hasta que los tres ejemplos oficiales de la AEAT cuadren byte a byte.
Es contraintuitivo dedicar dos días a una función de veinte líneas, pero si esto está mal todo lo demás es tiempo perdido — y es irreversible.
Días 3-4 · Persistencia y cadena
- Tabla de registros: huella, huella anterior, número y fecha del anterior, sello temporal, cadena de entrada.
- Serializa la escritura por emisor. No lo dejes para después: es un fallo que no aparece en pruebas y sí en producción.
Día 5 · XML contra los esquemas
Descarga los XSD oficiales y valida contra ellos en local, antes de enviar nada. Te ahorra la mitad de los rechazos.
Semana 2 — hablar con Hacienda
Días 6-7 · Validación sin conexión
El portal de preproducción de la AEAT tiene un formulario donde subes el XML a mano y su servidor te responde. No necesitas apoderamiento ni salida a internet desde tu servidor para usarlo.
Aquí es donde aparecen los rechazos de censo (1110, 4104) y de identificador (1177). Resuélvelos todos antes de montar el transporte.
Días 8-9 · Transporte
- Endpoint correcto según entorno y tipo de certificado.
- Cola con reintentos y espera creciente.
- Guardar el tiempo de espera que indica la AEAT y respetarlo.
Día 10 · QR y documento
QR en la factura, con la URL del entorno correcto y los parámetros escapados. Prueba con papel térmico real si imprimes tickets.
Días 11-12 · Un emisor real
Un solo cliente, en producción, facturando de verdad. Mira los rechazos, corrige, repite.
Días 13-14 · Colchón
Reserva dos días. Los vas a necesitar.
Lo que puedes dejar para después
- Panel bonito de estado. Con un listado y un log de errores llegas.
- Webhooks. Consultar por polling sirve al principio.
- Informes y estadísticas.
- Migrar el histórico anterior a la entrada en vigor.
Lo que NO puedes dejar para después
- El formato de la huella. Es irreversible.
- La serialización de la cadena. También irreversible.
- Guardar el sello temporal y la cadena de entrada. Sin eso no puedes reverificar nunca.
- Separar pruebas de producción, QR incluido.