Správa pravidel košíku a slevových kódů
ps_manage_cart_rules
- ProJen v TellMyShop Pro
- Zápis · náhled + schválení
- Ukládá: přepínač Prodej (dokud ho nevypnete)
- Prodej · přepínač, dokud ho nevypnete
- Viditelný hned po instalaci
Vytváří slevové kódy, včetně sérií jednorázových kódů, a zapíná je nebo vypíná. Nové kódy začínají vypnuté.
TellMyShop Free: Ne. Tento nástroj je jen v TellMyShop Pro. TellMyShop Free má jen hotové přehledy, které váš obchod čtou.
Zeptejte se chatu
„Vytvořte kód VITEJTE10: 10 % sleva na objednávky nad 200 PLN, platný do konce roku, jednou na zákazníka.“
Ukázkový náhled
Nové pravidlo košíku „Vítejte 10 %“, kód VITEJTE10, 10 %, min. 200 PLN s DPH, 2026-10-05 až 2026-12-31, 1 na zákazníka, 1000 použití. Vytvořeno jako NEAKTIVNÍ: po kontrole ho zapněte přes set_active.
Technické podrobnosti
Slevové kódy (pravidla košíku). action=list (s počtem použití) a action=get (podrobnosti s omezeními). action=create vytvoří jeden kód: procento, částka nebo doprava zdarma, minimální hodnota košíku, data, celkový počet použití a použití na zákazníka, volitelná omezení na kategorie, produkty nebo výrobce, skupiny zákazníků, exclusive (nekombinuje se s jinými kódy), exclude_discounted a u procentních slev apply_to (celá objednávka, vybrané produkty nebo nejlevnější produkt). action=generate vytvoří sérii unikátních JEDNORÁZOVÝCH kódů s předponou (například 200 kódů pro newsletter, count až 500) se stejnými podmínkami. action=update změní kód, data, limity, hodnotu nebo název. action=set_active kód zapne nebo vypne. action=delete odebere kód, který NIKDY nebyl použit v objednávce (použitý kód lze jen vypnout). Nové kódy začínají NEAKTIVNÍ, pokud není activate=true. Pravidlo bez kódu platí pro každého zákazníka automaticky a potřebuje auto_apply=true.
Parametry
| Název | Typ | Povinný | Popis |
|---|---|---|---|
| action | enum: list | get | create | update | set_active | generate | delete | ano | list | get | create | update | set_active | generate | delete. |
| shop_id | integer | ne | ID obchodu v instalaci multistore. Výchozí je obchod z adresy konektoru. ID vypíše ps_get_shop_info. |
| cart_rule_id | integer | když | get/update/set_active/delete: ID z action=list. |
| name | string | ne | create/generate/update: název zobrazený v košíku zákazníka (například „Podzimní výprodej -10 %“). Max. 254 znaků. |
| code | string | ne | create/update: kód, který se zadává v košíku (písmena, číslice, - a _). |
| auto_apply | boolean | ne | create: true = pravidlo BEZ kódu, uplatněné automaticky u každého, kdo splní podmínky. Výchozí false. |
| reduction_percent | number | ne | sleva v % (create/generate/update). Max. 100. |
| reduction_amount | number | ne | částková sleva v měně obchodu (create/generate/update). Max. 1 000 000. |
| amount_tax_included | boolean | ne | create/generate: částková sleva je s DPH (výchozí). |
| free_shipping | boolean | ne | doprava zdarma (create/generate/update). |
| minimum_amount | number | ne | minimální hodnota košíku s DPH, 0 = bez minima (create/generate/update). |
| date_from | string (YYYY-MM-DD) | ne | platné od (create/generate: výchozí dnes), RRRR-MM-DD. |
| date_to | string (YYYY-MM-DD) | když | platné do (create/generate: povinné), RRRR-MM-DD. |
| quantity | integer | když | create: celkový počet použití (povinné); update: zbývající počet použití. Rozsah 0 až 1 000 000. |
| quantity_per_user | integer | ne | použití na zákazníka (výchozí 1). Rozsah 1 až 1000. |
| category_ids | array of integer | ne | create/generate: kód funguje, jen když je v košíku produkt z těchto kategorií (ID z ps_get_category_tree). Max. 50 položek. |
| products | array of string | ne | create/generate: kód funguje jen s těmito produkty. Max. 100 položek. |
| manufacturer_ids | array of integer | ne | create/generate: kód funguje jen s produkty těchto výrobců. Max. 50 položek. |
| min_products | integer | ne | create/generate: kolik takových produktů musí být v košíku. Rozsah 1 až 1000. Výchozí 1. |
| apply_to | enum: order | selected_products | cheapest | ne | create/generate (jen procentní sleva): order = celý košík, selected_products = jen omezené produkty, cheapest = nejlevnější produkt. Výchozí order. |
| exclude_discounted | boolean | ne | create/generate/update: sleva vynechá produkty, které už jsou zlevněné. |
| customer_group_ids | array of integer | ne | create/generate: jen pro tyto skupiny zákazníků. Max. 20 položek. |
| exclusive | boolean | ne | create/generate: nelze kombinovat s jinými slevovými kódy. Výchozí false. |
| highlight | boolean | ne | create/update: nabídnout kód v košíku, když zákazník splní podmínky. |
| partial_use | boolean | ne | create/update (částková sleva): nevyužitá část částky zůstane zákazníkovi jako nový kód. |
| description | string | ne | create/generate/update: interní popis (jen v administraci). Max. 254 znaků. |
| activate | boolean | ne | create/generate: aktivní hned (výchozí ne: zapnete ho po kontrole). |
| count | integer | když | generate: kolik kódů (každý jednorázový). Rozsah 1 až 500. |
| prefix | string | když | generate: předpona kódu (například NEWS10 -> NEWS10-7KQ3XW9P). |
| code_length | integer | ne | generate: délka náhodné části kódu. Rozsah 6 až 16. Výchozí 8. |
| active | boolean | když | set_active: true = zapnout, false = vypnout. |
| only_active | boolean | ne | list: jen aktivní. Výchozí false. |
| search | string | ne | list: část názvu nebo kódu. Max. 100 znaků. |
| limit | integer | ne | Maximální počet řádků (výchozí 50, max. 200). |
| offset | integer | ne | Počet řádků k přeskočení, pro stránkování (výchozí 0). |
| confirm | boolean | ne | false (výchozí) vrátí náhled a nic neuloží. true provede změnu, jen když uživatel náhled schválil, spolu s change_token. |
| change_token | string | když | Token z náhledu. Povinný s confirm=true. Platí 30 minut, jednorázový, vázaný na argumenty a stav dat z náhledu. |
Omezení
Nové kódy začínají neaktivní, pokud není activate=true. generate: až 500 jednorázových kódů na volání. delete jen u kódů, které nikdy nebyly použity v objednávce. Pravidlo bez kódu potřebuje auto_apply. Seznam max. 200 řádků (výchozí 50). Jde o nástroj pro zápis, takže bez aktivní licence je skrytý, včetně seznamu; změny potřebují přepínač Prodej. Oprávnění se kontroluje pro každou akci (AdminCartRules). Lze vrátit přes ps_revert_change.
Co uvidíte, než se cokoli uloží
Chat nejdřív zavolá nástroj bez potvrzení. Modul vrátí náhled (současné a nové hodnoty) a jednorázový token platný 30 minut. Chat vám náhled ukáže a změnu uloží až po vašem ano.
Související nástroje
- Akce na kategorie a značky (katalogová cenová pravidla) ps_manage_catalog_price_rules
- Správa akčních cen (specifické ceny) ps_manage_specific_prices
- Vrácení změny zpět ps_revert_change
Příklady použití s tímto nástrojem
- Vytvořte slevový kód pro newsletter
- Dejte jednomu zákazníkovi jednorázový kód na omluvu
- Projděte aktivní slevové kódy a slevy
- Připravte kampaň na Black Friday v celém obchodě
- Porovnejte hranice dopravy zdarma s průměrnou objednávkou
- Deaktivujte prošlé a vyčerpané slevové kódy
- Nabídněte dopravu zdarma od určité částky objednávky
- Připravte celý obchod na Black Friday
- Úklid po akci
Naposledy aktualizováno: 2026-10-11