Ceny promocyjne (ceny specyficzne)
ps_manage_specific_prices
Ustawia, pokazuje albo usuwa ceny promocyjne na wybrane dni.
TellMyShop Free: Nie. To narzędzie jest tylko w TellMyShop Pro. TellMyShop Free ma tylko gotowe raporty, które czytają sklep.
Zapytaj Claude
„Daj 15% rabatu na sofę Oslo od piątku do niedzieli.”
Przykładowy podgląd
Produkt 112 Sofa Oslo 3-osobowa: -15%, 2026-10-09 do 2026-10-11 (włącznie), wszystkie grupy klientów, od 1 sztuki, wszystkie kombinacje. 2 499,00 -> 2 124,15 zł brutto.
Szczegóły techniczne
Promocje produktów (ceny specjalne): action=list pokazuje aktywne i zaplanowane promocje jednego produktu albo całego sklepu, action=add tworzy rabat procentowy albo kwotowy dla jednego produktu z datami, grupą klientów, minimalną ilością i opcjonalnie jedną kombinacją (combination_id), action=delete usuwa promocję po specific_price_id. Dodanie i usunięcie zwracają podgląd z ceną przed i po. Rabat powyżej 50% daje ostrzeżenie, powyżej 90% wymaga allow_big_change; promocja bez daty końca trwa bezterminowo (ostrzeżenie). Dla wielu produktów naraz użyj ps_manage_catalog_price_rules.
Parametry
| Nazwa | Typ | Wymagany | Opis |
|---|---|---|---|
| action | enum: list | add | delete | tak | list | add | delete. |
| shop_id | integer | nie | ID sklepu (multistore). Domyślnie sklep z adresu konektora; lista w ps_get_shop_info. |
| product | string | warunkowo | Wymagany przy add; przy list opcjonalny filtr. Produkt tak, jak widzi go człowiek: "id:123", "ref:ABC-1", "ean:5901234123457", adres URL produktu ze sklepu, samo ID (1–7 cyfr), EAN (8/12/13 cyfr) albo referencja. Maks. 300 znaków. |
| reduction_type | enum: percentage | amount | warunkowo | add: rabat procentowy albo kwotowy. |
| reduction | number | warunkowo | add: wartość rabatu – procent (np. 20 = 20%) albo kwota w walucie sklepu. Maks. 1 000 000. |
| tax_included | boolean | nie | add: rabat kwotowy liczony od ceny brutto (domyślnie) albo netto. |
| date_from | string (YYYY-MM-DD) | nie | add: początek promocji (domyślnie od teraz), RRRR-MM-DD. |
| date_to | string (YYYY-MM-DD) | nie | add: koniec promocji (włącznie). Bez daty = bezterminowo, RRRR-MM-DD. |
| customer_group_id | integer | nie | add: grupa klientów (0 = wszyscy). Domyślnie 0. |
| from_quantity | integer | nie | add: od ilu sztuk w koszyku. Domyślnie 1. |
| combination_id | integer | nie | add: tylko dla jednej kombinacji (wariantu) produktu – ID z ps_manage_combinations action=list. Bez tego promocja obejmuje wszystkie kombinacje. |
| specific_price_id | integer | warunkowo | delete: ID promocji z action=list. |
| allow_big_change | boolean | nie | add: zezwól na rabat > 90% (po potwierdzeniu użytkownika). Domyślnie false. |
| limit | integer | nie | Maks. liczba wierszy (domyślnie 50, maks. 200). |
| confirm | boolean | nie | false (domyślnie) = tylko podgląd, nic nie zapisuje. true = wykonaj – wyłącznie po wyraźnej zgodzie użytkownika na pokazany podgląd, razem z change_token. |
| change_token | string | warunkowo | Token z podglądu (wymagany przy confirm=true). Wiąże wykonanie z pokazanym podglądem i stanem danych; ważny 30 minut, jednorazowy. |
Ograniczenia
Jeden produkt na dodanie. Lista maks. 200 wierszy (domyślnie 50). Rabat powyżej 50%: ostrzeżenie; powyżej 90%: wymaga allow_big_change. Brak daty końca: ostrzeżenie. Daty to pełne dni (RRRR-MM-DD). To narzędzie zapisujące, więc bez aktywnej licencji jest ukryte, razem z listą; dodanie i usunięcie wymagają przełącznika Handel. Cofanie przez ps_revert_change.
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
- Promocje na kategorie i producentów (reguły cen katalogowych) ps_manage_catalog_price_rules
- Zmiana cen ps_update_prices
- Kombinacje produktu (warianty) ps_manage_combinations
- Cofnięcie zmiany ps_revert_change
Zastosowania z tym narzędziem
- Promocja czasowa na kategorię
- Przegląd aktywnych kodów rabatowych i promocji
- Przygotowanie kampanii Black Friday w całym sklepie
- Wyprzedaż sezonowa zaplanowana z datami
- Ceny, kody i stany dla rozmiarów i kolorów
- Promocja na całą markę albo kategorię
- Przygotowanie całego sklepu na Black Friday
- Sprzątanie po promocji
Aktualizacja: 2026-10-11