Alles, was Sie wissen sollten bevor Sie installieren.
Ein detaillierter Blick darauf, wie DfProforma Shopware — Pro-forma-Angebote für Shopware 6.7 mit Kundenakzeptanz und automatischer Konvertierung funktioniert, warum wir es so gebaut haben und der Gedanke hinter den Funktionen oben.
Pro-forma-Angebote: das fehlende Puzzleteil für B2B auf Shopware
Shopware 6.7 weiß, wie man Rechnungen, Lieferscheine und Gutschriften ausstellt, aber keine Pro-forma-Angebote. Dabei muss der Kunde in nahezu allen B2B-Kontexten — Industrieausrüstung, Geschäftsdienstleistungen, öffentliche Beschaffung, Ausschreibungsverkäufe — ein formelles Dokument erhalten, das er akzeptiert, bevor die Bestellung verbindlich wird. DfProforma schließt diese Lücke ohne Workarounds: ein echter nativer Shopware-Dokumenttyp, ein eigener Nummernkreis, eine markenkonforme PDF-Vorlage und ein eigenständiger Kundenakzeptanz-Workflow mit sicherer öffentlicher URL.
Wie es funktioniert, Schritt für Schritt
Ihr Verkäufer erhält eine Bestellung, öffnet die Detailseite in der Shopware-Administration, klickt auf Pro forma und generiert das Angebot. Das Modul erstellt sofort ein echtes Shopware-Dokument df_proforma mit seiner PF-Nummer und seinem markenkonformen Twig-PDF und legt es in einer dedizierten DAL-Entity ab. Es versendet das Angebot anschließend per E-Mail — anpassbare transaktionale Vorlage, mehrsprachig, mit dem Namen des Verkäufers unterzeichnet. Die E-Mail enthält eine verschlüsselte öffentliche URL. Der Kunde klickt, landet auf einer eigenständigen Akzeptanzseite (kein Shopware-Konto erforderlich), sieht die Bestellzusammenfassung und wählt Dieses Angebot annehmen oder Ablehnen mit Grund. Die Signatur wird zeitgestempelt und persistiert. Ihre Flow-Builder-Workflows werden automatisch ausgelöst, Ihr Team benachrichtigt, und alles wird für die Auditierung protokolliert.
Vollständiger und auditierbarer Status-Workflow
Sechs Geschäftsstatus decken den gesamten Lebenszyklus eines Angebots ab: Entwurf (erstellt, aber nicht versendet), gesendet (Kundenantwort wird erwartet), akzeptiert (Kunde hat auf Annehmen geklickt), abgelehnt (Kunde hat auf Ablehnen mit Grund geklickt), abgelaufen (30 Tage Gültigkeit ohne Antwort überschritten), konvertiert (zugrunde liegende Bestellung bezahlt). Jeder Übergang wird mit Zeitstempel auf die Sekunde genau, Akteur-Kennung, Auslöser-Typ (Verkäufer, Kunde, System, Zahlung) und JSON-Payload für freie Metadaten persistiert. Sie können jederzeit den genauen Verlauf eines Angebots rekonstruieren — nützlich bei Kundenstreitigkeiten, internen Audits oder kommerziellen Fragen.
Reibungslose öffentliche Kunden-Akzeptanz-URL
Dies ist der Hauptbeitrag des Moduls. Jedes versendete Angebot trägt eine öffentliche URL der Form ihr-shop.com/proforma/accept/{signiertes_token}. Das Token ist mit HMAC-SHA256 unter Verwendung des Shopware-Geheimschlüssels verschlüsselt und signiert, was Fälschung unmöglich macht. Der Kunde öffnet die URL ohne jegliches Shopware-Konto (die Seite umgeht die Standard-Kundenkonto-Authentifizierung), sieht eine sorgfältige Bestellzusammenfassung mit Zeilen, Preisen und Bedingungen und wählt ausdrücklich Dieses Angebot annehmen oder Ablehnen. Bei einer Ablehnung wird ein Pflichtfeld Grund verlangt — nützlich für Ihre Verkäufer, die den Kunden dann mit einem Gegenangebot kontaktieren können. Die Signatur wird auf die Millisekunde genau zeitgestempelt, und die IP-Adresse des Kunden wird als Beweis persistiert.
Auto-Konvertierung bei Zahlung, ohne menschliches Eingreifen
Eine klassische Falle von Pro-forma-Angebotsmodulen: Nachdem der Kunde akzeptiert und bezahlt hat, bleibt der Angebotsstatus eingefroren auf akzeptiert, bis ein Mensch ihn manuell auf konvertiert ändert. Ergebnis: Ihr Dashboard lügt, Ihre Berichte sind falsch, Ihre Verkäufer verbringen Zeit damit, Status zu aktualisieren, anstatt zu verkaufen. DfProforma löst das mit einem Subscriber auf das Event order_transaction.state.paid der Shopware-Statemachine. Sobald die Transaktion der Bestellung in den Status bezahlt wechselt, erkennt das Modul, dass ein akzeptiertes Pro-forma-Angebot mit dieser Bestellung verknüpft ist, und schaltet seinen Status automatisch auf konvertiert um, mit korrekt markiertem Übergangsverlauf (Auslöser-Typ: Zahlung). Keine Klicks, kein Cron, kein Eingriff.
Flow Builder ready: Hängen Sie Ihre bestehenden Workflows an
Das Modul emittiert zwei Standard-Shopware-Business-Events: ProformaGeneratedEvent (zum Zeitpunkt der Generierung) und ProformaAcceptedEvent (zum Zeitpunkt der Kundenakzeptanz). Beide implementieren BusinessEventInterface und sind automatisch in der Trigger-Liste des Flow Builders sichtbar. Sie können so alle Ihre bestehenden Workflows daran hängen: Slack-Benachrichtigung an das Vertriebsteam, wenn ein Angebot akzeptiert wird, interne Zusammenfassungsmail, Webhook an Ihr CRM, Custom-Field-Update am Kunden, automatischer Tag an der Bestellung. Kein Eingriff in den Modulcode erforderlich — alles läuft über das Shopware-Admin.
Vite-Admin-Modul erweitert die Bestelldetailseite
Die Verkäufer-Erfahrung ist direkt in die native Shopware-Administration integriert. Ein neuer Pro-forma-Tab erscheint auf der Bestelldetailseite (Erweiterung von sw-order-detail-base), mit der Liste der dieser Bestellung zugeordneten Angebote, ihrem Status, ihren Daten und ihrer PF-Nummer. Drei Hauptaktionen pro Angebot: Generieren (erste Erstellung), Senden (PDF-Versand per E-Mail mit konfigurierbarer Vorlage) und manuelle Übergangsaktionen (als gesendet markieren, akzeptieren, ablehnen) für die Ausnahmefälle, in denen Sie einen Status erzwingen möchten. Das Admin-JavaScript-Bundle ist in Vite (das Modul wird mit seiner vite.config.mjs-Konfiguration geliefert); nach der Installation führen Sie bin/build-administration.sh aus, um das globale Administrations-Bundle neu zu kompilieren, und der Tab erscheint.
Vollständig anpassbare Twig-PDF-Vorlage
Das PDF des Pro-forma-Angebots wird über die native Twig-Engine von Shopware aus der Vorlage src/Resources/views/documents/proforma.html.twig gerendert, die mit dem Modul mitgeliefert wird. Sie können sie über Ihr Theme oder Ihr Custom-Plugin gemäß der Shopware-Standard-Twig-Vorlagenhierarchie überschreiben. Die mitgelieferte Vorlage enthält eine Kopfzeile mit Ihrem Logo und Unternehmensangaben, einen Kundenblock, die Bestellzeilenzusammenfassung, HT- und TTC-Summen mit MwSt.-Aufschlüsselung, einen Zusammenfassungsstreifen am Fuß (PF-Nummer, Ausstellungsdatum, Ablaufdatum), ein dezentes Wasserzeichen und eine konfigurierbare Markenfarbe. Konformität mit dem visuellen Erscheinungsbild Ihres Shops, ohne eine Zeile Code zu schreiben.
Typische Anwendungsfälle
B2B-Shop für Industrieausrüstung: Pro-forma-Angebot vor Bestellbestätigung für Bestellungen über einer Schwelle zwingend erforderlich, Online-Kundenakzeptanz, automatische Konvertierung bei eingegangener Banküberweisung. Geschäftsdienstleistungen: Angebot nach Kundenbriefing versendet, Online-Akzeptanz mit möglichem Ablehnungsgrund zum Iterieren, Konvertierung bei Anzahlung. Öffentliche Beschaffung: formelles Dokument vom Auftraggeber gefordert, auditierbarer Übergangsverlauf für Compliance, zeitgestempelte Signatur und persistierte IP. B2B-Großhandel für Mode: Angebot an Wiederverkäufer-Kunden versendet, Online-Akzeptanz, ohne ein Konto erstellen zu müssen, automatische Konvertierung bei Zahlung. Vertikaler Marktplatz: Angebote auf Anfrage für nicht vorrätige Produkte versendet, 30 Tage Gültigkeit, automatischer Ablauf zur Pipeline-Bereinigung.
Es gibt noch keine Rezensionen.