Errores comunes de la AEAT y cómo solucionarlos

Guía completa de los errores más frecuentes al enviar facturas a la AEAT y sus soluciones.

Errores de validación de datos

ERR-NIF-001: NIF no válido o no encontrado

Mensaje completo:

Error: El NIF/CIF del emisor no es válido o no se encuentra en el censo de la AEAT
Código: ERR-NIF-001

Causas:

• NIF/CIF mal escrito (ej. B1234567 en vez de B12345678)
• NIF no dado de alta en la AEAT
• NIF revocado o suspendido

Solución:

1. Verifica tu NIF en Sede AEAT - Censo
2. Comprueba que está correctamente escrito (sin espacios, guiones)
3. Si es correcto pero da error, contacta con la AEAT: 901 200 345

Formato correcto:

✅ B12345678 (CIF empresa)
✅ 12345678A (NIF persona física)
✅ X1234567A (NIE)

❌ B1234567 (falta un dígito)
❌ B-12345678 (guion no permitido)
❌ b12345678 (minúsculas)

ERR-NIF-002: NIF del receptor no válido

Mensaje:

Error: El NIF/CIF del cliente no es válido
Código: ERR-NIF-002

Causas:

• NIF del cliente mal escrito
• NIF no existe en censo AEAT
• NIFFormato incorrecto para intracomunitario

Solución:

Para clientes españoles:

1. Solicita al cliente que verifique su NIF
2. Compruébalo en Consulta NIF AEAT
3. Si es correcto, crea factura rectificativa con NIF corregido

Para clientes intracomunitarios:

1. Verifica el NIF-IVA en VIES (UE)
2. Formato: Código país + número

   ✅ DE123456789 (Alemania)
   ✅ FR12345678901 (Francia)
   ✅ IT12345678901 (Italia)
   

📖 Facturas rectificativas

ERR-IMPORTE-001: Importe negativo o cero

Mensaje:

Error: El importe total de la factura no puede ser negativo o cero
Código: ERR-IMPORTE-001

Causas:

• Factura con importe 0€
• Factura rectificativa mal configurada
• Error en el cálculo (descuento > importe)

Solución:

Si es factura normal:

• Las facturas deben tener importe > 0€
• Si quieres facturar 0€ (ej. regalo), indica en observaciones y pon importe mínimo (ej. 0.01€)

Si es factura rectificativa:

• Las rectificativas de anulación sí pueden ser negativas
• Asegúrate de marcar correctamente como Factura rectificativa (F3)

En VERIFACTURING:

1. Ve a la factura
2. Haz click en Rectificar
3. Selecciona Anulación total
4. El sistema marcará correctamente como F3

ERR-IVA-001: Tipo de IVA no válido

Mensaje:

Error: El tipo de IVA aplicado no es válido para este tipo de operación
Código: ERR-IVA-001

Causas:

• IVA distinto de 21%, 10%, 4%, 0%
• IVA 0% sin justificación (debe ser exento o intracomunitario)
• Recargo de equivalencia mal aplicado

Solución:

Tipos de IVA permitidos:

✅ 21% - General
✅ 10% - Reducido
✅ 4% - Superreducido
✅ 0% - Exento (solo con justificación legal)

❌ 18% (antiguo, ya no válido)
❌ 8% (antiguo, ya no válido)
❌ Cualquier otro porcentaje

Si aplicaste IVA 0%:

• Debe ser operación exenta (educación, sanidad, etc.)
• O intracomunitaria (cliente con NIF-IVA europeo)
• Incluir referencia legal: "Art. 25 Ley 37/1992"

📖 IVA y retenciones

ERR-FECHA-001: Fecha fuera de rango

Mensaje:

Error: La fecha de expedición está fuera del rango permitido
Código: ERR-FECHA-001

Causas:

• Fecha de factura demasiado antigua (> 4 días sin enviar)
• Fecha futura
• Formato de fecha incorrecto

Solución:

1. Si la fecha es correcta pero tardaste en enviar:

   • Envíala igualmente (aunque tarde)
   • Puede generar sanción menor, pero es mejor tarde que nunca

2. Si la fecha es incorrecta:

   • Crea factura rectificativa con fecha correcta

3. Si es fecha futura:

   • No puedes facturar operaciones futuras
   • Espera a la fecha real de la operación

Formato correcto:

✅ 2025-10-01 (ISO 8601)
✅ 01/10/2025 (DD/MM/YYYY)

❌ 10/01/2025 (formato USA MM/DD/YYYY)
❌ 2025/10/35 (día no existe)

Errores de encadenamiento

ERR-HASH-001: Hash no coincide con el esperado

Mensaje:

Error: El hash de la factura no coincide con el esperado según el encadenamiento
Código: ERR-HASH-001

Causas:

• Cadena de hashes rota (factura eliminada o modificada)
• Error en el cálculo del hash
• Base de datos corrupta

Solución:

⚠️ Este es un error grave. Indica que el encadenamiento está roto.

1. No crear más facturas hasta resolver
2. Contacta con soporte inmediatamente: soporte@verifacturing.es
3. Proporciona:
   • Número de la factura con error
   • Últimas 5 facturas creadas
   • Capturas de pantalla

Posibles soluciones:

• Restaurar desde backup
• Recalcular toda la cadena (requiere soporte técnico)
• En casos extremos: reiniciar cadena (consultar AEAT)

ERR-HASH-002: Hash anterior no encontrado

Mensaje:

Error: El hash de la factura anterior no existe en los registros de la AEAT
Código: ERR-HASH-002

Causas:

• La factura anterior no se envió a la AEAT
• Hay un "salto" en la numeración

Solución:

1. Ve a Facturas > Todas las facturas
2. Filtra por Pendientes de envío
3. Envía todas las facturas pendientes en orden
4. Una vez enviadas, reintenta enviar la factura con error

Ejemplo:

2025/0040 - Enviada ✅
2025/0041 - Enviada ✅
2025/0042 - NO ENVIADA ❌
2025/0043 - Intentas enviar → Error ERR-HASH-002

Solución:
1. Enviar 2025/0042
2. Luego enviar 2025/0043

ERR-SECUENCIA-001: Número de factura fuera de secuencia

Mensaje:

Error: El número de factura no sigue la secuencia esperada
Código: ERR-SECUENCIA-001

Causas:

• Número de factura duplicado
• Salto en la numeración (ej. 0041 → 0045, falta 0042-0044)

Solución:

Si es duplicado:

1. Verifica que no creaste dos facturas con el mismo número
2. Si es error, elimina una (si aún no se envió)
3. Si ambas ya se enviaron, contacta con soporte

Si hay salto:

1. Envía las facturas faltantes primero
2. Después envía las posteriores

Consejo: VERIFACTURING numera automáticamente, pero si editaste manualmente los números, pueden aparecer inconsistencias.

Errores de certificado digital

ERR-CERT-001: Certificado no válido

Mensaje:

Error: El certificado digital no es válido o ha caducado
Código: ERR-CERT-001

Causas:

• Certificado caducado
• Certificado revocado
• Certificado no emitido por entidad reconocida

Solución:

1. Verifica la validez del certificado:

   • Configuración > Certificados
   • Comprueba la fecha de caducidad

2. Si caducó:

   • Renueva el certificado con tu entidad (FNMT, Camerfirma, etc.)
   • Instálalo en VERIFACTURING
   • Reenvía las facturas pendientes

3. Si está vigente pero da error:

   • Exporta el certificado y reinstálalo
   • Verifica que es un certificado de representante, no personal

📖 Certificados digitales

ERR-CERT-002: Certificado no autorizado

Mensaje:

Error: El certificado no tiene permisos para enviar facturas en nombre de esta empresa
Código: ERR-CERT-002

Causas:

• Certificado personal (no de representante)
• NIF del certificado ≠ NIF de tu empresa
• Certificado sin poderes de representación

Solución:

1. Verifica que tu certificado es de representante legal

2. Comprueba que el NIF del certificado coincide con el de tu empresa:

   Certificado: B12345678
   Empresa VERIFACTURING: B12345678 ✅
   

3. Si no coincide:

   • Solicita un certificado correcto a FNMT/Camerfirma
   • O actualiza los datos de tu empresa en VERIFACTURING

ERR-CERT-003: Cadena de confianza no válida

Mensaje:

Error: No se puede verificar la cadena de confianza del certificado
Código: ERR-CERT-003

Causas:

• Certificado raíz no reconocido
• Certificados intermedios faltantes

Solución:

1. Descarga de nuevo el certificado desde la entidad emisora
2. Asegúrate de descargar el pack completo (certificado + cadena)
3. Reinstala en VERIFACTURING

Si persiste:

• Contacta con tu entidad certificadora (FNMT, Camerfirma, etc.)
• Puede ser un problema de su infraestructura

Errores de conexión

ERR-CONN-001: Timeout al conectar con la AEAT

Mensaje:

Error: Tiempo de espera agotado al conectar con la AEAT
Código: ERR-CONN-001

Causas:

• AEAT temporalmente no disponible
• Problema de red
• Mantenimiento de la AEAT

Solución:

1. Verifica el estado de la AEAT:

   • Sede electrónica AEAT
   • Si muestra mensaje de mantenimiento, espera

2. Reintenta en unos minutos:

   • VERIFACTURING reintenta automáticamente cada 15 minutos
   • O haz click manual en Reintentar envío

3. Si persiste > 2 horas:

   • Contacta con soporte VERIFACTURING
   • O con AEAT: 901 200 345

ERR-CONN-002: Servicio de la AEAT no disponible

Mensaje:

Error: El servicio VeriFactu de la AEAT no está disponible temporalmente
Código: ERR-CONN-002

Causas:

• Mantenimiento programado de la AEAT
• Caída del servicio
• Saturación (ej. cierre de trimestre)

Solución:

No hagas nada. VERIFACTURING:

• Reintenta automáticamente cada 15 min durante 24h
• Te notifica cuando se envíe correctamente

Si es urgente (< 4 días para que caduque):

• Contacta con soporte para forzar reintentos más frecuentes
• O espera a que la AEAT vuelva (suele ser < 2 horas)

Errores de formato XML

ERR-XML-001: Formato XML no válido

Mensaje:

Error: El XML de la factura no cumple con el esquema XSD de VeriFactu
Código: ERR-XML-001

Causas:

• Bug en VERIFACTURING (poco probable)
• Caracteres especiales en la descripción
• Encoding incorrecto

Solución:

1. Revisa la descripción de la factura:

   • Elimina caracteres especiales: < > & " '
   • Usa solo letras, números, espacios y puntuación básica

2. Si persiste:

   • Contacta con soporte: soporte@verifacturing.es
   • Proporciona el número de factura para que revisemos el XML

ERR-XML-002: Campo obligatorio faltante

Mensaje:

Error: Falta el campo obligatorio [nombre_campo] en el XML
Código: ERR-XML-002

Causas:

• Datos incompletos en la factura
• Campo requerido vacío

Solución:

Según el campo que falte:

NIF/CIF:

• Asegúrate de que el cliente tiene NIF (facturas > 400€)

Dirección:

• Completa la dirección fiscal en los datos del cliente

Descripción:

• Añade descripción a las líneas de factura

Código postal:

• Añade CP en datos de empresa o cliente

En general:

1. Ve a la factura con error
2. Revisa que todos los campos obligatorios están completos
3. Guarda cambios y reenvía

Errores de lógica de negocio

ERR-LOGIC-001: Factura simplificada > 400€

Mensaje:

Error: Las facturas simplificadas no pueden superar los 400€ (IVA incluido)
Código: ERR-LOGIC-001

Causas:

• Cliente sin NIF y importe > 400€

Solución:

1. Solicita el NIF/CIF al cliente
2. Crea una factura completa (F1) con:
   • NIF del cliente
   • Dirección fiscal completa
3. Anula la factura simplificada (si ya se creó)

Alternativa: Divide en varias facturas de < 400€ cada una (no recomendado).

ERR-LOGIC-002: Rectificativa sin factura original

Mensaje:

Error: La factura rectificativa debe referenciar una factura original válida
Código: ERR-LOGIC-002

Causas:

• Referencia incorrecta a factura original
• Factura original no enviada a AEAT
• Número de factura original mal escrito

Solución:

1. Verifica que la factura original existe y está enviada:

   • Facturas > Buscar número original
   • Comprobar que estado = Aceptada

2. Si la original no se envió:

   • Envíala primero
   • Luego envía la rectificativa

3. Si el número es incorrecto:

   • Crea nueva rectificativa con referencia correcta

Errores específicos de VeriFactu

ERR-VF-001: QR code no válido

Mensaje:

Error: El código QR de la factura no es válido o no se puede verificar
Código: ERR-VF-001

Causas:

• QR mal generado (bug del sistema)
• Datos del QR no coinciden con la factura

Solución:

1. Contacta con soporte inmediatamente: soporte@verifacturing.es
2. Proporciona número de factura
3. No intentes enviar más facturas hasta que se resuelva

⚠️ Este error indica problema técnico grave.

ERR-VF-002: Serie de facturación no declarada

Mensaje:

Error: La serie de facturación utilizada no está declarada en la AEAT
Código: ERR-VF-002

Causas:

• Primera factura de una nueva serie
• Serie no registrada previamente

Solución:

1. Registra la serie en la AEAT:

   • Sede AEAT - Censos
   • Censo de empresarios > Series de facturación
   • Añade la serie nueva (ej. 2025)

2. O usa una serie ya registrada:

   • Configuración > Facturación > Series
   • Cambia a serie existente (ej. 2024)

Errores raros pero posibles

ERR-RARE-001: Factura duplicada

Mensaje:

Error: Ya existe una factura con este número en los registros de la AEAT
Código: ERR-RARE-001

Causas:

• Reenvío accidental de factura ya aceptada
• Dos sistemas facturando con la misma serie

Solución:

1. Verifica que la factura original está en estado Aceptada
2. Si es así, ignora el error (ya está enviada)
3. Si tienes dos sistemas facturando:
   • Usa series diferentes en cada sistema
   • O centraliza todo en VERIFACTURING

ERR-RARE-002: NIF sancionado o suspendido

Mensaje:

Error: El NIF del emisor está suspendido o sancionado por la AEAT
Código: ERR-RARE-002

Causas:

• Deudas con la AEAT
• Sanciones pendientes
• Suspensión de actividad

Solución:

1. Contacta con la AEAT urgentemente: 901 200 345
2. Regulariza tu situación fiscal
3. Una vez resuelto, podrás enviar facturas

Cómo interpretar los códigos de error

Los códigos de error siguen esta estructura:

ERR-[CATEGORIA]-[NUMERO]

Categorías:
- NIF: Errores de identificación fiscal
- IMPORTE: Errores de cálculo de importes
- IVA: Errores relacionados con IVA
- FECHA: Errores de fechas
- HASH: Errores de encadenamiento
- CERT: Errores de certificado digital
- CONN: Errores de conexión
- XML: Errores de formato
- LOGIC: Errores de lógica de negocio
- VF: Errores específicos de VeriFactu
- RARE: Errores poco comunes

Obtener ayuda con errores

Logs detallados

Facturas > Detalle de factura > Ver logs técnicos

Verás:

[2025-10-01 10:32:15] Creando XML...
[2025-10-01 10:32:16] XML creado correctamente
[2025-10-01 10:32:17] Firmando con certificado...
[2025-10-01 10:32:18] Firma correcta
[2025-10-01 10:32:19] Enviando a AEAT...
[2025-10-01 10:32:22] Error AEAT: ERR-NIF-002
                      NIF del receptor no válido

Copia estos logs al contactar con soporte.

Contactar soporte

Cuando contactes con soporte, proporciona:

1. ✅ Código de error completo (ej. ERR-NIF-002)
2. ✅ Número de factura con error
3. ✅ Logs técnicos (copia completa)
4. ✅ Captura de pantalla del error
5. ✅ Qué intentaste antes de contactar

Email: soporte@verifacturing.es Teléfono: 900 123 456 (L-V 9-18h)

Soporte de la AEAT

Para errores que requieren intervención de la AEAT:

📞 Teléfono: 901 200 345 🌐 Sede electrónica: https://sede.agenciatributaria.gob.es 💬 Chat: Disponible en sede electrónica (L-V 9-19h)

Prevención de errores

Checklist antes de enviar

✅ Datos de empresa correctos (NIF, dirección, etc.)

✅ Certificado digital válido y no próximo a caducar

✅ Datos del cliente completos (NIF si > 400€)

✅ Importes correctos (base, IVA, total)

✅ Descripción clara sin caracteres especiales

✅ Tipo de IVA correcto (21%, 10%, 4%, 0%)

✅ Fecha coherente (no futura, no demasiado antigua)

✅ Hash correcto (automático en VERIFACTURING)

Monitoreo proactivo

Dashboard > Estado del sistema

Verás indicadores:

🟢 Conexión con AEAT: OK
🟢 Certificado: Válido hasta 2027-10-01
🟢 Última factura enviada: Hace 2 horas
🟡 Facturas pendientes: 3 (dentro de plazo)

Si algo está 🔴 rojo, investiga antes de enviar más facturas.

¿Necesitas ayuda?

• 💬 Chat IA: Pregunta al asistente (describe el error exacto)
• 📧 Email: soporte@verifacturing.es
• 📞 Teléfono: 900 123 456 (L-V 9-18h)
• 🏛️ AEAT: 901 200 345

---

Más información:

• 📄 Enviar facturas a la AEAT
• 📄 Requisitos legales
• 📄 Certificados digitales