Genera un plugin de facturas PDF automáticas para WooCommerce
Toda tienda acaba necesitando adjuntar factura al email de confirmación. Los plugins populares funcionan en casos genéricos pero imponen layout, nombres de campo y rutas donde guardar los archivos. Una tienda española necesita la numeración FA-YY-NNNNNN y la cláusula de inversión del sujeto pasivo UE. Una alemana necesita numeración secuencial por año natural. Una UK registrada en IVA necesita campos MTD. "Opinado" se convierte en "incorrecto" en cuanto cruzas una frontera.
Generar este plugin desde cero te da una plantilla igual a tu papel real. Usamos un motor PDF server-side (dompdf o mPDF), guardamos las facturas con cache headers y descarga por URL firmada, y te dejamos editar la plantilla cuando el contable decida el año que viene que el logo debe ser 2mm más pequeño.
¿Por qué generarlo en vez de instalar un plugin existente?
WooCommerce PDF Invoices & Packing Slips (de WP Overnight) es la opción gratuita más conocida. Para una tienda UE estándar es adecuado. Empiezas a chocar con los límites cuando necesitas facturas bilingües, numeración por serie (tienda vs servicios), QR para Verifactu o guardar facturas fuera de /uploads.
Los addons pro suman rápido — el bundle Pro ronda 109€/año, con addons por feature para cosas como subida a Dropbox. Para una tienda con 500 facturas al mes, un plugin que cumpla tus requisitos fiscales y guarde en tu DO Spaces / S3 es una generación puntual en lugar de una factura recurrente.
El coste escondido mayor de los plugins genéricos es el crecimiento del almacenamiento PDF. Las facturas se acumulan en /wp-content/uploads/ indefinidamente y nadie limpia. Un plugin generado puede integrar DO Spaces / S3 desde el día 1, manteniendo tu servidor ligero.
Prompt de ejemplo
Este es el tipo de descripción que genera este plugin. Puedes partir de aquí y ajustar lo que necesites antes de generar.
Nombre del plugin: Acme WC Facturas (SII-ready)
Trigger de generación: woocommerce_order_status_completed.
Formato de número: FA-2-YY-NNNNNN, atómico vía tabla de secuencia.
Layout (A4 vertical):
- Cabecera: logo, razón social + CIF + domicilio.
- Bloque cliente: nombre, CIF/NIE, dirección fiscal.
- Tabla de líneas: SKU, nombre, cantidad, precio neto, IVA, total línea.
- Bloque totales: base imponible, IVA por tipo, total.
- Pie: cláusula legal (editable en ajustes), número secuencial, página x de y.
PDF adjuntado al email de confirmación automáticamente.
Almacenamiento: /wp-content/uploads/acme-invoices/YYYY/MM/<code>.pdf Y sync opcional a DO Spaces con ajuste para key + secret + bucket.
Admin: listado con estado, re-descarga, re-generar (mantiene el número).
Pestaña en Mi cuenta "Facturas" con enlace firmado válido 1 hora.
Compatible HPOS. Desinstalar deja los PDFs pero elimina la secuencia y opciones.Qué suele incluir el plugin generado
- dompdf o mPDF empaquetado en vendor/ con autoloader
- Asignación atómica de número de factura vía tabla con row locking
- Plantilla HTML en /templates/invoice.php, sobreescribible por el tema
- Hook a woocommerce_email_attachments para adjuntar en el email correcto
- Listado admin con re-descarga en bloque
- Ajustes: datos del emisor, reglas IVA, formato de numeración, destino de almacenamiento
- Lectura de pedidos HPOS-compatible
Añade QR Verifactu, numeración por idioma, facturas de abono rectificativas, IVA OSS intracomunitario — describe el requisito del contable y el plugin lo refleja.
Preguntas frecuentes
¿Soporta Verifactu?
El plugin puede generar el QR y la firma hasheada si describes el requisito. Verifactu evoluciona rápido — menciona la versión AEAT objetivo y escribimos el algoritmo exacto.
¿Dónde se guardan los PDFs?
Por defecto en /uploads/ por año/mes. Puedes apuntar a un bucket DO Spaces / S3 con descarga firmada. Bueno para tiendas de cientos al día.
¿Puedo editar el layout después?
Sí. La plantilla es PHP + HTML. Cambiar logo, añadir un campo, mover totales lleva un minuto. Un botón "regenerar" en admin vuelve a hacer el PDF manteniendo el número.
¿Gestiona reembolsos?
Al reembolsar, crea factura rectificativa (serie FR-YY-NNNNNN) referenciando la original. Describe tus requisitos fiscales y se implementa correcto a la primera.