Gestisci regole del carrello e codici sconto
ps_manage_cart_rules
- ProSolo TellMyShop Pro
- Scrittura · anteprima + approvazione
- Salva: interruttore Vendite (finché non lo spegni)
- Vendite · interruttore, finché non lo spegni
- Visibile subito dopo l’installazione
Crea codici sconto, anche serie di codici monouso, e li attiva o disattiva. I nuovi codici partono disattivati.
TellMyShop Free: No. Questo strumento è solo in TellMyShop Pro. TellMyShop Free ha solo report pronti che leggono il tuo negozio.
Chiedi alla chat
«Crea il codice BENVENUTO10: 10% di sconto sugli ordini sopra i 200 PLN, valido fino a fine anno, una volta per cliente.»
Anteprima di esempio
Nuova regola del carrello "Benvenuto 10%", codice BENVENUTO10, 10%, minimo 200 PLN lordi, dal 2026-10-05 al 2026-12-31, 1 per cliente, 1000 utilizzi. Creata come INATTIVA: attivala con set_active dopo il controllo.
Dettagli tecnici
Codici sconto (regole del carrello). action=list (con il numero di utilizzi) e action=get (dettagli con restrizioni). action=create crea un codice: percentuale, importo o spedizione gratuita, valore minimo del carrello, date, utilizzi totali e utilizzi per cliente, restrizioni facoltative a categorie, prodotti o produttori, gruppi di clienti, exclusive (non si combina con altri codici), exclude_discounted e, per gli sconti in percentuale, apply_to (intero ordine, prodotti selezionati o il prodotto più economico). action=generate crea una serie di codici MONOUSO unici con un prefisso (ad esempio 200 codici per la newsletter, count fino a 500) con le stesse condizioni. action=update cambia codice, date, limiti, valore o nome. action=set_active attiva o disattiva un codice. action=delete rimuove un codice che non è MAI stato usato in un ordine (un codice usato si può solo disattivare). I nuovi codici partono INATTIVI salvo activate=true. Una regola senza codice si applica automaticamente a ogni cliente e richiede auto_apply=true.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| action | enum: list | get | create | update | set_active | generate | delete | sì | list | get | create | update | set_active | generate | delete. |
| shop_id | integer | no | ID del negozio in un’installazione multinegozio. Predefinito: il negozio dell’indirizzo del connettore. Gli ID sono elencati da ps_get_shop_info. |
| cart_rule_id | integer | quando | get/update/set_active/delete: ID da action=list. |
| name | string | no | create/generate/update: nome mostrato nel carrello del cliente (ad esempio "Saldi d’autunno -10%"). Massimo 254 caratteri. |
| code | string | no | create/update: il codice da digitare nel carrello (lettere, cifre, - e _). |
| auto_apply | boolean | no | create: true = una regola SENZA codice, applicata automaticamente a chiunque soddisfi le condizioni. Predefinito false. |
| reduction_percent | number | no | sconto in % (create/generate/update). Massimo 100. |
| reduction_amount | number | no | sconto in importo nella valuta del negozio (create/generate/update). Massimo 1.000.000. |
| amount_tax_included | boolean | no | create/generate: lo sconto in importo è lordo (predefinito). |
| free_shipping | boolean | no | spedizione gratuita (create/generate/update). |
| minimum_amount | number | no | valore lordo minimo del carrello, 0 = nessun minimo (create/generate/update). |
| date_from | string (YYYY-MM-DD) | no | valido dal (create/generate: predefinito oggi), AAAA-MM-GG. |
| date_to | string (YYYY-MM-DD) | quando | valido fino al (create/generate: obbligatorio), AAAA-MM-GG. |
| quantity | integer | quando | create: numero totale di utilizzi (obbligatorio); update: numero di utilizzi rimasti. Intervallo da 0 a 1.000.000. |
| quantity_per_user | integer | no | utilizzi per cliente (predefinito 1). Intervallo da 1 a 1000. |
| category_ids | array of integer | no | create/generate: il codice funziona solo quando il carrello contiene un prodotto di queste categorie (ID da ps_get_category_tree). Massimo 50 elementi. |
| products | array of string | no | create/generate: il codice funziona solo con questi prodotti. Massimo 100 elementi. |
| manufacturer_ids | array of integer | no | create/generate: il codice funziona solo con i prodotti di questi produttori. Massimo 50 elementi. |
| min_products | integer | no | create/generate: quanti di questi prodotti devono essere nel carrello. Intervallo da 1 a 1000. Predefinito 1. |
| apply_to | enum: order | selected_products | cheapest | no | create/generate (solo sconto in percentuale): order = intero carrello, selected_products = solo i prodotti della restrizione, cheapest = il prodotto più economico. Predefinito order. |
| exclude_discounted | boolean | no | create/generate/update: lo sconto salta i prodotti già scontati. |
| customer_group_ids | array of integer | no | create/generate: solo per questi gruppi di clienti. Massimo 20 elementi. |
| exclusive | boolean | no | create/generate: non si può combinare con altri codici sconto. Predefinito false. |
| highlight | boolean | no | create/update: suggerisci il codice nel carrello quando il cliente soddisfa le condizioni. |
| partial_use | boolean | no | create/update (sconto in importo): la parte non usata dell’importo resta al cliente come nuovo codice. |
| description | string | no | create/generate/update: descrizione interna (solo back office). Massimo 254 caratteri. |
| activate | boolean | no | create/generate: attivo subito (predefinito no: lo attivi dopo il controllo). |
| count | integer | quando | generate: quanti codici (ciascuno monouso). Intervallo da 1 a 500. |
| prefix | string | quando | generate: prefisso del codice (ad esempio NEWS10 -> NEWS10-7KQ3XW9P). |
| code_length | integer | no | generate: lunghezza della parte casuale del codice. Intervallo da 6 a 16. Predefinita 8. |
| active | boolean | quando | set_active: true = attiva, false = disattiva. |
| only_active | boolean | no | list: solo attivi. Predefinito false. |
| search | string | no | list: frammento del nome o del codice. Massimo 100 caratteri. |
| limit | integer | no | Righe massime (predefinite 50, massimo 200). |
| offset | integer | no | Righe da saltare, per la paginazione (predefinito 0). |
| confirm | boolean | no | false (predefinito) restituisce un’anteprima e non salva nulla. true esegue, solo dopo che l’utente ha approvato l’anteprima, insieme a change_token. |
| change_token | string | quando | Token dell’anteprima. Obbligatorio con confirm=true. Valido 30 minuti, monouso, legato agli argomenti e allo stato dei dati dell’anteprima. |
Limiti
I nuovi codici partono inattivi salvo activate=true. generate: fino a 500 codici monouso per chiamata. delete solo per codici mai usati in un ordine. Una regola senza codice richiede auto_apply. Elenco massimo 200 righe (predefinite 50). È uno strumento di scrittura, quindi senza una licenza attiva è nascosto, elenco compreso; le modifiche richiedono l’interruttore Vendite. Permessi controllati per azione (AdminCartRules). Si può annullare con ps_revert_change.
Cosa vedi prima che venga salvato qualcosa
La chat chiama prima lo strumento senza confermare. Il modulo restituisce un’anteprima (valori attuali e nuovi) e un token monouso valido 30 minuti. La chat ti mostra l’anteprima e salva la modifica solo dopo il tuo sì.
Strumenti correlati
- Promozioni su categorie e marche (regole sui prezzi del catalogo) ps_manage_catalog_price_rules
- Gestisci i prezzi scontati (prezzi specifici) ps_manage_specific_prices
- Annulla una modifica ps_revert_change
Casi d’uso con questo strumento
- Crea un codice sconto per una newsletter
- Dai a un cliente un codice di scuse da usare una volta
- Controlla i codici sconto e gli sconti attivi
- Prepara una campagna Black Friday su tutto il negozio
- Confronta le soglie di spedizione gratuita con il tuo ordine medio
- Disattiva i codici sconto scaduti ed esauriti
- Offri la spedizione gratuita da un certo importo dell’ordine
- Prepara tutto il negozio per il Black Friday
- Fai pulizia dopo una promozione
Ultimo aggiornamento: 2026-10-11