Wszystko, co warto wiedzieć, zanim zainstalujesz.
Szczegółowe spojrzenie na to, jak działa DfProforma Shopware: Oferty Proforma z Akceptacją Klienta i Automatyczną Konwersją, dlaczego zbudowaliśmy go w ten sposób i jaka myśl stoi za powyższymi funkcjami.
Oferta proforma: brakujący element B2B w Shopware
Shopware 6.7 potrafi wystawiać faktury, dokumenty dostawy i korekty, ale nie oferty proforma. Tymczasem w niemal każdym kontekście B2B, czyli przy sprzęcie przemysłowym, usługach dla firm, zamówieniach publicznych i sprzedaży przetargowej, klient musi otrzymać formalny dokument, który akceptuje, zanim zamówienie stanie się wiążące. DfProforma wypełnia tę lukę bez prowizorki: prawdziwy natywny typ dokumentu Shopware, własny zakres numeracji, szablon PDF w Twojej identyfikacji wizualnej i samodzielny przepływ akceptacji przez klienta, z bezpiecznym adresem publicznym.
Jak to działa, krok po kroku
Twój handlowiec otrzymuje zamówienie, otwiera jego kartę w administracji Shopware, klika Proforma i generuje ofertę. Moduł natychmiast tworzy prawdziwy dokument Shopware df_proforma z numerem PF i szablonem PDF w Twigu, po czym zapisuje go w dedykowanej encji DAL. Następnie wysyła ofertę mailem, z konfigurowalnego, wielojęzycznego szablonu transakcyjnego podpisanego nazwiskiem handlowca. E-mail zawiera szyfrowany adres publiczny. Klient klika, trafia na samodzielną stronę akceptacji (bez żadnego konta Shopware), widzi podsumowanie zamówienia i wybiera Akceptuj ofertę albo Odrzuć z podaniem powodu. Podpis dostaje znacznik czasu i zostaje zapisany. Twoje przepływy Flow Buildera uruchamiają się automatycznie, zespół dostaje powiadomienie, a wszystko jest odnotowane na potrzeby audytu.
Kompletny i audytowalny przepływ statusów
Sześć statusów biznesowych pokrywa cały cykl życia oferty: robocza (utworzona, ale niewysłana), wysłana (czeka na odpowiedź klienta), zaakceptowana (klient kliknął Akceptuj), odrzucona (klient kliknął Odrzuć i podał powód), wygasła (minęło 30 dni ważności bez odpowiedzi) i przekształcona (powiązane zamówienie zostało opłacone). Każde przejście jest zapisywane z datą co do sekundy, identyfikatorem aktora, typem wyzwalacza (handlowiec, klient, system, płatność) i ładunkiem JSON na dowolne metadane. W każdej chwili odtworzysz dokładną historię oferty, co przydaje się przy sporze z klientem, audycie wewnętrznym albo pytaniu handlowym.
Publiczny adres akceptacji bez tarcia
To główny wkład tego modułu. Każda wysłana oferta ma publiczny adres w postaci twoj-sklep.pl/proforma/accept/{podpisany_token}. Token jest szyfrowany i podpisywany HMAC-SHA256 kluczem sekretnym Shopware, co uniemożliwia jego podrobienie. Klient otwiera adres bez żadnego konta Shopware (strona omija standardowe uwierzytelnianie konta klienta), widzi dopracowane podsumowanie zamówienia z pozycjami, cenami i warunkami, po czym świadomie wybiera Akceptuj ofertę albo Odrzuć. Przy odmowie wymagane jest pole Powód, co pomaga handlowcom wrócić do klienta z kontrpropozycją. Podpis dostaje znacznik czasu co do milisekundy, a adres IP klienta jest zapisywany jako dowód.
Automatyczna konwersja po zapłacie, bez udziału człowieka
Klasyczna pułapka modułów ofertowych: po tym, jak klient zaakceptował i zapłacił, status oferty tkwi na zaakceptowana, dopóki ktoś ręcznie nie przestawi go na przekształcona. Efekt: Twój panel kłamie, raporty są błędne, a handlowcy tracą czas na aktualizowanie statusów zamiast sprzedawać. DfProforma rozwiązuje to subscriberem na zdarzeniu order_transaction.state.paid z maszyny stanów Shopware. Gdy tylko transakcja zamówienia przechodzi w stan zapłacona, moduł wykrywa powiązaną zaakceptowaną ofertę proforma i automatycznie przełącza jej status na przekształcona, z poprawnie oznaczoną historią przejścia (typ wyzwalacza: płatność). Żadnego kliknięcia, żadnego CRON-a, żadnej interwencji.
Gotowe pod Flow Builder: podepnij istniejące przepływy
Moduł emituje dwa standardowe zdarzenia Business Event Shopware: ProformaGeneratedEvent (w chwili wygenerowania) i ProformaAcceptedEvent (w chwili akceptacji przez klienta). Oba implementują BusinessEventInterface i automatycznie pojawiają się w wyzwalaczu Flow Buildera. Podepniesz pod nie wszystkie swoje istniejące przepływy: powiadomienie na Slacku do zespołu sprzedaży przy akceptacji oferty, wewnętrzne podsumowanie mailem, webhook do CRM-u, aktualizację pola własnego klienta, automatyczny tag na zamówieniu. Bez żadnej ingerencji w kod modułu, wszystko z poziomu administracji Shopware.
Moduł administracji w Vite z rozszerzeniem karty zamówienia
Doświadczenie handlowca jest wbudowane wprost w natywną administrację Shopware. Na karcie zamówienia pojawia się nowa zakładka Proforma (rozszerzenie sw-order-detail-base) z listą ofert powiązanych z tym zamówieniem, ich statusami, datami i numerem PF. Trzy główne akcje przy każdej ofercie: Generuj (utworzenie), Wyślij (wysyłka PDF mailem z konfigurowalnego szablonu) oraz akcje ręcznego przejścia (oznacz jako wysłaną, zaakceptuj, odrzuć) na wyjątkowe sytuacje, gdy chcesz wymusić status. Bundle JavaScript administracji jest w Vite (moduł dostarcza własny vite.config.mjs). Po instalacji uruchom bin/build-administration.sh, żeby zrekompilować globalny bundle administracji, i zakładka się pojawi.
W pełni konfigurowalny szablon PDF w Twigu
PDF oferty proforma powstaje w natywnym silniku Twig w Shopware, na podstawie szablonu src/Resources/views/documents/proforma.html.twig dostarczonego w module. Nadpiszesz go ze swojego motywu albo własnej wtyczki, zgodnie ze standardową hierarchią szablonów Twig w Shopware. Dostarczony szablon zawiera nagłówek z Twoim logo i danymi firmy, blok klienta, podsumowanie pozycji zamówienia, sumy netto i brutto z rozbiciem VAT, pasek podsumowania w stopce (numer PF, data wystawienia, data ważności), dyskretny znak wodny i konfigurowalny akcent marki. Zgodność z identyfikacją wizualną sklepu bez pisania ani jednej linii kodu.
Typowe zastosowania
Sklep B2B ze sprzętem przemysłowym: oferta proforma obowiązkowa przed zatwierdzeniem zamówienia powyżej progu, akceptacja online, automatyczna konwersja po wpływie przelewu. Usługi dla firm: oferta wysyłana po briefie klienta, akceptacja online z ewentualnym powodem odmowy do dalszych iteracji, konwersja po zapłacie zaliczki. Zamówienia publiczne: formalny dokument wymagany przez zamawiającego, audytowalna historia przejść na potrzeby zgodności, podpis ze znacznikiem czasu i zapisanym adresem IP. Hurtownia odzieżowa B2B: oferta wysyłana do klientów detalicznych, akceptacja online bez zakładania konta, automatyczna konwersja po zapłacie. Wertykalny marketplace: oferty wysyłane na życzenie przy produkcie spoza magazynu, ważność 30 dni, automatyczne wygasanie oczyszczające lejek.
Na razie nie ma opinii o produkcie.