# Zapytanie o Wycenę B2B (Wycena Ekspresowa), kompletny przewodnik
> 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,…
- Strona:
- Język: pl
- Zaktualizowano: 2026-07-31
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfexpressquote/index.md), [en](https://www.datafirefly.com/en/documentation/dfexpressquote/index.md), [es](https://www.datafirefly.com/es/documentation/dfexpressquote/index.md), [de](https://www.datafirefly.com/de/documentation/dfexpressquote/index.md), [it](https://www.datafirefly.com/it/documentation/dfexpressquote/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfexpressquote/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfexpressquote/index.md)
- Indeks:
## 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
1. W back office otwórz **Moduły > Menedżer modułów**.
2. Kliknij **Wgraj moduł** i wskaż plik `dfexpressquote.zip`.
3. 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.