Aggiorna le scorte
ps_update_stock
- ProSolo TellMyShop Pro
- Scrittura · anteprima + approvazione
- Salva: interruttore Vendite (finché non lo spegni)
- Vendite · interruttore, finché non lo spegni
- Visibile subito dopo l’installazione
Cambia quanti articoli hai in magazzino.
TellMyShop Free: No. Questo strumento è solo in TellMyShop Pro. TellMyShop Free ha solo report pronti che leggono il tuo negozio.
Chiedi alla chat
«Ci sono arrivate altre 40 lampade nere ref:LMP-01. Aggiungile alle scorte.»
Anteprima di esempio
Prodotto 45 Lampada da giardino Nova, combinazione Nero: 12 -> 52 (+40). In caso di esaurimento: rifiuta gli ordini (invariato). Verrà registrato un movimento di magazzino.
Dettagli tecnici
Imposta la quantità in magazzino (un nuovo valore, o delta = varia di più o meno N) e il comportamento in caso di esaurimento (deny, allow, o default = impostazione del negozio), per un massimo di 100 elementi per chiamata. Per un prodotto con combinazioni indica combination_id; senza, l’anteprima elenca le combinazioni con ID e scorte. Salva come il back office: un movimento di magazzino con il dipendente del connettore e l’hook di aggiornamento delle scorte, così i moduli che sincronizzano le scorte (marketplace, ERP) vedono la modifica.
Parametri
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| 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. |
| changes | array of object | sì | Un elemento per prodotto o 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): ID della combinazione (obbligatorio quando cambi la quantità di un prodotto con combinazioni). quantity (integer): nuova quantità. Intervallo da 0 a 1.000.000. delta (integer): varia la quantità di più o meno N (invece di quantity). Intervallo da -1.000.000 a 1.000.000. out_of_stock (enum: deny | allow | default): comportamento in caso di esaurimento. |
| 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
Massimo 100 elementi per chiamata. Gestione avanzata delle scorte (magazzini): non gestita [da confermare]. 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
- Combinazioni dei prodotti (varianti) ps_manage_combinations
- Leggi un prodotto ps_get_product
- Diagnostica la visibilità di un prodotto ps_diagnose_product_visibility
- Annulla una modifica ps_revert_change
Casi d’uso con questo strumento
- Correggi le scorte dopo un inventario
- Aggiungi nuovi prodotti dal listino di un fornitore
- Imposta prezzi, codici e scorte per taglie e colori
Ultimo aggiornamento: 2026-10-11