Warenkorbregeln und Gutscheincodes verwalten
ps_manage_cart_rules
- ProNur in TellMyShop Pro
- Schreiben · Vorschau + Freigabe
- Speichert: Schalter Verkauf (bis zum Ausschalten)
- Verkauf · Schalter, bis zum Ausschalten
- Gleich nach der Installation sichtbar
Legt Rabattcodes an, auch Serien von Einmalcodes, und schaltet sie ein oder aus. Neue Codes starten ausgeschaltet.
TellMyShop Free: Nein. Dieses Werkzeug gibt es nur in TellMyShop Pro. TellMyShop Free hat nur fertige Berichte, die Ihren Shop lesen.
Den Chat fragen
„Leg den Code WELCOME10 an: 10 % auf Bestellungen über 200 PLN, gültig bis Jahresende, einmal pro Kunde.“
Beispielvorschau
Neue Warenkorbregel "Willkommen 10 %", Code WELCOME10, 10 %, mind. 200 PLN brutto, 2026-10-05 bis 2026-12-31, 1 pro Kunde, 1000 Nutzungen. Als INAKTIV angelegt: Schalten Sie sie nach der Prüfung mit set_active ein.
Technische Details
Rabattcodes (Warenkorbregeln). action=list (mit Zahl der Nutzungen) und action=get (Details mit Einschränkungen). action=create legt einen Code an: Prozent, Betrag oder kostenloser Versand, Mindestwert des Warenkorbs, Daten, Nutzungen insgesamt und pro Kunde, optionale Einschränkungen auf Kategorien, Produkte oder Hersteller, Kundengruppen, exclusive (nicht mit anderen Codes kombinierbar), exclude_discounted und bei Prozentrabatten apply_to (ganze Bestellung, ausgewählte Produkte oder das günstigste Produkt). action=generate erzeugt eine Serie eindeutiger EINMALCODES mit Präfix (zum Beispiel 200 Newsletter-Codes, count bis 500) mit denselben Bedingungen. action=update ändert Code, Daten, Limits, Wert oder Name. action=set_active schaltet einen Code ein oder aus. action=delete entfernt einen Code, der NIE in einer Bestellung genutzt wurde (ein genutzter Code lässt sich nur ausschalten). Neue Codes starten INAKTIV, außer bei activate=true. Eine Regel ohne Code gilt automatisch für jeden Kunden und braucht auto_apply=true.
Parameter
| Name | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| action | enum: list | get | create | update | set_active | generate | delete | ja | list | get | create | update | set_active | generate | delete. |
| shop_id | integer | nein | Shop-ID in einer Multistore-Installation. Standard ist der Shop aus der Konnektor-Adresse. Die IDs listet ps_get_shop_info auf. |
| cart_rule_id | integer | wenn | get/update/set_active/delete: ID aus action=list. |
| name | string | nein | create/generate/update: Name, der im Warenkorb des Kunden angezeigt wird (zum Beispiel "Herbstaktion -10 %"). Höchstens 254 Zeichen. |
| code | string | nein | create/update: der Code, der im Warenkorb eingegeben wird (Buchstaben, Ziffern, - und _). |
| auto_apply | boolean | nein | create: true = eine Regel OHNE Code, automatisch für alle angewendet, die die Bedingungen erfüllen. Standard false. |
| reduction_percent | number | nein | Rabatt in % (create/generate/update). Höchstens 100. |
| reduction_amount | number | nein | Betragsrabatt in der Shopwährung (create/generate/update). Höchstens 1.000.000. |
| amount_tax_included | boolean | nein | create/generate: Der Betragsrabatt ist brutto (Standard). |
| free_shipping | boolean | nein | kostenloser Versand (create/generate/update). |
| minimum_amount | number | nein | Mindest-Bruttowert des Warenkorbs, 0 = kein Minimum (create/generate/update). |
| date_from | string (YYYY-MM-DD) | nein | gültig ab (create/generate: Standard heute), JJJJ-MM-TT. |
| date_to | string (YYYY-MM-DD) | wenn | gültig bis (create/generate: Pflicht), JJJJ-MM-TT. |
| quantity | integer | wenn | create: Gesamtzahl der Nutzungen (Pflicht); update: verbleibende Zahl der Nutzungen. Bereich 0 bis 1.000.000. |
| quantity_per_user | integer | nein | Nutzungen pro Kunde (Standard 1). Bereich 1 bis 1000. |
| category_ids | array of integer | nein | create/generate: Der Code funktioniert nur, wenn der Warenkorb ein Produkt aus diesen Kategorien enthält (IDs aus ps_get_category_tree). Höchstens 50 Einträge. |
| products | array of string | nein | create/generate: Der Code funktioniert nur mit diesen Produkten. Höchstens 100 Einträge. |
| manufacturer_ids | array of integer | nein | create/generate: Der Code funktioniert nur mit Produkten dieser Hersteller. Höchstens 50 Einträge. |
| min_products | integer | nein | create/generate: wie viele solche Produkte im Warenkorb sein müssen. Bereich 1 bis 1000. Standard 1. |
| apply_to | enum: order | selected_products | cheapest | nein | create/generate (nur Prozentrabatt): order = ganzer Warenkorb, selected_products = nur die eingeschränkten Produkte, cheapest = das günstigste Produkt. Standard order. |
| exclude_discounted | boolean | nein | create/generate/update: Der Rabatt überspringt Produkte, die bereits reduziert sind. |
| customer_group_ids | array of integer | nein | create/generate: nur für diese Kundengruppen. Höchstens 20 Einträge. |
| exclusive | boolean | nein | create/generate: nicht mit anderen Rabattcodes kombinierbar. Standard false. |
| highlight | boolean | nein | create/update: den Code im Warenkorb vorschlagen, wenn der Kunde die Bedingungen erfüllt. |
| partial_use | boolean | nein | create/update (Betragsrabatt): Der ungenutzte Teil des Betrags bleibt dem Kunden als neuer Code. |
| description | string | nein | create/generate/update: interne Beschreibung (nur im Backend). Höchstens 254 Zeichen. |
| activate | boolean | nein | create/generate: sofort aktiv (Standard nein: Sie schalten ihn nach der Prüfung ein). |
| count | integer | wenn | generate: wie viele Codes (jeder einmal nutzbar). Bereich 1 bis 500. |
| prefix | string | wenn | generate: Präfix des Codes (zum Beispiel NEWS10 -> NEWS10-7KQ3XW9P). |
| code_length | integer | nein | generate: Länge des zufälligen Teils des Codes. Bereich 6 bis 16. Standard 8. |
| active | boolean | wenn | set_active: true = einschalten, false = ausschalten. |
| only_active | boolean | nein | list: nur aktive. Standard false. |
| search | string | nein | list: Fragment des Namens oder Codes. Höchstens 100 Zeichen. |
| limit | integer | nein | Maximale Zeilenzahl (Standard 50, höchstens 200). |
| offset | integer | nein | Zu überspringende Zeilen, zum Blättern (Standard 0). |
| confirm | boolean | nein | false (Standard) liefert eine Vorschau und speichert nichts. true führt aus, nur nachdem der Nutzer die Vorschau freigegeben hat, zusammen mit change_token. |
| change_token | string | wenn | Token aus der Vorschau. Pflicht bei confirm=true. Gilt 30 Minuten, einmal nutzbar, gebunden an die Argumente und den Datenstand der Vorschau. |
Grenzen
Neue Codes starten inaktiv, außer bei activate=true. generate: bis zu 500 Einmalcodes pro Aufruf. delete nur für Codes, die nie in einer Bestellung genutzt wurden. Eine Regel ohne Code braucht auto_apply. Liste höchstens 200 Zeilen (Standard 50). Es ist ein Schreibwerkzeug, daher ist es ohne aktive Lizenz ausgeblendet, auch list; Änderungen brauchen den Schalter Verkauf. Berechtigung pro Aktion geprüft (AdminCartRules). Mit ps_revert_change rückgängig zu machen.
Was Sie sehen, bevor etwas gespeichert wird
Der Chat ruft das Werkzeug zuerst ohne Bestätigung auf. Das Modul liefert eine Vorschau (aktuelle und neue Werte) und ein einmaliges Token, das 30 Minuten gilt. Der Chat zeigt Ihnen die Vorschau und speichert die Änderung erst nach Ihrem Ja.
Verwandte Werkzeuge
- Aktionen für Kategorien und Marken (Katalog-Preisregeln) ps_manage_catalog_price_rules
- Aktionspreise verwalten (spezifische Preise) ps_manage_specific_prices
- Änderung rückgängig machen ps_revert_change
Anwendungsfälle mit diesem Werkzeug
- Einen Gutscheincode für einen Newsletter anlegen
- Einem Kunden einen einmaligen Entschuldigungscode geben
- Aktive Gutscheincodes und Rabatte prüfen
- Eine Black-Friday-Kampagne für den ganzen Shop vorbereiten
- Grenzen für kostenlosen Versand mit Ihrem durchschnittlichen Bestellwert vergleichen
- Abgelaufene und aufgebrauchte Gutscheincodes deaktivieren
- Kostenlosen Versand ab einem festen Bestellwert anbieten
- Den ganzen Shop auf den Black Friday vorbereiten
- Nach einer Aktion aufräumen
Zuletzt aktualisiert: 2026-10-11