Minimalna ilość i sprzedaż w wielokrotnościach: dokumentacja DataFirefly Minimums
Instalacja, reguły ilości (minimum, wielokrotność, maksimum), priorytety i symulator, minimalne zamówienia dla grup, kontrole po stronie serwera, import CSV i rozwiązywanie problemów.
Co robi moduł
DataFirefly Minimums ustala minimum, obowiązkową wielokrotność (sprzedaż po 6, po 12) i maksimum dla produktu, kombinacji, kategorii, marki lub całego katalogu, opcjonalnie dla jednej grupy klientów i określonego okresu. Ustala też minimalną wartość zamówienia dla grupy klientów. Każda reguła jest ponownie sprawdzana na serwerze, od dodania do koszyka aż do utworzenia zamówienia: bezpośrednie żądanie nie pozwala jej obejść.

Instalacja
Zainstaluj plik ZIP w Moduły > Menedżer modułów > Załaduj moduł. Moduł tworzy swoje tabele, rejestruje hooki i dodaje dwie zakładki w Katalogu: Minima i wielokrotności oraz Minimalne zamówienie. Wersja 2.0.0 działa na PrestaShop 1.7.8, 8 i 9 z tym samym plikiem ZIP.
Aktualizacja z wersji 1.0.0: wgraj ZIP 2.0.0 na poprzednią wersję. Reguły i minimalne zamówienia zostają zachowane, nowe kolumny i ustawienia są dodawane automatycznie.
Przegląd
Strona konfiguracji otwiera się przeglądem: liczba aktywnych reguł według celu, minimalne zamówienia, lista kontroli po stronie serwera, zdarzenia z ostatnich 30 dni (dopasowane ilości, odrzucone zmiany, zablokowane strony zamówienia, odrzucone zamówienia) oraz kontrole spójności. Moduł liczy tylko rzeczywiste zdarzenia: nie szacuje żadnego wpływu na sprzedaż.

Kontrole spójności wskazują reguły dotyczące usuniętego produktu, kategorii, marki lub grupy, reguły wygasłe, zaokrąglone minima, pominięte maksima, reguły niejednoznaczne (ten sam cel, grupa i priorytet), produkty ze stanem poniżej minimum oraz natywną minimalną ilość kart produktów.
Ustawienia

- Włącz reguły zakupu: główny przełącznik. Po wyłączeniu nic nie jest wyświetlane ani stosowane; reguły zostają zachowane.
- Niedozwolona ilość przy dodawaniu do koszyka: dopasować ją do najbliższej dozwolonej ilości i poinformować klienta (w górę przy dodawaniu, w dół przy usuwaniu) albo odrzucić zmianę, podając dozwolone ilości.
- Wybór ilości według wielokrotności: przyciski + i – na stronie produktu, w szybkim podglądzie, na listach produktów (Hummingbird) i w koszyku przechodzą od jednej dozwolonej ilości do następnej.
- Warunki na stronie produktu, etykieta na listach, warunki pod pozycjami koszyka, pasek postępu: każde wyświetlanie można wyłączyć.
- Klient w kilku grupach: minimalne zamówienie grupy domyślnej, najwyższe lub najniższe.
- Natywna minimalna wartość zakupu: obowiązują oba minima albo minimum modułu zastępuje natywne dla klientów, którzy je mają.
- Zamówienia przez webservice i z panelu: zamówienia przez webservice są domyślnie sprawdzane i odrzucane z jednoznacznym błędem; zamówienia z panelu domyślnie nie, na potrzeby zamówień telefonicznych i wyjątków.
- Mierzyć dopasowania i blokady: zapisywany jest tylko identyfikator koszyka, wpisy są usuwane po 90 dniach.
- Zachować reguły przy odinstalowaniu.
Reguły ilości
Otwórz Katalog > Minima i wielokrotności. Lista pokazuje cel, grupę klientów, warunki, okres i priorytet każdej reguły. Reguły można duplikować oraz włączać i wyłączać zbiorczo.

Tworzenie reguły
- Dotyczy: produktu (wyszukiwanie po nazwie, indeksie, EAN lub ID, a następnie opcjonalnie jednej kombinacji), kategorii (z podkategoriami lub bez), marki lub wszystkich produktów.
- Sposób liczenia: każdy produkt i każda kombinacja osobno; każdy produkt z sumowanymi kombinacjami (rozmiary i kolory mieszane); lub wszystkie objęte produkty razem (mieszane).
- Grupa klientów: wszystkie grupy lub jedna. Niezalogowani odwiedzający należą do grupy Odwiedzający, zamówienia bez konta do grupy Gość.
- Minimum, wielokrotność, maksimum: minimum jest zaokrąglane w górę do wielokrotności (5 po 6 daje 6). Maksimum musi być wielokrotnością i co najmniej najmniejszą dozwoloną ilością: w przeciwnym razie formularz je odrzuca i proponuje dwie wartości.
- Nazwa opakowania dla każdego języka: „karton” daje „Sprzedawane na karton po 6”.
- Priorytet i opcjonalny okres (od / do).
Blok Co zobaczą klienci pokazuje komunikaty i etykietę już podczas wpisywania, wraz z ostrzeżeniami.

Która reguła obowiązuje
Dla każdej pozycji produktu w koszyku obowiązuje jedna reguła. Jest wybierana w tej kolejności:
- najwyższy priorytet;
- najbardziej precyzyjny cel: kombinacja, produkt, kategoria (najgłębsza najpierw), marka, cały katalog;
- reguła dla grupy klienta przed regułą dla wszystkich grup;
- najnowsza reguła.
Reguły mieszane są sprawdzane dodatkowo: sumują wszystkie produkty kategorii, marki lub całego zamówienia. Natywna minimalna ilość z karty produktu zostaje zachowana: gdy jest wyższa, podnosi minimum reguły, zaokrąglone do wielokrotności.
Symulator odpowiada na to pytanie dla produktu, kombinacji, grupy klientów lub klienta (e-mail) i ilości: pokazuje każdą regułę kandydującą, zastosowaną, powód odrzucenia pozostałych, obowiązujące warunki, wynik dla ilości, stan magazynowy i minimalne zamówienie.

Zakładka Moduły na karcie produktu pokazuje obowiązujące warunki dla każdej grupy klientów, reguły produktu i reguły dziedziczone.

Minimalne zamówienia dla grup
Otwórz Katalog > Minimalne zamówienie. Jedno minimum na grupę oraz opcjonalne minimum domyślne dla wszystkich klientów bez własnego minimum. Każde minimum wybiera swoją podstawę: brutto lub netto, przed lub po kuponach, z kosztem wysyłki szacowanym w koszyku lub bez niego. Kwoty wpisuje się w domyślnej walucie i są przeliczane po bieżącym kursie.

Co widzi klient
Strona produktu pokazuje warunki zakupu, dozwolone ilości i liczbę opakowań. Wybór ilości zaczyna się od dozwolonej ilości i przechodzi według wielokrotności.

Gdy stan magazynowy jest niższy niż minimum, a zamówienia przy braku towaru są wyłączone, klient widzi przyczynę, a przycisk dodawania do koszyka jest nieaktywny.

Listy produktów pokazują etykietę („Sprzedaż po 6”, „Min. 4”). W Hummingbird wybór ilości na miniaturach również stosuje regułę.

W koszyku każda pozycja przypomina swój warunek. Niedozwolona ilość jest wyjaśniona, z przyciskami ustawiającymi najbliższe dozwolone ilości, a przycisk zamówienia jest wyłączony z podaniem powodu.

Pasek postępu pokazuje kwotę brakującą do minimalnego zamówienia klienta, na komputerze i na telefonie.


Gdy ilość zostanie dopasowana automatycznie, klient jest o tym jednorazowo informowany w podsumowaniu koszyka.

Kontrole po stronie serwera
- Dodawanie do koszyka i zmiany ilości, przez AJAX lub bezpośredni adres URL: dopasowane lub odrzucone zgodnie z ustawieniem.
- Strona zamówienia: koszyk niezgodny z regułą jest odsyłany do koszyka z podaniem powodów.
- Bezpośrednie wejście do modułu płatności (na przykład na stronę potwierdzenia przelewu): przekierowanie do koszyka, zamówienie nie jest tworzone.
- Tworzenie zamówienia: ostatnia kontrola przed zapisaniem, niezależnie od punktu wejścia. Powiadomienia operatora płatności bez sesji klienta nigdy nie są blokowane, bo klient mógł już zapłacić: są zapisywane w dzienniku.
- Webservice i panel: zgodnie z ustawieniami.
Natywna minimalna wartość zakupu PrestaShop również jest egzekwowana przy tworzeniu zamówienia, podczas gdy PrestaShop sprawdza ją tylko na stronie zamówienia.
Import i eksport CSV
Otwórz Import / eksport. Typ pliku jest rozpoznawany po nagłówku: reguły ilości (kolumna scope) lub minimalne zamówienia (kolumna amount). Opcja Tylko sprawdź jest domyślnie zaznaczona: raport pokazuje każdy wiersz jako poprawny lub błędny i nic nie jest zapisywane. Istniejące reguły są zastępowane tylko wtedy, gdy wszystkie wiersze są poprawne, w jednej transakcji. Eksporty neutralizują formuły arkuszy i można je ponownie zaimportować bez zmian.

Kolumny reguł ilości: name, scope (product, category, manufacturer, all), product_id lub product_reference, combination_reference, category_id, include_subcategories, manufacturer_id, apply_mode (per_product, product_total, cumulative), group_id, min_qty, multiple, max_qty, priority, active, date_from, date_to, pack_label_xx. Kolumny minimalnych zamówień: group_id, amount, tax_incl, after_discounts, include_shipping, active. Pliki z wersji 1.0.0 są akceptowane.
Rozwiązywanie problemów
Minimum jest wyższe niż w regule
Natywna minimalna ilość z karty produktu jest wyższa: wygrywa, zaokrąglona do wielokrotności. Pokazują to symulator i kontrole spójności.
Klient nie może osiągnąć minimum
Stan magazynowy jest niższy niż minimum, a zamówienia przy braku towaru są wyłączone. Uzupełnij stan, zezwól na zamówienia przy braku towaru lub obniż minimum.
Koszyk blokuje komunikat natywnego minimum
To minimalna wartość zakupu z Preferencje sklepu > Ustawienia zamówień. Ustaw ją na 0 lub wybierz „zastępuje” w ustawieniach.
Przyciski +/- zmieniają ilość o 1
Szablon nie używa standardowych selektorów. Reguła nadal obowiązuje na serwerze: ilość jest dopasowywana lub odrzucana, a zamówienie blokowane.
Zgodność
- PrestaShop 1.7.8, 8.x i 9.x, ten sam ZIP (testowane z PHP 7.4, 8.1 i 8.5).
- Szablony Classic i Hummingbird.
- Multistore: reguły i minima zapisywane dla każdego sklepu.
- Wiele walut: kwoty przeliczane po bieżącym kursie.
- Interfejs w języku angielskim, francuskim, hiszpańskim, niemieckim, włoskim, niderlandzkim, polskim i portugalskim.