# Minimalna ilość i sprzedaż w wielokrotnościach: dokumentacja DataFirefly Minimums > Instalacja Zainstaluj moduł w Moduły > Menedżer modułów > Załaduj moduł za pomocą pliku ZIP albo skopiuj folder dfminimums do katalogu /modules/ sklepu i kliknij Instaluj. Podczas instalacji moduł tworzy… - Strona: - Język: pl - Zaktualizowano: 2026-09-22 - Inne języki: [fr](https://www.datafirefly.com/documentation/dfminimums/index.md), [en](https://www.datafirefly.com/en/documentation/dfminimums/index.md), [es](https://www.datafirefly.com/es/documentation/dfminimums/index.md), [de](https://www.datafirefly.com/de/documentation/dfminimums/index.md), [it](https://www.datafirefly.com/it/documentation/dfminimums/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfminimums/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfminimums/index.md) - Indeks: ## Instalacja Zainstaluj moduł w **Moduły > Menedżer modułów > Załaduj moduł** za pomocą pliku ZIP albo skopiuj folder `dfminimums` do katalogu `/modules/` sklepu i kliknij Instaluj. Podczas instalacji moduł tworzy dwie tabele (reguły ilościowe i minima zamówienia), rejestruje swoje hooki i dodaje dwie zakładki w menu Katalog: **Minima i wielokrotności** oraz **Minimalne zamówienie**. W produktach obsługiwanych przez moduł zostaw natywną **minimalną ilość** z karty produktu na 1. PrestaShop nadal sprawdza ją samodzielnie, a inna wartość może być sprzeczna z regułą modułu. ## Ustawienia modułu Strona konfiguracji modułu zawiera sześć ustawień. ### Włącz reguły zakupu Główny przełącznik. Po wyłączeniu żadna reguła nie jest wyświetlana ani stosowana w sklepie. Reguły pozostają zapisane. ### Automatycznie dostosuj ilości Gdy klient doda do koszyka ilość naruszającą regułę, moduł zastępuje ją najbliższą dozwoloną ilością: w górę przy dodawaniu, w dół przy usuwaniu. Dodanie 7 sztuk produktu sprzedawanego po 6 daje 12, zmiana z 12 na 11 daje 6. Pozycje personalizowane nigdy nie są zmieniane. Po wyłączeniu ilość pozostaje bez zmian, a koszyk jest zablokowany, dopóki klient jej nie poprawi. ### Pokaż warunki na stronie produktu Wyświetla pod przyciskiem dodania do koszyka ramkę z minimum, wielokrotnością i maksimum dla zalogowanego klienta. Ramka pojawia się także w szybkim podglądzie. ### Pokaż etykietę na listach produktów Dodaje krótką etykietę pod ceną miniatur produktów, na przykład „Sprzedaż po 6” lub „Min. 12”. ### Pokaż warunki pod każdą pozycją koszyka Przypomina warunek każdej pozycji i pokazuje błąd na czerwono, gdy ilość jest niedozwolona. ### Klient w kilku grupach Określa, które minimum zamówienia obowiązuje, gdy klient należy do kilku grup z własnym minimum: minimum jego grupy domyślnej, najwyższe lub najniższe. ## Tworzenie reguły ilościowej Otwórz **Katalog > Minima i wielokrotności** i kliknij **Dodaj regułę**. ### Dotyczy - **Produkt**: wyszukaj produkt po nazwie, indeksie, EAN lub ID, a następnie opcjonalnie wybierz kombinację. Reguła dla kombinacji ma pierwszeństwo przed regułą dla całego produktu. - **Kategoria**: wybierz kategorię i określ, czy uwzględnić podkategorie. Obejmuje to wszystkie produkty przypisane do kategorii, niezależnie od ich kategorii domyślnej. - **Wszystkie produkty**: reguła dotyczy całego katalogu. ### Grupa klientów Zostaw „Wszystkie grupy klientów” albo wybierz grupę. Reguła grupy dotyczy każdego klienta należącego do tej grupy, nawet jeśli nie jest to jego grupa domyślna. ### Minimum, wielokrotność i maksimum - **Minimalna ilość**: 0 lub 1 oznacza brak minimum. Jeśli ustawiono wielokrotność, a minimum nią nie jest, zostaje zaokrąglone w górę: minimum 10 po 6 daje 12. - **Sprzedaż w wielokrotnościach**: 1 pozostawia dowolną ilość, 6 przyjmuje tylko 6, 12, 18 itd. - **Maksymalna ilość**: 0 oznacza brak maksimum. Maksimum musi być wielokrotnością wybranej wielokrotności i być większe lub równe minimum. Reguła musi ustawiać co najmniej minimum większe niż 1, wielokrotność większą niż 1 lub maksimum. ## Która reguła obowiązuje Dla każdego produktu w koszyku obowiązuje jedna reguła „na produkt”. Moduł wybiera ją w tej kolejności: 1. najwyższy priorytet; 2. przy równym priorytecie najbardziej szczegółowa reguła: kombinacja, potem produkt, potem kategoria (najgłębsza najpierw), potem wszystkie produkty; 3. przy równej szczegółowości reguła grupy klientów przed regułą dla wszystkich grup. Przykład: reguła „Wina, sprzedaż po 6” dla wszystkich klientów i reguła „Wina, sprzedaż po 12” dla grupy Firmy. Klient firmowy zamawia po 12, klient detaliczny po 6. Panel modułu w zakładce Moduły karty produktu wyświetla reguły dotyczące bezpośrednio produktu oraz reguły kategorii lub katalogu, które również mogą obowiązywać. ## Dowolny mix w kategorii W regule kategorii pole **Sposób liczenia** ma dwie wartości. - **Każdy produkt osobno**: reguła dotyczy każdego produktu kategorii, jak reguła produktu. - **Wszystkie produkty kategorii razem (dowolny mix)**: minimum, wielokrotność i maksimum dotyczą sumy ilości wszystkich produktów kategorii w koszyku. Przykład: minimum 12 i wielokrotność 6 w trybie dowolnego mixu w kategorii Wina. Klient może wziąć 4 czerwone, 4 białe i 4 różowe. Przy łącznie 13 butelkach koszyk jest zablokowany. Reguły dowolnego mixu są sprawdzane dodatkowo obok reguły każdego produktu. Wino sprzedawane na sztuki nadal jest dostępne na sztuki, o ile suma kategorii spełnia regułę dowolnego mixu. ## Minima zamówienia dla grup Otwórz **Katalog > Minimalne zamówienie** i kliknij **Dodaj minimum zamówienia**. - **Grupa klientów**: jedno minimum na grupę. Pozycja „Wszyscy klienci (domyślnie)” dotyczy klientów, których grupy nie mają własnego minimum. - **Kwota minimalna**: podawana w domyślnej walucie sklepu, automatycznie przeliczana dla koszyków w innej walucie. Koszty wysyłki nigdy nie są wliczane. - **Kwota brutto**: Nie porównuje kwotę z sumą produktów netto, co jest typowe w B2B. - **Odejmij kupony**: Tak bierze sumę po regułach koszyka i kuponach. Natywne minimum zakupu (**Parametry sklepu > Ustawienia zamówień**) pozostaje aktywne i dotyczy wszystkich. Ustaw je na 0, jeśli mają się liczyć tylko minima dla grup. ## Co widzi klient Gdy koszyk narusza regułę, moduł wypełnia klucz `minimalPurchaseRequired` koszyka, którego PrestaShop używa dla własnej minimalnej kwoty. Przycisk zamówienia jest wyłączony, a natywny alert koszyka pokazuje „Twój koszyk nie spełnia jeszcze warunków zakupu.” oraz szczegóły każdego problemu: niedozwoloną ilość z możliwymi ilościami, sumę kategorii w trybie dowolnego mixu, brakującą kwotę do minimum zamówienia. Kontrola jest powtarzana przy otwarciu strony zamówienia: klient, który próbuje wejść na nią bezpośrednio, wraca do koszyka. W sklepie pola ilości stosują się do reguły. W motywie Classic przyciski TouchSpin przeskakują o wielokrotność. W Hummingbird przyciski +/- przechodzą od razu do następnej lub poprzedniej dozwolonej ilości. ## Import i eksport CSV Import znajduje się nad listą reguł. Plik akceptuje separator `;` lub `,` i wymaga wiersza nagłówka z co najmniej kolumną `scope`. Rozpoznawane kolumny: - `name`: nazwa wewnętrzna, generowana, gdy jest pusta; - `scope`: `product`, `category` lub `all`; - `product_id` lub `product_reference`; - `combination_reference`: indeks kombinacji; - `category_id` i `include_subcategories` (0 lub 1); - `apply_mode`: `per_product` lub `cumulative` (dowolny mix); - `group_id`: 0 dla wszystkich grup; - `min_qty`, `multiple`, `max_qty`, `priority`, `active`. Pole „Najpierw usuń wszystkie istniejące reguły tego sklepu” zastępuje cały zestaw reguł. Błędne wiersze są wymieniane z numerem i nie blokują pozostałych. Przycisk **Eksportuj CSV** tworzy ten sam format, przydatny do przenoszenia reguł między sklepami. Plik przykładowy można pobrać z bloku importu. ## Dobre praktyki - Zacznij od szerokiej reguły (kategoria lub katalog), a potem dodaj wyjątki dla produktów: najbardziej szczegółowa reguła wygrywa bez zmiany priorytetu. - Używaj priorytetu tylko wtedy, gdy mniej szczegółowa reguła ma wygrać, na przykład reguła kategorii, która ma obowiązywać wszystkie jej produkty. - Testuj na koncie klienta z każdej grupy: reguły grup nie są widoczne dla niezalogowanego gościa. - Po zmianie wyczyść pamięć podręczną, jeśli sklep używa modułu cache całych stron. ## Rozwiązywanie problemów ### Klient nie może zejść poniżej pewnej ilości, choć żadna reguła tego nie wymaga Sprawdź natywną minimalną ilość na karcie produktu (zakładka Stany magazynowe lub Ilości, zależnie od wersji) i ustaw ją z powrotem na 1. ### Koszyk jest zablokowany natywnym komunikatem o minimalnej kwocie To natywne minimum z **Parametry sklepu > Ustawienia zamówień**. Ustaw je na 0, jeśli mają się liczyć tylko minima dla grup. ### Przyciski +/- zmieniają ilość o 1 Motyw nie używa standardowych selektorów Classic ani Hummingbird. Reguła nadal działa po stronie serwera: koszyk jest korygowany lub blokowany. Napisz do nas z nazwą motywu, aby go dostosować. ### Moduł zamówienia na jednej stronie przepuszcza zamówienie Zewnętrzny moduł ignoruje `minimalPurchaseRequired`. Przetestuj go na sklepie testowym i napisz do nas z jego nazwą. ## Zgodność - PrestaShop 8.0 do 9.x, ten sam ZIP dla obu gałęzi. - Motywy Classic i Hummingbird. - Multisklep: reguły i minima są zapisywane dla każdego sklepu. - Architektura ModuleAdminController, bez zależności Composer, PHP 7.2 i nowszy. - Interfejs w języku angielskim, francuskim, hiszpańskim, niemieckim, włoskim, niderlandzkim, polskim i portugalskim.