Alles wat u wilt weten voordat u installeert.
Een gedetailleerde blik op hoe DfProforma Shopware: Proforma Offertes voor Shopware 6.7 met Klantacceptatie en Automatische Omzetting werkt, waarom we het zo gebouwd hebben en de gedachte achter de bovenstaande functies.
De proforma offerte: het ontbrekende stuk voor B2B op Shopware
Shopware 6.7 kan facturen, pakbonnen en creditnota's uitgeven, maar geen proforma offertes. Nochtans moet de klant in vrijwel alle B2B-contexten (industrieel materieel, zakelijke dienstverlening, overheidsaankopen, verkoop via aanbesteding) een formeel stuk ontvangen dat hij accepteert voordat de bestelling vast wordt. DfProforma vult dat gat zonder geknutsel: een echt native Shopware-documenttype, een eigen nummerreeks, een gebrande PDF-template, en een zelfstandige acceptatieworkflow voor de klant met een beveiligde publieke URL.
Hoe het werkt, stap voor stap
Uw verkoper ontvangt een bestelling, opent de fiche in de Shopware-administratie, klikt op Proforma en genereert de offerte. De module maakt onmiddellijk een echt Shopware-document df_proforma aan met zijn PF-nummer en zijn gebrande Twig-PDF, en slaat dat op in een aparte DAL-entiteit. Vervolgens verstuurt hij de offerte per e-mail, met een aanpasbare meertalige transactionele template die op naam van de verkoper is ondertekend. De e-mail bevat een versleutelde publieke URL. De klant klikt, komt op een zelfstandige acceptatiepagina terecht (geen Shopware-account vereist), ziet de samenvatting van de bestelling, en kiest Deze offerte accepteren of Weigeren met een reden. De handtekening krijgt een tijdstempel en wordt bewaard. Uw Flow Builder workflows worden automatisch gestart, uw team wordt verwittigd, en alles wordt geregistreerd voor audit.
Volledige en auditeerbare statusworkflow
Zes bedrijfsstatussen dekken de volledige levenscyclus van een offerte: concept (aangemaakt maar niet verzonden), verzonden (in afwachting van een antwoord van de klant), geaccepteerd (de klant heeft op Accepteren geklikt), geweigerd (de klant heeft op Weigeren geklikt met een reden), vervallen (de geldigheid van 30 dagen is verstreken zonder antwoord) en omgezet (de onderliggende bestelling is betaald). Elke overgang wordt bewaard met de datum tot op de seconde, de identificatie van de actor, het triggertype (verkoper, klant, systeem, betaling) en een JSON-payload voor vrije metadata. U kunt op elk moment de exacte historiek van een offerte reconstrueren, wat nuttig is bij een klantgeschil, een interne audit of een commerciële vraag.
Publieke acceptatie-URL zonder wrijving
Dat is de belangrijkste bijdrage van de module. Elke verzonden offerte draagt een publieke URL in de vorm uw-webshop.com/proforma/accept/{ondertekend_token}. Het token is versleuteld en ondertekend met HMAC-SHA256 met de secret key van Shopware, wat vervalsing onmogelijk maakt. De klant opent de URL zonder enig Shopware-account (de pagina omzeilt de standaard authenticatie van het klantaccount), ziet een verzorgde samenvatting van de bestelling met regels, prijzen en voorwaarden, en kiest uitdrukkelijk Deze offerte accepteren of Weigeren. Bij een weigering wordt een verplicht veld Reden gevraagd, wat nuttig is voor uw verkopers die de klant daarna met een tegenvoorstel kunnen contacteren. De handtekening krijgt een tijdstempel tot op de milliseconde, en het IP-adres van de klant wordt bewaard als bewijs.
Automatische omzetting bij betaling, zonder menselijke tussenkomst
Een klassieke valkuil van modules voor proforma offertes: nadat de klant heeft geaccepteerd en betaald, blijft de status van de offerte op geaccepteerd staan zolang een mens die niet handmatig op omgezet zet. Het gevolg: uw dashboard liegt, uw rapporten kloppen niet, en uw verkopers besteden tijd aan het bijwerken van statussen in plaats van aan verkopen. DfProforma lost dat op met een Subscriber op de gebeurtenis order_transaction.state.paid van de Shopware state machine. Zodra de transactie van de bestelling op betaald komt te staan, detecteert de module dat er een geaccepteerde proforma offerte aan die bestelling hangt, en zet hij de status automatisch op omgezet, met de overgangshistoriek correct gemarkeerd (triggertype betaling). Geen klik, geen cron, geen tussenkomst.
Flow Builder ready: sluit uw bestaande workflows aan
De module stuurt twee standaard Shopware Business Events uit: ProformaGeneratedEvent (op het moment van de generatie) en ProformaAcceptedEvent (op het moment van de acceptatie door de klant). Beide implementeren BusinessEventInterface en zijn automatisch zichtbaar in de trigger van de Flow Builder. Zo kunt u er al uw bestaande workflows op aansluiten: een Slack-melding aan het verkoopteam wanneer een offerte wordt geaccepteerd, een interne samenvattingsmail, een webhook naar uw CRM, het bijwerken van een custom veld op de klant, een automatische tag op de bestelling. Er is geen enkele ingreep in de code van de module nodig, alles loopt via de Shopware-admin.
Vite adminmodule met uitbreiding van de besteldetailpagina
De ervaring voor de verkoper is rechtstreeks in de native Shopware-administratie geïntegreerd. Er verschijnt een nieuw tabblad Proforma op de besteldetailpagina (uitbreiding van sw-order-detail-base), met de lijst van de offertes die aan die bestelling hangen, hun status, hun data en hun PF-nummer. Drie hoofdacties per offerte: Genereren (initiële aanmaak), Verzenden (verzending van de PDF per e-mail met een instelbare template), en de handmatige overgangsacties (markeren als verzonden, accepteren, weigeren) voor de uitzonderlijke gevallen waarin u een status wilt forceren. De JavaScript-bundel van de admin draait op Vite (de module wordt geleverd met zijn configuratie vite.config.mjs); voer na de installatie bin/build-administration.sh uit om de globale administratiebundel te hercompileren, en het tabblad verschijnt.
Volledig aanpasbare Twig PDF-template
De PDF van de proforma offerte wordt gerenderd via de native Twig-engine van Shopware, op basis van de template src/Resources/views/documents/proforma.html.twig die in de module wordt meegeleverd. U kunt die overschrijven vanuit uw thema of uw eigen plugin volgens de standaard Twig-templatehiërarchie van Shopware. De meegeleverde template bevat een header met uw logo en uw bedrijfsgegevens, een klantblok, de samenvatting van de bestelregels, de totalen exclusief en inclusief btw met de btw-uitsplitsing, een samenvattingsbalk in de voettekst (PF-nummer, uitgiftedatum, vervaldatum), een discreet watermerk en een instelbaar merkaccent. Conform de huisstijl van uw webshop zonder één regel code te schrijven.
Typische toepassingen
B2B-webshop voor industrieel materieel: proforma offerte verplicht vóór de bevestiging van bestellingen boven een drempel, online acceptatie door de klant, automatische omzetting zodra de overschrijving binnen is. Zakelijke dienstverlening: offerte verstuurd na de klantbriefing, online acceptatie met eventuele weigeringsreden om te itereren, omzetting bij de betaling van het voorschot. Overheidsaankopen: formeel stuk dat de opdrachtgever eist, auditeerbare overgangshistoriek voor conformiteit, handtekening met tijdstempel en bewaard IP. B2B-groothandel in mode: offerte verstuurd naar wederverkopers, online acceptatie zonder dat zij een account moeten aanmaken, automatische omzetting bij betaling. Verticale marktplaats: offertes verstuurd op aanvraag voor producten die niet op voorraad zijn, geldigheid van 30 dagen, automatisch vervallen om de pijplijn vrij te maken.
There are no reviews yet.