# DataFirefly Auto Clearance: automatyczna wyprzedaż zalegającego towaru > Instalacja Zainstaluj moduł w Moduły > Menedżer modułów > Załaduj moduł, wysyłając plik ZIP, albo skopiuj folder dfclearance do katalogu /modules/ sklepu i kliknij Zainstaluj. Podczas instalacji moduł: tworzy kategorię… - Strona: - Język: pl - Zaktualizowano: 2026-09-30 - Inne języki: [fr](https://www.datafirefly.com/documentation/dfclearance/index.md), [en](https://www.datafirefly.com/en/documentation/dfclearance/index.md), [es](https://www.datafirefly.com/es/documentation/dfclearance/index.md), [de](https://www.datafirefly.com/de/documentation/dfclearance/index.md), [it](https://www.datafirefly.com/it/documentation/dfclearance/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfclearance/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfclearance/index.md) - Indeks: ## Instalacja Zainstaluj moduł w **Moduły > Menedżer modułów > Załaduj moduł**, wysyłając plik ZIP, albo skopiuj folder `dfclearance` do katalogu `/modules/` sklepu i kliknij Zainstaluj. Podczas instalacji moduł: - tworzy kategorię **Outlet** pod stroną główną, którą możesz przemianować lub zastąpić istniejącą kategorią; - dodaje zakładkę **Katalog > Automatyczna wyprzedaż** z listą produktów w outlecie; - tworzy swoje tabele (produkty w outlecie, wykluczenia, dziennik, sprzedaż z outletu); - pozostaje **wyłączony**: żadna cena ani kategoria się nie zmienia, dopóki nie włączysz automatycznego uruchamiania. Przy aktualizacji z wersji 1.0.0 wystarczy wgrać nowy plik ZIP: skrypt aktualizacji dodaje tabelę sprzedaży, nowe ustawienia i nowe hooki, nie zmieniając istniejących ustawień. ## Pierwsze kroki Strona konfiguracji pokazuje listę czterech kroków, dopóki moduł nie działa w pełni: 1. **Ustaw progi** w zakładce Progi i ceny. Wartości domyślne to 10 % po 90 dniach, 20 % po 150 dniach i 35 % po 240 dniach. 2. **Uruchom symulację** przyciskiem Symuluj u góry strony. Raport wymienia produkty, które trafiłyby do outletu, rabaty, które by się zmieniły, i produkty, które by go opuściły. Nic nie jest zapisywane. 3. **Włącz automatyczne uruchamianie**, pierwsza opcja zakładki Progi i ceny. 4. **Zaplanuj zadanie cron** z adresem URL z zakładki Zadanie cron. Po symulacji przycisk **Zastosuj teraz** uruchamia przetwarzanie naprawdę, jeśli moduł jest włączony. ## Progi i ceny ### Progi domyślne Każdy próg łączy liczbę dni bez sprzedaży z rabatem procentowym. Pierwszy próg to próg wejścia do outletu. Każdy próg musi dawać wyższy rabat niż poprzedni. Oś czasu pod tabelą pokazuje postęp i sygnalizuje niespójne progi przed zapisaniem. Dni bez sprzedaży liczone są od ostatniego ważnego zamówienia zawierającego produkt, łącznie ze wszystkimi kombinacjami. Produkt nigdy niesprzedany liczy się od daty utworzenia. ### Postęp progów - **Dni bez sprzedaży**: licznik startuje od nowa po każdej sprzedaży, również w outlecie. - **Czas w outlecie**: progi biegną dalej, nawet gdy produkt się sprzedaje. W obu przypadkach rabat produktu w outlecie nigdy nie spada. ### Progi dla kategorii Przycisk **Dodaj regułę kategorii** tworzy własny zestaw progów dla jednej kategorii. Reguła obejmuje kategorię i wszystkie jej podkategorie oraz zastępuje progi domyślne dla tych produktów. Gdy produkt pasuje do kilku reguł, obowiązuje pierwsza na liście. W przypadku produktu przeniesionego do outletu moduł korzysta z kategorii, które miał przed wejściem. ### Obsługa kategorii - **Dodaj** (zalecane): produkt zostaje dodany do outletu i pozostaje w swoich kategoriach. - **Dodaj jako kategorię domyślną**: outlet staje się też kategorią domyślną, widoczną w okruszkach. - **Przenieś**: produkt pojawia się tylko w outlecie. Jego kategorie są zapisywane i przywracane przy wyjściu. Tryby Dodaj jako kategorię domyślną i Przenieś zmieniają adres URL produktu, jeśli kategoria jest częścią formatu adresów produktów. PrestaShop przekierowuje stary adres, ale sprawdź to przed użyciem na dobrze pozycjonowanym katalogu. ### Ochrona cen - **Maksymalny rabat** (domyślnie 60 %): limit dla wszystkich progów. - **Ochrona marży**: cena w outlecie nigdy nie spada poniżej ceny zakupu netto powiększonej o minimalną marżę (domyślnie 5 %). Produkty bez ceny zakupu nie są ograniczane. Jeśli żaden rabat nie jest możliwy, produkt nie trafia do outletu. - **Końcówka ceny**: Dokładna, x,99, x,90 lub x,00. Moduł zaokrągla cenę brutto w outlecie dla kraju domyślnego do najbliższej końcówki. Jeśli żadna końcówka nie mieści się w 5 punktach od rabatu progu, zostaje dokładny procent. Pole **Podgląd dla produktu za** na bieżąco oblicza cenę na każdym progu dla wybranej ceny, z zaokrągleniem i maksymalnym rabatem. ## Kwalifikacja ### Warunki wejścia - **Minimalny stan do wejścia**: ustaw 2 lub więcej, aby ostatnia sztuka została w pełnej cenie. - **Pomijaj produkty już w promocji**: produkt z aktywnym rabatem dla wszystkich klientów nie trafia do outletu, aby rabaty się nie sumowały. - **Wykluczone kategorie i marki**: takie produkty nigdy nie trafiają do outletu. Pole filtra pomaga znaleźć kategorię na długiej liście. Produkty wirtualne, wyłączone i z zerową ceną są zawsze pomijane. ### Warunki wyjścia - **Opuść outlet po wyczerpaniu stanu**: produkt odzyskuje kategorie i cenę regularną po wyprzedaniu. - **Opuść outlet po uzupełnieniu stanu**: produkt wychodzi, gdy jego stan przekroczy ilość z chwili wejścia. - Produkt wyłączony lub wykluczony również wychodzi przy następnym uruchomieniu. ### Okres ponownego wejścia Produkt, który opuszcza outlet, usunięty ręcznie, uzupełniony albo wykluczony i ponownie dopuszczony, nie może wrócić przed upływem tego okresu (domyślnie 30 dni, 0 go wyłącza). Przy 30 dniach przekreślona cena zawsze odpowiada najniższej cenie z ostatnich 30 dni, zgodnie z unijną dyrektywą Omnibus. Okres nie obowiązuje po zmianie kategorii outlet. ### Nowe produkty na uruchomienie Ogranicza liczbę produktów trafiających do outletu przy każdym uruchomieniu (domyślnie 200). Resztę przetwarzają kolejne uruchomienia. Każde uruchomienie ma też limit czasu, aby zmieścić się w ograniczeniach hostingu. ### Pauza Podaj datę początkową i końcową, aby wstrzymać wyprzedaż na czas wyprzedaży sezonowych lub akcji Black Friday. W czasie pauzy żaden produkt nie trafia do outletu i żaden rabat nie rośnie. Wyjścia nadal działają, a obecne ceny w outlecie się nie zmieniają. Nagłówek modułu pokazuje trwającą pauzę. ## Zadanie cron Zakładka **Zadanie cron** podaje adres URL do wywoływania raz dziennie, najlepiej w nocy, z przyciskiem kopiowania. Dostępne parametry: - `&simulate=1`: uruchomienie próbne, nic nie jest zmieniane; - `&all_shops=1`: przetwarza wszystkie sklepy instalacji multisklep. Przykładowa linia dla crontab lub cPanel: ``` 0 3 * * * curl -s "https://twoj-sklep.pl/module/dfclearance/cron?token=TWOJ_TOKEN" > /dev/null ``` Wyświetlana jest data ostatniego wywołania. Jeśli automatyczne uruchamianie jest włączone, a cron nie był wywołany od ponad 48 godzin, u góry strony pojawia się ostrzeżenie. Przycisk **Nowy token** unieważnia obecny adres. Gdy sklep jest w trybie konserwacji, dodaj adres IP serwera do listy IP konserwacji, w przeciwnym razie wywołanie zostanie zablokowane. ## Pulpit Zakładka Pulpit pokazuje: - liczbę produktów i sztuk w outlecie; - zapas do wyprzedania w cenie zakupu i jego wartość w cenie outletu; - przychód netto z outletu z ostatnich 30 dni z liczbą zamówień i sztuk oraz od instalacji; - wyprzedany zapas w cenie zakupu; - średni rabat produktów w outlecie; - wykres przychodu z outletu dzień po dniu, ruchy z ostatnich 30 dni, rozkład produktów według rabatu i pięć bestsellerów outletu. Sprzedaż jest zapisywana w chwili zamówienia dla produktów, które były wtedy w outlecie. Liczą się tylko ważne zamówienia, a kwoty są przeliczane na walutę domyślną. Dane zaczynają się od instalacji modułu: nie ma historii wstecznej. ## Produkty wkrótce i wykluczenia Zakładka **Wkrótce** wymienia produkty, które osiągną próg wejścia w ciągu najbliższych 7, 14, 30 lub 60 dni, z rabatem, jaki otrzymają, stanem i jego wartością zakupu. Produkty oznaczone „następne uruchomienie” przekroczyły już próg. Przycisk **Wyklucz** trwale usuwa je z wyprzedaży. Zakładka **Wykluczone produkty** przyjmuje ID lub indeksy rozdzielone przecinkami. Wykluczenie produktu, który jest już w outlecie, powoduje jego natychmiastowe wyjście. Przycisk **Usuń wykluczenie** przywraca kwalifikację po okresie ponownego wejścia. ## Etykieta i e-maile ### Etykieta Etykieta wyświetla się na miniaturach i kartach produktów, obok natywnej etykiety rabatu. Możesz wybrać jej kolor i tekst dla każdego języka, z podglądem na żywo. ### Raport e-mail Po włączeniu raport jest wysyłany po każdym rzeczywistym uruchomieniu, które dodaje lub wycofuje produkty albo zmienia rabat. Wymienia produkty wraz z rabatem i powodem. Zostaw pole odbiorców puste, aby użyć adresu e-mail sklepu, lub wpisz kilka adresów rozdzielonych przecinkami. Przycisk testowy wysyła wynik symulacji. ## Lista produktów w outlecie **Katalog > Automatyczna wyprzedaż** wymienia produkty w outlecie z rabatem, ceną regularną brutto, ceną w outlecie brutto, stanem, datą wejścia i następnym krokiem (na przykład „35 % za 38 dni”). Z tej listy możesz: - usunąć produkt z outletu, który nie wróci przed końcem okresu ponownego wejścia; - uruchomić przetwarzanie ręcznie; - wyeksportować listę do CSV. ## Jak stosowany jest rabat Rabat to natywna cena specjalna PrestaShop dla wszystkich klientów, walut i krajów. Motyw pokazuje więc zwykłą przekreśloną cenę i etykietę rabatu. Bez końcówki ceny rabat jest procentowy. Z końcówką jest to kwota brutto obliczona dla kraju domyślnego, a motywy pokazują wtedy oszczędność jako kwotę, a nie procent. Moduł aktualizuje indeks cen modułu wyszukiwania fasetowego, jeśli ten na to pozwala, aby filtr ceny był poprawny. Jeśli cena bazowa produktu zmieni się, gdy jest w outlecie, cena specjalna zostanie przeliczona przy następnym uruchomieniu. ## Odinstalowanie i reset Przycisk **Wycofaj wszystkie produkty** w zakładce Zadanie cron usuwa wszystkie produkty z outletu, przywraca ich kategorie i kasuje ceny outletu. Następnie obowiązuje okres ponownego wejścia. Odinstalowanie modułu robi to samo przed usunięciem jego tabel. Kategoria outlet nie jest usuwana. ## Rozwiązywanie problemów ### Żaden produkt nie trafia do outletu Uruchom symulację. Sekcja Pominięte produkty wymienia produkty, których ochrona marży nie pozwala przecenić. Pozostałe filtry nie tworzą wiersza w raporcie: sprawdź minimalny stan, opcję pomijania produktów w promocji, wykluczone kategorie i marki, okres ponownego wejścia i ewentualną pauzę. Na koniec sprawdź, czy pierwszy próg nie jest dłuższy niż wiek twoich produktów. ### Ręcznie usunięty produkt nie wraca To okres ponownego wejścia. Skróć go lub ustaw na 0, jeśli nie sprzedajesz w Unii Europejskiej. ### Cena w outlecie nie kończy się na ,99 Przy tanim produkcie żadna końcówka nie mieści się w 5 punktach od rabatu progu: moduł zostawia wtedy dokładny procent. W krajach innych niż domyślny inna stawka VAT również przesuwa końcówkę. ### Cron nie działa Otwórz adres crona w przeglądarce: musi zwrócić wynik JSON. Błąd 503 zwykle oznacza tryb konserwacji, błąd 403 nieprawidłowy token. ## Zgodność - PrestaShop od 8.0 do 9.x, ten sam plik ZIP obsługuje obie wersje. - Multisklep i wielojęzyczność. - Bez zależności Composer. - Rabat stosowany na poziomie produktu, łącznie ze wszystkimi kombinacjami. - Interfejs w języku francuskim, angielskim, hiszpańskim, niemieckim, włoskim, niderlandzkim, polskim i portugalskim.