AutoEnvioFacturas: envía tus facturas por email automáticamente, con Verifactu

Versión 1.0 · Compatible con FacturaScripts 2026+ · Compatible con el plugin Verifactu oficial v1.1

AutoEnvioFacturas añade a FacturaScripts algo que el flujo diario agradece: que cada factura que emites salga sola por email, con su PDF adjunto, sin depender de que alguien se acuerde de pulsar "enviar". Y lo hace respetando la ley antifraude: si el ejercicio está en modo Verifactu, la factura no se envía hasta que el QR está en el PDF.

Qué hace, en una frase

Cada minuto, el cron busca facturas de cliente ya emitidas (nunca bocetos), comprueba que se pueden enviar, genera el PDF con tu formato de impresión predeterminado y lo manda al destinatario correcto. Una factura, un email, sin duplicados.

Cómo funciona por dentro

En cada pasada, el plugin:

Selecciona las facturas emitidas que aún no se han enviado y cuya fecha sea igual o posterior a la fecha de inicio que hayas configurado.
Descarta las que estén anuladas y, si así lo indicas, las rectificativas.
Comprueba la puerta Verifactu (ver más abajo).
Busca el destinatario: primero el contacto de facturación de la factura; si no hay, el email del cliente. Si no hay ninguno, la deja marcada como "sin email" y la reintenta en cada pasada (en cuanto añadas el email, sale sola).
Espera el margen de gracia que hayas fijado.
Genera el PDF, envía el email con la notificación editable y marca la factura como enviada.

El envío es idempotente: se apoya en el mismo mecanismo interno que usa el botón de enviar manual de FacturaScripts, así que enviar a mano y enviar en automático nunca se pisan. Una factura no se envía dos veces.

La puerta Verifactu

Esta es la parte que hace especial al plugin. Según el modo del ejercicio:

Sin el plugin Verifactu, o ejercicio sin modo Verifactu: basta con que la factura esté emitida.
Modo verifactu: solo se envía cuando el alta está aceptada y la factura no está anulada — exactamente la misma condición con la que el plugin Verifactu pinta el QR en el PDF. Es decir, si el email sale, el PDF lleva QR.
Modo no-verifactu: espera al procesado local (la firma/hash) y entonces envía, con QR. Si una factura nunca va a llevar registro (estado sin "Enviar a Verifactu", empresa sin certificado…), se envía con normalidad sin QR, porque nunca iba a tenerlo.

Mientras una factura espera a Verifactu, la verás en el historial como esperando-verifactu. Si se queda ahí, revisa su pestaña Verifactu: certificado caducado, empresa sin configurar, estado emitido sin la opción "Enviar a Verifactu", o rechazo de la AEAT son las causas típicas.

Configuración

Todo se gestiona desde Administrador → Email, donde el plugin añade dos pestañas:

Envío de facturas por email, con los ajustes:
- Activado: interruptor general. Viene desactivado al instalar; nada sale hasta que lo enciendas.
- No enviar facturas anteriores a: fecha de corte. Al instalar se pone a hoy, para que el plugin no intente enviar de golpe todo tu histórico.
- Máx. emails por ejecución: cuántos envíos como mucho por pasada del cron (por defecto 25).
- Margen antes de enviar (minutos): pequeña espera desde que la factura queda lista hasta que sale (por defecto 1; pon 0 para envío inmediato). Útil por si necesitas rectificar algo recién emitido.
- Incluir rectificativas: si quieres que las facturas rectificativas también se envíen.
- Copia oculta (CCO): email opcional que recibe copia de cada envío.
Historial de envíos: el registro completo, solo lectura.

El texto del email es una notificación editable llamada autoenviofacturas-factura, que también encuentras en Administrador → Emails. Puedes cambiar asunto y cuerpo (HTML) usando los marcadores {name} (cliente), {code} (nº de factura), {date} (fecha), {total} (importe) y {company} (tu empresa).

El historial

Cada factura genera una fila con su estado, que evoluciona así:

esperando-verifactu → programado → enviado

…o bien error (si el envío falla; reintenta hasta 3 veces) o sin-email (si no hay destinatario; se reevalúa en cada pasada). Lo tienes tanto en la pestaña "Historial de envíos" como en el menú Administrador → "Envío auto de facturas".

Operaciones frecuentes

Reenviar una factura: vacía su campo femail y pon sus intentos a 0 (o borra su fila) en el historial.
Factura atascada en esperando-verifactu: revisa su pestaña Verifactu (certificado, empresa, estado, respuesta de la AEAT).
Agotó los 3 intentos con error: arregla el SMTP y resetea los intentos de su fila.
No envía nada: comprueba que el interruptor está activado, que el email de salida está bien configurado y que la fecha de corte no es posterior a tus facturas.
Ejecutar el cron a mano: la URL de tu instalación + /cron, o php index.php -cron.

Requisitos

FacturaScripts 2026 o superior
PHP 8.1 o superior
Cuenta de email de salida configurada en FacturaScripts
Cron del servidor configurado (el cron habitual de FacturaScripts), recomendado con una cadencia de un minuto.
Para el flujo con QR: el plugin Verifactu oficial (compatible con la v1.1)