# Zapytanie o Wycenę B2B: kompletny przewodnik

> Prezentacja Moduł Zapytanie o Wycenę B2B (dfb2bquote) dodaje prawdziwy obieg sprzedaży na wyceny do Twojego sklepu PrestaShop. Przycisk „Wycena" zastępuje lub uzupełnia dodanie do koszyka: Twoi klienci biznesowi budują zapytanie…

- Strona: <https://www.datafirefly.com/pl/documentation/dfb2bquote/>
- Język: pl
- Zaktualizowano: 2026-08-01
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfb2bquote/index.md), [en](https://www.datafirefly.com/en/documentation/dfb2bquote/index.md), [es](https://www.datafirefly.com/es/documentation/dfb2bquote/index.md), [de](https://www.datafirefly.com/de/documentation/dfb2bquote/index.md), [it](https://www.datafirefly.com/it/documentation/dfb2bquote/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfb2bquote/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfb2bquote/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## Prezentacja

Moduł **Zapytanie o Wycenę B2B** (`dfb2bquote`) dodaje prawdziwy obieg sprzedaży na wyceny do Twojego sklepu PrestaShop. Przycisk **„Wycena"** zastępuje lub uzupełnia dodanie do koszyka: Twoi klienci biznesowi budują zapytanie w **dedykowanym koszyku wycen**, wysyłają je, a Ty przejmujesz kontrolę w zapleczu, aby **negocjować ceny linia po linii**, zastosować rabat, ustalić ważność i wygenerować **PDF** w stylu Twojego sklepu. Po akceptacji wyceny przez klienta jedno kliknięcie **przekształca ją w rzeczywiste zamówienie** z utrwalonymi cenami negocjowanymi.

Zaprojektowany dla B2B i sprzedaży na zamówienie: hurtownicy, zaopatrzenie firm, duże wolumeny, produkty konfigurowalne. Klasyczna ścieżka zakupowa Twoich klientów indywidualnych pozostaje nienaruszona: przycisk Wycena może zastąpić zakup lub po prostu pojawić się obok niego.

## Zgodność

- PrestaShop 8.0 do 9.x
- PHP 7.4 do 8.3
- Pojedynczy sklep i multisklep
- Wielojęzyczność (przetłumaczone statusy, e-maile dostarczone w FR i EN)
- Motyw Classic i motywy niestandardowe (przycisk jest wstrzykiwany nawet jeśli motyw nie wywołuje hooka)
- Brak zależności (ani Composer, ani framework)

## Instalacja

1. W zapleczu otwórz **Moduły > Menedżer modułów**.
2. Kliknij **Zainstaluj moduł** i wybierz plik `dfb2bquote.zip`.
3. Po instalacji kliknij **Konfiguruj**.

Podczas instalacji moduł tworzy swoje tabele (wyceny, linie, statusy, koszyk wycen, historia), inicjalizuje **siedem statusów** domyślnych, rejestruje swoje hooki (karta produktu, nagłówek, panel klienta, logowanie) i dodaje zakładkę **Wyceny** pod pozycją _Zamówienia_ w menu administracyjnym. W panelu klienta pojawia się link **Moje wyceny**.

## Konfiguracja

### Przycisk i wyświetlanie

- **Aktywuj moduł**: włącza lub wyłącza cały obieg wycen po stronie front.
- **Tryb przycisku**: _Zastąpienie_ (przycisk Wycena zajmuje miejsce dodania do koszyka, dla sklepu w 100% na wyceny) lub _Uzupełnienie_ (przycisk pojawia się obok klasycznego zakupu, aby obsługiwać jednocześnie B2C i B2B).
- **Etykieta przycisku**: tekst wyświetlany na przycisku („Wycena", „Zapytaj o cenę"…).
- **Ukryj ceny**: ukrywa ceny katalogowe po stronie front, dla logiki w pełni opartej na wycenach.
- **Grupy klientów**: pozostaw puste, aby wyświetlać przycisk wszystkim, lub wybierz grupy (na przykład grupy biznesowe), aby zarezerwować go dla B2B.

### Zapytanie i reguły

- **Zezwól gościom**: pozwala niezalogowanemu odwiedzającemu złożyć zapytanie z podaniem danych kontaktowych (nazwisko, e-mail, firma, telefon). Wyłącz, aby akceptować tylko zalogowanych klientów.
- **Minimalna kwota**: próg netto wymagany do wysłania zapytania.
- **Ważność (dni)**: domyślny okres ważności stosowany do wycen.
- **Pokaż link „Moje wyceny"**: wyświetla wskaźnik wycen i link dostępu w nagłówku.

### Konwersja i dokumenty

- **E-mail administratora**: adres otrzymujący powiadomienie przy każdym nowym zapytaniu.
- **Status zamówienia przy konwersji**: status stosowany do zamówienia wygenerowanego przy konwersji zaakceptowanej wyceny.
- **Warunki (regulamin)**: tekst wyświetlany na dole PDF wyceny.

## Użytkowanie, strona klienta

### Zapytanie o wycenę

Na karcie produktu i listingach klient klika przycisk **Wycena**. Produkt (wraz z wariantem) jest dodawany do jego **koszyka wycen**, niezależnego od koszyka zakupowego. Wskaźnik „Moja wycena" aktualizuje się w nagłówku.

### Koszyk wycen

Na stronie koszyka wycen klient dostosowuje ilości, usuwa linie, dodaje wiadomość, a następnie wysyła zapytanie. Jeśli nie jest zalogowany i tryb gościa jest dozwolony, podaje swoje dane kontaktowe. Po wysłaniu wycena jest tworzona ze statusem **Nowe zapytanie**, a powiadomienie trafia do Twojego zespołu.

Koszyk wycen jest powiązany z sesją odwiedzającego i **utrzymuje się między stronami**. Przy logowaniu koszyk zbudowany jako gość jest automatycznie **przenoszony** na konto klienta.

### Panel „Moje wyceny"

Z poziomu swojego konta klient znajduje listę swoich wycen wraz ze statusem. W szczegółach wyceny przegląda linie i sumy, **pobiera PDF**, a gdy wycena została mu wysłana, może ją **zaakceptować** lub **odrzucić**. Gość uzyskuje dostęp do swojej wyceny przez link zabezpieczony unikalnym kluczem.

## Użytkowanie, zaplecze

### Lista wycen

Zakładka **Wyceny** (pod pozycją _Zamówienia_) wyświetla wszystkie zapytania z referencją, klientem, kolorową odznaką statusu, sumą netto i datą. Kliknięcie otwiera ekran zarządzania.

### Negocjacja wyceny

Na ekranie szczegółów, dla każdej linii, przypominana jest **cena katalogowa**, a Ty wpisujesz **cenę negocjowaną netto**. Możesz również:

- zastosować **rabat globalny** w kwocie netto lub w procentach;
- dodać **orientacyjne koszty dostawy**;
- wpisać **wiadomość przeznaczoną dla klienta**;
- ustalić lub dostosować **datę ważności**.

### Status i powiadomienie

Zmieniasz **status** wyceny, a zaznaczając **Powiadom klienta**, wyzwalasz wysłanie e-maila. Ustaw wycenę na **Wycena wysłana**, aby klient mógł ją zaakceptować ze swojego panelu. Cała historia statusów jest zachowywana ze znacznikiem czasu.

### Konwersja na zamówienie

Gdy wycena ma status **Zaakceptowana**, pojawia się przycisk **Przekształć w zamówienie**. Konwersja tworzy koszyk, stosuje każdą cenę negocjowaną przez `SpecificPrice` powiązany z tym koszykiem, dodaje ewentualny rabat globalny przez regułę koszyka (`CartRule`), a następnie tworzy zamówienie przez `validateOrder` ze skonfigurowanym statusem.

Ceny specyficzne i reguły tymczasowe są **czyszczone automatycznie** po utworzeniu zamówienia: Twój katalog nigdy nie jest modyfikowany, a zamówienie ma dokładnie wynegocjowane kwoty.

## Statusy wyceny

- **Nowe zapytanie**: wycena otrzymana, do obsłużenia.
- **W trakcie**: w przygotowaniu po stronie sklepu.
- **Wycena wysłana**: przekazana klientowi, który może ją zaakceptować lub odrzucić.
- **Zaakceptowana**: zatwierdzona przez klienta, gotowa do konwersji na zamówienie.
- **Odrzucona**: odrzucona przez klienta.
- **Wygasła**: przekroczona data ważności.
- **Przekształcona w zamówienie**: przekształcona w rzeczywiste zamówienie.

## FAQ i rozwiązywanie problemów

### Przycisk „Wycena" się nie wyświetla

Sprawdź, czy moduł jest aktywny, czy odwiedzający należy do dozwolonej grupy (jeśli ograniczyłeś wyświetlanie), i wyczyść cache PrestaShop. Moduł potrafi wstrzyknąć przycisk nawet jeśli Twój motyw nie wywołuje hooka karty produktu; w przypadku bardzo spersonalizowanego motywu sprawdź obecność kontenera zakupu.

### Biała strona lub błąd „nieprawidłowy JSON" przy dodawaniu

Wyczyść cache (Zaawansowane parametry > Wydajność) i na czas testów wyłącz łączenie i kompresję plików (CCC). Odpowiedzi AJAX modułu to ścisły JSON, zwracany bezpośrednio dla zgodności z PrestaShop 9.

### Ceny nie są ukryte

Włącz opcję **Ukryj ceny**. W zależności od motywu niektóre bardzo specyficzne miejsca wyświetlania cen mogą wymagać dostosowania; moduł ukrywa standardowe miejsca PrestaShop.

### Klient nie może zaakceptować swojej wyceny

Akceptacja i odmowa są możliwe tylko wtedy, gdy wycena ma status **Wycena wysłana**. Ustaw ten status z poziomu zaplecza.

### E-maile nie docierają

Sprawdź adres wpisany w polu **E-mail administratora** oraz konfigurację e-mail PrestaShop (Zaawansowane parametry > E-mail). Szablony są dostarczone po francusku i angielsku i pozostają personalizowalne.

### Czy moduł jest zgodny z PrestaShop 9 i multisklepem?

Tak. Moduł jest zgodny z PrestaShop 8 i 9, w pojedynczym sklepie i w multisklepie. Wyceny są powiązane ze sklepem i językiem klienta.
