Combinazioni dei prodotti (varianti)
ps_manage_combinations
- ProSolo TellMyShop Pro
- Scrittura · anteprima + approvazione
- Salva: interruttore Vendite (finché non lo spegni)
- Vendite · interruttore, finché non lo spegni
- Visibile subito dopo l’installazione
Mostra le varianti di un prodotto, come taglie e colori, e cambia i loro prezzi, codici e quale variante viene mostrata per prima.
TellMyShop Free: No. Questo strumento è solo in TellMyShop Pro. TellMyShop Free ha solo report pronti che leggono il tuo negozio.
Chiedi alla chat
«Le taglie XL della felpa Oslo devono costare 10 in più delle altre taglie.»
Anteprima di esempio
Prodotto 310 Felpa Oslo. Combinazione 1204 (Taglia XL, Colore Grigio): impatto sul prezzo +0,00 -> +10,00 lordi (+8,13 netti), prezzo finale 189,99 -> 199,99 PLN lordi. Combinazione 1208 (Taglia XL, Colore Blu navy): lo stesso.
Dettagli tecnici
Combinazioni (varianti: taglia, colore...). action=list mostra le combinazioni di un prodotto con attributi, riferimento, EAN, impatto sul prezzo (netto e lordo), prezzo lordo finale, scorte e la combinazione predefinita. action=update cambia fino a 100 combinazioni: price_impact_gross o price_impact_net (quanto la combinazione differisce dal prezzo base; 0 = uguale), wholesale_price, reference, ean13, upc, mpn, weight_impact, minimal_quantity, default=true (combinazione predefinita nella pagina prodotto). Non crea né elimina combinazioni. Scorte: ps_update_stock con combination_id. Promozione su una variante: ps_manage_specific_prices con combination_id.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| action | enum: list | update | sì | list | update. |
| 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. |
| lang | string | no | Codice ISO della lingua, ad esempio pl o en. Predefinita: la lingua predefinita del negozio. |
| product | string | quando | action=list: il prodotto. Il prodotto come lo indica una persona: "id:123", "ref:ABC-1", "ean:5901234123457", un URL di prodotto del negozio, un ID semplice (1–7 cifre), un EAN (8/12/13 cifre) o un riferimento. Massimo 300 caratteri. |
| changes | array of object | quando | action=update: un elemento per combinazione. Massimo 100 elementi. Campi di ogni elemento: product (string, obbligatorio): prodotto (id:123, ref:ABC-1, ean:..., URL del prodotto, ID, EAN o riferimento). Massimo 300 caratteri. combination_id (integer, obbligatorio): ID della combinazione da action=list. price_impact_gross (number): impatto sul prezzo lordo (ad esempio 10 = 10 in più del prezzo base, -5 = più economico). Intervallo da -1.000.000 a 1.000.000. price_impact_net (number): impatto sul prezzo netto (invece del lordo). Intervallo da -1.000.000 a 1.000.000. wholesale_price (number): prezzo di acquisto netto della combinazione (0 = il prezzo di acquisto del prodotto). Intervallo da 0 a 10.000.000. reference (string): riferimento (codice) della combinazione. Massimo 64 caratteri. ean13 (string): EAN-13 (vuoto = rimuovi). upc (string): UPC. mpn (string): codice del produttore (MPN). Massimo 40 caratteri. weight_impact (number): impatto sul peso (kg). Intervallo da -10.000 a 10.000. minimal_quantity (integer): quantità minima per ordine. Intervallo da 1 a 100.000. default (boolean): true = la combinazione predefinita del prodotto. |
| 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
update: fino a 100 combinazioni per chiamata. Non crea né elimina combinazioni (back office). 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
- Aggiorna le scorte ps_update_stock
- Gestisci i prezzi scontati (prezzi specifici) ps_manage_specific_prices
- Aggiorna i prezzi ps_update_prices
- Annulla una modifica ps_revert_change
Casi d’uso con questo strumento
Ultimo aggiornamento: 2026-10-11