Modifier le stock
ps_update_stock
- ProTellMyShop Pro uniquement
- Écriture · aperçu + validation
- Enregistre: interrupteur Ventes (jusqu’à désactivation)
- Ventes · interrupteur, jusqu’à désactivation
- Visible dès l’installation
Modifie le nombre d’articles que vous avez en stock.
TellMyShop Free: Non. Cet outil fait uniquement partie de TellMyShop Pro. TellMyShop Free ne contient que des rapports prêts à l’emploi qui lisent votre boutique.
Demandez au chat
« Nous avons reçu 40 lampes noires ref:LMP-01 de plus. Ajoute-les au stock. »
Exemple d’aperçu
Produit 45 Lampe de jardin Nova, déclinaison Noir : 12 -> 52 (+40). En rupture de stock : refuser les commandes (inchangé). Un mouvement de stock sera enregistré.
Détails techniques
Définit la quantité en stock (une nouvelle valeur, ou delta = variation de plus ou moins N) et le comportement en rupture de stock (deny, allow, ou default = réglage de la boutique), pour jusqu’à 100 éléments par appel. Pour un produit avec déclinaisons, indiquez combination_id ; sans lui, l’aperçu liste les déclinaisons avec leurs ID et leur stock. Enregistre comme le back office : un mouvement de stock au nom de l’employé du connecteur et le hook de mise à jour du stock, pour que les modules qui synchronisent le stock (places de marché, ERP) voient la modification.
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| shop_id | integer | non | ID de la boutique dans une installation multiboutique. Par défaut, la boutique de l’adresse du connecteur. Les ID sont listés par ps_get_shop_info. |
| changes | array of object | oui | Un élément par produit ou par déclinaison. 100 éléments maximum. Champs de chaque élément : product (string, obligatoire) : produit (id:123, ref:ABC-1, ean:..., URL du produit, ID, EAN ou référence). 300 caractères maximum. combination_id (integer) : ID de la déclinaison (obligatoire pour modifier la quantité d’un produit avec déclinaisons). quantity (integer) : nouvelle quantité. De 0 à 1 000 000. delta (integer) : modifier la quantité de plus ou moins N (au lieu de quantity). De -1 000 000 à 1 000 000. out_of_stock (enum : deny | allow | default) : comportement en rupture de stock. |
| confirm | boolean | non | false (par défaut) renvoie un aperçu et n’enregistre rien. true exécute, uniquement après que l’utilisateur a validé l’aperçu, avec change_token. |
| change_token | string | quand | Jeton issu de l’aperçu. Obligatoire avec confirm=true. Valable 30 minutes, à usage unique, lié aux arguments et à l’état des données de l’aperçu. |
Limites
100 éléments maximum par appel. Gestion avancée des stocks (entrepôts) : non prise en charge [à confirmer]. Annulable avec ps_revert_change.
Ce que vous voyez avant tout enregistrement
Le chat appelle d’abord l’outil sans le confirmer. Le module renvoie un aperçu (valeurs actuelles et nouvelles) et un jeton à usage unique valable 30 minutes. Le chat vous montre l’aperçu et n’enregistre la modification qu’après votre oui.
Outils liés
- Déclinaisons des produits (variantes) ps_manage_combinations
- Obtenir un produit ps_get_product
- Diagnostiquer la visibilité d’un produit ps_diagnose_product_visibility
- Annuler une modification ps_revert_change
Cas d’usage avec cet outil
- Corriger les niveaux de stock après un inventaire
- Ajouter de nouveaux produits à partir de la liste d’un fournisseur
- Régler les prix, les codes et le stock des tailles et des couleurs
Dernière mise à jour: 2026-10-11