Winkelwagenregels en kortingscodes beheren
ps_manage_cart_rules
- ProAlleen TellMyShop Pro
- Schrijven · voorbeeld + goedkeuren
- Slaat op: schakelaar Verkoop (tot je hem uitzet)
- Verkoop · schakelaar, tot je hem uitzet
- Zichtbaar direct na installatie
Maakt kortingscodes aan, ook reeksen codes voor eenmalig gebruik, en schakelt ze in of uit. Nieuwe codes beginnen uitgeschakeld.
TellMyShop Free: Nee. Deze tool zit alleen in TellMyShop Pro. TellMyShop Free heeft alleen kant-en-klare rapporten die je winkel lezen.
Vraag het aan de chat
“Maak code WELKOM10: 10% korting op bestellingen boven 200 PLN, geldig tot het eind van het jaar, één keer per klant.”
Voorbeeldweergave van een wijziging
Nieuwe winkelwagenregel “Welkom 10%”, code WELKOM10, 10%, min. 200 PLN bruto, 2026-10-05 tot 2026-12-31, 1 per klant, 1000 keer te gebruiken. Aangemaakt als INACTIEF: schakel hem na controle in met set_active.
Technische details
Kortingscodes (winkelwagenregels). action=list (met aantal keer gebruikt) en action=get (details met beperkingen). action=create maakt één code: percentage, bedrag of gratis verzending, minimale waarde van de winkelwagen, data, totaal aantal keer te gebruiken en aantal per klant, optionele beperking tot categorieën, producten of fabrikanten, klantgroepen, exclusive (niet te combineren met andere codes), exclude_discounted en, bij kortingen in procenten, apply_to (hele bestelling, geselecteerde producten of het goedkoopste product). action=generate maakt een reeks unieke codes VOOR EENMALIG GEBRUIK met een voorvoegsel (bijvoorbeeld 200 codes voor de nieuwsbrief, count tot 500) met dezelfde voorwaarden. action=update wijzigt code, data, limieten, waarde of naam. action=set_active schakelt een code in of uit. action=delete verwijdert een code die NOOIT in een bestelling is gebruikt (een gebruikte code kan alleen worden uitgeschakeld). Nieuwe codes beginnen INACTIEF, tenzij activate=true. Een regel zonder code geldt automatisch voor elke klant en vereist auto_apply=true.
Parameters
| Naam | Type | Verplicht | Beschrijving |
|---|---|---|---|
| action | enum: list | get | create | update | set_active | generate | delete | ja | list | get | create | update | set_active | generate | delete. |
| shop_id | integer | nee | Winkel-ID in een multistore-installatie. Standaard de winkel uit het connectoradres. ID’s staan in ps_get_shop_info. |
| cart_rule_id | integer | wanneer | get/update/set_active/delete: ID uit action=list. |
| name | string | nee | create/generate/update: naam die in de winkelwagen van de klant wordt getoond (bijvoorbeeld “Herfstactie -10%”). Max. 254 tekens. |
| code | string | nee | create/update: de code die in de winkelwagen wordt ingetypt (letters, cijfers, - en _). |
| auto_apply | boolean | nee | create: true = een regel ZONDER code, automatisch toegepast op iedereen die aan de voorwaarden voldoet. Standaard false. |
| reduction_percent | number | nee | korting in % (create/generate/update). Max. 100. |
| reduction_amount | number | nee | korting als bedrag in de valuta van de winkel (create/generate/update). Max. 1.000.000. |
| amount_tax_included | boolean | nee | create/generate: de korting als bedrag is bruto (standaard). |
| free_shipping | boolean | nee | gratis verzending (create/generate/update). |
| minimum_amount | number | nee | minimale brutowaarde van de winkelwagen, 0 = geen minimum (create/generate/update). |
| date_from | string (YYYY-MM-DD) | nee | geldig vanaf (create/generate: standaard vandaag), JJJJ-MM-DD. |
| date_to | string (YYYY-MM-DD) | wanneer | geldig tot (create/generate: verplicht), JJJJ-MM-DD. |
| quantity | integer | wanneer | create: totaal aantal keer te gebruiken (verplicht); update: resterend aantal keer. Bereik 0 tot 1.000.000. |
| quantity_per_user | integer | nee | aantal keer per klant (standaard 1). Bereik 1 tot 1000. |
| category_ids | array of integer | nee | create/generate: de code werkt alleen als er een product uit deze categorieën in de winkelwagen zit (ID’s uit ps_get_category_tree). Max. 50 items. |
| products | array of string | nee | create/generate: de code werkt alleen met deze producten. Max. 100 items. |
| manufacturer_ids | array of integer | nee | create/generate: de code werkt alleen met producten van deze fabrikanten. Max. 50 items. |
| min_products | integer | nee | create/generate: hoeveel van zulke producten in de winkelwagen moeten zitten. Bereik 1 tot 1000. Standaard 1. |
| apply_to | enum: order | selected_products | cheapest | nee | create/generate (alleen korting in procenten): order = hele winkelwagen, selected_products = alleen de beperkte producten, cheapest = het goedkoopste product. Standaard order. |
| exclude_discounted | boolean | nee | create/generate/update: de korting slaat producten over die al in de aanbieding zijn. |
| customer_group_ids | array of integer | nee | create/generate: alleen voor deze klantgroepen. Max. 20 items. |
| exclusive | boolean | nee | create/generate: niet te combineren met andere kortingscodes. Standaard false. |
| highlight | boolean | nee | create/update: de code in de winkelwagen voorstellen als de klant aan de voorwaarden voldoet. |
| partial_use | boolean | nee | create/update (korting als bedrag): het ongebruikte deel van het bedrag blijft als nieuwe code voor de klant. |
| description | string | nee | create/generate/update: interne beschrijving (alleen backoffice). Max. 254 tekens. |
| activate | boolean | nee | create/generate: meteen actief (standaard nee: je schakelt de code na controle in). |
| count | integer | wanneer | generate: hoeveel codes (elk voor eenmalig gebruik). Bereik 1 tot 500. |
| prefix | string | wanneer | generate: voorvoegsel van de code (bijvoorbeeld NEWS10 -> NEWS10-7KQ3XW9P). |
| code_length | integer | nee | generate: lengte van het willekeurige deel van de code. Bereik 6 tot 16. Standaard 8. |
| active | boolean | wanneer | set_active: true = inschakelen, false = uitschakelen. |
| only_active | boolean | nee | list: alleen actieve. Standaard false. |
| search | string | nee | list: fragment van de naam of code. Max. 100 tekens. |
| limit | integer | nee | Maximaal aantal rijen (standaard 50, max. 200). |
| offset | integer | nee | Aantal rijen om over te slaan, voor paginering (standaard 0). |
| confirm | boolean | nee | false (standaard) geeft een voorbeeld en slaat niets op. true voert uit, alleen nadat de gebruiker het voorbeeld heeft goedgekeurd, samen met change_token. |
| change_token | string | wanneer | Token uit het voorbeeld. Verplicht bij confirm=true. 30 minuten geldig, eenmalig, gekoppeld aan de argumenten en de gegevensstatus van het voorbeeld. |
Grenzen
Nieuwe codes beginnen inactief, tenzij activate=true. generate: tot 500 codes voor eenmalig gebruik per aanroep. delete alleen voor codes die nooit in een bestelling zijn gebruikt. Een regel zonder code vereist auto_apply. Lijst max. 200 rijen (standaard 50). Het is een schrijftool, dus zonder actieve licentie is hij verborgen, ook list; wijzigingen vereisen de schakelaar Verkoop. Rechten worden per actie gecontroleerd (AdminCartRules). Terug te draaien met ps_revert_change.
Wat je ziet voordat er iets wordt opgeslagen
De chat roept de tool eerst aan zonder bevestiging. De module geeft een voorbeeld (huidige en nieuwe waarden) en een eenmalig token dat 30 minuten geldig is. De chat laat je het voorbeeld zien en slaat de wijziging pas op na jouw ja.
Verwante tools
- Acties per categorie en merk (catalogusprijsregels) ps_manage_catalog_price_rules
- Actieprijzen beheren (specifieke prijzen) ps_manage_specific_prices
- Wijziging terugdraaien ps_revert_change
Toepassingen met deze tool
- Maak een kortingscode voor een nieuwsbrief
- Geef één klant een eenmalige excuuscode
- Bekijk de actieve kortingscodes en kortingen
- Bereid een Black Friday-campagne voor in de hele winkel
- Vergelijk de drempels voor gratis verzending met je gemiddelde bestelling
- Deactiveer verlopen en opgebruikte kortingscodes
- Bied gratis verzending aan vanaf een vast bestelbedrag
- Maak de hele winkel klaar voor Black Friday
- Ruim op na een actie
Laatst bijgewerkt: 2026-10-11