HolaGest Docs

Español

English
中文

Español

English
中文

Apariencia

⚙️ El Procesamiento Automático de VeriFactu ​

🎯 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:

Registro 1: Hash1 = SHA-256(Datos Registro 1)
Registro 2: Hash2 = SHA-256(Datos Registro 2 + Hash1)
Registro 3: Hash3 = SHA-256(Datos Registro 3 + Hash2)

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 ​

[2026-03-15 10:30:15] verifactu-invoice-hash-signature
Iniciando proceso de hash y firma de registros de facturas...
Encontrados 5 registros pendientes de procesar.

Procesando registro 1 de 5: Factura 2026-001 (Alta)...
Hash generado: 3a5f8b2c4d5e6f7g8h9i0j1k2l3m4n5o
Firma generada: MIIGfQYJKoZIhvcNAQcCoIIGbjCCBmoCAQExDzANBglghkgBZQMEAgEFADALBgkqhkiG9w0BBwGgggQFMIIEATCCAumgAwIBAgIQfTjwJqBUdbGMdosx...
Registro procesado correctamente.

Procesando registro 2 de 5: Factura 2026-002 (Alta)...
Hash generado: 7d9e1a4f5b6c2g3h8i9j0k1l2m3n4o5p
Hash previo: 3a5f8b2c4d5e6f7g8h9i0j1k2l3m4n5o
Firma generada: MIIGfQYJKoZIhvcNAQcCoIIGbjCCBmoCAQExDzANBglghkgBZQMEAgEFADALBgkqhkiG9w0BBwGgggQFMIIEATCCAumgAwIBAgIQfTjwJqBUdbGMdosx...
Registro procesado correctamente.

...

Proceso completado. 5 registros procesados correctamente.

Ejemplo de Log: Envío de Facturas ​

[2026-03-15 10:30:20] verifactu-invoice-send
Iniciando proceso de envío de registros de facturas...
Verificando requerimientos pendientes...
No hay requerimientos pendientes.

Buscando registros de facturas pendientes de envío...
Encontrados 3 registros pendientes.

Enviando registro 1 de 3: Factura 2026-001 (Alta)...
Conectando con la AEAT...
Enviando datos...
Respuesta de la AEAT: Aceptado
Estado actualizado: Aceptado
Registro enviado correctamente.

Enviando registro 2 de 3: Factura 2026-002 (Alta)...
Conectando con la AEAT...
Enviando datos...
Respuesta de la AEAT: AceptadoConErrores
Advertencia: El código postal del cliente no coincide con la provincia
Estado actualizado: AceptadoConErrores
Registro enviado con advertencias.

Enviando registro 3 de 3: Factura 2026-003 (Alta)...
Conectando con la AEAT...
Enviando datos...
Respuesta de la AEAT: Rechazado
Error: El NIF del cliente no es válido
Estado actualizado: Rechazado
Registro rechazado.

Proceso completado. 3 registros procesados (1 aceptado, 1 con errores, 1 rechazado).

🔍 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:

[2026-03-15 10:30:20] verifactu-invoice-send
Proceso completado. 5 registros procesados (5 aceptados, 0 con errores, 0 rechazados).

⚠️ 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:

[2026-03-15 10:30:20] verifactu-invoice-send
Respuesta de la AEAT: AceptadoConErrores
Advertencia: El código postal del cliente no coincide con la provincia

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:

[2026-03-15 10:30:20] verifactu-invoice-send
Respuesta de la AEAT: Rechazado
Error: El NIF del cliente no es válido

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 ​

ProcesoFrecuenciaAplicable a
Hash y firma de facturasCada pocos min.Todos los modos
Hash y firma de eventosCada pocos min.Solo modo NO-VeriFactu
Creación de eventosCada 24 horasSolo modo NO-VeriFactu
Envío de facturasCada 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! ⚙️

Documentación liberada bajo Licencia MIT

Copyright © 2025 HolaGest