⚙️El Procesamiento Automático de VeriFactu

Guía completa del sistema de procesamiento automático de VeriFactu - Funcionamiento y monitoreo de tareas automáticas

🎯 Objetivo

Comprender el funcionamiento del sistema de procesamiento automático de VeriFactu en HolaGest, los diferentes procesos que se ejecutan en segundo plano y cómo monitorear su correcto funcionamiento.

📖 ¿Qué es el Procesamiento Automático?

El procesamiento automático es un sistema de tareas programadas que se ejecutan automáticamente en segundo plano a intervalos regulares, sin intervención del usuario.

Importancia del Procesamiento Automático en VeriFactu

VeriFactu depende completamente del procesamiento automático para muchos de sus procesos:

  • ✅ Envío automático de registros de facturas a la AEAT

  • ✅ Generación de hash y firma digital de registros

  • ✅ Creación de registros de eventos (modo NO-VeriFactu)

  • ✅ Procesamiento de requerimientos de la AEAT

  • ✅ Detección de anomalías en los datos

⚠️ IMPORTANTE: El procesamiento automático funciona sin necesidad de configuración por parte del usuario. HolaGest se encarga de todo automáticamente.

🔄 Procesos Automáticos de VeriFactu

El sistema de procesamiento automático ejecuta 4 procesos principales:

1️⃣ Hash y Firma de Registros de Facturas

Nombre del proceso: verifactu-invoice-hash-signature

Descripción: Genera el hash y firma digitalmente los registros de facturas.

Funcionamiento:

  1. Busca registros de facturas sin hash (pendientes de procesar)

  2. Para cada registro:

    • Genera el hash criptográfico (SHA-256)

    • Encadena con el hash del registro anterior

    • Firma digitalmente con el certificado de la empresa

  3. Guarda el hash y la firma en la base de datos

Ejemplo de encadenamiento:

Importancia: Este proceso es obligatorio para garantizar la integridad de la cadena de facturas.

Frecuencia: Se ejecuta automáticamente cada pocos minutos.

2️⃣ Hash y Firma de Registros de Eventos

Nombre del proceso: verifactu-event-hash-signature

Descripción: Genera el hash y firma digitalmente los registros de eventos.

Funcionamiento:

  1. Busca registros de eventos sin hash (pendientes de procesar)

  2. Para cada registro:

    • Genera el hash criptográfico (SHA-256)

    • Encadena con el hash del registro anterior

    • Firma digitalmente con el certificado de la empresa

  3. Guarda el hash y la firma en la base de datos

Aplicable solo a: Modo NO-VeriFactu

Importancia: Garantiza la integridad de la cadena de eventos.

Frecuencia: Se ejecuta automáticamente cada pocos minutos.

3️⃣ Creación de Registros de Eventos

Nombre del proceso: verifactu-event-check

Descripción: Crea automáticamente los registros de eventos necesarios.

Funcionamiento:

  1. Verifica si hay ejercicios en modo NO-VeriFactu

  2. Crea los registros de eventos necesarios:

    • Inicio de NO-VeriFactu: Al comenzar el ejercicio

    • Fin de NO-VeriFactu: Al finalizar el ejercicio

    • Detección de anomalías en facturas: Periódicamente

    • Detección de anomalías en eventos: Periódicamente

    • Resumen de eventos: Periódicamente

  3. Verifica la integridad de los datos

  4. Detecta anomalías o inconsistencias

Aplicable solo a: Modo NO-VeriFactu

Frecuencia: Se ejecuta automáticamente cada 24 horas.

Importancia: Garantiza el cumplimiento normativo en modo NO-VeriFactu.

4️⃣ Envío de Registros de Facturas

Nombre del proceso: verifactu-invoice-send

Descripción: Envía los registros de facturas a la AEAT.

Funcionamiento:

  1. Verifica si hay requerimientos pendientes o en proceso

  2. Si hay requerimientos:

    • Prioriza el requerimiento (máxima prioridad)

    • Envía los registros del requerimiento uno por uno

    • Actualiza el estado de cada registro

  3. Si NO hay requerimientos:

    • Busca registros de facturas pendientes de envío (estado vacío)

    • Envía los registros uno por uno a la AEAT

    • Actualiza el estado con la respuesta de la AEAT

Aplicable a: Modo VeriFactu (envío online) y Requerimientos (ambos modos)

Frecuencia: Se ejecuta automáticamente cada pocos minutos.

Importancia: Es el proceso principal que envía las facturas a la AEAT.

📊 Monitoreo del Procesamiento Automático

Acceso a los Logs

Ruta: Menú Administrador → Logs → Pestaña Historial

Filtrar por Canal

Para ver los logs de un proceso específico:

  1. En la pestaña "Historial", busca el filtro "Canal"

  2. Selecciona el canal que deseas revisar:

    • verifactu-invoice-hash-signature

    • verifactu-event-hash-signature

    • verifactu-event-check

    • verifactu-invoice-send

  3. Haz clic en "Filtrar" o "Buscar"

Información en los Logs

Los logs muestran información detallada sobre cada ejecución del proceso:

Ejemplo de Log: Hash y Firma de Facturas

Ejemplo de Log: Envío de Facturas

🔍 Interpretar los Logs

✅ Logs Correctos

Indicadores de funcionamiento correcto:

  • ✅ El proceso se ejecuta regularmente (cada pocos minutos)

  • ✅ Los registros se procesan correctamente

  • ✅ Los estados son "Aceptado" o "AceptadoConErrores"

  • ✅ No hay errores graves

Ejemplo de log correcto:

⚠️ Logs con Advertencias

Indicadores de advertencias:

  • ⚠️ Estado "AceptadoConErrores"

  • ⚠️ Mensajes de advertencia de la AEAT

  • ⚠️ Datos que no coinciden (por ejemplo, código postal y provincia)

Ejemplo de log con advertencia:

Qué hacer:

  1. Revisar el mensaje de advertencia en los logs

  2. Corregir los datos del cliente si es posible

  3. Enviar una subsanación si es necesario (ver guía de subsanación)

❌ Logs con Errores

Indicadores de errores:

  • ❌ Estado "Rechazado"

  • ❌ Mensajes de error de la AEAT

  • ❌ Excepciones o errores de conexión

  • ❌ El proceso no se ejecuta (no hay logs recientes)

Ejemplo de log con error:

Qué hacer:

  1. Revisar el mensaje de error en los logs

  2. Corregir el problema (por ejemplo, NIF inválido del cliente)

  3. Volver a enviar el registro desde la factura (pestaña VeriFactu)

  4. Si el problema persiste, contactar con soporte

❓ Solución de Problemas

Problema 1: Los registros quedan en estado "Pendiente"

Síntomas:

  • Los registros no se envían (quedan en estado "Pendiente" indefinidamente)

  • No aparecen logs recientes del proceso

Causas posibles:

  • Error en el proceso de hash y firma

  • Certificado digital no válido o caducado

  • Error de conexión con la AEAT

  • El procesamiento automático no está funcionando

Solución:

  1. Revisar los logs del canal verifactu-invoice-hash-signature:

    • Ir a Menú Administrador → Logs → Historial

    • Filtrar por canal: verifactu-invoice-hash-signature

    • Verificar que los registros se procesan correctamente

    • Verificar que se genera el hash y la firma

  2. Verificar el certificado digital:

    • Ir a Menú Administrador → Empresas → Abrir empresa → Sección VeriFactu

    • Verificar que el certificado es válido y no ha caducado

    • Verificar que la contraseña del certificado es correcta

  3. Revisar los logs del canal verifactu-invoice-send:

    • Filtrar por canal: verifactu-invoice-send

    • Verificar si hay errores de conexión con la AEAT

  4. Contactar con soporte si el problema persiste

Problema 2: Estado "AceptadoConErrores"

Síntomas:

  • Los registros se envían correctamente

  • Pero el estado es "AceptadoConErrores"

Causas posibles:

  • Datos del cliente incorrectos o incompletos

  • Advertencias de la AEAT (código postal, provincia, etc.)

Solución:

  1. Revisar los logs del canal verifactu-invoice-send:

    • Buscar el mensaje de advertencia de la AEAT

    • Identificar qué dato es incorrecto

  2. Corregir los datos del cliente:

    • Ir a Menú Ventas → Clientes

    • Buscar el cliente afectado

    • Corregir los datos incorrectos (código postal, provincia, etc.)

  3. Enviar una subsanación (si es necesario):

Problema 3: Estado "Rechazado"

Síntomas:

  • Los registros se envían

  • Pero el estado es "Rechazado"

Causas posibles:

  • Datos de la factura incorrectos (NIF inválido, etc.)

  • Errores graves en los datos

Solución:

  1. Revisar los logs del canal verifactu-invoice-send:

    • Buscar el mensaje de error de la AEAT

    • Identificar qué dato es incorrecto

  2. Corregir los datos de la factura:

    • Ir a la factura afectada

    • Corregir los datos incorrectos (NIF del cliente, etc.)

  3. Volver a enviar el registro:

    • Ir a la pestaña VeriFactu de la factura

    • Hacer clic en "Enviar alta" nuevamente

Problema 4: No aparecen logs recientes

Síntomas:

  • No hay logs recientes en el historial

  • Los registros no se procesan

Causas posibles:

  • El procesamiento automático no está funcionando correctamente

  • Problema técnico del sistema

Solución:

  1. Verificar el estado del sistema:

    • Ir a Menú Administrador → Logs → Historial

    • Verificar si hay logs de otros procesos (no solo VeriFactu)

  2. Contactar con soporte técnico:

    • Si no hay logs recientes de ningún proceso, puede haber un problema técnico

    • Contactar con el soporte de HolaGest para resolver el problema

📈 Verificar el Estado de los Registros

Desde el Informe VeriFactu

Ruta: Menú Informes → VeriFactu

Pestaña Facturas:

  • Ver todos los registros de facturas enviados

  • Filtrar por estado: Pendiente, Aceptado, AceptadoConErrores, Rechazado

  • Ver detalles de cada registro

Pestaña Eventos (solo modo NO-VeriFactu):

  • Ver todos los registros de eventos

  • Filtrar por tipo de evento

  • Ver detalles de cada evento

Desde la Factura

Ruta: Menú Ventas → Facturas → Abrir factura → Pestaña VeriFactu

Información visible:

  • Estado del registro: Pendiente, Aceptado, AceptadoConErrores, Rechazado

  • Fecha de envío: Cuándo se envió el registro

  • Hash del registro: Hash criptográfico generado

  • Firma digital: Firma del certificado

  • Código QR: Código QR de la factura

🎓 Mejores Prácticas

✅ Recomendaciones

  1. Revisar logs regularmente (al menos una vez por semana)

  2. Verificar el estado de los registros en el Informe VeriFactu

  3. Corregir errores rápidamente cuando aparezcan en los logs

  4. Mantener el certificado actualizado (renovar antes de caducar)

  5. Hacer copias de seguridad de la base de datos regularmente

❌ Errores a Evitar

  1. ❌ Ignorar los logs de errores

  2. ❌ No revisar el estado de los registros

  3. ❌ Dejar registros en estado "Rechazado" sin corregir

  4. ❌ No renovar el certificado digital a tiempo

📊 Resumen de Procesos Automáticos

Proceso
Frecuencia
Aplicable a

Hash y firma de facturas

Cada pocos min.

Todos los modos

Hash y firma de eventos

Cada pocos min.

Solo modo NO-VeriFactu

Creación de eventos

Cada 24 horas

Solo modo NO-VeriFactu

Envío de facturas

Cada pocos min.

Modo VeriFactu y Requerim.

📞 Contacto y Soporte

Si tienes problemas con el procesamiento automático:

  1. Revisar los logs en Menú Administrador → Logs → Historial

  2. Consultar esta guía para solucionar problemas comunes

  3. Contactar con soporte de HolaGest si el problema persiste

📝 Resumen Ejecutivo

El procesamiento automático de VeriFactu funciona sin intervención del usuario:

  • ✅ No requiere configuración por parte del usuario

  • ✅ Se ejecuta automáticamente en segundo plano

  • ✅ Procesa hash, firma y envío de registros

  • ✅ Puedes monitorear el funcionamiento mediante logs

  • ✅ Puedes verificar el estado de los registros en el Informe VeriFactu

Monitoreo recomendado:

  1. Revisar logs regularmente (Menú Administrador → Logs)

  2. Verificar estado de registros (Menú Informes → VeriFactu)

  3. Corregir errores cuando aparezcan

¡El procesamiento automático de VeriFactu trabaja para ti las 24 horas del día! ⚙️

AnteriorCómo crear y enviar un requerimientoSiguienteCómo descargar la declaración responsable

Última actualización