Shopware Estensioni Shopware

DfProforma Shopware — Preventivi pro forma per Shopware 6.7 con accettazione cliente e conversione automatica

Emettete preventivi pro forma reali da Shopware 6.7, fateli accettare online dai vostri clienti tramite un URL pubblico sicuro, e convertiteli in ordini automaticamente al pagamento. Workflow di stati completo, eventi Flow Builder, PDF Twig personalizzabile, modulo Vite admin, multilingua FR EN DE ES.

Il preventivo pro forma nativo che Shopware non ha

Shopware 6.7 Tipo di documento personalizzato URL di accettazione pubblico Compatibile Flow Builder PDF Twig personalizzabile Auto-conversione al pagamento Modulo Vite admin Multilingua FR EN DE ES Workflow di stati
  • Rimborso 30 giorni
  • 12 mesi di aggiornamenti
  • Supporto 24h
www.datafirefly.com/it/
Proforma Module Shopware
v1.0.2 · aggiornato 2026-05-21
Cosa fa

L' versione breve.

01

Tipo di documento Shopware nativo df_proforma

Il modulo registra un vero tipo di documento Shopware (non un PDF parallelo), con il suo range di numerazione dedicato PF{n} e il suo template Twig brandizzato. Il preventivo pro forma appare naturalmente nell'elenco documenti dell'ordine, accanto a fatture, DDT e note di credito.

02

URL di accettazione pubblica firmata

Ogni preventivo inviato riceve un URL pubblico cifrato e firmato che il cliente apre senza un account Shopware. Pagina di accettazione curata con riepilogo ordine, bottone Accetta questo preventivo, bottone Rifiuta con campo motivo, validità configurabile di 30 giorni. La firma elettronica viene timestampata e persistita come prova.

03

Workflow di stati completo e verificabile

Sei stati di business: bozza, inviato, accettato, rifiutato, scaduto, convertito. Ogni transizione viene tracciata con data, trigger (commerciale, cliente, sistema, pagamento), metadati. Sapete esattamente dove si trova ogni preventivo e chi ha fatto cosa, al minuto.

04

Conversione automatica al pagamento

Quando l'ordine sottostante passa a pagato (transizione order_transaction.state.paid), il preventivo passa automaticamente allo stato convertito. I vostri commerciali non devono mai aggiornare lo stato manualmente dopo il pagamento, e la vostra dashboard rimane coerente senza intervento.

La versione lunga

Tutto quello che vorresti sapere prima di installare.

Uno sguardo dettagliato su come funziona DfProforma Shopware — Preventivi pro forma per Shopware 6.7 con accettazione cliente e conversione automatica, perché l'abbiamo progettato così, e il ragionamento dietro le funzionalità qui sopra.

§ 01

Il preventivo pro forma: il pezzo mancante del B2B su Shopware

Shopware 6.7 sa emettere fatture, DDT e note di credito, ma non preventivi pro forma. Eppure, in quasi tutti i contesti B2B — attrezzature industriali, servizi alle aziende, appalti pubblici, vendite per gara d'appalto — il cliente deve ricevere un documento formale che accetta prima che l'ordine diventi vincolante. DfProforma colma questa lacuna senza espedienti: un vero tipo di documento Shopware nativo, il suo range di numerazione, un template PDF brandizzato e un workflow di accettazione cliente autonomo con URL pubblica sicura.

§ 02

Come funziona, passo dopo passo

Il vostro commerciale riceve un ordine, apre la scheda nell'amministrazione Shopware, clicca su Pro forma, genera il preventivo. Il modulo crea immediatamente un vero documento Shopware df_proforma con il suo numero PF, il suo PDF Twig brandizzato, e lo registra in un'entità DAL dedicata. Invia quindi il preventivo via email — template transazionale personalizzabile, multilingua, firmato con il nome del commerciale. L'email contiene un URL pubblico cifrato. Il cliente clicca, arriva su una pagina di accettazione autonoma (nessun account Shopware necessario), vede il riepilogo dell'ordine, e sceglie Accetta questo preventivo o Rifiuta con motivo. La firma è timestampata e persistita. I vostri workflow Flow Builder vengono attivati automaticamente, il vostro team viene notificato, e tutto viene tracciato per audit.

§ 03

Workflow di stati completo e verificabile

Sei stati di business coprono l'intero ciclo di vita di un preventivo: bozza (creato ma non inviato), inviato (in attesa di risposta cliente), accettato (cliente ha cliccato Accetta), rifiutato (cliente ha cliccato Rifiuta con motivo), scaduto (validità di 30 giorni superata senza risposta), convertito (ordine sottostante pagato). Ogni transizione viene persistita con timestamp al secondo, identificatore dell'attore, tipo di trigger (commerciale, cliente, sistema, pagamento), e payload JSON per metadati liberi. Potete ricostruire in qualsiasi momento la cronologia esatta di un preventivo — utile in caso di disputa cliente, audit interno o questione commerciale.

§ 04

URL di accettazione pubblica cliente senza attriti

Questo è il contributo principale del modulo. Ogni preventivo inviato porta un URL pubblico della forma vostro-shop.com/proforma/accept/{token_firmato}. Il token è cifrato e firmato con HMAC-SHA256 usando la chiave segreta di Shopware, il che rende impossibile la falsificazione. Il cliente apre l'URL senza alcun account Shopware (la pagina bypassa l'autenticazione standard dell'account cliente), vede un riepilogo curato dell'ordine con righe, prezzi e condizioni, e sceglie esplicitamente Accetta questo preventivo o Rifiuta. In caso di rifiuto, viene richiesto un campo Motivo obbligatorio — utile per i vostri commerciali che possono poi ricontattare il cliente con una contro-proposta. La firma è timestampata al millisecondo, e l'indirizzo IP del cliente viene persistito come prova.

§ 05

Auto-conversione al pagamento, senza intervento umano

Una trappola classica dei moduli di preventivi pro forma: dopo che il cliente ha accettato e pagato, lo stato del preventivo rimane congelato su accettato finché un umano non lo passa manualmente a convertito. Risultato: la vostra dashboard mente, i vostri report sono falsi, i vostri commerciali passano tempo ad aggiornare stati invece di vendere. DfProforma risolve questo con un Subscriber sull'evento order_transaction.state.paid della macchina a stati di Shopware. Non appena la transazione dell'ordine passa a pagata, il modulo rileva che un preventivo pro forma accettato è collegato a questo ordine, e passa automaticamente il suo stato a convertito, con la cronologia di transizione correttamente marcata (tipo di trigger: pagamento). Nessun clic, nessun cron, nessun intervento.

§ 06

Compatibile con Flow Builder: collegate i vostri workflow esistenti

Il modulo emette due eventi Business Event standard di Shopware: ProformaGeneratedEvent (al momento della generazione) e ProformaAcceptedEvent (al momento dell'accettazione del cliente). Entrambi implementano BusinessEventInterface e sono automaticamente visibili nel trigger di Flow Builder. Potete così collegare tutti i vostri workflow esistenti: notifica Slack al team vendite quando un preventivo viene accettato, email riepilogo interno, webhook al vostro CRM, aggiornamento di campo personalizzato sul cliente, tag automatico sull'ordine. Nessun intervento nel codice del modulo necessario — tutto passa per l'admin Shopware.

§ 07

Modulo Vite admin con estensione della scheda ordine

L'esperienza commerciale è integrata direttamente nell'amministrazione nativa di Shopware. Un nuovo tab Pro forma appare sulla scheda ordine (estensione di sw-order-detail-base), con l'elenco dei preventivi collegati a questo ordine, il loro stato, le loro date e il loro numero PF. Tre azioni principali per preventivo: Genera (creazione iniziale), Invia (invio del PDF via email con template configurabile), e azioni di transizione manuale (segna come inviato, accetta, rifiuta) per i casi eccezionali in cui volete forzare uno stato. Il bundle JavaScript admin è in Vite (il modulo è fornito con la sua configurazione vite.config.mjs); dopo l'installazione, lanciate bin/build-administration.sh per ricompilare il bundle globale di amministrazione, e il tab appare.

§ 08

Template PDF Twig interamente personalizzabile

Il PDF del preventivo pro forma viene renderizzato tramite il motore Twig nativo di Shopware, a partire dal template src/Resources/views/documents/proforma.html.twig fornito nel modulo. Potete sovrascriverlo dal vostro tema o plugin personalizzato seguendo la gerarchia standard dei template Twig di Shopware. Il template fornito include un'intestazione con il vostro logo e i dati aziendali, un blocco cliente, il riepilogo delle righe ordine, i totali HT e TTC con scomposizione IVA, una banda di riepilogo in fondo (numero PF, data di emissione, data di scadenza), una filigrana discreta e un colore brand configurabile. Conformità all'identità visiva del vostro shop senza scrivere una riga di codice.

§ 09

Casi d'uso tipici

Shop B2B di attrezzature industriali: preventivo pro forma obbligatorio prima della validazione dell'ordine per ordini sopra una soglia, accettazione cliente online, conversione automatica al ricevimento del bonifico bancario. Servizi alle aziende: preventivo inviato dopo il brief cliente, accettazione online con eventuale motivo di rifiuto per iterare, conversione al pagamento dell'acconto. Appalti pubblici: documento formale richiesto dall'autorità appaltante, cronologia transizioni verificabile per conformità, firma timestampata e IP persistita. Shop mode B2B all'ingrosso: preventivo inviato a clienti rivenditori, accettazione online senza che debbano creare un account, conversione automatica al pagamento. Marketplace verticale: preventivi inviati su richiesta per prodotti non in stock, validità 30 giorni, scadenza automatica per liberare la pipeline.