Dlaczego kalkulator rabatów nie działa? Diagnoza krok po kroku

Najpierw odtwórz problem bez zmieniania ustawień. Zapisz nazwę produktu i wariantu, cenę regularną i promocyjną, ilość, kod, walutę, adres rozliczeniowy oraz sposób prezentacji podatku. Zanotuj, jaka kwota powinna się pojawić i w którym miejscu wynik pierwszy raz przestaje się zgadzać.

Jeżeli cena jest błędna już na karcie, sprawdź cenę produktu, wariant, walutę i cache strony. Jeśli karta jest poprawna, ale koszyk nie, weryfikuj kupon, rabaty automatyczne, adres podatkowy oraz przeliczenie koszyka. Gdy panel zamówienia różni się od checkoutu, sprawdź zapisane pozycje i logi bramki przed ponowną próbą obciążenia klienta.

Używaj tego samego wariantu i identycznego kodu kuponu. Dodatkowa spacja, adres z innego kraju albo produkt wyprzedażowy mogą zmienić regułę, którą sklep zastosuje.

Najpierw ustal, od jakiej wartości ma być liczona promocja: ceny regularnej, promocyjnej, ceny produktu czy kwalifikującej się części koszyka. WooCommerce core oferuje kupony procentowe, stałą zniżkę na produkt i stałą zniżkę na koszyk.

Kupony WooCommerce są naliczane do cen produktów przed obliczeniem podatku. Sklep może wyświetlać ceny brutto, ale rabat i podatek są rozliczane na pozycjach koszyka, co czasem daje różnicę kilku groszy wobec ręcznego odjęcia procentu od całej sumy brutto. Przy cenie 123 zł brutto i stawce 23% cena netto wynosi 100 zł; rabat 10% zmniejsza podstawę netto o 10 zł, a podatek nalicza się od obniżonej podstawy.

Sprawdź konfigurację w WooCommerce > Ustawienia > Podatek: czy ceny produktów wpisujesz z podatkiem oraz jak wyświetlasz ceny w sklepie, koszyku i checkoutcie. Porównaj pozycję zamówienia i przypisany do niej podatek, a zasady ustawień cen opisujemy szerzej w przewodniku o cenach WooCommerce i VAT.

Kupon może być aktywny, ale nie kwalifikować się do zawartości koszyka. W panelu przejdź do Marketing > Kupony, edytuj kod i sprawdź zakładki Ogólne, Ograniczenia użycia oraz Limity użycia. Kupony trzeba też włączyć w WooCommerce > Ustawienia > Ogólne > Włącz kupony.

Sprawdź datę ważności, minimalną i maksymalną wartość koszyka, produkty i kategorie objęte rabatem, wykluczenia produktów przecenionych, dozwolone adresy e-mail oraz limit użyć na kupon i klienta. Przy stałej zniżce produktowej sprawdź limit liczby kwalifikujących się sztuk, a przy kuponie na koszyk upewnij się, czy jego podstawa obejmuje tylko określone pozycje.

WooCommerce core nie stosuje kodu kuponu automatycznie: klient wpisuje go w koszyku lub checkoutcie. Jeżeli rabat ma włączyć się bez kodu, sprawdź rozszerzenie promocji automatycznej i jego warunki, zamiast szukać błędu w kuponie. Oficjalna dokumentacja zarządzania kuponami WooCommerce opisuje aktywację, typy zniżek, ograniczenia użycia i komunikaty przy odmowie zastosowania.

Komunikat o nieprawidłowym kuponie warto diagnozować dosłownie. Zapisz pełną treść błędu, a następnie sprawdź kod, datę wygaśnięcia, próg koszyka, ograniczenia produktów, adres e-mail i limit użyć. Nie wyłączaj ograniczeń hurtowo, bo możesz przypadkiem uruchomić promocję dla klientów lub produktów spoza jej zakresu.

Różnica często wynika z tego, że karta produktu i koszyk stosują inne warunki: wariant, adres podatkowy, walutę albo rabat automatyczny. Zapisz miejsce, w którym kwoty się rozchodzą, i porównaj te same dane wejściowe.

Wyczyść cache strony i przeglądarki oraz sprawdź produkt w nowej sesji. WooCommerce > Status > Narzędzia zawiera narzędzia utrzymaniowe, w tym czyszczenie niektórych danych cache, ale cache hostingu, CDN i wtyczki może wymagać osobnego opróżnienia. Nie wykluczaj z cache całego sklepu bez diagnozy; porównaj zachowanie produktu i koszyka w warunkach bez cache.

Jeśli checkout przelicza podatek po wpisaniu adresu, to wynik przed i po uzupełnieniu adresu może być różny zgodnie z konfiguracją podatkową. Porównuj ceny dla tego samego kraju, kodu pocztowego i klasy podatkowej produktu. W przypadku wielu walut testuj każdą walutę jako osobny scenariusz, bo kurs, zaokrąglenie i reguła kuponu mogą zależeć od dodatku.

Konflikt rozszerzeń testuj na kopii sklepu lub stagingu, aby nie zmieniać doświadczenia klientów. Zaktualizuj wtyczki i motyw na środowisku testowym, odtwórz błąd, a następnie włącz motyw domyślny, na przykład Storefront, i sprawdź wynik.

Kolejny krok to czasowe pozostawienie aktywnego WooCommerce i dodatku, którego dotyczy problem, a następnie ponowne wykonanie tych samych działań. Jeśli błąd zniknie, włączaj pozostałe rozszerzenia pojedynczo i testuj po każdej zmianie. Zwróć uwagę na dodatki do cen dynamicznych, walut, kuponów, cache, checkoutu i wariantów.

W przeglądarce otwórz narzędzia deweloperskie i sprawdź zakładkę Console po dodaniu kuponu oraz zmianie ilości. Błędy JavaScript mogą blokować aktualizację sumy, mimo że serwer zapisuje poprawną cenę. W zakładce Network sprawdź, czy żądanie aktualizacji koszyka kończy się odpowiedzią błędu i czy występuje przy konkretnym produkcie lub kuponie.

Oficjalna procedura WooCommerce zaleca testowanie konfliktów na kopii, przełączenie motywu i wyłączanie rozszerzeń poza WooCommerce oraz badanym dodatkiem. Można też wyłączyć cache przeglądarki podczas testu. Zapisz listę testowanych komponentów, bo bez tego trudno odróżnić wynik konfliktu od chwilowego efektu cache.

Porównaj trzy wartości: cenę pokazaną klientowi, sumę zamówienia zapisaną w WooCommerce i kwotę przekazaną do operatora płatności. Jeśli panel i płatność są zgodne, a ekran pokazuje inną cenę, problem dotyczy prezentacji lub cache; jeśli różnią się też zapisane kwoty, sprawdź naliczanie kuponu, podatku lub własny kod.

Kontrola ręczna dla rabatu procentowego jest prosta: wartość kwalifikującej się podstawy × stawka rabatu = rabat przed podatkiem. Przy kuponie stałym sprawdź osobno, czy dotyczy produktu czy koszyka, ile jednostek obejmuje i jak WooCommerce podzielił rabat pomiędzy pozycje. Nie porównuj procentu od całego koszyka z kuponem, który obejmuje tylko jeden produkt.

W szczegółach zamówienia przejrzyj pozycje, wartość kuponu, podatek, dostawę i sumę końcową. Jeśli rabat jest rozdzielony pomiędzy kilka produktów, suma rabatów na pozycjach może różnić się o grosz od prostego obliczenia od całej kwoty z powodu zaokrągleń. Porównuj wartości zapisane na pozycjach, a nie tylko etykietę promocyjną na stronie.

Przed ręczną korektą zamówienia sprawdź, czy kwota została już autoryzowana lub pobrana. Korekta w panelu nie musi zmieniać płatności zewnętrznej. Zapisz numer zamówienia testowego, zastosowany kupon, podstawę rabatu, podatek i kwotę operatora, aby wykazać, na którym etapie powstała różnica.

W WooCommerce sprawdź ustawienie aktywacji kuponów, sam kod i jego ograniczenia, ceny produktu, wariant oraz podatki. W edycji kuponu zweryfikuj zakładki Ogólne, Ograniczenia użycia i Limity użycia, a w ustawieniach sklepu tryb wprowadzania oraz wyświetlania cen.

Sprawdź też, czy problem występuje w klasycznym koszyku, czy w Cart and Checkout Blocks. Oficjalna dokumentacja badanego rozszerzenia może określać obsługiwany typ checkoutu i ograniczenia integracji. Nie zakładaj, że poprawny wynik na stronie produktu gwarantuje poprawne przeliczenie po zmianie adresu lub w bloku checkoutu.

Przed zgłoszeniem przygotuj krótką reprodukcję: adres produktu, identyfikator wariantu, kod kuponu, ilość, adres testowy, oczekiwaną wartość i wynik rzeczywisty. Dodaj zrzuty karty, koszyka i zamówienia oraz informację o aktywnych dodatkach cenowych. Nie wysyłaj danych osobowych klienta w publicznym zgłoszeniu ani zrzucie ekranu.

Jeśli błąd dotyczy naliczania kuponu w WooCommerce, pomoc techniczna WooCommerce może objąć diagnozę ustawień, konfliktów dodatków i zapisu zamówienia. Do czasu naprawy wstrzymaj promocję, jeśli sklep pobiera błędną kwotę, albo tymczasowo usuń wyłącznie regułę, która powoduje rozbieżność.

Programista jest potrzebny, gdy błąd pozostaje po sprawdzeniu warunków kuponu, podatków, cache i konfliktów albo gdy własny kod modyfikuje cenę. Przekaż mu reprodukcję problemu, wynik testu na kopii, wersje WooCommerce i rozszerzeń oraz informację, czy nieprawidłowa kwota trafia do zamówienia i operatora płatności.

Po naprawie ponownie sprawdź kupon działający i niedziałający, produkt objęty oraz wykluczony, cenę promocyjną, warianty, podatek, zmianę ilości, zapis zamówienia i kwotę operatora. Odbiór powinien wykazać, że rabat nalicza się raz i tylko na pozycje, które spełniają warunki.