¶ Promocje koszykowe - rabaty zależne od koszyka
Promocje koszykowe w Hummerce to reguły, które liczą rabat na podstawie zawartości całego koszyka: jego wartości, liczby sztuk, wybranej dostawy i płatności, klienta i czasu zakupu. Obniżają ceny towarów, sumę zamówienia, koszt dostawy albo płatności - sklep ustawia je samodzielnie w panelu, bez prac programistycznych.
Stan na wersję Hummerce 2.34 (ostatnie zmiany w module: 2.34.33), aktualizacja 2026-09-28.
¶ Korzyści i zastosowania
- Typowe akcje bez programisty: darmowa dostawa od progu, rabat od wartości koszyka, rabat za liczbę sztuk, taniej przy płatności online, rabat dla klientów firmowych.
- Motywowanie do większego koszyka: progi wartości i ilości, a w koszyku komunikat o przekroczeniu progu.
- Akcje ograniczone w czasie: daty, godziny i dni tygodnia (np. "happy hours", weekendowa darmowa dostawa) - promocja włącza się i wyłącza sama.
- Promocje dla wybranych grup: kryterium klientów (grupa, konto firmowe, zgoda na newsletter) i widoki (osobne zasady dla B2B i B2C, dla wersji językowych).
- Rabat na część towarów: kryterium towarów w kalkulatorze i limit sztuk, np. "przy 3 książkach najtańsza -50%" - klient dokłada do koszyka kolejną książkę zamiast kupować dwie.
- Kontrola łączenia rabatów: kolejność i Łączy się z następnymi promocjami, ceny minimalne na końcu listy.
- Szybkie przygotowanie podobnej akcji: kopia istniejącej promocji, wyłączona do czasu sprawdzenia.
- Sprawdzenie ceny koszyka przez asystenta AI (MCP) bez zakładania koszyka i bez zamówienia testowego.
¶ Jak to wygląda
Zrzuty ze sklepu demonstracyjnego Hummerce (szablon Bootstrap 5) i jego panelu. Warunek koszyka, kalkulator i koszyk pokazują przykład "trzecia książka za pół ceny".
¶ Lista promocji koszykowych
¶ Promocja - warunki ogólne
¶ Warunek koszyka - co najmniej 3 książki
¶ Kalkulator - najtańsza książka 50% taniej
¶ Zastosowane promocje w koszyku - książka za pół ceny i darmowa dostawa
¶ Zasady działania
¶ Z czego składa się promocja
- Symbol - unikalna nazwa promocji w panelu.
- Włączony - ręczne włączenie lub wyłączenie. Wyłączona promocja nie działa, ale zachowuje całą konfigurację.
- Aktywna - status liczony automatycznie: promocja jest włączona i trwa jej Czas trwania. System odświeża go co 5 minut. W koszyku daty i godziny są sprawdzane na bieżąco.
- Promocja kuponowa - promocja działa tylko po wpisaniu kodu z jej kampanii (zob. Kupony rabatowe).
- Warunki ogólne - wszystkie muszą być spełnione:
- Dla klientów niezalogowanych, Dla klientów zalogowanych,
- Kryterium klientów (dla zalogowanych) - np. grupa klientów, konto firmowe, zgoda na newsletter, data ostatniej wizyty. Kryteria łączą się ze sobą (każde kolejne zawęża grupę),
- Kryterium towarów - promocja działa, gdy w koszyku jest przynajmniej jeden pasujący towar (kategoria, producent, cena, parametr, dostępność i inne),
- Kryterium działa na - wszystkie produkty, produkty pojedyncze i zestawy albo komponenty zestawów,
- Czas trwania - Ważne od, Ważne do, Godziny dostępności promocji, Dni tygodnia. Puste pola oznaczają brak ograniczenia,
- Dla wszystkich widoków albo wybrane Widoki (sklepy, wersje językowe, B2B i B2C).
- Liczenie wg kwot brutto i Obliczenia wg waluty - czy progi i kwoty w promocji są brutto czy netto i w jakiej walucie. Domyślnie według konfiguracji sklepu.
- Warunki koszyka - dodatkowe progi (niżej). Promocja bez warunków koszyka działa zawsze, gdy spełnia warunki ogólne.
- Kalkulator cen - co i o ile promocja obniża (niżej).
- Łączy się z następnymi promocjami - czy po tej promocji mają działać kolejne.
¶ Warunki koszyka
- Każdy warunek może zawierać:
- Wartość koszyka od - do, opcjonalnie tylko dla towarów spełniających kryteria, np. "powyżej 300 zł za rośliny, bez producenta X",
- Ilość towarów od - do, opcjonalnie tylko dla wybranych towarów, np. "co najmniej 3 sztuki z kategorii Kawa",
- Wartość zamówienia od - do - wartość towarów razem z kosztem dostawy i płatności,
- Sposób płatności i Sposób dostawy - promocja działa tylko przy wybranych metodach.
- W jednym warunku wszystkie wypełnione pola muszą być spełnione jednocześnie.
- Warunki łączy się operatorem I albo Lub, ustawianym przy warunku - np. "wartość koszyka od 200 zł Lub co najmniej 5 sztuk".
- Warunek można oznaczyć jako nieaktywny zamiast go usuwać.
- Wartość koszyka liczona jest po rabatach z promocji, które są wyżej na liście.
¶ Rodzaje rabatów - kalkulatory
| Kalkulator | Co robi |
|---|---|
| Rabat procentowy na towary | Obniża towary o procent. Opcjonalnie: kryterium towarów objętych rabatem, cena minimalna po rabacie, limit sztuk z rabatem (wybieranych od najtańszych, od najdroższych albo wg kolejności w koszyku), rabat procentowy na dostawę i płatność |
| Rabat kwotowy za towary | Obniża towary o kwotę. Opcjonalnie: kryterium towarów, cena minimalna, rabat kwotowy na dostawę i płatność |
| Rabat kwotowy na sumę zamówienia | Odejmuje kwotę od całego zamówienia, z ceną minimalną za towar, dostawę i płatność |
| Sztywna cena | Ustala stałą cenę towarów objętych promocją |
| Cena pobierana z parametru | Cena towaru z wybranego parametru towaru |
| Cena pobierana z wybranego cennika | Cena towaru z cennika (zob. Cenniki i ceny indywidualne) |
| Kalkulator ceny usługi | Cena usługi (np. montażu, ubezpieczenia) liczona jako procent ceny towarów |
| Sztywna cena dostawy / płatności | Stała cena dostawy lub płatności, np. darmowa dostawa |
| Cena dostawy / płatności z parametru | Cena dostawy lub płatności z parametru |
| Próg darmowej dostawy / płatności z parametru | Darmowa dostawa lub płatność powyżej Ceny granicznej ustawionej na danym sposobie dostawy lub płatności |
| Standardowa cena dostaw i płatności | Podstawowe ceny dostawy i płatności z ich konfiguracji |
| Minimalna cena za sztukę / za dostawę / płatność | Pilnuje, żeby łączne rabaty nie zeszły poniżej ceny minimalnej. Działa jako ostatnia promocja na liście |
| Kalkulator starego mechanizmu kuponów | Nalicza rabaty ze starego mechanizmu kuponów (zob. Kupony rabatowe) |
- Kryterium towarów w kalkulatorze decyduje, które towary dostaną rabat. Kryterium towarów w warunkach ogólnych decyduje, czy promocja w ogóle zadziała. Oba kryteria muszą się pokrywać - jeśli się wykluczają, promocja się dopasuje, ale nie da rabatu.
- Nowe sklepy dostają trzy promocje startowe: standardowe ceny dostaw i płatności, próg darmowej dostawy i kalkulator starych kuponów.
¶ Przykład: trzecia książka za pół ceny
Promocja w sklepie demonstracyjnym: przy zakupie co najmniej 3 książek najtańsza z nich kosztuje 50% mniej.
| Element promocji | Ustawienie |
|---|---|
| Warunki ogólne | Kryterium towarów: towary w kategorii Książki; dla klientów zalogowanych i niezalogowanych; Dla wszystkich widoków; bez dat zakończenia |
| Warunek koszyka | Ilość towarów od 3, zsumowana dla kategorii Książki - skarpetki czy torba w koszyku nie liczą się do progu |
| Kalkulator | Rabat procentowy na towary 50%, kryterium towarów objętych rabatem: kategoria Książki, limit produktów podlegających promocji 1, porządek wyboru: od najtańszych |
| Kolejność | na końcu listy, za progiem darmowej dostawy; Łączy się z następnymi promocjami = Tak |
| Opis w koszyku | opis promocji: "Trzecia książka za pół ceny! Przy zakupie co najmniej 3 książek najtańsza z nich kosztuje 50% mniej.", pokaż w koszyku = Tak |
- Koszyk z książkami za 98 zł, 89 zł i 65 zł: najtańsza kosztuje 32,50 zł. Wartość przekracza też próg darmowej dostawy - koszyk pokazuje obie promocje (zrzut wyżej).
- Przy 2 książkach promocja się nie dopasowuje. Przy 6 książkach rabat dostaje nadal jedna sztuka - zasada "co trzecia sztuka taniej" wymaga nowego kalkulatora.
¶ Kolejność i łączenie promocji
- Promocje działają po kolei, w kolejności ustawionej na liście promocji koszykowych (Ustaw kolejność). Każda kolejna liczy od wyniku poprzednich.
- Na początku listy powinna być promocja ze standardowymi cenami dostaw i płatności - kolejne promocje obniżają te ceny.
- Łączy się z następnymi promocjami = Nie - jeśli ta promocja naliczyła rabat, kolejne promocje z listy już nie działają. Jeśli się nie dopasowała albo nic nie zmieniła, system sprawdza kolejne.
- Promocje z ceną minimalną ustawia się na końcu listy.
¶ Kopiowanie promocji
- Każdą promocję można skopiować z poziomu jej edycji (Operacje -> Kopiuj promocję koszykową).
- Kopia dostaje symbol z dopiskiem
Copy(przy kolejnych kopiachCopy1,Copy2) i jest wyłączona - nie zadziała, dopóki sklep jej nie sprawdzi i nie włączy. - Kopia przenosi warunki ogólne, widoki, kalkulator z parametrami i wszystkie warunki koszyka.
¶ Zastosowane promocje w koszyku i w zamówieniu
- Koszyk w szablonie Bootstrap 5 może pokazać w podsumowaniu sekcję Zastosowane promocje koszyka z opisem każdej promocji, która zmieniła cenę - np. "Trzecia książka za pół ceny!".
- W szablonie Bootstrap 4 nie obsługujemy prezentacji promocji w koszyku - rabaty się naliczają, ale koszyk nie pokazuje opisów promocji.
- Opis ustawia się w promocji w polu Opis promocji (edytor HTML, osobno dla każdego języka) i włącza polem Pokaż w koszyku. Promocja bez tych ustawień działa, ale nie ma opisu w koszyku.
- Przy kilku promocjach opisy pojawiają się w kolejności promocji na liście.
- Zamówienie zapisuje promocje koszykowe: w szczegółach zamówienia w panelu widać Reguły promocji koszykowych - dopasowane i użyte (te, które zmieniły wartość zamówienia).
- Opisy promocji towarowych na karcie towaru i przy pozycji koszyka ustawia się w promocjach towarowych.
¶ Promocje specjalne (gratisy z limitem)
- Dodatkowy moduł: promocja, w której klient dodaje do koszyka towar w cenie promocyjnej (np. gratis) z osobnego miejsca w sklepie.
- Promocja ustala maksymalną ilość jednego produktu podlegającego promocji i maksymalną ilość różnych produktów w promocji. Po przekroczeniu limitu koszyk pokazuje komunikat i prosi o usunięcie nadmiarowych towarów.
- Moduł włącza się w ramach wdrożenia. Miejsce w sklepie, z którego klient dodaje towar promocyjny, przygotowuje się w szablonie.
¶ Wersja
- Od wersji 2.25 - w starszych wersjach działała poprzednia polityka cenowa, bez promocji koszykowych.
- Od wersji 2.30 - poprawione kryteria (drzewo kategorii w kilku kryteriach jednej promocji) i wyłączanie promocji na liście bez utraty warunków koszyka.
- Od wersji 2.32 - kopiowanie promocji.
- Od wersji 2.33 - prezentacja zastosowanych promocji w koszyku (szablon Bootstrap 5).
- Od wersji 2.34 - kampanie nowych kuponów rabatowych jako promocje koszykowe.
- Ostatnie zmiany w module: wersja 2.34.33.
¶ Zależności
- Nowa polityka cenowa (reguły cennika, promocje towarowe, promocje koszykowe) - zob. Polityka cenowa - przegląd. Sklep na starej polityce cenowej musi najpierw przejść na nową.
- Ceny towarów z reguł cennika i promocji towarowych - promocje koszykowe liczą od nich.
- Sposoby dostawy i płatności - progi darmowej dostawy (Cena graniczna) ustawia się na sposobie dostawy (zob. Sposoby dostawy - przegląd).
- Kupony rabatowe - kampanie kuponowe to promocje koszykowe (zob. Kupony rabatowe).
- Szablon sklepu: Bootstrap 5 - rabaty i sekcja Zastosowane promocje koszyka w koszyku; Bootstrap 4 i starsze - rabaty działają, prezentacja promocji w koszyku nie jest obsługiwana.
- Promocje specjalne - dodatkowy moduł i miejsce w szablonie.
- Zasady promocji (regulamin, informowanie o najniższej cenie) - sklep ustala we własnym zakresie.
¶ Wdrożenie
- Działa po aktualizacji - sklep na nowej polityce cenowej tworzy i zmienia promocje w panelu sam. Prace są potrzebne w tych przypadkach:
- przejście ze starej polityki cenowej na nową (odtworzenie dotychczasowych rabatów, cen dostaw i płatności w regułach, testy),
- przygotowanie promocji i testy na środowisku testowym na zlecenie sklepu,
- opisy zastosowanych promocji w koszyku (tylko szablon Bootstrap 5) - założenie parametrów opisu promocji i pokazywania w koszyku, jeśli sklep ich nie ma,
- promocje specjalne - włączenie modułu i miejsce w sklepie do dodawania towarów promocyjnych,
- dedykowany rodzaj rabatu - nowy kalkulator,
- uruchomienie produkcyjne.
- Minimalny szacowany czas:
- konfiguracja promocji we własnym zakresie - 0 h,
- przygotowanie i testy promocji na zlecenie sklepu - od 1 h,
- opisy zastosowanych promocji w koszyku, szablon Bootstrap 5 - od 1 h,
- prezentacja promocji w koszyku, szablon Bootstrap 4 - nie jest obsługiwana; wymaga indywidualnego wdrożenia widoku koszyka, wycenianego osobno,
- nowy kalkulator - od 4 h,
- przejście ze starej polityki cenowej - od 8 h.
- Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
- Od czego zależy czas:
- liczba i złożoność promocji do przygotowania lub odtworzenia,
- szablon sklepu - w Bootstrap 5 prezentacja promocji w koszyku jest gotowa, w Bootstrap 4 jej nie ma,
- rodzaj rabatu - czy wystarczą standardowe kalkulatory,
- liczba języków opisów promocji,
- wersja sklepu - sklep na wersji starszej niż 2.25 albo na starej polityce cenowej wymaga najpierw aktualizacji (wycena osobno),
- integracje, które przekazują rabaty dalej (ERP, marketplace) - wycena osobno.
¶ Ograniczenia
- Brak podglądu działania promocji w panelu - efekt sprawdza się w koszyku na środowisku testowym albo przez asystenta AI (
ec2_cart_price_preview). - Promocja, której kryterium kalkulatora wyklucza się z kryterium towarów promocji, dopasowuje się, ale nie daje rabatu - panel o tym nie ostrzega.
- Łączy się z następnymi promocjami = Nie zatrzymuje kolejne promocje tylko wtedy, gdy ta promocja faktycznie naliczyła rabat.
- Przy mieszaniu operatorów I i Lub w wielu warunkach łatwo o nieoczekiwany wynik - złożone zasady lepiej rozdzielić na osobne promocje.
- Wartość koszyka w warunkach liczona jest po rabatach z promocji wyżej na liście - zmiana kolejności może zmienić to, czy klient przekroczy próg.
- Kalkulatory ceny minimalnej działają prawidłowo tylko na końcu listy.
- W szablonie Bootstrap 4 nie obsługujemy prezentacji promocji w koszyku - rabaty się naliczają, ale klient nie widzi opisów zastosowanych promocji. Prezentacja działa tylko w szablonie Bootstrap 5.
- Parametry opisu promocji i pokazywania w koszyku trzeba mieć założone w sklepie.
- Limit sztuk z rabatem jest stały - "najtańsza z 3 książek -50%" przy 6 książkach nadal obniża jedną sztukę.
- Koszyk pokazuje tylko promocje, które zmieniły cenę - nie informuje, ile brakuje do progu promocji.
- Komunikaty promocji nie mają wersji niemieckiej.
- Kopia promocji nie przenosi dodatkowych parametrów zapisanych na poszczególnych warunkach koszyka - po skopiowaniu warto sprawdzić warunki.
- Przez REST API nie da się zarządzać promocjami koszykowymi. Przez MCP nie zmienimy warunków koszyka, czasu trwania, widoków, opisu w koszyku ani łączenia z następnymi promocjami i nie usuniemy promocji - to robi się w panelu.
- Promocja utworzona przez MCP nie ma ustawionych widoków - nie działa, dopóki w panelu nie zaznaczy się Dla wszystkich widoków albo wybranych widoków.
- Każda aktywna promocja wydłuża liczenie koszyka - przy dużej liczbie promocji warto wyłączać zakończone.
- Nie weryfikujemy zadania pod kątem zgodności z prawem (np. licencje przekazanych materiałów, RODO, regulamin sklepu).
¶ Potencjał rozwoju
- Podgląd działania promocji w panelu (wycena przykładowego koszyka przy edycji).
- Informacja w koszyku, ile brakuje do progu promocji (np. "jeszcze 30 zł do darmowej dostawy").
- Nowe kalkulatory, np. "kup X, dostaniesz Y", "co trzecia sztuka taniej", rabat do określonego poziomu cenowego.
- Obsługa warunków koszyka, czasu trwania i widoków przez asystenta AI i REST API.
- Prezentacja zastosowanych promocji w szablonie Bootstrap 4.
- Ostrzeżenie w panelu, gdy kryteria promocji i kalkulatora się wykluczają.
¶ Najczęstsze pytania
Czy Hummerce obsługuje darmową dostawę od progu wartości koszyka?
Tak, kalkulatorem progu darmowej dostawy powiązanym z Ceną graniczną ustawioną na sposobie dostawy.
Czy promocje koszykowe łączą się z kuponami rabatowymi?
Tak - kampanie kuponowe to również promocje koszykowe, ustawiane jako promocja kuponowa z własnym kodem.
Czy promocja koszykowa działa tylko dla wybranych klientów lub widoków?
Tak. Kryterium klientów (grupa, konto firmowe, zgoda na newsletter) i widoki (B2B, B2C, wersje językowe) zawężają, dla kogo promocja obowiązuje.
Czy klient widzi w koszyku, jaka promocja obniżyła cenę?
Tak, w szablonie Bootstrap 5 - sekcja Zastosowane promocje koszyka pokazuje opis każdej zastosowanej promocji. W szablonie Bootstrap 4 ta prezentacja nie jest obsługiwana.
Ile trwa przygotowanie nowej promocji koszykowej?
Konfiguracja we własnym zakresie - 0 h. Przygotowanie i testy na nasze zlecenie - od 1 h. Przejście ze starej polityki cenowej na nową - od 8 h.
Czy da się zarządzać promocjami koszykowymi przez REST API?
Nie. Promocje koszykowe zakłada się i zmienia w panelu albo częściowo przez asystenta AI (MCP) - REST API nie ma na nich operacji.
¶ Powiązane
- Cenniki i ceny indywidualne i Reguły cennika - wcześniejsze etapy liczenia ceny klienta.
- Kupony rabatowe - kampanie kuponowe jako promocje koszykowe.
- Sposoby dostawy - przegląd - próg darmowej dostawy i płatności.
- Na hummerce.com: Platforma B2C, Promocje produktowe i koszykowe, Kupony rabatowe.
Chcecie zobaczyć, jak promocje koszykowe mogą działać w Waszym sklepie? Umówcie bezpłatną prezentację.
¶ Szczegóły konfiguracji
¶ Dostęp w panelu
- Panel: Promocja -> Promocje koszykowe - lista z filtrem Promocje standardowe / Promocje kuponowe / Wszystkie promocje, wyszukiwarką, włączaniem i wyłączaniem, Ustaw kolejność, historią zmian i operacją grupową usuwania.
- Edycja promocji: warunki ogólne, Warunki koszyka (Dodaj warunek), Kalkulator cen (Typ kalkulatora i jego parametry), Opis promocji, Pokaż w koszyku, zakładka Historia, Operacje -> Kopiuj promocję koszykową.
- Sposób dostawy i płatności: Cena graniczna - próg darmowej dostawy lub płatności.
- Zamówienie: Reguły promocji koszykowych (dopasowane / użyte) w szczegółach zamówienia.
¶ REST API i MCP
- REST API: brak operacji na promocjach koszykowych.
- MCP (Asystent AI - serwer MCP):
ec2_promotions_list- lista promocji koszykowych z oznaczeniem promocji kuponowych,ec2_price_rules_list,ec2_price_rule_details(zrule_type=cart_promotion) - kolejność, warunki, czas trwania, kalkulator i jego parametry,ec2_price_calculators_list- dostępne kalkulatory i ich parametry,ec2_price_rule_create,ec2_price_rule_update,ec2_price_rule_set_parameter,ec2_price_rule_delete_parameter,ec2_price_rule_reorder- nowa promocja, zmiana warunków ogólnych (klienci, kryteria, kalkulator), parametry kalkulatora, kolejność,ec2_cart_price_preview- wycena koszyka dla klienta lub gościa przez te same reguły co w sklepie, bez zapisu,- uprawnienia takie jak do reguł cennika, promocji towarowych i promocji koszykowych w panelu; wycena koszyka wymaga uprawnienia do koszyków klientów.
¶ Komunikaty sklepu
Opisy promocji w koszyku zmienia się w samej promocji (pole Opis promocji, osobno dla każdego języka). Komunikaty sklepu zmienia się w edytorze komunikatów. Komunikaty mają wartości domyślne po polsku i angielsku, bez wersji niemieckiej.
¶ Koszyk
| Klucz | Wartość domyślna |
|---|---|
msg.cart.cartPromotions |
Zastosowane promocje koszyka |
¶ Promocje specjalne
| Klucz | Wartość domyślna |
|---|---|
error.cartPromotion.differentItemsMaxQuantityReached |
Niestety osiągnięto limit różnych produktów w promocji. Usuń nadmiarowe towary z koszyka, aby spełnić warunki promocji |
error.cartPromotion.singleProductMaxQuantityReached |
Niestety osiągnięto limit dla pojedynczego produktu określonego w promocji. Usuń nadmiarowe towary z koszyka, aby spełnić warunki promocji |
error.specialCartPromotion.cannotAddItem |
Towar nie może być dodany do koszyka |
¶ Parametry
| Symbol | Obiekt | Etykieta |
|---|---|---|
_promotionDescription |
promocja koszykowa | Opis promocji - tekst w koszyku |
_showOnCartPage |
promocja koszykowa | Pokaż w koszyku |
_borderPrice |
sposób dostawy, sposób płatności | Cena graniczna - próg darmowej dostawy lub płatności |
_cartPromotionRulesThatMatch |
zamówienie | Dopasowane reguły promocji koszykowych |
_cartPromotionRulesThatChangedPrices |
zamówienie | Reguły promocji koszykowych, które zmieniły wartość zamówienia |
_specialCartPromotion |
promocja koszykowa | Promocja specjalna |
_singleItemMaxQuantity |
promocja koszykowa | Maksymalna ilość jednego produktu (podlegającego promocji) |
_maximumDifferentItemsQuantity |
promocja koszykowa | Maksymalna ilość różnych produktów w promocji (podlegających promocji) |