Antes de enviar tu primera factura conviene entender cinco conceptos que aparecen en todos lados. No tienes que memorizar la normativa — solo entender por qué existe cada pieza.

Veri*Factu en una frase

Veri*Factu es el sistema que obliga a los programas de facturación a enviar cada factura a Hacienda (AEAT) en tiempo real, de forma que no pueda modificarse después. La ley detrás es el RD 1007/2023 y la orden ministerial OM HAC/1177/2024.

AEAT valida NIFs reales también en preproducción/QA. No uses NIFs inventados; el emisor suele ser el NIF del titular del certificado FNMT. Ver Entornos.

Huella (SHA-256)

Cada factura lleva un hash SHA-256 de los datos principales (importe, NIF, número, fecha, tipo…) llamado huella. Hacienda lo recalcula: si no coincide → error 2000.

En la práctica, puedes omitir huella, tipoHuella y fechaHoraHusoGenRegistro y el servidor los genera por ti. Solo necesitas calcularlos a mano si tu ERP ya lo hace o quieres depurar un 2000.

Datos de tu factura  →  hash SHA-256  →  "huella"  →  se incluye en el envío
                                             ↑
                              AEAT la recalcula y compara

La huella tiene un formato estricto: 64 caracteres hexadecimales en mayúsculas. El campo se llama huella en el JSON y tipoHuella: "01" significa SHA-256.

Truco de depuración: si AEAT te devuelve el error 2000, el mensaje incluye la cadena canónica que ELLOS calcularon. Cópiala, calcula su SHA-256 y compara con la tuya — así encuentras exactamente qué dato estás formateando distinto.

Formato de importes en la huella

Este es el error más frecuente. Los importes dentro de la cadena canónica no usan dos decimales siempre:

Valor	❌ Incorrecto	✅ Correcto
210	`210.00`	`210.0`
1210	`1210.00`	`1210.0`
21.10	`21.10`	`21.1`
21.15	`21.15`	`21.15`

Fórmula: Number(v).toFixed(2).replace(/\.00$/, ".0").

Encadenamiento

Las facturas no son independientes: cada factura incluye la huella de la factura anterior. Esto forma una cadena que hace imposible insertar o borrar facturas del histórico sin que se note.

Factura 1  →  huella₁
Factura 2  →  (huella₁ + datos₂)  →  huella₂
Factura 3  →  (huella₂ + datos₃)  →  huella₃

Nosotros llevamos el rastro por ti. En el camino feliz puedes omitir encadenamiento y primerRegistro: el servidor usa la última huella persistida (o marca primer registro si la cadena está vacía).

Si controlas la cadena a mano: pasa encadenamiento.registroAnterior en cada envío (excepto el primero, con primerRegistro: true).

Primer registro (`primerRegistro: true`)

La primera factura de una cadena nueva no tiene "factura anterior". Puedes omitir el campo (el servidor lo infiere) o enviar primerRegistro: true explícitamente.

primerRegistro omitido / true   →  no hay huella anterior, es la primera de la cadena
primerRegistro: false           →  hace falta enlace a la factura anterior (tuyo o auto)

Si mandas primerRegistro: true y la cadena ya tiene facturas → error 409 ChainStateError («la cadena ya existe»). Si mandas primerRegistro: false sin la huella correcta (y sin auto-relleno posible) → error 409 ChainContinuityError.

CSV (Código Seguro de Verificación)

Cuando AEAT acepta tu factura te devuelve un CSV: un código alfanumérico con el formato A-XXXXXXXXXXXXXXX. Es el "número de expediente" de esa factura en los servidores de Hacienda.

Con el CSV y la URL de verificación, cualquiera puede comprobar en la web de la AEAT que la factura existe y no ha sido manipulada. Debes imprimir el CSV y el QR en el PDF de la factura (art. 25 del RD 1007/2023).

Sistema informático (`sistemaInformatico`)

AEAT exige identificar qué software (SIF) generó el registro. En Simple*Factu no lo envías en el JSON: la API lo rellena con el SIF de plataforma. Tú solo envías datos de negocio + certificado del emisor.

OT = obligado tributario (el NIF emisor de la factura). No confundir con el fabricante del SIF.

El modo excepcional “SIF del cliente” (clientSifEnabled) solo lo activa soporte/admin si tu ERP es el fabricante certificado. Detalle: Envío de facturas → Sistema informático.

Con esto claro, el Inicio rápido debería tener mucho más sentido.