Kupony rabatowe w Hummerce to kody, które klient wpisuje w koszyku (albo dostaje w linku), żeby otrzymać rabat na zamówienie. Sklep przygotowuje kampanię z warunkami i rodzajem rabatu, a potem wydaje do niej dowolną liczbę kodów - jeden wspólny dla wszystkich klientów albo tysiące jednorazowych. Kupony wspierają mailingi, newsletter, akcje sezonowe, rekompensaty dla klientów i współpracę z partnerami.
Stan na wersję Hummerce 2.35 (ostatnie zmiany w module: 2.35.67), aktualizacja 2026-10-07.
- Jedno miejsce konfiguracji - kampania kuponowa korzysta z tych samych warunków i kalkulatorów rabatu co promocje koszykowe, więc mniej pomyłek w ustawieniach.
- Kody dla jednej osoby bez zakładania konta - kupon przypisany do adresu e-mail chroni przed przekazaniem kodu dalej (reklamacje, przeprosiny, oferty dla stałych klientów, także dla gości bez konta).
- Wyjątek w kampanii bez tworzenia nowej akcji - jeden kod z wyższym rabatem (np. dla partnera lub influencera) w tej samej kampanii.
- Kontrola kosztów akcji - limit użyć na pojedynczym kodzie i na całej kampanii, np. "pierwsze 500 zamówień".
- Kupon, który nie łączy się z inną promocją (np. z darmową dostawą albo wyprzedażą) - bez ręcznego pilnowania.
- Masowe kody do mailingów, ulotek i partnerów - generowanie tysięcy unikalnych kodów według wzoru, eksport do CSV, kody bez znaków łatwych do pomylenia.
- Kody w linkach (mailing, SMS, media społecznościowe) - klient nie musi niczego przepisywać.
- Szybkie zarządzanie listą kodów - wyszukiwanie po kodzie, filtr po kampanii i włączanie lub wyłączanie wielu kuponów jednym ruchem (od wersji 2.35.67).
- Obsługa kuponów przez asystenta AI (MCP) - sprawdzenie, co daje dany kod i dlaczego nie zadziałał, oraz tworzenie nowych kodów.
Zrzuty ze sklepu demonstracyjnego Hummerce (dane testowe).

- Kampania to promocja koszykowa oznaczona jako Promocja kuponowa. Taka promocja działa tylko wtedy, gdy klient wpisze kod z tej kampanii.
- Kampania określa: rodzaj i wysokość rabatu (Kalkulator cen), dla kogo (klienci zalogowani albo niezalogowani, kryterium klientów), na jakie towary, warunki koszyka (minimalna lub maksymalna wartość, liczba sztuk, sposób dostawy lub płatności), czas trwania, widoki (sklepy), w których działa, czy łączy się z kolejnymi promocjami, oraz łączny limit użyć wszystkich kuponów kampanii.
- Kupon to kod przypisany do jednej kampanii. Na kuponie można dodatkowo ustawić: Włączony, Maksymalną liczbę użyć, własną Datę rozpoczęcia i Datę zakończenia (kupon może być ważny dłużej niż kampania), Klienta (kupon tylko dla jednego, zalogowanego klienta), Powiązany e-mail, Przesłonięcie kalkulatora rabatu, Wykluczone promocje koszyka oraz Aktywację kuponu przez URL.
- Aktywny to status liczony automatycznie: czy kupon jest włączony, w okresie ważności i nie przekroczył limitu. System odświeża go domyślnie co godzinę, a w kuponie można go odświeżyć od razu.
- Rabat liczy kalkulator wybrany w kampanii. Dla kampanii kuponowych sensowne są przede wszystkim: Rabat procentowy na towary (z opcjonalną ceną minimalną i limitem sztuk), Rabat kwotowy za towary, Rabat kwotowy na sumę zamówienia, Sztywna cena oraz kalkulatory dostawy i płatności, np. Sztywna cena dostawy.
- W Przesłonięciu kalkulatora rabatu na kuponie można wybrać tylko cztery kalkulatory: rabat kwotowy na sumę zamówienia, rabat kwotowy za towary, rabat procentowy na towary, sztywna cena. Parametry wpisane na kuponie zastępują parametry kampanii.
- Przy rabacie ograniczonym do części sztuk (np. 1 z 2) suma koszyka jest poprawna, a cena jednostkowa pozycji pokazuje średnią.
- Sklepy z dedykowanymi rabatami mogą potrzebować dodatkowego kalkulatora - dodaje się go jak do innych promocji koszykowych.
- Limit na kuponie decyduje, ile razy można użyć danego kodu (np.
1 dla kodu jednorazowego, 10000 dla kodu akcji). Limit na kampanii ogranicza łączną liczbę użyć wszystkich kodów (np. "pierwsze 500 zamówień").
- Użycie liczy się w chwili złożenia zamówienia, nie w chwili wpisania kodu w koszyku.
- Ważność wyznaczają daty kuponu, a gdy ich nie ma - daty kampanii. Godziny i dni tygodnia ustawia się w kampanii.
- Domyślnie w koszyku może być jeden kupon - nowy kod zastępuje poprzedni. Obsługę wielu kuponów naraz włączamy w konfiguracji technicznej.
- Kupon "raz na klienta" (ten sam kod użyty tylko raz z danego adresu e-mail) to dodatkowy moduł obsługujący oba mechanizmy kuponów, włączany w ramach wdrożenia.
- Kupon z Powiązanym e-mailem działa tylko wtedy, gdy adres w zamówieniu jest taki sam jak adres przypisany do kuponu (wielkość liter nie ma znaczenia).
- U klienta zalogowanego system porównuje adres z konta. U gościa kupon trafia do koszyka jako oczekujący, bez rabatu, a koszyk prosi o podanie adresu - po wpisaniu zgodnego adresu rabat się nalicza.
- Przy składaniu zamówienia system sprawdza adres jeszcze raz. Jeśli klient zmieni e-mail w formularzu zamówienia, zamówienia nie da się złożyć, dopóki nie poprawi adresu albo nie usunie kuponu.
- Adres przypisany do kuponu jest w koszyku częściowo zamaskowany.

- Kody można dodawać pojedynczo albo generować partią według wzoru. Partia dostaje wspólne ustawienia: limit użyć, daty, powiązany e-mail, przesłonięcie kalkulatora.
- Znaki specjalne we wzorze:
? - kolejna cyfra numeru porządkowego (np. LATO-??? -> LATO-001, LATO-002), ! - losowa cyfra, # - losowa mała litera, @ - losowa mała litera lub cyfra, $ - losowa wielka litera, % - losowa wielka litera lub cyfra, * - losowa litera lub cyfra.
- Generator pomija znaki łatwe do pomylenia (domyślnie
0 O o I l 1), żeby kody dało się bezpiecznie przepisać z papieru albo podyktować przez telefon.
- Kody są unikalne w całym sklepie. Jeśli wzór daje za mało kombinacji, generowanie kończy się komunikatem o konflikcie - wtedy trzeba wydłużyć losową część wzoru.
- Listę kodów kampanii można wyeksportować do pliku CSV, np. do wysyłki mailingowej.
- Kupon z włączoną Aktywacją kuponu przez URL można przekazać jako link, np.
https://sklep.pl/?coupon=LATO-001. Parametr działa na każdej stronie sklepu, także w linku do udostępnionego koszyka.
- Jeśli kupon z linku nie może być jeszcze użyty (np. pusty koszyk), sklep go zapamiętuje i próbuje dodać przy kolejnych zmianach w koszyku.
- Kampania kuponowa jest jedną z promocji koszykowych i przechodzi przez nie w tej samej kolejności co pozostałe.
- Łączy się z następnymi promocjami w kampanii decyduje, czy po rabacie z kuponu działają kolejne promocje.
- Wykluczone promocje koszyka na kuponie wyłączają wskazane promocje, gdy kupon jest w koszyku - np. kod -20% nie łączy się z darmową dostawą. Pusta lista na kuponie oznacza, że obowiązuje lista wykluczeń z kampanii.
- Ceny w koszyku najpierw przechodzą przez reguły cennika i promocje produktowe, a dopiero potem przez promocje koszykowe, w tym kupony.
- Kupony nowego mechanizmu mają własną pozycję w menu panelu - Kupony rabatowe. Stare listy noszą w menu dopisek "(nieaktywne)" (Lista kuponów (nieaktywne), Kampanie kuponowe (nieaktywne)), a między listą starych i nowych kuponów jest przycisk przejścia.
- Listę można zawęzić filtrem Filtruj według promocji (kampanii), filtrami Włączony i Aktywny oraz wyszukiwarką po kodzie kuponu - wielkość liter nie ma znaczenia. Kolumna Promocja koszyka pokazuje kampanię każdego kuponu.
- Eksport Eksportuj CSV uwzględnia tę samą frazę wyszukiwania, więc do pliku trafiają tylko kupony widoczne po wyszukaniu.
- Operacja grupowa zmienia ustawienie Włączony na zaznaczonych kuponach (włączenie lub wyłączenie). Innych pól - np. dat - w ten sposób nie zmienia się.
- Zamówienie zapisuje użyte kupony: w szczegółach zamówienia w panelu widać parametr "Symbol kuponu".
- Kupon pokazuje Liczbę użyć, a kampania - łączną liczbę użyć swoich kuponów.
- Zamówienia z danym kodem można wyfiltrować na liście zamówień warunkiem parametru
_coupons w kryteriach listy - razem z pozostałymi filtrami (status, daty, płatność).
- Wpisanie kodu w koszyku i jego użycie trafiają do historii sklepu.
|
Stary mechanizm (kampanie kuponowe) |
Nowy mechanizm |
| Warunki |
własny zestaw: kategorie, towary, klient, wartość zamówienia, daty |
pełne warunki promocji koszykowych (klienci, towary, koszyk, dostawa, płatność, czas, widoki) |
| Rabat |
procentowy lub kwotowy, rabat na dostawę |
kalkulatory promocji koszykowych, przesłonięcie rabatu na kuponie |
| Dziedziczenie |
niewypełnione dane kuponu brane z kampanii - łatwo o rozbieżności |
kupon dziedziczy z kampanii, nadpisuje tylko to, co ustawiono na kuponie |
| Powiązanie z e-mailem |
brak |
tak |
| Wykluczenie promocji przez kupon |
brak |
tak |
| Kupon za newsletter |
tak |
nie (zob. niżej) |
- Oba mechanizmy mogą działać w sklepie jednocześnie. Po wpisaniu kodu sklep najpierw szuka go wśród starych kuponów, a potem wśród nowych.
- Nowy mechanizm nie przenosi starych kuponów automatycznie. Przejście polega na utworzeniu odpowiednich kampanii kuponowych i wygenerowaniu kodów na nowo (albo dokończeniu starych akcji w starym mechanizmie).
- Stary moduł można wyłączyć dopiero wtedy, gdy nie korzysta z niego żadna aktywna akcja ani kupon za newsletter.
- Po potwierdzeniu zapisu do newslettera sklep generuje klientowi unikalny kod, przypisuje go do konta klienta i wysyła mailem.
- Kod powstaje w kampanii wskazanej w konfiguracji, według wzoru, z domyślnym limitem użyć i liczbą dni ważności.
- Klient, który wypisze się i zapisze ponownie, nie dostaje nowego kodu - dostaje ponownie ten sam albo informację, że promocja została już wykorzystana.
- Kupon za newsletter działa na starym mechanizmie kuponów - sklep, który go używa, musi mieć włączony stary moduł i kampanię starego typu.
- Od wersji 2.34 - w starszych wersjach działa tylko stary mechanizm kuponów.
- Od wersji 2.35 w standardowej konfiguracji nowych sklepów stary mechanizm jest wyłączony. Sklepy, które go używają, mogą korzystać z niego dalej, równolegle z nowym.
- Lista kuponów nowego mechanizmu w osobnym menu, z filtrem po promocji, wyszukiwarką i operacją grupową Włączony: od wersji 2.35.67.
- Ostatnie zmiany w module: wersja 2.35.67.
- Promocje koszykowe - kampania kuponowa to promocja koszykowa.
- Szablon sklepu: BS5 ma pełną obsługę, także kuponów z powiązanym e-mailem. BS4 i starsze - wpisywanie kodów działa, ale koszyk nie pokazuje kuponu oczekującego na e-mail ani pola do jego podania (wymaga rozszerzenia szablonu).
- Kupon "raz na klienta" - dodatkowy moduł, włączany przy wdrożeniu.
- Kupon za newsletter - stary moduł kuponów i zapis do newslettera z potwierdzeniem.
- Regulamin promocji i zasady łączenia rabatów - sklep ustala we własnym zakresie.
- Działa po aktualizacji do wersji 2.34 lub nowszej - moduł włącza się sam, a kampanie tworzy się w panelu bez prac programistycznych. Prace są potrzebne w tych przypadkach:
- przejście ze starego mechanizmu: odtworzenie aktywnych kampanii i kodów w nowym mechanizmie, testy, wyłączenie starego modułu,
- kupony z powiązanym e-mailem w szablonie BS4 lub starszym - rozszerzenie koszyka o pole adresu i informację o kuponie oczekującym,
- kupon "raz na klienta" - włączenie modułu i parametrów,
- dedykowany rodzaj rabatu - nowy kalkulator,
- testy na środowisku testowym i uruchomienie produkcyjne.
- Minimalny szacowany czas:
- szablon BS5, sklep bez starych kuponów - 0 h (konfiguracja kampanii we własnym zakresie) albo od 1 h, gdy przygotowujemy pierwszą kampanię i testy,
- przejście ze starego mechanizmu - od 4 h,
- kupony z powiązanym e-mailem w szablonie BS4 - od 6 h,
- kupon "raz na klienta" - od 2 h.
- Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
- Od czego zależy czas: szablon sklepu (w BS5 obsługa jest kompletna, w BS4 i starszych trzeba rozszerzyć koszyk), liczba i złożoność aktywnych kampanii starego typu do odtworzenia, indywidualne zmiany w obsłudze kuponów, liczba języków do uzupełnienia komunikatów, wersja sklepu (starsza niż 2.34 wymaga najpierw aktualizacji - wycena osobno), dedykowane kalkulatory rabatów (wycena osobno).
- Stare kupony nie przenoszą się do nowego mechanizmu automatycznie - aktywne akcje trzeba odtworzyć albo dokończyć w starym mechanizmie.
- Kupon za newsletter działa tylko na starym mechanizmie kuponów.
- Jedna osoba może zapisać się do newslettera kilka razy z różnych adresów e-mail i dostać kilka kodów - nie ma zabezpieczenia przed wielokrotną rejestracją.
- Pełna obsługa kuponów z powiązanym e-mailem jest tylko w szablonie BS5. W BS4 i starszych, bez rozszerzenia szablonu, taki kupon trafia do koszyka bez rabatu i bez wyjaśnienia dlaczego.
- Domyślnie jeden kupon w koszyku - nowy kod zastępuje poprzedni.
- Na kuponie można przesłonić tylko cztery kalkulatory rabatu; rabatów na dostawę i płatność nie da się przesłonić na pojedynczym kuponie (ustawia się je w kampanii).
- Godziny i dni tygodnia ustawia się tylko w kampanii, nie na pojedynczym kuponie.
- Przy rabacie na część sztuk cena jednostkowa pozycji w koszyku to średnia - suma jest poprawna.
- Kupon "raz na klienta" rozpoznaje klienta po adresie e-mail, więc inny adres pozwala użyć kodu ponownie.
- Status Aktywny odświeża się domyślnie co godzinę - kupon, który stał się nieważny, może chwilę widnieć na liście jako aktywny (w koszyku ważność jest sprawdzana na bieżąco).
- Brak raportu wykorzystania kuponów w panelu (wartość zamówień, rabat udzielony z kodu) - dostępne są liczba użyć, parametr kuponu w zamówieniu i filtr listy zamówień.
- Brak importu kodów z pliku (np. kodów od partnera).
- Operacja grupowa na liście kuponów zmienia tylko ustawienie Włączony - dat, limitów użyć i pozostałych pól nie da się zmienić na wielu kuponach naraz.
- Przez asystenta AI nie utworzymy kampanii ani kodu w starym mechanizmie - tylko nowy kod w istniejącej kampanii.
- Nie weryfikujemy konfiguracji pod kątem zgodności z prawem - regulamin promocji, zasady łączenia rabatów i informowanie o najniższej cenie ustala sklep.
- Kupon za newsletter w nowym mechanizmie, z rozbudowanymi zasadami generowania kodów.
- Raporty wykorzystania kuponów (liczba zamówień, wartość, udzielony rabat) w panelu lub w Google Looker Studio.
- Import kodów z zewnętrznego źródła.
- Dalsze operacje grupowe na liście kuponów (np. zmiana dat i limitów użyć).
- Rabat do określonego poziomu cenowego i inne nowe kalkulatory.
- Narzędzie przenoszące stare kampanie i kupony do nowego mechanizmu.
- Godziny i dni tygodnia na pojedynczym kuponie.
Czy w Hummerce kupon rabatowy można przypisać do jednego klienta lub adresu e-mail?
Tak. Kupon z ustawieniem Powiązany e-mail działa tylko przy zamówieniu z tym adresem, także u gościa bez konta. Osobno można też przypisać kupon do jednego, zalogowanego klienta.
Czy kupon rabatowy łączy się z innymi promocjami w koszyku?
Zależy od ustawień kampanii i kuponu. Kampania decyduje, czy łączy się z kolejnymi promocjami, a na kuponie można dodatkowo wykluczyć wybrane promocje koszykowe.
Czy stare kupony rabatowe przenoszą się automatycznie do nowego mechanizmu?
Nie. Aktywne kampanie i kody trzeba odtworzyć w nowym mechanizmie albo dokończyć w starym - automatycznego przeniesienia nie ma.
Ile trwa uruchomienie kuponów rabatowych w Hummerce?
W szablonie BS5, bez starych kuponów - 0 h, konfiguracja kampanii we własnym zakresie, albo od 1 h, gdy przygotowujemy pierwszą kampanię. Przejście ze starego mechanizmu - od 4 h.
Czy kupon za zapis do newslettera działa w nowym mechanizmie kuponów?
Nie. Kupon za newsletter działa tylko na starym mechanizmie - żeby z niego korzystać, sklep musi mieć włączony stary moduł kuponów.
Czy można wygenerować naraz tysiące unikalnych kodów rabatowych do mailingu?
Tak. Generator tworzy kody według wzoru ze znakami specjalnymi (kolejny numer, losowe cyfry i litery), pomija znaki łatwe do pomylenia i pozwala wyeksportować listę do CSV.
Chcesz zobaczyć, jak kupony rabatowe mogą działać w Waszym sklepie? Umów bezpłatną prezentację.
- Kampanie: Promocja -> Promocje koszykowe, filtr Promocje kuponowe. W kampanii: Promocja kuponowa, Maksymalna ilość użyć kuponów w promocji, Kalkulator cen, Kupony (Podgląd kuponów, Generuj kupony).
- Kupony kampanii: menu Kupony rabatowe (od 2.35.67) - lista z filtrami Filtruj według promocji, Włączony i Aktywny, kolumną Promocja koszyka, wyszukiwarką po kodzie, operacją grupową zmiany Włączony, przyciskami Dodaj kupon, Generuj kupony, Eksportuj CSV oraz przejściem do starej listy (Lista kuponów (nieaktywne)).
- Kupon: Kod kuponu, Kampania promocyjna, Włączony, Aktywny (z odświeżeniem Aktywuj kupon), Maksymalna liczba użyć, Liczba użyć, Klient, Powiązany e-mail, Data rozpoczęcia, Data zakończenia, Wykluczone promocje koszyka, Przesłonięcie kalkulatora rabatu, Aktywacja kuponu przez URL.
- Konfiguracja w panelu: grupa Nowe kupony rabatowe - Zezwól na aktywację kuponu przez URL (domyślnie tak), Włącz automatyczną walidację (domyślnie tak), Interwał walidacji (sekundy) (domyślnie 3600), Wykluczone znaki (domyślnie
0OoIl1), Zezwól na wiele kuponów (ustawienie techniczne, domyślnie nie).
- Konfiguracja kuponu za newsletter: grupa Kupon za newsletter - Symbol kampanii newsletterowej, Szablon kuponów newslettera, Domyślna maksymalna liczba użycia (domyślnie 1), Domyślna liczba dni ważności kuponu (domyślnie 30).
- Zamówienie: parametr "Symbol kuponu" w szczegółach zamówienia i pozycji zamówienia.
- Historia: wpisy "Wybrany kupon" i "Użyty kupon".
- MCP (Asystent AI - serwer MCP):
ec2_promotions_list (promocje koszykowe, w tym kuponowe), ec2_coupons_list (kupony z obu mechanizmów, z oznaczeniem, z którego pochodzą), ec2_coupon_details (co daje kod i jakie warunki musi spełnić), ec2_coupons_create (nowy kod w istniejącej kampanii - tylko w nowym mechanizmie). Wymagane uprawnienia do kuponów, takie jak w panelu.
Komunikaty nowego mechanizmu mają wartości domyślne po polsku i angielsku. Komunikaty kuponu z powiązanym e-mailem nie mają wersji niemieckiej. Zmienia się je w edytorze komunikatów.
| Klucz |
Wartość domyślna |
coupon.invalid |
Nieprawidłowy kupon |
coupon.disabled |
Ten kupon jest wyłączony |
coupon.inactive |
Ten kupon nie jest aktywny |
coupon.notYetValid |
Ten kupon nie jest jeszcze ważny |
coupon.expired |
Ten kupon wygasł |
coupon.notValidHour |
Ten kupon nie jest ważny o tej porze |
coupon.notValidDay |
Ten kupon nie jest ważny w dniu dzisiejszym |
coupon.usageLimitExceeded |
Ten kupon został użyty maksymalną liczbę razy |
coupon.noPromotion |
Ten kupon nie ma przypisanej promocji |
coupon.promotionDisabled |
Promocja dla tego kuponu jest wyłączona |
coupon.promotionInactive |
Promocja dla tego kuponu nie jest aktywna |
coupon.promotionNotYetValid |
Promocja dla tego kuponu jeszcze się nie rozpoczęła |
coupon.promotionExpired |
Promocja dla tego kuponu wygasła |
error.coupon.customerInvalid |
Ten kupon jest przeznaczony dla innego klienta. Nie możesz z niego skorzystać. |
error.coupon.minOrderValue |
Ten kupon ma określoną minimalną wartość zamówienia {1}. Wartość Twojego zamówienia wynosi {0}. |
error.coupon.maxOrderValue |
Ten kupon ma określoną maksymalną wartość zamówienia {1}. Wartość Twojego zamówienia wynosi {0}. |
error.coupon.noCoupon |
Nieprawidłowy symbol kuponu - {0}. |
error.coupon.empty |
Podaj kod kuponu. |
error.coupon.oneTime |
Przykro nam, ale nie możesz użyć tego kuponu drugi raz. |
| Klucz |
Wartość domyślna |
info.coupon.emailPending |
Kupon ({0}) oczekuje na uzupełnienie danych - jest przypisany do konkretnego adresu e-mail. Podaj ten adres w panelu po lewej stronie koszyka, aby naliczyć rabat. |
error.coupon.emailMismatchOnOrder |
Kupon ({0}) jest przypisany do konkretnego adresu e-mail. Adres podany w zamówieniu nie pasuje - popraw adres e-mail lub usuń kupon, zanim złożysz zamówienie. |
msg.cart.couponEmail.title |
Adres e-mail do kuponu |
msg.cart.couponEmail.apply |
Zapisz e-mail |
msg.cart.couponEmail.matched |
Adres potwierdzony - kupon zostanie naliczony. |
msg.cart.couponEmail.mismatch |
Aktualny adres e-mail nie pasuje do adresu przypisanego do kuponu. |
| Szablon |
Odbiorca |
Kiedy |
couponForNewsletter |
klient |
potwierdzenie zapisu do newslettera - nowy kod albo ponowne przypomnienie kodu |
Zmienne w szablonie: $couponSymbol (kod kuponu), $customer (klient), $isFirstTime (czy kod został właśnie wygenerowany), $isCouponStillValid (czy kod można jeszcze użyć).