# Dokumentacja modułu Przedsprzedaży PrestaShop (dfpreorder) > Moduł DataFirefly Pre-Orders (dfpreorder) pozwala sprzedawać produkty, zanim trafią do magazynu, w PrestaShop 8 i 9. Ta strona obejmuje instalację, ustawienia, reguły, przyjęcia towaru i rozwiązywanie problemów. Instalacja Pobierz plik… - Strona: - Język: pl - Zaktualizowano: 2026-10-07 - Inne języki: [fr](https://www.datafirefly.com/documentation/dfpreorder/index.md), [en](https://www.datafirefly.com/en/documentation/dfpreorder/index.md), [es](https://www.datafirefly.com/es/documentation/dfpreorder/index.md), [de](https://www.datafirefly.com/de/documentation/dfpreorder/index.md), [it](https://www.datafirefly.com/it/documentation/dfpreorder/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfpreorder/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfpreorder/index.md) - Indeks: Moduł **DataFirefly Pre-Orders** (dfpreorder) pozwala sprzedawać produkty, zanim trafią do magazynu, w PrestaShop 8 i 9. Ta strona obejmuje instalację, ustawienia, reguły, przyjęcia towaru i rozwiązywanie problemów. ## Instalacja 1. Pobierz plik ZIP z konta klienta DataFirefly. 2. W panelu administracyjnym przejdź do _Moduły > Menedżer modułów > Wgraj moduł_ i wyślij plik ZIP. 3. Podczas instalacji moduł tworzy swoje tabele, trzy statusy zamówienia i dwie pozycje menu: _Katalog > Przedsprzedaż_ dla reguł oraz _Zamówienia > Przedsprzedaż_ do monitorowania. 4. Otwórz konfigurację modułu, sprawdź ustawienia ogólne i skopiuj adres URL crona. Moduł działa od PrestaShop 8.0 do 9.x z tego samego pliku ZIP, w multisklepie i w wielu językach. Teksty są dostarczone po polsku, angielsku, francusku, hiszpańsku, niemiecku, włosku, niderlandzku i portugalsku. ## Ustawienia ogólne - **Domyślny tekst przycisku** i **tekst etykiety**, w każdym języku. Każda reguła może je zastąpić. - **Koszyki łączące przedsprzedaż i produkty dostępne**: zezwalaj bez komunikatu, zezwalaj z informacją, że zamówienie zostanie wysłane jednorazowo, albo zabroń łączenia. - **Pole zgody przy składaniu zamówienia**: dodaje obowiązkowe pole, gdy koszyk zawiera przedsprzedaż. Treść obsługuje znacznik `%date%`, zastępowany najpóźniejszą przewidywaną datą wysyłki z koszyka. Data zgody jest zapisywana przy każdej pozycji przedsprzedaży. - **E-maile** potwierdzenia i dostępności, włączane osobno. - **Automatyczny przydział** przyjętego towaru oraz **status zamówienia** nadawany po przydzieleniu wszystkich pozycji. - **Formularz Powiadom mnie** przy produktach, których nie można zamówić lub których przedsprzedaż jest wyczerpana. - **Wysyłka zamówień mieszanych**: jedna przesyłka, gdy wszystko będzie dostępne, wysyłka częściowa (najpierw produkty dostępne, jedno zamówienie i jedna faktura) lub podział na dwa zamówienia z tym samym numerem przy płatności. Przy podziale wybierasz, czy decyduje klient w koszyku, czy każdy mieszany koszyk jest dzielony. - **E-mail o wysyłce częściowej** z listą wysłanych produktów i linkiem do śledzenia. - **Dane strukturalne PreOrder**, domyślnie wyłączone: włącz je tylko wtedy, gdy motyw lub moduł SEO nie generuje już JSON-LD produktu. ## Tworzenie reguły przedsprzedaży Przejdź do _Katalog > Przedsprzedaż_, a następnie _Dodaj regułę_. Reguła dotyczy produktu albo konkretnego wariantu. Tryb wybiera się za pomocą trzech kart, a kolumna po prawej pokazuje podczas wpisywania podgląd bloku sklepu, oczekujące zamówienia tej reguły i historię jej dat. ### Trzy tryby - **Przy braku towaru**: przedsprzedaż rusza, gdy stan osiąga zero, i kończy się po uzupełnieniu. To tryb dla braków u dostawcy. - **Wymuszony**: produkt pozostaje w przedsprzedaży, dopóki reguła jest aktywna, nawet przy dostępnym towarze. To tryb premiery produktu. - **Okno dat**: przedsprzedaż otwiera się i zamyka w podanych terminach. Zamknięcie realizuje zadanie cron, a awaryjnie każde wyświetlenie karty produktu. ### Pozostałe pola - **Przewidywana data wysyłki**: widoczna na karcie produktu, w koszyku, na koncie klienta, na fakturze i w e-mailach. - **Maksymalna ilość** i **maksimum na klienta**: 0 oznacza brak limitu. Limity są sprawdzane po stronie serwera przy każdym zapisie koszyka. - **Rabat przedsprzedażowy** procentowy lub kwotowy: dostępny w trybach wymuszonym i okna dat, gdzie okres jest znany z góry. Tworzy cenę specyficzną usuwaną po zakończeniu reguły. - **Tekst przycisku** i **komunikat** w każdym języku, właściwe dla reguły. - **Odliczanie** (do zamknięcia lub do premiery) oraz **pasek zarezerwowanych sztuk**, który wymaga maksymalnej ilości. ### Tworzenie wielu reguł naraz Przycisk _Przypisanie zbiorcze i import CSV_ otwiera dwa formularze. Pierwszy dotyczy wszystkich produktów z kategorii, marki lub od dostawcy (kryteria się sumują). Dla produktów, które mają już reguły, wybierz _Aktualizuj tylko przewidywaną datę wysyłki_ (domyślnie), _Zastąp wszystkie ustawienia_ lub _Pozostaw bez zmian_, oraz czy produkty bez reguły mają ją otrzymać. Drugi importuje plik CSV z kolumnami `product` (ID lub indeks), `combination` (opcjonalnie), `mode`, `release_date`, `max_qty`, `max_per_customer`, `date_start`, `date_end`. W istniejących regułach zmieniane są tylko obecne i wypełnione kolumny. ### Przesunięcie daty dostawy od dostawcy W przypisaniu zbiorczym wybierz dostawcę, wpisz nową przewidywaną datę wysyłki, pozostaw _Aktualizuj tylko przewidywaną datę wysyłki_ i _Powiadom klientów o zmianie daty_, a następnie zastosuj. Wszystkie reguły produktów dostawcy zostaną przesunięte, także reguły wariantów; tryby, limity i okna pozostają bez zmian. Oczekujące zamówienia przyjmują nową datę, klienci otrzymują e-mail o opóźnieniu z linkiem do anulowania, a zmiana trafia do historii każdej reguły. Plik CSV zawierający tylko `product` i `release_date` robi to samo dla poszczególnych produktów. ## Co widzi klient Przy produkcie w przedsprzedaży przycisk dodania do koszyka przyjmuje wybrany tekst, na zdjęciach na listach i na karcie pojawia się etykieta, a ramka pokazuje przewidywaną datę, Twój komunikat, odliczanie i pasek zarezerwowanych sztuk. Blok odświeża się po zmianie wariantu. W koszyku każda pozycja objęta przedsprzedażą jest oznaczona przewidywaną datą. Przy składaniu zamówienia pole zgody przypomina termin. Po zamówieniu klient śledzi przedsprzedaż w sekcji _Moje konto > Moje zamówienia przedsprzedażowe_ i może poprosić o anulowanie pozycji, które nadal czekają. ## Wysyłka zamówień mieszanych Ustawienie _Wysyłka zamówień mieszanych_ określa, co się dzieje, gdy zamówienie zawiera produkty dostępne i produkty w przedsprzedaży. - **Jedna przesyłka** (domyślnie): całe zamówienie czeka w statusie _Przedsprzedaż: oczekuje na towar_ i wychodzi, gdy wszystko jest dostępne. - **Wysyłka częściowa**: strona zamówienia pokazuje produkty dostępne z polem na numer przesyłki i przyciskiem _Oznacz jako wysłane częściowo_. Zamówienie przechodzi do statusu _Przedsprzedaż: wysłane częściowo_, który pozwala wygenerować dokument dostawy, a klient otrzymuje listę wysłanych produktów, link do śledzenia przesyłki i pozostałe produkty z datami. Panel pokazuje wszystkie zamówienia, których dostępna część może wyjść od razu. Jedno zamówienie, jedna faktura; druga paczka korzysta z natywnego numeru przesyłki PrestaShop. - **Podział na dwa zamówienia**: PrestaShop tworzy przy płatności jedno zamówienie dla produktów dostępnych i drugie dla przedsprzedaży, z tym samym numerem, natywnym mechanizmem paczek (bez override). Pozycja częściowo dostępna zostaje podzielona na dwie. Koszt wysyłki naliczany jest za każdą paczkę. Przy opcji wyboru klienta pole w koszyku pozwala mu poprosić o podział; w przeciwnym razie każdy mieszany koszyk jest dzielony. Przetestuj podział z modułami płatności w sklepie testowym przed włączeniem. Produkt w trybie wymuszonym, który ma jeszcze towar, PrestaShop traktuje jako dostępny i nie oddziela go. ### Kolumna Przedsprzedaż na liście zamówień Natywna lista _Zamówienia_ zyskuje kolumnę _Przedsprzedaż_ z filtrem: dowolna przedsprzedaż, oczekuje na towar, gotowe do wysyłki, zgłoszono anulowanie. Jednym kliknięciem wyodrębnia zamówienia czekające na towar. ## Monitorowanie i przydział towaru _Zamówienia > Przedsprzedaż_ zbiera cały monitoring. ### Panel Wskaźniki pokazują sztuki oczekujące, liczbę zamówień, zarezerwowany przychód brutto, sztuki już przydzielone i prośby o anulowanie. Tabela produktów podaje dla każdego produktu lub wariantu sztuki oczekujące, stan w PrestaShop, sztuki możliwe do przydzielenia od razu oraz ilość do zamówienia u dostawcy. Eksport CSV korzysta z tych samych kolumn. ### Przydział dostawy Zamówienie w przedsprzedaży zmniejsza stan magazynowy już w chwili złożenia, co spycha go poniżej zera. Sztuki fizycznie dostępne dla przedsprzedaży to zatem: sztuki oczekujące + bieżący stan. Po uzupełnieniu towaru przycisk _Przydziel (najstarsze najpierw)_ obsługuje zamówienia według daty, a _Wybierz zamówienia_ otwiera ekran przydziału z zaznaczonymi i edytowalnymi pozycjami. Suma wyboru aktualizuje się na żywo, z ostrzeżeniem, gdy przekracza fizycznie dostępne sztuki. Gdy wszystkie pozycje przedsprzedaży w zamówieniu zostaną przydzielone, zamówienie przechodzi do ustawionego statusu (domyślnie _Przedsprzedaż: gotowe do wysyłki_), a klient dostaje e-mail. Dalej kompletujesz zamówienie jak zwykle. Automatyczny przydział obsługuje przedsprzedaż bez ręcznego zatwierdzania, ale nigdy przed ogłoszoną datą w regule wymuszonej lub z oknem dat. ## Obsługa opóźnienia Otwórz regułę, zmień przewidywaną datę wysyłki i pozostaw włączoną opcję _Powiadom klientów o zmianie daty_. Oczekujące zamówienia zostaną zaktualizowane, a każdy zainteresowany klient otrzyma e-mail z nową datą i linkiem do prośby o anulowanie. Liczba powiadomionych klientów pojawia się po zapisaniu, a historia ogłaszanych dat znajduje się pod formularzem. Prośby o anulowanie trafiają do panelu. _Potwierdź anulowanie_ zwalnia zarezerwowane sztuki; zwrot środków wykonujesz na stronie zamówienia swoją metodą płatności. _Zachowaj zamówienie_ przywraca pozycje do stanu oczekującego. ## Zadanie cron Konfiguracja modułu pokazuje adres URL z tokenem. Zaplanuj go co 15 minut u swojego hostingodawcy. Otwiera i zamyka okna dat o właściwej porze, a przy włączonym automatycznym przydziale obsługuje przedsprzedaż, do której dotarł towar. ## Najczęstsze pytania ### Czy klient płaci całość? Tak. Klient płaci pełną kwotę przy zamówieniu za pomocą Twoich zwykłych metod płatności. ### Czy produkty dostępne mogą wyjść przed przedsprzedażą? Tak, przy wysyłce częściowej lub podziale opisanych w sekcji Wysyłka zamówień mieszanych. W trybie jednej przesyłki zamówienie czeka, aż wszystko będzie dostępne. ### Dlaczego zamówienie przechodzi do statusu Przedsprzedaż: oczekuje na towar? Moduł nadaje ten status, gdy zamówienie jest opłacone i zawiera co najmniej jedną pozycję w przedsprzedaży. Status jest opłacony i nie pozwala na wysyłkę, dzięki czemu niekompletne zamówienie nie trafia do kompletacji. ### Czy reguła dla jednego wariantu wpływa na pozostałe? PrestaShop obsługuje ustawienie zezwalające na zamówienia bez towaru wyłącznie na poziomie produktu. Moduł ustawia je więc na produkcie, a następnie blokuje w sklepie i w koszyku warianty bez towaru, które nie mają reguły, aby zachować pierwotne zachowanie sklepu. ### Odliczanie się nie pojawia Pojawia się tylko wtedy, gdy data zakończenia (tryb okna dat) lub przewidywana data wysyłki jest w przyszłości i gdy opcja jest włączona w regule. ### Przycisk zachowuje pierwotny tekst Moduł podmienia tekst przycisku dodania do koszyka w standardowych motywach. Przy mocno zmodyfikowanym motywie skontaktuj się ze wsparciem, podając adres karty produktu: selektor przycisku można dostosować.