Zapytanie o Wycenę B2B (Wycena Ekspresowa), kompletny przewodnik
Instalacja, konfiguracja i obsługa zapytania o wycenę B2B (koszyk zamieniany w wycenę PDF jednym kliknięciem, bez zakładania konta) dla PrestaShop 8 i 9.
Wprowadzenie
Moduł Wycena Ekspresowa Wieloproduktowa B2B (dfexpressquote) dodaje w stopce koszyka przycisk zapytania o wycenę. Jednym kliknięciem Twój klient biznesowy zamienia swój koszyk w schludną wycenę PDF, którą otrzymuje e-mailem, bez zakładania konta. Kopia trafia do Twojego sklepu, a każda wycena jest śledzona w back office wraz ze statusami.
PDF jest generowany biblioteką TCPDF, wbudowaną już w PrestaShop: bez zewnętrznych bibliotek i bez zależności od Composera. Dokument nigdy nie jest przechowywany na serwerze, lecz odtwarzany na żądanie z migawki koszyka zapisanej w bazie.
Kompatybilność
- PrestaShop 8.0 do 9.x
- PHP 7.4 do 8.3
- Pojedynczy sklep i multistore
- 5 języków: FR, EN, ES, DE, IT
- Motyw Classic i motywy własne (okno modalne w natywnym JavaScripcie, niezależne od motywu)
- Bez zależności (ani Composer, ani framework)
Instalacja
- W back office otwórz Moduły > Menedżer modułów.
- Kliknij Wgraj moduł i wskaż plik
dfexpressquote.zip. - Po instalacji kliknij Konfiguruj.
Podczas instalacji moduł tworzy swoją tabelę wycen, rejestruje hooki (actionFrontControllerSetMedia, displayShoppingCartFooter, displayExpressCheckout), dodaje zakładkę Wyceny Ekspresowe w menu Zamówienia i ustawia wartości domyślne.
Konfiguracja
Wyświetlanie i przycisk
- Etykieta przycisku: tekst wyświetlany w stopce koszyka, do dostosowania.
- Pytaj o dane kontaktowe: włącza tryb formularza kontaktowego. Po wyłączeniu moduł przechodzi w tryb natychmiastowego jednego kliknięcia, w którym wycena PDF powstaje bez żadnego formularza.
Wycena
- Prefiks numeru: prefiks numerów wycen (domyślnie
DEV), po którym następuje data i licznik. - Okres ważności: liczba dni ważności wyceny, używana do wyliczenia daty ważności.
- Pokaż VAT: wyświetla kolumny i sumy VAT na PDF.
- Pokaż adres: dodaje na PDF blok z adresem odbiorcy.
- Adnotacje prawne dotyczące VAT i Warunki: dowolne teksty dodawane w stopce wyceny.
E-maile
- E-mail do klienta: automatycznie wysyła klientowi wycenę PDF w załączniku.
- E-mail do sklepu: wysyła powiadomienie do Twojego zespołu.
- Adres e-mail powiadomień: odbiorca wewnętrzny (domyślnie adres e-mail sklepu).
Działanie
Dwa tryby zapytania
W trybie formularza kliknięcie otwiera lekkie okno modalne, w którym klient podaje firmę, imię i nazwisko, adres e-mail oraz opcjonalnie telefon, numer VAT UE i wiadomość. W trybie natychmiastowego jednego kliknięcia wycena PDF powstaje od razu, bez formularza. W obu przypadkach zakładanie konta nie jest wymagane.
Wycena PDF
PDF przejmuje identyfikację Twojego sklepu: logo, dane kontaktowe, unikalny numer, datę wystawienia i datę ważności, blok odbiorcy, tabelę produktów (referencja, nazwa, ilość, cena jednostkowa netto, VAT, wartość netto) oraz sumy netto, VAT i brutto, a na końcu Twoje adnotacje i warunki. Dokument nigdy nie jest zapisywany na dysku: jest odtwarzany na żądanie z migawki koszyka zapisanej w bazie, co zapobiega gromadzeniu plików i gwarantuje zawsze spójny dokument.
Automatyczne e-maile
Zależnie od konfiguracji klient otrzymuje wycenę w załączniku, a Twój sklep dostaje powiadomienie na wskazany adres. Szablony e-maili są dostarczane po francusku i po angielsku.
Obsługa w back office
Zakładka Wyceny Ekspresowe zawiera listę wszystkich wycen z numerem, odbiorcą, kwotą brutto, statusem i datą. Otwierasz wycenę, aby zobaczyć szczegóły, zmieniasz jej status (nowa, wysłana, zaakceptowana, odrzucona, przekształcona) oraz w każdej chwili odtwarzasz lub pobierasz PDF.
Bezpieczeństwo
Pobieranie PDF jest chronione deterministycznym tokenem wyprowadzonym z klucza Twojego sklepu. Każde zapytanie jest zabezpieczone pułapką na roboty typu honeypot oraz tokenem powiązanym z bieżącym koszykiem i działa wyłącznie na koszyku bieżącej sesji.
FAQ i rozwiązywanie problemów
Czy klient musi założyć konto?
Nie. Zapytanie o wycenę działa w trybie gościa. Tryb natychmiastowego jednego kliknięcia generuje PDF nawet bez formularza.
Czy trzeba instalować bibliotekę PDF?
Nie. Wycena jest generowana biblioteką TCPDF, wbudowaną już w PrestaShop 8 i 9. Bez zależności od Composera.
Przycisk nie pojawia się na stronie koszyka
Wyczyść pamięć podręczną PrestaShop (Ustawienia zaawansowane > Wydajność), a na czas testów wyłącz łączenie i kompresję plików (CCC). Przycisk wyświetla się tylko wtedy, gdy koszyk zawiera co najmniej jedną pozycję. Jeśli Twój motyw nie wywołuje hooka displayShoppingCartFooter, przycisk jest wstawiany przy ładowaniu zasobów front.
Czy pliki PDF gromadzą się na serwerze?
Nie. Wycena nie jest przechowywana na dysku: jest odtwarzana na żądanie z migawki koszyka zapisanej w bazie.
Czy moduł jest kompatybilny z PrestaShop 9?
Tak. Moduł działa na PrestaShop 8 i 9, w multistore i w wielu językach.