Reguły koszyka i kody rabatowe
ps_manage_cart_rules
Tworzy kody rabatowe i włącza albo wyłącza je. Nowe kody startują jako wyłączone.
Zapytaj Claude
„Utwórz kod WITAJ10: 10% na zamówienia powyżej 200 zł, ważny do końca roku, raz na klienta.”
Przykładowy podgląd
Nowa reguła „Powitalny 10%”, kod WITAJ10, 10%, min. 200 zł, 2026-10-03 do 2026-12-31, 1 na klienta, 1000 użyć. Powstanie jako NIEAKTYWNA. Włącz ją przez set_active po sprawdzeniu.
Szczegóły techniczne
Wyświetla, tworzy albo włącza i wyłącza reguły koszyka (rabaty i kody rabatowe): procent, kwota albo darmowa dostawa, minimalna wartość koszyka, daty ważności, łączna liczba użyć i liczba na klienta. action=list tylko czyta. Nowy kod powstaje NIEAKTYWNY; włączasz go przez action=set_active po sprawdzeniu. Usuwania nie ma: kod można tylko wyłączyć. Reguła bez kodu wymaga auto_apply.
Parametry
Nazwy parametrów nie są jeszcze potwierdzone w module 0.3.0 i mogą się zmienić.
| Nazwa | Typ | Wymagany | Opis |
|---|---|---|---|
| action | enum: list | create | set_active | tak | list czyta reguły; create dodaje nową, nieaktywną regułę; set_active włącza albo wyłącza regułę. |
| cart_rule_id | integer | nie | Reguła do przełączenia (set_active). |
| active | boolean | nie | Nowy stan (set_active). |
| name | string | nie | Nazwa widoczna dla klienta (create). |
| code | string | nie | Kod rabatowy (create). Bez kodu wymagany jest auto_apply. |
| auto_apply | boolean | nie | Stosuj automatycznie, bez kodu (create). |
| reduction_percent | number | nie | Rabat procentowy (create). |
| reduction_amount | number | nie | Rabat kwotowy (create). |
| free_shipping | boolean | nie | Darmowa dostawa (create). |
| minimum_amount | number | nie | Minimalna wartość koszyka (create). |
| date_from | string (YYYY-MM-DD HH:MM) | nie | Ważny od (create). |
| date_to | string (YYYY-MM-DD HH:MM) | nie | Ważny do (create). |
| quantity | integer | nie | Łączna liczba użyć (create). |
| quantity_per_user | integer | nie | Liczba użyć na klienta (create). |
| shop_id | integer | nie | ID sklepu w instalacji multistore. Domyślnie sklep z adresu konektora. Listę ID zwraca ps_get_shop_info. |
| confirm | boolean | nie | false (domyślnie) zwraca podgląd i niczego nie zapisuje. true wykonuje zmianę, wyłącznie po zgodzie użytkownika na podgląd, razem z change_token. |
| change_token | string | warunkowo | Token z podglądu. Wymagany przy confirm=true. Ważny 30 minut, jednorazowy, związany z argumentami i stanem danych z podglądu. |
Ograniczenia
Nowe kody startują jako nieaktywne. Nie ma akcji usuwania: zamiast tego wyłącz kod. Reguła bez kodu wymaga auto_apply. Uprawnienia sprawdzane per akcja (AdminCartRules add / edit).
Co widzisz przed zapisem
Claude najpierw wywołuje narzędzie bez potwierdzenia. Moduł zwraca podgląd (obecne i nowe wartości) oraz jednorazowy token ważny 30 minut. Claude pokazuje Ci podgląd i zapisuje zmianę dopiero po Twojej zgodzie.
Powiązane narzędzia
- Ceny promocyjne (ceny specyficzne) ps_manage_specific_prices
- Cofnięcie zmiany ps_revert_change
Aktualizacja: 2026-10-03