Todo lo que querrías saber antes de instalar.
Una mirada detallada a cómo funciona DfProforma Shopware — Presupuestos pro forma para Shopware 6.7 con aceptación del cliente y auto-conversión, por qué lo construimos así y la lógica detrás de las características anteriores.
El presupuesto pro forma: la pieza que falta del B2B en Shopware
Shopware 6.7 sabe emitir facturas, albaranes y abonos, pero no presupuestos pro forma. Y sin embargo, en prácticamente todos los contextos B2B — equipamiento industrial, servicios a empresas, compras públicas, ventas por licitación — el cliente debe recibir un documento formal que acepte antes de que el pedido se vuelva firme. DfProforma cubre esta carencia sin trucos: un verdadero tipo de documento Shopware nativo, su propio rango de numeración, una plantilla PDF con marca y un flujo de aceptación del cliente autónomo con URL pública segura.
Cómo funciona, paso a paso
Su comercial recibe un pedido, abre la ficha en la administración de Shopware, hace clic en Pro forma, genera el presupuesto. El módulo crea inmediatamente un documento Shopware df_proforma real con su número PF, su PDF Twig con marca, y lo registra en una entidad DAL dedicada. A continuación envía el presupuesto por email — plantilla transaccional personalizable, multilingüe, firmada con el nombre del comercial. El email contiene una URL pública cifrada. El cliente hace clic, llega a una página de aceptación autónoma (sin cuenta Shopware necesaria), ve el resumen del pedido y elige Aceptar este presupuesto o Rechazar con motivo. La firma queda registrada con marca de tiempo y persistida. Sus flujos Flow Builder se disparan automáticamente, su equipo es notificado, y todo queda rastreado para auditoría.
Flujo de estados completo y auditable
Seis estados de negocio cubren todo el ciclo de vida de un presupuesto: borrador (creado pero no enviado), enviado (a la espera de respuesta del cliente), aceptado (el cliente hizo clic en Aceptar), rechazado (el cliente hizo clic en Rechazar con motivo), caducado (validez de 30 días superada sin respuesta), convertido (pedido subyacente pagado). Cada transición se persiste con marca de tiempo al segundo, identificador del actor, tipo de disparador (comercial, cliente, sistema, pago), y payload JSON para metadatos libres. Puede reconstruir en cualquier momento el historial exacto de un presupuesto — útil en caso de disputa con cliente, auditoría interna o pregunta comercial.
URL pública de aceptación del cliente sin fricción
Esta es la aportación principal del módulo. Cada presupuesto enviado lleva una URL pública de la forma su-tienda.com/proforma/accept/{token_firmado}. El token está cifrado y firmado con HMAC-SHA256 usando la clave secreta de Shopware, lo que hace imposible la falsificación. El cliente abre la URL sin ninguna cuenta de Shopware (la página omite la autenticación estándar de cuenta de cliente), ve un resumen cuidado del pedido con líneas, precios y condiciones, y elige explícitamente Aceptar este presupuesto o Rechazar. En caso de rechazo, se solicita un campo Motivo obligatorio — útil para sus comerciales que pueden recontactar al cliente con una contraoferta. La firma queda registrada con marca de tiempo al milisegundo, y la dirección IP del cliente queda persistida como prueba.
Auto-conversión al pago, sin intervención humana
Una trampa clásica de los módulos de presupuestos pro forma: tras la aceptación y el pago del cliente, el estado del presupuesto queda congelado en aceptado hasta que un humano lo cambie manualmente a convertido. Resultado: su panel miente, sus informes son falsos, sus comerciales pasan tiempo actualizando estados en lugar de vender. DfProforma resuelve esto con un Subscriber en el evento order_transaction.state.paid de la máquina de estados de Shopware. En cuanto la transacción del pedido pasa a pagada, el módulo detecta que un presupuesto pro forma aceptado está vinculado a este pedido, y cambia automáticamente su estado a convertido, con el historial de transición correctamente marcado (tipo de disparador: pago). Sin clics, sin cron, sin intervención.
Compatible con Flow Builder: conecte sus flujos existentes
El módulo emite dos eventos Business Event estándar de Shopware: ProformaGeneratedEvent (en el momento de la generación) y ProformaAcceptedEvent (en el momento de la aceptación por el cliente). Ambos implementan BusinessEventInterface y son visibles automáticamente en el disparador de Flow Builder. Puede conectar así todos sus flujos existentes: notificación Slack al equipo de ventas cuando se acepta un presupuesto, email resumen interno, webhook a su CRM, actualización de campo personalizado en el cliente, etiqueta automática en el pedido. Sin intervención en el código del módulo — todo pasa por el admin de Shopware.
Módulo Vite admin con extensión de la ficha de pedido
La experiencia del comercial está integrada directamente en la administración nativa de Shopware. Una nueva pestaña Pro forma aparece en la ficha de pedido (extensión de sw-order-detail-base), con la lista de presupuestos vinculados a este pedido, su estado, fechas y número PF. Tres acciones principales por presupuesto: Generar (creación inicial), Enviar (envío del PDF por email con plantilla configurable), y acciones de transición manual (marcar como enviado, aceptar, rechazar) para los casos excepcionales en los que desee forzar un estado. El bundle JavaScript admin está en Vite (el módulo incluye su configuración vite.config.mjs); tras la instalación, ejecute bin/build-administration.sh para recompilar el bundle global de administración, y la pestaña aparece.
Plantilla PDF Twig totalmente personalizable
El PDF del presupuesto pro forma se renderiza mediante el motor Twig nativo de Shopware, a partir de la plantilla src/Resources/views/documents/proforma.html.twig incluida en el módulo. Puede sobreescribirla desde su tema o plugin personalizado siguiendo la jerarquía estándar de plantillas Twig de Shopware. La plantilla incluida lleva una cabecera con su logo y datos de empresa, un bloque cliente, el resumen de líneas del pedido, los totales HT y TTC con desglose de IVA, una banda de resumen al pie (número PF, fecha de emisión, fecha de caducidad), una marca de agua discreta y un acento de marca configurable. Conformidad con la identidad visual de su tienda sin escribir una línea de código.
Casos de uso típicos
Tienda B2B de equipamiento industrial: presupuesto pro forma obligatorio antes de la validación del pedido para pedidos por encima de un umbral, aceptación del cliente en línea, conversión automática al recibir la transferencia bancaria. Servicios a empresas: presupuesto enviado tras el brief del cliente, aceptación en línea con eventual motivo de rechazo para iterar, conversión al pago del anticipo. Compras públicas: documento formal exigido por el órgano contratante, historial de transiciones auditable para conformidad, firma con marca de tiempo e IP persistida. Tienda mayorista B2B de moda: presupuesto enviado a clientes revendedores, aceptación en línea sin que tengan que crear cuenta, conversión automática al pago. Marketplace vertical: presupuestos enviados bajo demanda para productos sin stock, validez de 30 días, caducidad automática para liberar el pipeline.
No hay valoraciones aún.